Ce guide est pour vous si vous avez installé un module hybride et que vous souhaitez mettre à jour ce module vers la V3.
Suivez ces instructions pour mener à bien cette mise à jour de notre module Prestashop.

Avertissement

Avant toute mise à jour, veuillez à lire attentivement les conseils suivants:

• Il faudra configurer sur notre nouvelle plateforme les flux qui sont actuellement en V2, puis les désactiver sur la V2 une fois que ces nouveaux flux seront actifs. Une demande de clôture du compte V2 devra ensuite être envoyée à notre service backoffice à cette adresse : backoffice@lengow.com 
• Testez si possible le module sur un environnement de préproduction avant de l'installer / le mettre à jour sur la production.
  Privilégiez une période calme dans votre activité pour mettre à jour le module (évitez le rush des soldes, par exemple). Il est préférable que nous soyons disponibles pour vous accompagner en cas d'erreur, évitez donc toute mise à jour avant un weekend ou un jour férié.
  Si vous possédez des surcharges, conservez-les afin de les reporter si besoin.

• Suite à la sortie de la version 1.7, Prestashop a édité un nouveau validateur de code. Cette validation de code est obligatoire pour la mise en ligne d’un module sur le Prestashop Addons. Cet outil impose de nouvelles règles de syntaxe (norme PSR-2) et interdit certaines pratiques de code que nous utilisions jusqu’à maintenant. Nous avons donc été obligé de réécrire notre code en fonction des exigences de Prestashop.
  Dans cette logique, le dossier “override” du module, permettant de faire des surcharges de code directement au sein du module, a été supprimé. Dorénavant, les surcharges doivent être réalisées comme Prestashop l’impose : Consultez leur procédure technique
  Si vous possédez des surcharges, le code doit être déplacé dans le dossier “override/modules” de Prestashop. Une modification des noms de variable peut également être nécessaire pour maintenir le bon fonctionnement du code. Nous conseillons que cette modification soit effectuée par un développeur.
  
  

Mise à jour du module (une fois que tout est désactivé en V2)

A. Faites une sauvegarde de votre base de données

Par sécurité , faites une copie de la base de donnée de votre site Prestashop.

Vous pouvez faire cette copie vous-même, ou via l’interface de Prestashop :

ÉTAPE 1 : Allez dans votre tableau de bord administrateur puis dans paramètres avancés → Base de données → Sauvegarde de base de données.

ÉTAPE 2 : Acceptez l’avertissement avant de faire une sauvegarde.

ÉTAPE 3 : La copie de la base de données sera accessible via le tableau de bord ou à la racine du projet du site via votre dossier admin → Backups.

B. Supprimez le cron dans votre crontab

Avec le module hybride, vous deviez mettre en place une tâche cron dans votre serveur crontab pour réaliser cette routine, ce qui pouvait être contraignant.

Pour contrer ce souci et éviter l’importation de commandes en doublon, dans les modules V3 nous avons décidé de ne plus vous demander de gérer cette tâche cron et de l’effectuer de notre côté.
Il y a donc maintenant un cron côté Lengow qui lance ce script de synchronisation toutes les 30 minutes.

ÉTAPE : Il faut que vous supprimiez cette tâche cron dans votre serveur crontab.

C. Mise à jour du module Lengow

ÉTAPE 1 : Connectez-vous au back-office de Prestashop avec un compte possédant des droits d'administrateur.

ÉTAPE 2 : Allez dans l'onglet "Modules" > "Modules manager"

ÉTAPE 3 : Cliquez sur "Upload a module" en haut à droite, sélectionnez l'archive .zip et cliquez sur "Upload a module". Vous pourrez aussi retrouver le module via le store, en tapant "Lengow", et télécharger directement la dernière version.

ÉTAPE 4 : Rechargez la page et cliquez sur l'onglet Lengow > accueil à gauche de la page ou sur Configure au niveau du module Lengow.

ÉTAPE 5 : Sur la page d'identification, cliquez sur "Connect my Prestashop with Lengow".

ÉTAPE 6 : Entrez les jetons d’accès et secret dans les champs demandés. Vous pourrez les trouver en vous connectant à votre compte Lengow et en cliquant sur votre image de profil en haut à droite, puis sur informations générales → A.P.I.

ÉTAPE 7 : Sur l'écran de matching des catalogues, matchez le ou les catalogues existants avec les boutiques de votre Prestashop, et validez.

ÉTAPE 8 : Pour terminer, cliquez sur "Retour à mes boutiques".

ÉTAPE 9 : Il vous faudra vérifier si votre catalogue produits vous semble cohérent après la migration. De plus, vous devrez calibrer vos transporteurs par défaut dans les options des commandes afin de correctement les remplir au moment de l'importation.