Site icon Votre graphiste en ligne

Refonte PrestaShop: moderniser avec Hummingbird v2 et l’Admin API

La refonte PrestaShop prend un nouveau tournant avec l’arrivée de Hummingbird v2 et la montée en puissance de l’Admin API. Entre une interface front moderne, des composants documentés via Storybook et une API back‑office pensée pour l’extensibilité, l’écosystème vise à faciliter les migrations et les intégrations côté boutiques et intégrateurs.

La bêta Hummingbird v2.0.0 a été publiée en tant que version « developer‑first, lightweight, and modular », montrant une activité importante du projet (plus de 320 commits, environ 500 fichiers modifiés, ~50 000 insertions et ~30 000 suppressions selon l’annonce officielle). Parallèlement, PrestaShop 9 apporte l’Admin API construite sur API Platform pour moderniser le back‑office.

Pourquoi moderniser votre boutique PrestaShop ?

Moderniser une boutique PrestaShop, c’est améliorer la performance, la maintenabilité et l’expérience client. La migration vers des bases techniques récentes (Symfony 6.4 LTS, PHP 8.1/8.4) permet de bénéficier d’une sécurité et d’une performance accrues, et PrestaShop 9 intègre ces avancées.

La refonte PrestaShop ne concerne pas seulement l’apparence : elle inclut des changements d’architecture back‑end. L’introduction de l’Admin API basée sur API Platform et des patterns CQRS (Commands/Queries) vise à rendre le back‑office extensible, intégrable et plus adapté aux échanges modernes (JSON‑LD, GraphQL, JSON:API).

Enfin, la communauté est un moteur essentiel : le bilan 2025 évoque des centaines de contributeurs autour de PrestaShop 9, la refonte de l’Update Assistant (350+ PRs) et des jalons comme la beta Hummingbird v2. Participer à cette modernisation apporte du support et des ressources partagées.

Hummingbird v2 : nouveautés techniques et état du projet

Hummingbird v2 est conçu pour PrestaShop 9.0.x et versions supérieures ; il repose sur une base moderne avec Bootstrap 5, TypeScript et des conventions BEM pour les classes CSS. Le dépôt open‑source PrestaShop/hummingbird publie la release (tag v2.0.0‑beta) et la documentation du projet est accessible publiquement.

La beta v2.0.0 met l’accent sur une approche « developer‑first » et modulaire. Les prérequis de développement sont listés dans le README : Node.js v20.x, npm v8, Storybook pour documenter l’UI et des environnements Docker fournis pour un développement local reproductible.

Le workflow Dev inclut Storybook et une CI qui déploie automatiquement la documentation UI sur GitHub Pages lors des merges, ce qui facilite la découverte et les tests des composants par les développeurs et intégrateurs.

Impact sur les thèmes et modules : Bootstrap 5, jQuery et compatibilité

Hummingbird abandonne jQuery en interne : le thème n’utilise plus jQuery pour son propre code, même si la librairie reste disponible pour assurer la compatibilité des modules legacy. La recommandation officielle est cependant d’initier la migration des modules hors jQuery pour éviter les dettes techniques futures.

La migration forcée vers Bootstrap 5 entraîne des changements de classes et d’utilitaires CSS. Les modules tiers doivent s’aligner sur ces nouvelles classes pour garantir un rendu correct avec Hummingbird et éviter les ruptures visuelles ou fonctionnelles.

Plusieurs modules natifs ont déjà été refondus pour Hummingbird (ps_mainmenu, ps_facetedsearch, ps_featuredproducts, productcomments, etc.), fournissant des exemples concrets de migration et de bonnes pratiques à suivre pour mettre à jour vos propres modules.

Accessibilité et qualité de l’interface

L’accessibilité est un objectif fort de Hummingbird 2.0 : la présentation à la DevCon indique une cible de conformité supérieure à 95 % par rapport aux exigences de l’European Accessibility Act (EAA). C’est un signal important pour les boutiques qui cherchent à se conformer aux obligations légales et à améliorer l’expérience utilisateur pour tous.

Le choix de composants documentés via Storybook permet de tester les états accessibles des composants (contrastes, navigation clavier, rôles ARIA). Le déploiement automatique de la documentation UI renforce la stabilité et la réutilisabilité des composants.

En pratique, les équipes doivent intégrer des tests d’accessibilité dans leur CI et valider les nouveaux composants Hummingbird pour conserver ou dépasser ces niveaux de conformité, notamment lors de la customisation ou de l’ajout de widgets tiers.

Admin API : le back‑office extensible et moderne

PrestaShop 9 introduit une nouvelle Admin API bâtie sur API Platform qui supporte JSON‑LD, GraphQL et JSON:API, avec une approche REST/JSON moderne pour remplacer et prolonger l’ancien Webservice XML. L’objectif est de faciliter l’intégration avec CRM, ERP et outils marketing via OAuth2 et une meilleure automatisation.

L’Admin API s’appuie sur l’architecture CQRS (Commands/Queries) et réutilise les commandes et queries du cœur PrestaShop. La documentation officielle inclut un guide de contribution et des exemples pour aider les développeurs à exposer de nouvelles ressources.

L’activation de l’Admin API se fait via Back Office → Advanced Settings → New Features and Experimental Functionality. Certains endpoints sont marqués comme expérimentaux et doivent être explicitement activés avant d’être exposés en production.

ps_apiresources, contributions et gouvernance communautaire

Les endpoints de l’Admin API sont fournis et étendus via le module open‑source ps_apiresources. Ce repo public permet d’ajouter de nouvelles ressources et de voir des exemples d’implémentation concrets pour s’inspirer et contribuer.

Une initiative communautaire (Call for Contributions) lancée en 2025 vise à compléter les endpoints manquants : la revue des contributions a démarré en septembre 2025 et l’objectif est de clore l’initiative fin 2025. Pour faciliter cela, PrestaShop a mis en place un canal Slack dédié (#cfc-adminapi), un tracker de couverture API et des labels GitHub.

Les contributeurs sont encouragés à tester avec Postman/Insomnia/curl, à s’appuyer sur le module ps_apiresources pour exemples, et à suivre le guide de contribution et les patterns CQRS mis à disposition dans la documentation développeur.

Stratégie de migration et bonnes pratiques

Avant toute migration, vérifiez la compatibilité des modules : contrôlez l’usage de jQuery, l’adaptation aux classes Bootstrap 5 et la conformité aux conventions BEM si vous ciblez Hummingbird. Testez localement avec les environnements Docker fournis et Storybook pour l’UI.

Pour l’Admin API, activez les endpoints expérimentaux si nécessaire (via le Back Office) et utilisez ps_apiresources pour étendre l’API plutôt que de fork irréfléchis. Les outils recommandés pour les tests sont Postman, Insomnia ou curl, et la documentation officielle contient des exemples concrets et des guides pas à pas.

Enfin, impliquez la communauté : suivez le canal Slack #cfc-adminapi, surveillez les labels GitHub et participez aux revues. La participation collective accélère la couverture des endpoints manquants et permet d’atteindre les objectifs fixés pour fin 2025.

La refonte PrestaShop avec Hummingbird v2 et l’Admin API est une opportunité pour moderniser votre boutique, améliorer l’accessibilité et faciliter les intégrations back‑office. Les outils, guides et canaux communautaires sont en place pour soutenir cette transition.

Pour démarrer : consultez le repo PrestaShop/hummingbird (tag v2.0.0‑beta), lisez le README pour les prérequis (Node.js v20.x, npm v8), activez l’Admin API dans le Back Office, et examinez ps_apiresources pour comprendre comment étendre les endpoints selon vos besoins.

Quitter la version mobile