This guide is for you if you have installed a hybrid plugin and you want to update this plugin to V3.
Follow these instructions to successfully upgrade our Prestashop plugin (also called "module").
Warning - Read first
Before upgrading, please read the following tips carefully:
- You will have to configure the feeds that are currently in V2 on the new platform, then deactivate them in V2 once the new feeds are live. A request to close the account should then be sent to our backoffice team at this address: firstname.lastname@example.org
- If possible, test the plugin on a pre-production environment before installing/updating it in production.
Choose a quiet period in your activity to update the module (and avoid the rush of sales, for example). It is preferable that we are available to assist you in case of error, so avoid any update before a weekend or a holiday.
If you have overloads, keep them to postpone them if necessary.
- Following the release of version 1.7, Prestashop has published a new code validator. This code validation is mandatory for the release of a module on the Prestashop Addons. This tool imposes new syntax rules (PSR-2 standard) and prohibits some code practices that we used until now. So we had to rewrite our code according to the Prestashop requirements.
In this logic, the "override" folder of the module, allowing to make code overloads directly within the module, has been removed. From now on, overrides must be done as Prestashop requires: Read their technical procedure
If you have overrides, the code must be moved to the "override/modules" folder of Prestashop. A modification of variable names may also be necessary to maintain the proper functioning of the code. We recommend that this modification be done by a developer.
Update the plugin (once all is disabled in V2)
A. Make a backup of your database
Out of security, make a copy of the database of your Prestashop site.
You can either do this copy yourself, or via the Prestashop interface:
STEP 1: Go to your admin dashboard and then go to advanced settings → Database → Database backup.
STEP 2: Accept the warning before making a backup.
STEP 3: The copy of the database will be accessible via the dashboard or at the root of the site project via your admin folder → Backups.
B. Delete the cron in your crontab
With the hybrid plugin, you had to set up a cron job in your crontab server to perform this routine, which could be restrictive.
To counter this problem and to avoid importing duplicate orders in V3 plugins, we decided to stop asking you to manage this cron task and to do it on our side.
So we now have a cron on the Lengow side which launches this synchronization script every 30 minutes.
STEP: You have to delete this cron task in your crontab server.
C. Update of the Lengow plugin
STEP 1: Connect to the Prestashop back-office with an account having administrator rights.
STEP 2: Go to "Modules" > "Modules manager" tab.
STEP 3: Click on "Upload a module" on the top right, select the .zip archive and click on "Upload a module". You can also find the module via the store, by typing Lengow and directly download the latest version.
STEP 4: Reload the page and click on the Lengow tab > home on the left of the page or on Configure in the Lengow module.
STEP 5: On the login page click on "Connect my Prestashop with Lengow".
STEP 6: Enter the access and secret tokens in the requested fields. You can find them by logging into your Lengow account and clicking on your profile picture in the top right and then general information → A.P.I.
STEP 7: On the catalog matching screen, match the existing catalogues with your Prestashop stores and validate.
STEP 8: To finish click on "Back to my stores".
STEP 9: You will need to check if your product catalogue looks consistent after the migration. In addition, you will need to calibrate your default carriers in the order options in order to fill them correctly at the time of import.