Recommended PrestShop Version

Thanks for choosing Agile.
For customers using our Agile Multiple Seller module and its accessry modules, we highly recommend to use PrestaShop 1.6x or 1.7.5 or lower. PrestaShop has made some changes in versions higher than 1.7.6 that makes it possible or very difficult to implement some of features via hooks, or override, since required hooks or override is not available.

Sept. 05, 2019
This guide is intended to provide you with some basic information and recommendation on how to upgrade PrestaShop store with Agile Modules installed. 

PrestaShop provide an One Click upgrade module that can help you upgrade your PrestaShop store. It is really a powerful and convenience tool. It works in most case if your store is a pure/clean PrestaShop and upgrade is a minor upgrade, meaining you have not installed any 3rd party modules or you have not done any customization changes and the upgrade is within the same major version of PrestaShop.  Otherwise you may face different kind of issues.

If you are considering upggrade your PrestaShop store from an older version to a newer version and your store has Agile modules installed, please follow steps below to avoid some of torubles.

1. Backup your store 

It is always a good practice to make a full backup of your store (both files and database). So you will be able to redo in case the upgrade does not go well. 

2. Uninstall/Delete all Agile modules
Before upgrade your PrestaShop, please uninstall and delete Agile modules from your store at back office - Modules tab

Why - because during PrestaShop upgrade, it usually will disbale/uninstall all 3rd party modules, when disbale/uninstall the module during upgrade, most cases it is not able to remove
the override classes from modules you installed. This will causes issues when you finish upgrade your PrestaShop store. You will not be able to re-install the module again or not able to installa newer version of the modules.

Make sure - all override classes have been cleanly removed by uninstallation. If you do not have any other modules installed, all override class files should be a empty or emprty class.

No wrries about your business data - when you uninstall Agile modules, we will not remove any business data. When you reinstall or install a newer version, those business data will be still there. We can not guarantee this behavior for any other 3rd party modules. you may need to contact module developer for more details if you decided to uninstall 3rd party modules.

3. Upgarde your prestashop
Once you have uninstalled and deleted all agile modules, you are now ready to upgrade stroe.
You can use One Click upgrade tool, or you can use other way to upgrade PrestaShop to a newer version.
Please refer Prestaashop user's guide for details on how to upgrade prestaShop.
(Note - This step might also be not that easy, especially when you are upgarde from different major version)

See here for Prestaashop guide 
To PrestaShop 1.5x - http://doc.prestashop.com/display/PS15/Updating+PrestaShop
To PrestaShop 1.6x - http://doc.prestashop.com/display/PS16/Manual+update


4. Test new version of your store
Before installing new version of modules, please make sure the upgarded store works fine. Please test fully to make sure all functioin are working as expected. 

5. Install new version of modules.
In most cases, you will need newer version of the modules for newer version of PrestaShop, because we have to adjust our modules to the changes of PrestaShop.
please always conatct us to confirm teh compatibility of our modules and request upgrade of the modules.

See our modules upgrade policy here
See here on how to install agile modules