Disponible pour missions & renforts d’agence · Réponse rapide, par la personne qui intervient

WhatsApp contact@allaux.fr
FR EN TR
allaux.
Urgence Parler de mon projet

Passer des shortcodes aux blocs de panier et de commande sur WooCommerce

Depuis WooCommerce 8.3, sorti le 14 novembre 2023, les pages Panier et Commande utilisent par défaut des blocs Gutenberg sur les nouvelles installations, à la place des shortcodes historiques [woocommerce_cart] et [woocommerce_checkout]. Les shortcodes restent pris en charge en solution de repli : rien n’oblige à migrer dans l’urgence.

Décrire mon problème Discuter sur WhatsApp

Ce que les blocs changent par rapport aux shortcodes

Les shortcodes [woocommerce_cart] et [woocommerce_checkout] génèrent le tunnel d’achat en PHP côté serveur, avec un rendu HTML classique. Les blocs de panier et de commande fonctionnent différemment : l’interface s’appuie sur React côté navigateur, qui communique avec le site via l’API du Store WooCommerce plutôt que par rechargement complet de page à chaque étape. Le résultat visuel pour l’acheteur reste un tunnel de commande classique, mais le mécanisme technique sous-jacent change entièrement.

Il est possible de revenir au shortcode à tout moment via le bouton de transformation disponible dans la barre d’outils du bloc, ce qui laisse une marge de manœuvre si une extension bloque la migration.

Pourquoi une personnalisation du tunnel de commande peut ne plus s’appliquer

  • Un hook ou un filtre PHP classique qui modifiait l’affichage du panier ou de la commande shortcode (par exemple pour ajouter un champ, un message, ou réorganiser des sections) ne s’applique pas automatiquement aux blocs : l’architecture React n’exécute pas ce code PHP au moment du rendu, une réécriture est souvent nécessaire via les points d’extension propres aux blocs (filtres JavaScript, API du Store).
  • Une extension de paiement ou de livraison qui ne déclare pas explicitement sa compatibilité avec les blocs peut ne pas apparaître comme moyen de paiement disponible côté panier ou commande en blocs, même si elle fonctionne normalement avec les shortcodes.
  • Un thème qui surchargeait fortement le CSS ou les templates PHP du tunnel de commande shortcode (fichiers dans woocommerce/checkout/) voit ces personnalisations sans effet sur les blocs, qui utilisent leurs propres gabarits.

Comment je conduis la bascule vers les blocs

  1. Identifier le mode actuel du site

    Je vérifie si les pages Panier et Commande utilisent encore les shortcodes historiques ou déjà les blocs, notamment sur un site créé avant novembre 2023 qui n’a pas basculé automatiquement.

  2. Tester les extensions concernées avant bascule

    Je vérifie sur un environnement de test que chaque extension de paiement et de livraison active fonctionne avec les blocs et déclare sa compatibilité, avant toute bascule en production.

  3. Recenser les personnalisations existantes

    Je liste les hooks PHP et surcharges de template qui modifient le tunnel de commande shortcode, pour identifier lesquels doivent être réécrits pour les blocs.

  4. Bascule et réécriture ciblée

    J’active les blocs et je réécris uniquement les personnalisations qui ne s’appliquent plus, via les points d’extension propres aux blocs plutôt qu’en reproduisant l’ancien mécanisme.

  5. Solution de repli si blocage

    Si une extension critique n’est pas compatible, je reconvertis le bloc concerné en shortcode via la barre d’outils, ce qui permet de repousser la migration de cette page sans bloquer le reste du site.

Pour aller plus loin

Décrivez votre besoin en 1 minute

Quelques questions ciblées pour que je vous réponde avec une estimation, pas avec un questionnaire de plus.

D’où partez-vous ?
Quelle est la taille du catalogue, s’il y a une boutique ?
Le site utilise-t-il des extensions payantes avec licence à retransférer ? (facultatif)

Certaines licences sont limitées à un domaine ou nécessitent une réactivation auprès de l’éditeur.

Qu’est-ce qui doit impérativement être conservé ? (facultatif)
Indiquez au moins un e-mail ou un téléphone pour que je puisse vous répondre.

Indiquez au moins un e-mail ou un téléphone pour que je puisse vous répondre.

Questions fréquentes

Dois-je basculer vers les blocs si mon site utilise encore les shortcodes ?
Non dans l’urgence : les shortcodes restent pris en charge comme solution de repli. Je recommande de migrer quand les extensions de paiement et de livraison utilisées sont confirmées compatibles.
Mes hooks PHP personnalisés vont-ils simplement s’arrêter de fonctionner ?
Ils ne provoquent pas d’erreur, mais ils cessent de s’appliquer visuellement puisque les blocs ne passent plus par le rendu PHP shortcode qu’ils modifiaient. Une réécriture ciblée est nécessaire pour retrouver le même comportement.
Comment savoir si mon extension de paiement est compatible avec les blocs ?
Je teste le moyen de paiement sur la page Commande en mode bloc, sur un environnement de test : s’il n’apparaît pas dans la liste des moyens disponibles, l’extension n’est probablement pas encore compatible.
Puis-je revenir en arrière si la migration pose un problème ?
Oui, chaque bloc panier ou commande propose un bouton de transformation vers sa version shortcode directement dans sa barre d’outils, sans manipulation technique lourde.
Les blocs changent-ils l’expérience visible par l’acheteur ?
Le déroulé reste un tunnel de commande classique pour l’acheteur. Ce qui change se situe côté technique : le rendu s’appuie sur React et l’API du Store WooCommerce plutôt que sur un rendu PHP classique.

Pages liées