Hummingbird 2 s’impose progressivement comme le nouveau standard visuel et technique de PrestaShop. Avec son arrivée en tant que thème par défaut à partir de PrestaShop 9.1, de nombreuses boutiques commencent à se poser la question cruciale : comment migrer vers ce nouveau thème sans casser les modules existants, ni dégrader l’expérience utilisateur en production ?
Ce changement est loin d’être purement cosmétique. Hummingbird 2.0.0 Beta représente une refonte majeure avec plus de 320 commits, plus de 500 fichiers modifiés, plus de 50 000 lignes ajoutées et 30 000 supprimées. Retrait progressif de jQuery, passage à Bootstrap 5.3.3, nouveaux hooks, nouvelle stratégie CSS avec @layer : autant d’éléments qui peuvent impacter directement vos thèmes enfants et vos modules. Dans cet article, nous allons détailler une stratégie concrète pour migrer votre boutique vers Hummingbird 2 sans casser vos modules.
Sommaire
Comprendre ce que change Hummingbird 2 dans PrestaShop 9.1
À partir de PrestaShop 9.1, Hummingbird 2 devient le nouveau thème par défaut pour les nouvelles installations. Le thème Classic reste disponible, mais clairement en retrait : il n’est plus le socle de référence pour les développements futurs. Pour les boutiques existantes, bonne nouvelle : lors d’une mise à jour 9.0.x → 9.1, votre thème actuel est conservé, ce qui vous laisse le temps de planifier une migration contrôlée.
Hummingbird 2 est pensé comme un thème « developer-first ». Il se veut léger, rapide et modulaire, avec un accent fort sur les performances (scores Lighthouse élevés) et une architecture claire pour les personnalisations. Cela signifie que la structure HTML, le CSS et une partie du JavaScript ont été repensés pour être plus robustes et moins dépendants de hacks front historiques issus de Classic.
La documentation officielle indique que les produits, catégories, pages CMS et principaux modules sont automatiquement adaptés à Hummingbird. Cependant, cette continuité n’est pas automatique pour tous les modules tiers ou personnalisés : une vérification manuelle est recommandée après le passage à Hummingbird 2. Comprendre ces changements structurels est la première étape pour éviter les modules « cassés » ou invisibles après la migration.
Planifier la migration : environnement de test et démarche en étapes
Migrer vers Hummingbird 2 sans casser ses modules commence par une règle simple : ne jamais le faire directement en production. La documentation de migration vers PrestaShop 9.x recommande une démarche en étapes : audit, préparation d’un environnement de test, vérification des données, puis seulement ensuite travail sur le thème et les modules.
Concrètement, mettez en place un clone de votre boutique (pré‑production ou environnement local Docker) avec la même base de données, les mêmes modules et la même configuration. Installez PrestaShop 9.1 sur cet environnement, conservez votre thème actuel dans un premier temps, puis activez progressivement Hummingbird 2 pour tester l’impact sur vos modules. Cela vous permettra de détecter les problèmes d’intégration, de hooks ou de JavaScript sans aucun risque pour vos clients.
Dans ce plan, la migration du thème arrive après l’audit fonctionnel de vos modules : quels modules sont critiques, lesquels touchent au front, lesquels injectent du JavaScript ou du CSS spécifique ? Classez-les par priorité. Hummingbird 2 étant appelé à devenir le standard de test du Marketplace, anticiper cette migration aujourd’hui vous évitera des surprises lors de futures mises à jour.
Cloner Hummingbird pour créer un thème enfant plutôt que porter Classic
Une erreur fréquente consiste à vouloir « adapter » un ancien thème basé sur Classic directement sur PrestaShop 9.1. Or, Hummingbird introduit une nouvelle grille, de nouveaux hooks, et une approche JS sans jQuery. Les efforts pour tordre un thème Classic afin qu’il s’adapte à ce nouvel écosystème risquent d’être plus coûteux que de repartir d’un socle propre.
La stratégie recommandée par les guides techniques récents est de cloner le dépôt GitHub de Hummingbird et de l’utiliser comme base pour un thème enfant ou un thème sur‑mesure. Le dépôt fournit la structure complète du thème (assets, templates, configuration), ainsi que des instructions pour travailler en local (Node 20, npm 8, Docker de démo, etc.). Vous partez ainsi d’un thème à jour, compatible avec les nouveautés de PrestaShop 9.x.
À partir de ce clone, créez un thème enfant dans lequel vous centraliserez vos overrides de templates, votre CSS spécifique et vos JS personnalisés. Cette approche limite fortement le risque de casser les modules lors des futures mises à jour de Hummingbird, puisque vous conservez intacte la logique interne du thème parent, y compris les nouveaux hooks et la structure Bootstrap 5.
JS et modules : sortir de jQuery sans casser les comportements
Un des changements les plus sensibles pour les modules concerne le JavaScript. Hummingbird 2 ne charge plus jQuery dans le thème lui‑même. La librairie reste encore accessible pour les modules, mais l’équipe PrestaShop annonce clairement son intention de la retirer à terme. S’appuyer sur jQuery pour vos modules, c’est donc s’exposer à des cassures futures.
La ligne directrice est la suivante : migrer vos scripts vers du JavaScript moderne (ES6+), utiliser fetch pour les requêtes AJAX, les méthodes DOM natives (querySelector, classList, closest, etc.) et limiter les dépendances à des sélecteurs fragiles. Un article communautaire francophone, dédié à la migration des modules PrestaShop vers Hummingbird 2 sans jQuery, détaille précisément cette transition et montre comment nettoyer les anciens hooks JS hérités de Classic.
Sur le plan pratique, cela se traduit par une réécriture progressive de vos fichiers JS de modules : remplacement des $(document).ready par des écouteurs DOMContentLoaded, migration des $.ajax vers fetch, suppression des manipulations DOM basées sur des classes js- dépendantes du thème Classic. En testant ces nouveaux scripts sur votre environnement de pré‑production en Hummingbird 2, vous garantissez que vos modules resteront fonctionnels même lorsque jQuery disparaîtra totalement du cœur du thème.
Abandon des classes pour les hooks JS : adopter les data‑attributes
Avec Hummingbird 2, PrestaShop pousse une nouvelle convention pour cibler les comportements JavaScript : ne plus compter sur les classes CSS comme points d’accroche, mais sur des attributs de données dédiés. Cette approche découple la couche de style (classes CSS) de la couche de comportement (sélecteurs JS), ce qui réduit le risque de casser les modules lors d’un changement de thème ou de design.
Concrètement, au lieu de cibler des sélecteurs comme .js-product-miniature ou .btn-add-to-cart, il est recommandé de viser des attributs comme [data-ps-toggle], [data-link-action] ou des attributs data- personnalisés propres à votre module. Cette pratique est largement mise en avant dans la documentation Hummingbird et dans les exemples du thème.
Pour migrer vos modules, commencez par identifier tous les scripts qui utilisent des classes « techniques » liées au thème Classic. Remplacez ces points d’accroche par des data-* ajoutés dans vos templates .tpl. Vos sélecteurs deviennent alors plus robustes face aux refontes graphiques. Lors du passage à Hummingbird 2, le markup pouvant changer, vos modules continueront à fonctionner tant que ces attributs de données restent présents.
Migration CSS/HTML : gérer proprement le passage à Bootstrap 5.3.3
Sur le plan de l’intégration, le saut de Bootstrap 4.0.0‑alpha.5 (utilisé par Classic) à Bootstrap 5.3.3 dans Hummingbird 2 est probablement la source la plus visible de cassures potentielles. Grille mise à jour, classes renommées, comportements par défaut modifiés : vos modules qui reposaient sur le markup de Classic doivent être revus pour rester alignés.
Parmi les changements à anticiper, on retrouve de nouveaux breakpoints (avec une logique repensée, notamment un seuil < 360 px sans infix, puis xs, sm, md, etc.), le renommage de .no-gutters en .g-0, ou encore le fait que les colonnes ne sont plus position: relative par défaut. Dans certains cas, vous devrez ajouter explicitement des classes comme .position-relative pour reproduire les anciens comportements.
Pour migrer sans casser vos modules, passez en revue tous vos templates .tpl front‑office qui manipulent la grille Bootstrap (listes produits, blocs de contenu, formulaires, sliders). Adaptez les classes aux conventions de Bootstrap 5, mettez à jour votre CSS personnalisé pour éviter les conflits, et profitez‑en pour nettoyer les anciens styles liés au thème Classic. Testez systématiquement sur plusieurs résolutions pour vérifier que vos blocs ne se décalent pas dans Hummingbird.
Hooks et points d’injection : éviter les modules « muets »
Le changement de thème ne touche pas uniquement le visuel, il impacte aussi la manière dont les modules s’injectent dans les pages via les hooks. Hummingbird 2 introduit quelques modifications importantes qu’il faut anticiper pour ne pas se retrouver avec des modules invisibles ou dupliqués à certains endroits.
Par exemple, le hook displaySearch a été retiré. Il servait surtout pour le module ps_searchbar sur la page 404 et pouvait provoquer des doublons. Par ailleurs, la variable $HOOK_DISPLAYORDERDETAIL est remplacée par un hook displayOrderDetail plus standardisé, et un nouveau hook displayModalContent permet d’injecter du contenu dans le conteneur central de modale du thème.
Si vos modules dépendaient du mapping de hooks spécifique au thème Classic (positions exactes, templates dédiés), il est indispensable de les revoir pour utiliser les nouveaux emplacements. Vérifiez module par module : quelles positions front‑office sont utilisées ? Quels hooks sont réellement présents dans Hummingbird 2 ? Ajustez ensuite vos enregistrements de hooks et vos templates pour que les modules continuent à s’afficher de manière cohérente sur le nouveau thème.
Performance, accessibilité et SEO : adapter les modules aux exigences modernes
Hummingbird 2 est pensé pour répondre aux standards modernes en matière de performance, d’accessibilité et de SEO. Le thème est présenté comme conforme à plus de 95 % des critères de l’European Accessibility Act, avec une structure sémantique renforcée, de meilleurs contrastes, une navigation clavier travaillée, et une attention particulière portée aux lecteurs d’écran.
Pour vos modules, cela signifie qu’il ne suffit plus d’« afficher quelque chose » : il faut l’afficher de manière accessible et SEO‑friendly. Titres hiérarchisés, textes alternatifs, focus visibles, aria‑labels ou rôles lorsque nécessaire : autant d’éléments que vous devez intégrer dans vos templates pour rester aligné avec la philosophie d’Hummingbird. Profitez de la migration pour auditer vos modules sous l’angle de l’accessibilité.
Le thème intègre également des optimisations SEO (données structurées, structure HTML adaptée) et même un mode sombre natif. Vos modules front doivent donc respecter ces contraintes : vérifier les contrastes en dark mode, éviter d’imposer des couleurs en dur qui deviennent illisibles, et s’intégrer harmonieusement dans la structure existante. En procédant ainsi, vous rejetez moins d’efforts sur le thème et rendez vos modules plus réutilisables d’un site à l’autre.
Suivre l’écosystème : s’inspirer des éditeurs déjà compatibles Hummingbird 2
Un signal fort de la maturité de Hummingbird 2 vient des éditeurs tiers. Des outils comme Creative Elements (page builder) annoncent déjà un support complet de PrestaShop 9 et d’Hummingbird, ce qui montre que l’écosystème commence à s’aligner sur la nouvelle architecture de thème. Pour les développeurs de modules, ces intégrations sont une source précieuse de bonnes pratiques.
Pour assurer leur compatibilité, ces constructeurs de pages ont dû adapter leurs widgets, shortcodes et templates à Bootstrap 5, revoir leurs hooks, et parfois refondre leur logique JS pour s’affranchir de jQuery et des anciennes classes du thème Classic. Observer comment ils gèrent les data‑attributes, les nouvelles grilles, ou encore l’injection de contenu dans les modales peut vous inspirer pour refactoriser vos propres modules.
Étant donné que Hummingbird 2 est annoncé comme le nouveau standard de test pour les modules sur le Marketplace PrestaShop, se caler dès maintenant sur les conventions adoptées par les principaux éditeurs tiers vous garantit une meilleure longévité de vos développements. En pratique, cela signifie : tester systématiquement vos modules sur Hummingbird 2, suivre les évolutions de sa documentation, et intégrer progressivement ses bonnes pratiques dans votre base de code.
Migrer vers Hummingbird 2 sans casser ses modules est un chantier important, mais parfaitement gérable à condition d’adopter une démarche structurée. En partant d’un environnement de test, en clonant Hummingbird comme base de thème enfant, puis en traitant méthodiquement les sujets JS, CSS/HTML, hooks et accessibilité, vous transformez une migration risquée en opportunité d’assainir et de moderniser votre écosystème de modules.
Plutôt que d’attendre que Hummingbird devienne incontournable, profiter de la phase actuelle (bêta, puis intégration dans PrestaShop 9 et 9.1) pour tester, donner du feedback et corriger vos modules vous place en avance de phase. En faisant de Hummingbird 2 votre nouveau standard de test, vous sécurisez vos futures mises à jour, évitez les régressions en production, et offrez à vos clients une boutique plus rapide, plus accessible et plus durable techniquement.
