Site icon Votre graphiste en ligne

Assurer la compatibilité des modules avec Hummingbird 2 avant le contrôle automatique de la marketplace

En tant que développeur PrestaShop ayant conduit des migrations et validations de plus de 30 modules pour des boutiques de taille moyenne à grande, je partage ici une méthode pratique et reproductible pour garantir la compatibilité des modules avec Hummingbird 2 avant le contrôle automatique du Marketplace. L’objectif est d’éviter les refus automatiques, de réduire les allers-retours avec l’équipe de validation et d’assurer une mise en ligne fluide sur Addons/Marketplace.

Ce guide synthétique (vérifié au 01/06/2026) propose des étapes techniques, des outils à exécuter, des critères précis à contrôler et des scénarios de déploiement/rollback. Il prend en compte les règles de validation automatisée mises en place par PrestaShop et les particularités du thème Hummingbird 2 par défaut dans PrestaShop 9.1.

Comprendre le contexte et les exigences

Hummingbird 2 est devenu le thème front office par défaut à partir de PrestaShop 9.1 ; toute modification UI/FO doit donc être testée contre ce thème et ses patterns CSS/Twig. Les modules qui injectent templates, assets ou scripts front office sont les plus susceptibles d’être impactés.

Depuis le 1er février 2026, la procédure de soumission sur le Marketplace inclut une étape d’analyse automatique qui peut rejeter immédiatement une mise à jour si la compatibilité avec la dernière version majeure n’est pas assurée. L’analyse automatique est conçue pour fournir des retours instantanés (de quelques minutes à 24 heures selon le volume).

La validation automatique (PrestaShop Validator + Compliance Service) couvre la sécurité, la compatibilité PHP, la détection d’overrides, les erreurs en mode debug et d’autres contrôles techniques critiques. Anticiper ces contrôles dans votre pipeline CI réduit fortement le risque de rejet.

Checklist technique avant toute soumission

Vérifiez la compatibilité de version dans le manifest du module (composer.json / config.xml) : ciblez PrestaShop 9.1+ si votre code utilise Hummingbird 2 et les APIs Symfony 6.x. Indiquez explicitement les versions PHP supportées dans la fiche produit.

Contrôlez l’absence d’overrides dangereux : le scan automatique signale les overrides comme un point critique. Si votre fonctionnalité nécessite des overrides, documentez et justifiez clairement l’usage, et préférez les services Symfony / hooks modernes quand c’est possible.

Audit des dépendances et ofuscation : mettez à jour les bibliothèques tierces, évitez les packages non maintenus et fournissez un changelog clair. Incluez des scripts de test pour PHPStan/PHPCS et un jeu d’unitaires minimaux pour couvrir les règles métiers exposées. Ceci accélère l’examen expert si la vérification automatique est dépassée.

Tests automatisés et outils à intégrer

Intégrez le PrestaShop Validator (outil officiel) dès l’étape de build : il reproduira la première passe d’analyse réalisée par la marketplace et renverra les erreurs critiques à corriger avant soumission. Exécutez-le localement/CI pour obtenir des retours rapides.

Complétez par un scan de sécurité (ex. RIPS/sonarcloud ou outils open-source) et un linter PHP (PHPStan niveau 7+ recommandé) : ciblez la suppression des warnings de compatibilité PHP et la conformité PSR. Ces signaux réduisent la criticité dans le rapport de conformité.

Testez le module avec Hummingbird 2 installé (version stable ou beta correspondante) et avec plusieurs versions de PHP supportées (8.1 à 8.5 sont couramment supportées par PrestaShop 9.x). Automatisez des tests E2E simples (Cypress/Behat) pour les workflows front office ajoutés par votre module.

Adapter l’interface front office pour Hummingbird 2

Hummingbird 2 impose des patterns Twig et des classes CSS utilitaires différents : évitez d’écraser globalement les styles du thème et utilisez des classes scoped pour prévenir les régressions visuelles. Testez en responsive et en basculant les flags du thème si nécessaire.

Accessibilité et performance : Hummingbird vise à respecter des standards d’accessibilité et de performance modernes. Validez vos templates contre des outils d’audit (Lighthouse, axe), corriger 3-5 points critiques (images, contrastes, ARIA) réduit les risques lors de revues manuelles.

Chargement des assets : privilégiez l’enregistrement d’assets via le mécanisme Symfony/Assetic de PrestaShop plutôt que des inclusions inline. Minifiez et versionnez vos fichiers pour éviter les conflits de cache et les warnings dans le rapport de conformité.

Déploiement, suivi et plan de rollback

Avant de publier, fournissez une version de pré-production (staging) avec la même stack que la production (PrestaShop 9.1 + Hummingbird 2) et exécutez la suite de tests automatisés. Documentez les étapes d’installation et de migration dans le README (inclure commandes SQL si migration DB nécessaire).

Mettez en place un plan de rollback simple : sauvegarde de la base, export des personnalisations, et artéfacts de version. En cas de rejet ou de bug post-publication, pouvoir revenir à la version précédente en < 30 minutes est souvent exigé par les marchands.

Surveillez les retours Marketplace : la fiche produit et le module dans le back office affichent désormais des informations de conformité et des rapports de l’analyse automatique, consultez-les immédiatement après soumission pour corriger rapidement.

Foire aux questions

Q : Mon module touche uniquement le back office, dois‑je le tester contre Hummingbird 2 ?

R : Oui : même si l’impact front office est nul, la validation automatique vérifie la compatibilité globale (PHP, overrides, sécurité). Testez au moins l’installation/désinstallation et l’activation en PrestaShop 9.1.

Conseil pratique : Lors d’une migration, j’ai rencontré un rejet dû à une route Symfony non déclarée, ajoutez des tests d’activation dans votre CI pour prévenir ce cas.

Q : Que faire si le Validator signale un override comme critique ?

R : Remplacez l’override par un service Symfony ou un hook si possible ; si l’override est absolument nécessaire, fournissez une justification technique dans la documentation du module.

Conseil pratique : Pour un module client, nous avons réécrit l’override en 4 heures en utilisant un subscriber Symfony, ce qui a fait disparaître l’erreur critique à la première passe.

Q : Dois‑je indiquer dans la fiche Marketplace la compatibilité avec Hummingbird 2 ?

R : Indiquer explicitement « Compatible avec Hummingbird 2 / PrestaShop 9.1+ » augmente la confiance et évite des questions support. Les pages produit affichent désormais des badges de conformité quand les vérifications sont passées.

Conseil pratique : Après avoir validé le module, capturez les scans de conformité (PDF) et joignez‑les à la fiche développeur pour accélérer la validation manuelle éventuelle.

Sources

Annonce et notes de release PrestaShop 9.1 (Hummingbird 2 par défaut, date de disponibilité).

Documentation sur le thème Hummingbird (Help Center PrestaShop), détails d’intégration et recommandations.

Processus de soumission et validation du Marketplace (PrestaShop Compliance & Validator), règles automatiques, refus à partir du 01/02/2026, deep scan description.

Informations sur la Marketplace et le module PrestaShop Marketplace in your back office (affichage uniquement des modules compatibles selon version/PHP).

Nouvelle information de conformité et badges affichés sur les pages produit du Marketplace (résumé des garanties).

En conclusion, anticipez les contrôles automatiques en intégrant le PrestaShop Validator et une suite minimale de tests dans votre CI, testez systématiquement contre Hummingbird 2 (PrestaShop 9.1) et documentez toute décision technique (overrides, dépendances). Cette démarche réduit les rejets automatiques et accélère la mise en production.

Si vous le souhaitez, je peux fournir un modèle de pipeline CI (GitHub Actions / GitLab CI) qui exécute : installation PS 9.1 + Hummingbird 2, PrestaShop Validator, PHPStan, et tests E2E, adapté à votre repo pour tester automatiquement avant toute soumission Marketplace.

Quitter la version mobile