PrestaShop 9 apporte son lot de changements techniques, et la question qui revient le plus souvent chez les commerçants n'est pas « quand migrer » mais « est-ce que mes modules vont survivre ». Un module non compatible peut bloquer une fonctionnalité clé, générer des erreurs en front ou pire, casser le processus de commande. Avant tout projet de migration, un audit de compatibilité des modules s'impose. Voici comment le mener correctement.
Pourquoi la compatibilité des modules est le vrai sujet d'une migration
Une migration de version majeure, comme le passage à PrestaShop 9, ne se résume pas à un changement de noyau. Le cœur du logiciel évolue (PHP, Symfony, structure des hooks), mais ce sont surtout les modules tiers qui déterminent si la boutique continuera de fonctionner correctement. Un thème personnalisé qui appelle des hooks obsolètes, un module de paiement qui n'a pas été mis à jour depuis trois ans, ou un connecteur de marketplace qui dépend d'une API dépréciée : chacun de ces éléments peut transformer une migration simple en chantier de plusieurs semaines.
Selon la documentation officielle PrestaShop, chaque montée de version majeure modifie certains hooks, dépréciée certaines fonctions et change parfois la structure de la base de données (source : documentation développeur PrestaShop, developers.prestashop-project.org). Un module conçu pour PrestaShop 1.7 ou 8 n'est donc pas automatiquement compatible avec la version 9, même s'il semble fonctionner au premier chargement.
Les symptômes d'une incompatibilité de module
- Erreurs 500 ou pages blanches après activation d'un module
- Fonctionnalités de panier ou de paiement qui disparaissent du front-office
- Hooks qui ne s'affichent plus dans le thème (bandeaux, blocs promo, avis clients)
- Erreurs dans les logs PrestaShop (onglet Paramètres avancés > Logs)
- Messages d'avertissement dans le back-office à l'activation du module
Un module qui ne génère aucune erreur visible n'est pas nécessairement compatible. Certains dysfonctionnements n'apparaissent qu'en conditions réelles de commande, lors d'un pic de trafic, ou avec certains moyens de paiement spécifiques.
Comment vérifier la compatibilité de ses modules avant de migrer
Dresser l'inventaire complet des modules installés
La première étape consiste à lister tous les modules actifs, mais aussi ceux désactivés qui pourraient être réactivés par erreur. Dans le back-office, le menu Modules > Gestionnaire de modules affiche l'ensemble des extensions installées, avec leur éditeur et leur version. Il est utile de noter :
- le nom exact du module et son numéro de version
- l'éditeur ou le développeur (PrestaShop natif, module tiers payant, développement spécifique)
- la date de dernière mise à jour du module
- la fonction critique ou non du module pour l'activité (paiement, livraison, fiscalité, marketing)
Consulter la marketplace officielle PrestaShop Addons
Pour les modules achetés sur la marketplace PrestaShop Addons, la fiche produit indique généralement les versions de PrestaShop supportées. C'est une première source fiable, mais elle ne garantit pas une compatibilité parfaite sur une boutique personnalisée : le comportement peut varier selon les autres modules installés et les surcharges de code présentes.
Identifier les modules développés sur mesure
Les modules spécifiques, développés pour des besoins propres à l'activité (connecteur ERP, règle de tarification B2B, intégration logistique spécifique), nécessitent un audit de code. Il s'agit de vérifier si le module utilise des fonctions ou des hooks dépréciés dans la nouvelle version. Cette vérification demande une compétence technique PrestaShop, car elle implique de lire le code source du module et de le comparer aux évolutions documentées par l'éditeur du logiciel.
Que faire si un module n'est pas compatible ?
Chercher une version mise à jour auprès de l'éditeur
Dans la majorité des cas, les éditeurs sérieux publient une version compatible avec la nouvelle version majeure dans les mois qui suivent sa sortie. Il convient de vérifier directement sur la fiche du module ou de contacter le support de l'éditeur pour connaître le calendrier de mise à jour.
Trouver un module équivalent
Si l'éditeur ne prévoit pas de mise à jour, il faut identifier un module alternatif proposant la même fonctionnalité. Cette recherche doit se faire en amont de la migration, pas après, pour éviter une interruption de service sur une fonctionnalité critique comme le paiement ou le calcul de la TVA.
Faire réécrire ou adapter le module spécifique
Pour les développements sur mesure, un prestataire technique peut adapter le code existant aux nouvelles exigences de PrestaShop 9. Le coût et le délai dépendent de la complexité du module et du nombre de hooks ou de fonctions à réécrire. C'est un point à chiffrer avant de valider le calendrier de migration.
Ne jamais migrer en production sans avoir testé l'ensemble des modules sur un environnement de préproduction. Un module incompatible découvert après la mise en ligne peut bloquer des commandes en cours et générer une perte de chiffre d'affaires directe.
Construire une checklist de migration fiable
Étape 1 : copie de l'environnement de test
Avant toute action, dupliquer la boutique (base de données et fichiers) sur un environnement de test isolé, identique à la production. Cette étape est non négociable pour limiter les risques.
Étape 2 : audit module par module
Chaque module est testé individuellement : activation, utilisation en conditions réelles (ajout au panier, passage de commande test, simulation de livraison), puis vérification des logs d'erreurs.
Étape 3 : test du parcours client complet
Au-delà des modules pris isolément, il faut tester le parcours complet : recherche produit, ajout au panier, choix de livraison, paiement, confirmation de commande. Certains conflits n'apparaissent qu'en combinant plusieurs modules entre eux.
Étape 4 : validation des performances
Une migration majeure peut aussi impacter les temps de chargement si certains modules ne sont pas optimisés pour la nouvelle architecture. Un contrôle des temps de réponse avant et après migration permet de détecter une régression de performance.
Qui peut réaliser cet audit de compatibilité ?
Cet audit demande une double compétence : une connaissance fine de l'architecture PrestaShop (hooks, surcharges, structure Symfony pour les versions récentes) et une capacité à lire du code PHP pour les modules spécifiques. Pour une boutique avec peu de modules standards, l'audit peut rester simple. Pour une boutique avec des dizaines de modules et des développements spécifiques, l'accompagnement d'un prestataire technique qualifié devient pertinent pour sécuriser le calendrier et le budget.
Aller plus loin
Cette étape d'audit de compatibilité s'inscrit généralement dans un projet de migration plus large, qui inclut aussi la vérification de la version PHP, la compatibilité du thème et la stratégie de bascule en production.