Upgrades

Latest Version

To download the latest version of the distribution, log into your account in the store, go to “My Account” and then “My Downloads”. The list of files you can download is displayed on this page and will always be a list of the most up-to-date versions of the files.

Upgrading to Version 3.8.3 from Versions 2.x or 3.x

The changes between 2.x and 3.x are major but upgrading to the latest version from any 2.x or 3.x version is simple thanks to a new automatic upgrade script:

1. Copy the updated files across

   Overwrite all existing files with the updated files from version 3.8.3.

   They already have the correct folder structure, so a single drag-and-drop of the folders/files in the files folder into the root directory for the store will put the files in the correct locations; there's no need to copy the files individually - that often results in files being missed out!

   Please Note: If the admin folder for the store is not named “admin” then care must be taken to place the files from within the files/admin folder into the store's admin folder, copying across the files/admin folder won't work!

2. Automatically update the database and configuration

   A very handy automatic update script, advshipper_auto_upgrade.php, is provided with this module to update the database to work with the new version of the module.

   • Or you can go to Modules > Advanced Shipper Config in the Zen Cart Admin and the module will be updated automagically!

3. [OPTIONAL but RECOMMENDED]

   The format of the surcharges was changed in version 3.8.3!

   The format of previous surcharges will be updated automatically by the upgrade if updating from a version before 3.8.3. However, the documentation about the new format should be read, otherwise any newly entered surcharges are likely to be incorrect and will not work!

4. [OPTIONAL but RECOMMENDED - ESPECIALLY THOSE UPGRADING FROM VERSION 2.x] Read the updated manual

   The following changes between versions 2.x and 3.x are covered in the updated manual.

   • The “Calculation Method” option has been dropped from the module. Calculation Methods are now specified directly in the Table of Rates for a region using XML-style element tag; tables of rates will not work without these tags!
   • The “Show Rate Calculations” option has also been dropped from the module. It is no longer necessary due to the new output template functionality.
   • Additional options are now available: “UPS” and “USPS” rates. “Handling Fees” have been replaced by much improved “Surcharge” functionality (Existing Handling fee settings are automatically upgraded).

Upgrading to Version 3.8.3 from Version 1.0.0

Version 3.8.3 isn't even remotely similar to version 1.0.0, some files have been renamed and over a dozen new files have been added. Version 1.0.0 must be completely removed before installing version 3.8.3. Version 3.8.3 is not backwards compatible. The following steps are required to upgrade:

1. Uninstall the Previous Version

   Before you add the new files you should uninstall the old version of this module.

   • Go to Modules > Shipping, click on advshipper and then Remove

2. Remove the outdated database tables

   Using software such as PHPMyAdmin, all database tables beginning with “advshipper” should be DROPped from the store's database.

3. Delete the old files

   One of the files from version 1.0.0 conflicts with a file in version 3.8.3. The old files should all be removed, but at the very least, the following file must be removed:

   • admin/includes/functions/extra_functions/advshipper_functions.php

4. Install version 3.8.3

   Version 3.8.3 can now be installed as if this were a fresh store.

   • Follow the Installation Instructions to install the new version.

Back to top