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 Magento 1 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.
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 Magento site.
You can either do this copy yourself, or via the Magento interface:
STEP 1: In the Magento administration panel, select System > Tools > Backups.
STEP 2: Select the type of backup you want: System Backup, Database and Media Backup or Database Backup. System backup creates a backup of the database and file system ; the other two options are self-explanatory.
STEP 3: Read the warning, then click OK when ready.
STEP 4: Specify a backup name. If you wish, check the box "Put store on the maintenance mode while backup creation". If you wish, check the box "Exclude media folder from backup". Click OK when you are ready.
STEP 5: You can view backups at any time by following Step 1. To delete a backup, check the corresponding box (1), select Delete from the Actions drop-down menu (2), and then click Submit (3).
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 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: In Magento 1, an option allows to manage the cron of Magento and also to retrieve orders. Unless there is a real need for you, this option should be disabled.
C. Update of the Lengow plugin
STEP 1: Uninstall your Lengow plugin:
- Go to the Magento Connect interface (System > Magento Connect > Magento Connect Manager).
- Log in with the administrator account (the one with the most rights).
- In the "Manage existing extensions" section, search for "Lengow_Export" and uninstall it.
- Then click on "Commit Changes" and wait.
Once the uninstallation is complete, return to the top of this page
STEP 2: Load the new version of the plugin:
- Click on "Choose a file" and select the zip of the new version of the Lengow module.
- Click on download and wait. Magento will reset the cache for you.
STEP 3: Check the update:
- Check that the version of the Lengow plugin has changed correctly by going to any page of the plugin and looking at the footer.
STEP 4: Connect to V3 with the new plugin:
- Connect to Lengow.
- 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 5: 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 so that they are filled in correctly at the time of import.