Edit Orders 4.x includes an installation / upgrade script and a removal script. These script will handle the process of installing, upgrading, and removing Edit Orders. You should not run any SQL files from older versions of Edit Orders.

DO NOT RUN OLDER VERSIONS OF THE INSTALL/UPGRADE SQL FILES when installing or upgrading!!!!!!
Doing so will cause issues with the installation and may cause Edit Orders to not function as expected.

Do you use any other Zen Cart modules? If you do make sure you read the Integration with Other Modules section for special instructions regarding the installation of Edit Orders PRIOR TO UPLOADING any files to your store.

Step by Step Installation Instructions

1. Pre - Installation.
   1. Backup your Zen Cart installation and database. Best practice is to keep regular backups and perform a manual backup prior to the installation or modification of any portion of Zen Cart.
      You can use Secure FTP to backup the files. Two well known FTP programs are WinSCP and FileZilla.
      You can backup the MySQL database either using a tool such as PhpMyAdmin or from the Zen Cart admin interface using DrByte's Backup MYSQL Plugin
   2. Unzip the package contents to a temporary directory on your computer.
      For the rest of these instructions we will refer to this location as "/temp".
2. Modified Core Files. ("/temp/1_modified_core_files")
   Because these files are modified versions of core Zen Cart files and will impact your store and potentially other plugins, they have been separated from the new files added by this plugin for easy identification.
   1. Rename the "your_admin_folder" folder to match the name of your store's admin folder.
   2. If you have installed any other plugins or modifications to your Zen Cart installation which make changes to any of the Modified Core Files you will need to use a tool like Winmerge or Beyond Compare to incorporate those changes into these files.
      If you use "Ty Package Tracker" or "Super Orders" installed make sure you read the Integration with Other Modules section before uploading.
   3. Upload all of the folders and files inside the Modified Core Files folder to the location of your Zen Cart installation. The directory structure should match your store's directory structure.
      Do not upload the "1_modified_core_files" folder to your store, just the files and folders inside the Modified Core Files directory.
3. New Files. ("/temp/2_new_files")
   These files do not include modifications to any core Zen Cart files. We will be adding these new files to Zen Cart as part of the installation of Edit Orders.
   1. Rename the "your_admin_folder" folder to match the name of your store's admin folder.
   2. If you have installed any other plugins or modifications to your Zen Cart installation which make changes to any of the New Files you will need to use a tool like Winmerge or Beyond Compare to incorporate those changes into these files.
   3. Upload all of the folders and files inside the New Files folder to the location of your Zen Cart installation. The directory structure should match your store's directory structure.
      Do not upload the "2_new_files" folder to your store, just the files and folders inside the New Files directory.
4. Install. ("/temp/3_install")
   These files trigger the installation or upgrade scripts included with Edit Orders to run inside the Zen Cart administrative interface.
   1. Log into the admin side of your Zen Cart installation using a web browser. Yes, log into your admin interface now before continuing.
      Failing to first login can result in you missing vital installation and error messages.
   2. Upload all of the folders and files inside the Install folder to the location of your Zen Cart installation. The directory structure should match your store's directory structure.
      Do not upload the "3_install" folder to your store, just the files and folders inside the Install directory.
   3. Click on ANY link in the admin interface (except edit orders). The "Admin Home" link is a good choice.
   4. Note any error or success messages which appear on the top of the site.
      • If all goes well it should report success.
      • If additional steps need to be performed, follow the instructions. When done go back to Install Step 3 (previous step).
        The previous step should start with the text "Click on ANY link" .
5. Optional Items. ("/temp/4_optional_items")
   These files are some optional files such as language packs which a user might want to install with Edit Orders.
   
   These are not currently maintained and may need to be updated to work correctly with the current version of Edit Orders. If you do update one of these please contribute those changes to the maintainers and / or the Edit Orders support thread.

Edit Orders 4.x includes a removal script. This script will handle the process of un-installing Edit Orders. You should not run any SQL files from older versions of Edit Orders.

DO NOT RUN OLDER VERSIONS OF THE UN-INSTALL / REMOVAL SQL FILES when removing!!!!!!
Doing so will cause issues with the removal and afterwards may cause Zen Cart to not function as expected.

Step by Step Removal Instructions

1. Pre - Removal.
   1. Backup your Zen Cart installation and database. Best practice is to keep regular backups and perform a manual backup prior to the installation or modification of any portion of Zen Cart.
      You can use Secure FTP to backup the files. Two well known FTP programs are WinSCP and FileZilla.
      You can backup the MySQL database either using a tool such as PhpMyAdmin or from the Zen Cart admin interface using DrByte's Backup MYSQL Plugin
   2. Unzip the package contents to a temporary directory on your computer.
      For the rest of these instructions we will refer to this location as "/temp".
2. Un-Install. ("/temp/5_uninstall")
   These files trigger the removal scripts included with Edit Orders (these run inside the Zen Cart administrative interface).
   1. Log into the admin side of your Zen Cart installation using a web browser. Yes, log into your admin interface now before continuing.
      Failing to first login can result in you missing vital installation and error messages.
   2. Upload all of the folders and files inside the Un-Install folder to the location of your Zen Cart installation. The directory structure should match your store's directory structure.
      Do not upload the "5_uninstall" folder to your store, just the files and folders inside the Install directory.
   3. Click on ANY link in the admin interface (except edit orders). The "Admin Home" link is a good choice.
   4. Note any error or success messages which appear on the top of the site.
      • If all goes well it should report success.
      • If additional steps need to be performed, follow the instructions. When done go back to Install Step 3 (previous step).
        The previous step should start with the text "Click on ANY link" .
        
        If a file could not be deleted it is always better to correct permissions and allow the script to remove files. If you manually remove files the removal process may not ever be completed.
3. Cleanup Modified Core Files. ("/temp/1_modified_core_files")
   The un-installation script cannot automatically remove the alterations made to core Zen Cart files. These steps should aid you in undoing the changes.
   1. Rename the "your_admin_folder" folder to "admin".
   2. Download a clean copy of your currently installed version of Zen Cart or locate a file backup made before Edit Orders was installed. Unzip the contents to a temporary directory on your computer.
      For the rest of these instructions we will refer to this location as "/clean".
   3. For each file found inside the Modified Core Files folder "/temp/1_modified_core_files" replace the file with the corresponding file from "/clean".
      The directory structure of both locations should be the same. You only need to copy individual files from "/clean" to "/temp/1_modified_core_files".
      Make sure you replace every file including those in folders underneath Modified Core Files folder.
   4. If you have installed any other plugins or modifications to your Zen Cart installation which make changes to any of the Modified Core Files you will need to use a tool like Winmerge or Beyond Compare to incorporate those changes into these files.
   5. Rename the "admin" folder to match the name of your store's admin folder.
   6. Upload all of the folders and files inside the Modified Core Files folder to the location of your Zen Cart installation. The directory structure should match your store's directory structure.
      Do not upload the "1_modified_core_files" folder to your store, just the files and folders inside the Modified Core Files directory.

1. Login to your Zen Cart Administrative interface.
2. Navigate to "customers"->"orders"
   
   
3. Select the order you want to edit from the list
4. Click the "edit" button (on the right) to edit the order
   
   

1. Open an Order for editing (see how to).
2. Update (edit) the customer, billing, or shipping address as needed.
   You must enter a valid country name (and state) found in the Zen Cart database. Failure to do so may result in incorrect calculation of taxes and order totals, warnings in the Zen Cart debug logs, or potentially more serious errors resulting in the display of a "blank page" or the inability to correctly load / edit the order from the Zen Cart admin.
3. Update (edit) the phone number associated with the order as needed.
4. Update (edit) the payment method as needed.
   If you edit the CC number associated with an order this module will sanitize the CC number in the database removing portions of the CC number.
5. To save the changes click the "update" button.
   
   

1. Open an Order for editing (see how to).
2. Click the "Add Products" button near the center of the page.
3. Step #1: Narrow down the list of products (pick one option):
   • Select a category from the list.
   • Enter a search term and press the "enter" key on your keyboard.
4. Step #2: Choose a product from the list.
5. Step #3: Choose any product options / attributes as needed.
6. Step #4: Select quantity and pricing options.
   1. Select the desired quantity. This field will be subject to the product's min / max configured settings. Inventory numbers will be adjusted for the selected product in the database.
   2. Select whether to use any configured store specials or sales price for the product or to only use the full product price.
   3. Click the "Add now" button.

1. Open an Order for editing (see how to).
2. Update (edit) the product quantity, name, model, price, one time charges, and product options / attributes.
3. To save the changes click the "update" button.

Many of the common Order Total modules such as subtotal, tax, total, and low order fee are automatically calculated for the order based upon store settings and information present in the order. Changing the values for automatically calculated order totals is not allowed. This helps prevent math errors and ensures the values are obtained the same way as during customer checkout.

1. Open an Order for editing (see how to).
2. Select the order total module to add to the order.
   If you select shipping you will need to also select the specific shipping module.
3. Enter the desired order total name (text) to be shown to the customer.
   Note some order total modules will automatically change the name.
4. Add the desired order total cost.
   Gift Certificates and Vouchers can be entered as either a negative or positive value. They will be shown as a negative number after saved.
5. To save the changes click the "update" button.

1. Open an Order for editing (see how to).
2. Clear the order total name shown to the customer.
3. Clear the order total cost for the order total.
4. To save the changes click the "update" button.

1. Open an Order for editing (see how to).
2. If the order total corresponds to shipping you may change the shipping module by selecting the desired module from the dropdown list.
3. Update the order total name (text) shown to the customer.
   Note some order total modules will automatically change the name.
4. Update the order total cost to the desired amount.
5. To save the changes click the "update" button.

NOTE: The price will be shown with or without tax based upon the storefront settings not the admin settings. This is done on purpose to ensure pricing is calculated correctly in all order total modules Most of the order total modules are designed to run from the storefront / catalog side only). See the Zen Cart configuration option "DISPLAY_PRICE_WITH_TAX"

Update order comments and statuses as you do within the orders (or Super Orders) page then click the "Update" button.

(You MUST have Super Orders installed to use the Super Orders integration features)

You will need to follow the following steps to use Edit Orders with Super Orders v4.x.

• If you are running Super Orders v4.x, no patches or additional files are needed. DO NOT UPLOAD the orders.php file from the Edit Orders 1_modified_core_files folder.
• To add buttons that take you back to the edit_orders.php page from the Super Orders orders.php page, go to
  Admin > Configuration > Super Orders
  . Set the Edit Orders Module Switch to "True" to activate the Edit Orders navigation buttons in Super Orders.

If you overwrite "orders.php" after installing "Edit Orders" you may need to run the "Edit Orders" installation step 3 in order for links to "Edit Orders" from "Super Orders" to function.

(You MUST have Ty Package Tracker installed to use the Ty Package Tracker integration features )

You will need to follow the following steps to use Edit Orders with Ty Package Tracker v3.1.3.

• If you are running Ty Package Tracker v3.1.3 , you will need to use a tool like Winmerge or Beyond Compare to merge the orders.php files from both Edit Orders and Ty Package Tracker.
  (if you are in using all three add-ons -- Super Orders, Edit Orders and Ty Package Tracker -- skip this step and DO NOT UPLOAD the orders.php file from the Edit Orders 2_Modified_Core_Files folder.)
• If you'd like to add the shipper tracking number fields to the edit_orders.php page, go to
  Admin > Configuration > Ty Package Tracker
  . Set the Ty Package Tracker Module Switch to "True" to activate the Ty Package Tracker shipper tracking number fields in Edit Orders.

If you overwrite "orders.php" after installing "Edit Orders" you may need to run the "Edit Orders" installation step 3 in order for links to "Edit Orders" from "Ty Package Tracker" to function.

(You MUST have Local Sales Tax 2.3.5 or newer installed)

You will need to follow the following steps to use Edit Orders with Local Sales Tax 2.3.5 or newer.

• Copy "/includes/functions/extra_functions/functions_local_sales_taxes.php" to "/your_admin_folder/includes/functions/extra_functions/functions_local_sales_taxes.php".
  ("your_admin_folder" is the location of your Zen Cart admin folder.)

The tax rate shown next to individual products only replects the Zen Cart configured tax rate. It does not include any tax rates defined by "Local Sales Tax". This field will only modify the Zen Cart tax rate.

(You MUST have Admin New Order 1.3 or newer installed)

If you overwrite "new_orders.php" after installing "Edit Orders" you may need to run the "Edit Orders" installation step 3 in order for links to "Edit Orders" from "Admin New Order" to function.

(You MUST have Admin New Customer 1.2 or newer installed)

If you have installed a version of "Admin New Customer" <= 1.2, you will need to delete "/admin/includes/extra_functions/new_customer.php". This is not neccessary for versions of "Admin New Customer" >= 1.3.

• Updated tax calculations to Zen Cart 1.5.1 based code.
• Fixed a tax calculation bug when all products were removed from an order.
• Fixed the code handling product attribute updates to be more accurate.
• Fixed a bug which caused the subtotal to always be zero.
• Fixed a bug with the automatic calculation of onetime charges based on attributes (when adding a product).
• When the order is loaded address information more closely matches the information found during checkout.
  • If we can determine the country by id, name, or iso code:
    • The "country" field will contain the Zen Cart country array.
    • The "zone_id" field will be populated based upon country and state.
  • Otherwise, the "country field will contain the country name. This allows one to see / update the country (to one found in the Zen Cart country database).
• The country listed for addresses will now be displayed as a dropdown if the country exists in the Zen Cart database. Otherwise it will be displayed as text.
• Copied the catalog tax function "zen_get_tax_rate_from_desc()" from Zen Cart 1.5.1 to support additional order total modules.
• Copied the catalog function "zen_get_country_list" from Zen Cart 1.5.1 to support country dropdowns in the addresses.
• Zen Cart functions copied from the "catalog" side are only included if not already present.
• Disabled manual editing of the "Low Order Fee" order total module. This is handled automatically.
• If no remaining order total modules are available to add to an order, the order total entry fields will not be shown.
• Ty Tracker will add a tracking number to the sent email when:
  1. The order is updated and notify customer is selected.
  2. Ty Tracker is installed and enabled.
  3. A Tracking Code is present for the "shipper".
  4. The "shipper" is enabled in Ty Tracker.
• Included the "plugin" class and associated files.
  • The class and files are not part of "Edit Orders".
  • Provides for simplification of the installation / upgrade process.
  • Provides for simplification of the removal process.
  • Does some extra checks against Zen Cart's configure.php files.
• Created new install, upgrade, and removal processes.
  • Makes use of the "plugin" class and associated files
  • On upgrade attempts to make needed modifications to any existing orders.php from "Super Orders" or "Admin New Order"
• Cleaned up comments in "orders.php" to be more friendly.
• Links in "orders.php" to edit will no longer appear if Edit Orders is not installed.
• Moved 'BOX_CONFIGURATION_EDIT_ORDERS' into a language file (used to display the configuration menu item).
• Updated readme (collaboration of Zen Cart forum members).

• Reduced duplicate code for Ty Package Tracker support.
• Complete rewrite of the code handling products and attributes.
  • Utilizes Zen Cart functions and classes where possible.
  • Added many new functions to provide better support products and attributes.
  • Added a class used to abstract access to product attributes.
  • Used when displaying, updating, and adding products (including attributes).
• Added updated versions of some Zen Cart core classes to allow them to work correctly from the admin side of Zen Cart.
  • admin/init_includes/init_currencies.php to load the currencies class.
  • includes/classes/order_total.php to load the correct language files.
  • includes/classes/shipping.php to load the correct language files.
• When adding a product:
  • You can now search by product id, name, description, and model.
  • Step 2 now shows both the product name and model.
  • The built-in Zen Cart functions are called in a similar manner as adding a product to your shopping cart. This ensures the order totals can be automatically updated.
  • You can disable the use of "specials / sales prices" still. This is not recommended.
  • The store settings for handling attributes (including showing / hiding) are utilized.
• When updating a product: product information is pulled from the database, then requested changes (such as name and price) are merged. This ensures the correct product information is always present in the order.
• Updated to utilize the order_totals class and modules
  • Order Total modules are loaded when adding or updating a product.
  • Ensures proper calculation of subtotal and total.
  • Tax calculation now is done automatically using the store settings (same as during a customer checkout).
  • Order Total Lines are now added by selecting the desired module from a dropdown.
  • The Order Total dropdown contains a list of installed order totals not already present in the order.
  • Added support for specifying and changing the shipping module when a shipping line is used.
  • Removed field for changing the shipping tax. This is automatically calculated by includes/modules/order_total/ot_shipping.php.
• Copied (and modified for use in the admin side of Zen Cart) a handful of the catalog tax functions to admin/functions/extra_functions/edit_orders_functions.php
• Updated the installation script to add additional failure messages and not report success if a step fails.
• Fixed the order status dropdown to correctly select order status. This avoids the status being accidentally changed if the status is not "Pending (1)".
• Moved the "edit" button in the order menu over so the "details" button is more likely to be clicked by someone quickly looking at an order. This should hopefully lower the number of "accidentally" edited orders.
• Added special handling to support the "ot_loworderfee" module.
• Added some "dummy" files for those upgrading from an older version.
• Minor updates to the readme for version 4.1.

• When adding a product display the product model along with the name.

• Updated to to be compatible with Zen Cart v1.5
• Removed Super Orders links to the super_orders.php page. Super Orders v4.0 is now integrated into the default orders.php file which makes the links to the super_orders.php page and the Super Orders on/off configuration switch in the Edit Orders configuration menu obsolete.
• Updated edit_orders.php commenting to implement the same commenting code as orders.php (remove the need for the includes/functions/extra_functions/common_orders_functions.php file)
• Removed additional stray hard coded text and replaced them with proper language file definitions
• Added an admin setting to set the shipping tax (previous versions required an edit to the edit_orders.php to set this value)

• Bug fix - Corrects issue where order comments which included apostrophe's would generate an error.
• Bug fix - Corrects issue where on certain host configurations the shop owner would get language ID errors.
• Buglet (little bug.. ) fix - Fixed Shipping method filed so that it no longer shows raw HTML outputs (affected mainly FedEx shipping users)
• Added last updated field to properly support Rewards module
• Added French language support (courtesy of sanji!!!) If anyone has other language translations, send them to me and I will update the fileset.
• More formatting fixes to totals section. All entry fields now right align
• Included required PHP version data in the Purpose & Aim tab
• Minor updates and tweaks to readme for clarity

• Full integration of Ty Package Tracker files
• MINOR edit to the orders.php file. Added "Details" icon and modified the "Edit" icon to correctly redirect to the Edit Orders page
• Formatting fixes so that numeric entry fields right align (taxes, prices, additional total options, etc.)

• Refined and corrected errors in the readme file
• Added missing license.txt file
• Included a set files required for Super Orders v1.3.9 users

• Clean up and reorganize the readme file
• Removed all of the hard coded text and fixed file names and replaced them with proper language file definitions
• Replaced "Add Product" text link with an "Add Products button
• Add icons to the customer section
• Corrected table format and layout of the customer section.
• Modified customer section layout so that field labels appear next to each field for each customer address type.
• Removed unused left column call and corrected <head> section to remove unused/erroneous code.
• Order status and send email features now work like Zen Cart 1.3.9 (includes the no e-mail and hidden "admin" comments options)
• Includes the properly modified orders.php file
• The back button now returns to the order list page
• Added an order details button to return to the detail page of the order you are editing
• The back button on the add product section returns to the order editing page
• Added an order details button on the add product section to return to the detail page of the order you are editing
• Added an admin flag that toggles the display of navigation buttons required for use with Super Orders
• Added an admin flag that toggles the display of input fields required for use with Ty Package Tracker

v 2.04 11/6/2010 - Scott Turner

1. Fixed problem with add product page in v1.3.9h.

1. Fixed problems with updating text attributes when more than one text attribute is used in Zen Cart.
2. Fixed problems with adding a product with text attributes when more than one text attribute is used in Zen Cart.
3. Fixed problem with using apostrophes in a text attribute when adding a product.

v 2.02 2/18/2009 - Scott Turner

1. Fixed problem with adding products when they are in the Top Category (i.e. they aren't in a category folder).
2. Fixed problem with adding products that are not on special being added at $0 when the apply special price box is checked.

1. Fixed problem with TABLE_ORDERS not updating when adding a new product.
2. Fixed problem with wrong currencies when adding a new product.

v 2.0 10/15/2008 - Scott Turner

1. Implemented new attributes handling in the following ways:
   • -- a) In addition to the more complicated attribute editor, a simpler option is available.
     • -- i) Select a new attribute from a drop-down menu in admin.
     • -- ii) The new price will be automatically calculated by subtracting the old attribute price and adding the new attribute price.
       
   • -- b) Text attributes now are implemented through a text box.
   • -- c) Fixed attribute pricing for the following scenarios:
     • -- i) One Time Charges Implemented
     • -- ii) Price Factor & Offset Implemented
     • -- iii) One Time Price Factor & Offset Implemented
     • -- iv) Attributes Qty Price Implemented
     • -- v) One Time Attributes Qty Price Implemented
     • -- vi) Price Per Word & Free Words Implemented
     • -- vii) Price Per Letter & Free Letters Implemented
     • -- viii) Specials and Sales Implemented for Attributes When Option is Selected for Attribute
   • -- d) Product one time charges are easily editable.
   • -- e) You can switch back and forth between the old advanced attribute editor and the easier one using a text-link.
     • -- i) The advanced attribute editor allows you to change the price and attribute option and value manually.
     • -- ii) The simple attribute editor allows you to choose from the attributes listed in your database.
     • -- iii) The advanced attribute editor will not update prices it leaves you to do this.
     • -- iv) The simple attribute editor updates prices automatically.
     • -- v) The simple attribute editor is the preferred method of altering attributes! The advanced is useful for advanced purposes.
   • -- f) Downloads are now implemented correctly and will change automatically when using the simple attribute editor.
   • -- g) All attribute data from TABLE_PRODUCTS_ATTRIBUTES now moves successfully to TALBE_ORDERS_PRODUCTS_ATTRBIUTES when an attribute option is changed using the simple attribute editor.
2. Adding products has added a few new features.
   • -- a) You can choose whether or not new products use the special or sales price.
   • -- b) Text attributes now work with a text box.
   • -- c) Many new attribute options are implemented correctly when calculating the price for new products. See 1-c for more info.
   • -- d) Downloads are now implemented correctly.
   • -- e) All attribute data from TABLE_PRODUCTS_ATTRIBUTES now moves successfully to TALBE_ORDERS_PRODUCTS_ATTRBIUTES when a new product is added with an attribute.
3. Coupon and group discounts now calculate correctly with taxes. To do so, the mod uses your average tax rate for all the products that were purchased.
4. Fixed problem with quantity discounts adding to total instead of subtracting.
5. Changed behavior so that clicking "details" on the order screen will give you the original edit orders page that Zen Cart has built in.
   • -- a) This allows you to choose which page you want to use. Click "details" for just the basics. Click "edit" to make some changes to an order.
6. Fixed problems with data in TABLE_ORDERS_PRODUCTS not updating includng products_price, products_tax, and final_price.
7. You can now enter a value for shipping taxes and this will calculate correctly. Zen Cart doesn't store this info in the database, so this must be changed every time when editing orders. A compromise, but better than nothing.
8. Added lines for edits to orders.php per popular demand on Zen Cart forums.

v 1.53 8/1/08 - Scott Turner

1. Fixed problem with customer's billing information not updating.
2. Fixed problem with adding product attributes with apostrophes causing an error.
3. Fixed problem with quotes and apostrophes being ignored.

v 1.52 7/31/08 - Scott Turner

1. Fixed problems with coupons and gift certificates adding to total instead of subtracting.

v 1.51 6/22/08 - Scott Turner

1. Fixed problems with emails when HTML emails are enabled.

v 1.5 5/24/08 - Scott Turner

NOTE: 1.5 - Works With Zen Cart 1.3.8

1. Fixed Issues with Adding a Product With Attributes
2. Adding Products with Attributes Will Automatically Recalculate Price
3. Fixed Issue with Deleting a Product (Thanks zc_tester)
4. Fixed Issue with Editing a Product Attribute (Thanks zc_tester)
5. Added Ability to Edit Product Attributes Price Increases/Decreases
   ---- NOTE: This will not change the unit price - this must be edited manually.
6. Corrected PHP tags
7. Fixed Problems with Status/Comments Updates & Emails

v 1.2.6 11/12/2007 - numinix

1. Re-added functions (required)
2. Re-added missing installation instructions
3. Re-wrote readme.txt

v 1.2.5 10/15/2007 - san

1. Bug fix
2. Removed functions
3. Code optimization

v 1.2.0 10/01/2007 - Chris Barnhill

1. Added additional payment options
2. Updated how credit card numbers are displayed

v 1.1.0 02/16/2007 - Igor Couto

1. Bug fix
2. Updated readme.txt

v 1.0.0 01/07/2007 - Kathleen

1. Ported from OSC for Zen Cart v1.2