Site icon Votre graphiste en ligne

Création PrestaShop: cap sur Hummingbird v2 et l’Admin API

La récente vague d’annonces autour de PrestaShop redessine le paysage du développement de boutiques. Entre la beta publique de Hummingbird v2 publiée le 26/11/2025 et les avancées de l’Admin API, les équipes techniques et les agences doivent anticiper des changements profonds dans les workflows et les architectures front/back.

Dans cet article nous parcourons les principales nouveautés de Hummingbird v2, les implications pour les modules et thèmes, les bonnes pratiques recommandées, ainsi que l’état et l’usage concret de l’Admin API. L’objectif : proposer une feuille de route pratique pour les développeurs et intégrateurs PrestaShop.

Hummingbird v2 : panorama de la beta

Hummingbird v2.0.0 Beta a été publiée le 26/11/2025 et la release met en avant des chiffres impressionnants du milestone : «more than 320 commits, 500 file changes, 50,000 additions, and 30,000 deletions». Ces statistiques soulignent l’ampleur du refactor et la modernisation opérée sur le thème.

Le référentiel Hummingbird sur GitHub montre un projet actif (au 12/2025) avec ~107 étoiles, ~111 forks et un historique de commits important (>1k commits). La page des Releases comporte le tag v2.0.0-beta, preuve de la publication accessible pour testeurs et contributeurs.

Le README du repo indique des prérequis récents pour le développement : Node.js v20 et npm v8. Cela confirme le glissement vers un écosystème Node moderne et des toolchains actuelles pour le front-end.

Nouveautés techniques et impact front-end

Hummingbird v2 introduit des changements techniques majeurs : adoption de Bootstrap 5.3.3, migration vers SCSS et TypeScript, support natif du «Dark Mode», architecture modulaire et lazy-loading natif. Ces choix visent à améliorer la maintenabilité et les performances perceptibles.

Les optimisations Core Web Vitals et l’ajout de données structurées (JSON‑LD) montrent une priorité affichée sur le SEO et l’expérience utilisateur. Le lazy-loading natif combiné à une meilleure gestion des assets aide à réduire les temps de chargement et les CLS/TTI problématiques.

La suppression de jQuery du thème et la migration Bootstrap 4→5 entraînent des ruptures : classes et utilitaires changent, et certains modules natifs ont été refactorés (ps_mainmenu, ps_facetedsearch, ps_featuredproducts, productcomments…). Ces ruptures demandent des adaptations côté modules et personnalisations.

Compatibilité, roadmap et migration du thème

Hummingbird v2 est compatible avec PrestaShop 9+. La roadmap indique que Hummingbird «deviendra le nouveau thème par défaut à partir de PrestaShop 9.1», tandis que le thème Classic restera disponible pour la transition.

PrestaShop 9, sorti le 10/06/2025, a posé les bases : modernisation vers Symfony 6.4 (LTS), support PHP 8.1→8.4 et l’introduction de l’Admin API. Hummingbird complète cette modernisation côté front en proposant un thème pensé pour les pratiques actuelles.

Pour les boutiques en production, la migration doit être planifiée : tests de compatibilité, audit des modules tiers, et mise en place d’un plan de correction pour les composants impactés (CSS/JS, hooks et templates). Le basculement vers Hummingbird par défaut à 9.1 laisse le temps d’adaptation.

Conséquences pratiques pour modules, agences et intégrateurs

La suppression de jQuery et la migration vers Bootstrap 5 exigent des mises à jour pour de nombreux modules et des refactors pour les agences qui maintiennent des thèmes ou des intégrations spécifiques. Les classes utilitaires Bootstrap changées provoquent des ajustements CSS importants.

Les agences voient aussi une opportunité : un écosystème «developer‑first» facilite intégrations ERP/CRM, approches less/PWA, et automatisations via scripts CI (ex. CLI Update Assistant). Ces évolutions peuvent réduire les coûts d’intégration sur le long terme si la migration est bien orchestrée.

Certaines fonctionnalités natives ont été refactorées, ce qui demande une revue des modules natifs et tiers (ps_mainmenu, ps_facetedsearch, etc.). Les agences doivent prévoir des campagnes de tests et de correction pour éviter les régressions lors du passage à Hummingbird v2.

Bonnes pratiques recommandées pour développer avec Hummingbird v2

PrestaShop recommande l’utilisation des composants Bootstrap natifs lorsque cela est possible, et la convention BEM pour les composants non‑Bootstrap. Ces règles facilitent la compatibilité et la lisibilité du code CSS.

Pour la gestion des styles, l’usage de @layer en CSS est conseillé pour gérer les priorités et éviter les conflits. L’architecture d’override SCSS est soulignée pour permettre des personnalisations propres et maintenables.

Au niveau JavaScript, il est recommandé d’utiliser des attributs de données pour relier l’interaction aux composants plutôt que de s’appuyer sur des sélecteurs de classes, ce qui rend l’UI plus robuste face aux changements structurels et à la minification.

Admin API : fondations, usages et exemples concrets

L’Admin API de PrestaShop est construite sur API Platform avec une implémentation CQRS. L’authentification est gérée via OAuth2 et l’API est conçue pour être extensible et exposer le back‑office via des standards modernes (JSON‑LD, GraphQL, JSON:API mentionnés dans la documentation).

La documentation «How to use the Admin API» fournit des exemples pratiques : obtention d’un token OAuth2 (avec scopes détaillés), import d’un fichier docs.json dans Postman, exemples curl pour GET/PUT/POST et gestion des erreurs (ex. 403 «Invalid scope» si un scope est manquant).

Pour faciliter l’extension, le module ps_apiresources centralise les resources/endpoints scannés par le Core. Une nouvelle collection d’endpoints communautaires peut être ajoutée via ce module sans attendre une release majeure du Core.

Communauté, contributions et suivi du progrès

L’initiative «Call for Contributions: Admin API», lancée le 07/08/2025, invite la communauté à compléter les endpoints manquants. Le bilan de progrès (novembre 2025) montre que la revue des contributions a commencé en septembre et visait une complétion fin 2025.

Des contributions concrètes ont été déposées par des acteurs comme Codencode, Progi1984 et Kiwik sur des ressources importantes (catégories, attributs, stores, suppliers, adresses, etc.). PrestaShop met à disposition un «API coverage tracker» sur GitHub et un canal Slack #cfc-adminapi pour coordonner les efforts et éviter les doublons.

Le cycle de maintenance de PrestaShop 9.x reflète une cadence active : le patch 9.0.1 (13/10/2025) a corrigé ~60+ bugs et mergé ~140 PRs, suivi de 9.0.2 avec des améliorations du Back Office et de la couverture API. Ces patchs améliorent rapidement la stabilité et rendent l’Admin API plus robuste pour les intégrations.

La combinaison Hummingbird v2 + Admin API ouvre des possibilités techniques inédites pour les projets PrestaShop : modernité frontale, API riche et extensible, et un écosystème prêt pour des architectures less et des intégrations complexes.

Pour les développeurs et agences, la feuille de route pratique est claire : tester Hummingbird v2 en environnement contrôlé, mettre à jour ou refactorer les modules impactés, s’approprier l’Admin API via la documentation et contribuer aux endpoints manquants pour accélérer l’adoption collective.

Quitter la version mobile