WooCommerce Analyse
Checkout en blocs ou shortcode : ce que WooCommerce a vraiment changé au tunnel de commande
Depuis WooCommerce 8.3, les nouvelles boutiques démarrent avec un panier et une page de commande construits en blocs. Les boutiques existantes gardent le shortcode. Deux architectures, deux façons de personnaliser, et un choix qui dépend d'abord des extensions de paiement et de livraison.

Le tunnel de commande est la page la plus rentable d’une boutique et celle qu’on ose le moins toucher. WooCommerce l’a pourtant profondément transformée : depuis la version 8.3, publiée le 16 novembre 2023, les blocs Panier, Validation de commande et Confirmation de commande sont installés par défaut sur toute nouvelle boutique. Les boutiques existantes ne sont pas basculées d’office, et le shortcode [woocommerce_checkout] reste disponible.
Deux boutiques WooCommerce peuvent donc aujourd’hui afficher deux tunnels de commande qui n’ont presque plus rien en commun sous le capot. La différence n’est pas cosmétique.
Deux architectures, pas deux habillages
Le checkout historique est une page PHP rendue par le serveur. Chaque champ, chaque bloc d’information passe par des hooks et des filtres que les extensions et les thèmes utilisent depuis quinze ans : woocommerce_checkout_fields, woocommerce_after_order_notes et des dizaines d’autres. Le recalcul des frais de port se fait par des allers-retours AJAX qui renvoient des fragments de page.
Le checkout en blocs est une application JavaScript qui dialogue avec la Store API, une API REST dédiée au parcours d’achat. L’interface se met à jour sans rechargement, les erreurs s’affichent au niveau du champ concerné, et l’éditeur de blocs permet de réorganiser la page visuellement. En contrepartie, les hooks PHP du tunnel historique n’ont plus d’effet : une extension qui ajoutait un champ par woocommerce_checkout_fields ne l’affiche tout simplement pas.
Le point de blocage : paiement et livraison
Un moyen de paiement n’apparaît dans le checkout en blocs que si son extension fournit une intégration dédiée. Les grands prestataires l’ont fait, mais les passerelles bancaires plus confidentielles, certains modules de paiement en plusieurs fois et de nombreux sélecteurs de points relais ont longtemps tardé. Une boutique qui bascule sans vérifier peut perdre un moyen de paiement sans le moindre message d’erreur : il n’est simplement plus proposé.
La même prudence vaut pour les champs spécifiques : numéro de TVA intracommunautaire, date de livraison souhaitée, message cadeau. WooCommerce propose désormais une API de champs additionnels pour le checkout en blocs, mais un champ ajouté par un vieux filtre PHP doit être réécrit, pas simplement déplacé.
Les critères de choix
- Nouvelle boutique : les blocs s’imposent. C’est la direction du projet, et les extensions récentes sont d’abord pensées pour eux.
- Boutique existante, tunnel peu personnalisé, paiement par un prestataire majeur : la bascule se prépare en préproduction et se fait sans grand risque.
- Boutique existante avec champs sur mesure, passerelle régionale ou logique de livraison complexe : le shortcode reste un choix légitime, le temps d’inventorier ce qui devra être réécrit.
Dans tous les cas, la bascule se fait page par page : une copie de la page de commande avec les blocs, testée avec de vraies commandes en mode test du prestataire de paiement, avant de remplacer la page de production. Le détail des nouveautés figure dans l’annonce officielle de WooCommerce 8.3.
Ce qu’il faut retenir
- Blocs par défaut depuis WooCommerce 8.3 pour les nouvelles boutiques ; le shortcode reste pris en charge.
- Les hooks PHP du tunnel historique ne s’appliquent pas au checkout en blocs.
- La compatibilité des moyens de paiement et de livraison décide du calendrier de bascule.
Je ne bascule jamais un checkout en blocs pour la beauté du geste. La question que je pose est simple : qu’est-ce que la boutique gagne en ventes ? Sur une boutique neuve, les blocs font gagner du temps à tout le monde. Sur une boutique qui vend depuis huit ans avec un tunnel sur mesure qui convertit bien, je préfère garder le shortcode et planifier la réécriture proprement, plutôt que de découvrir un samedi que le paiement en trois fois a disparu. — Simon Janvier
Vous hésitez à basculer votre tunnel de commande ? L’audit offert inventorie les extensions et les champs qui devront être adaptés. Demander l’audit e-commerce