Faragiri
Français

Apprendre WooCommerce WordPress

Où vivent les données avant et après le changement de stockage des commandes, les crochets qui comptent autour du panier, et ce que la loi française ajoute à une page produit.

5Sections
4Min de lecture
5Profondeur

Cinq étapes, une boutique

Où sont les crochets, et quelle étape mérite d'être crue

Chaque étape ci-dessous est un endroit où du code peut s'exécuter, et le rétrécissement est volontairement non chiffré : une seule d'entre elles est atteinte par tout client dont l'argent est réellement arrivé.

  1. Vue du catalogueUn cache complet sert cette page, donc aucun PHP ne s'exécute
  2. Ajout au panierwoocommerce_add_to_cart_validation peut refuser l'article ici
  3. Page de commandeChaque visite est du PHP et des requêtes, ce qui est normal et non un bogue
  4. Commande crééewoocommerce_checkout_create_order, le bon moment pour fixer des champs
  5. Paiement complétéSe déclenche même si le client ne charge jamais la page de remerciement

La figure ne porte aucun chiffre, parce qu'aucune boutique n'en partage deux identiques. La preuve est l'ordre et la dernière étape : accrocher l'exécution de la commande à la page de remerciement fait perdre tout client qui a fermé l'onglet.

WooCommerce est une extension qui transforme WordPress en boutique, ce qui veut dire que chaque produit est un article, chaque commande est un article, et chaque attribut est une taxonomie ou une ligne de métadonnées. Comprendre cette seule phrase explique aussi bien pourquoi WooCommerce s'intègre à tout ce que fait WordPress que pourquoi il ralentit à une taille qu'une boutique conçue pour le commerce ne remarquerait pas.

La conséquence est concrète : les données produit vivent dans wp_posts et wp_postmeta, et depuis le passage au stockage performant des commandes, les commandes vivent dans leurs propres tables plutôt que parmi les articles. Une boutique restée sur une installation ancienne peut encore avoir ses commandes comme articles, et une requête écrite pour un modèle ne trouve rien sur l'autre, ce qui est la première chose à vérifier quand un rapport revient vide.

Les crochets qui comptent sont autour du panier et de la commande

  • woocommerce_add_to_cart_validation est le filtre qui peut refuser un article, en renvoyant false avec un message, et c'est là qu'une règle de stock ou d'éligibilité doit vivre
  • woocommerce_checkout_create_order permet de fixer des champs sur la commande avant qu'elle ne soit enregistrée, ce qui est le bon moment plutôt qu'après
  • woocommerce_payment_complete est celui sur lequel accrocher l'exécution de la commande, pas la page de remerciement, parce qu'un client qui ferme l'onglet ne la charge jamais
  • Les prix sont filtrés, pas lus directement : une extension qui modifie woocommerce_product_get_price change ce que voit toute autre extension

Ce dernier point est la source des bogues les plus déroutants de cet écosystème. Un prix affiché et un prix facturé passent par des filtres différents à des moments différents, si bien que deux extensions faisant chacune quelque chose de raisonnable produisent un total que personne n'avait voulu, et le correctif exige de savoir sur quel crochet se trouve chacune.

Ce que la loi française ajoute à une simple page produit

Le droit de rétractation de quatorze jours du code de la consommation s'applique à toute vente en ligne à un particulier, et il doit être expliqué avant le paiement, pas dans une page de conditions générales que personne n'ouvre. Les conditions générales de vente elles-mêmes sont obligatoires, contrairement à ce que suppose la plupart des thèmes de boutique livrés depuis l'anglais, et un compte bancaire ou un numéro de TVA intracommunautaire doit apparaître sur chaque facture émise à un professionnel.

Céline Ferrand vend des tissus en ligne depuis Roubaix et a lancé sa boutique sur un thème WooCommerce acheté tel quel, sans page de rétractation ni mentions légales. La banque qui traite ses paiements par carte a suspendu le compte marchand après un contrôle de conformité, six semaines après le lancement, le temps que ces deux pages soient ajoutées et validées.

Où va la performance

Les pages panier et commande ne peuvent pas être mises en cache, parce qu'elles sont propres à chaque client, donc chaque visite est une requête PHP complète avec son lot de requêtes SQL. Une boutique rapide sur son catalogue et lente au moment de payer est normale et n'est pas un bogue ; une boutique lente sur son catalogue a un problème de cache, parce que le catalogue, lui, est mis en cache.

Le filtrage par attribut est l'autre poste. La navigation à facettes sur des lignes de métadonnées coûte une jointure par attribut, et se dégrade nettement autour de quelques milliers de produits avec plusieurs attributs. La réponse est un index conçu pour cet usage plutôt qu'un réglage supplémentaire de la base, et le savoir tôt évite un mois de travail sur la mauvaise piste.

Les outils à faire tourner en 2026

Le stockage performant des commandes est le réglage à activer, gratuit avec WooCommerce, et il déplace les commandes vers des tables dédiées avec de vrais index plutôt que la table des articles. Il a remplacé les commandes comme articles, ce qui rendait les requêtes de commande lentes en volume, et toute extension qui n'a pas été mise à jour pour ce changement est un risque de compatibilité à vérifier avant de l'activer.

Query Monitor sur une copie de données réelles est le second, gratuit et open source. Le volume de commandes change les plans de requête, donc un passage en caisse rapide sur vingt commandes de test ne dit rien d'un passage en caisse avec cinquante mille. Il a remplacé l'optimisation sur des données de démonstration, ce qui est la façon la plus courante de ne rien corriger.

Là où ça bloque

Le blocage est de personnaliser la commande en modifiant les fichiers de gabarit. WooCommerce permet à un thème de remplacer ses propres fichiers de gabarit, donc la modification fonctionne, puis l'extension met à jour sa propre version de ce gabarit et la version modifiée se retrouve privée d'un champ que le nouveau code attend. Cela échoue après une mise à jour que personne n'a reliée à la cause.

Préférer un crochet à une substitution de gabarit à chaque fois, et quand une substitution est réellement nécessaire, noter la version depuis laquelle elle a été copiée et la revérifier à chaque mise à jour. Le système de crochets sur lequel tout cela repose est celui des extensions WordPress, les gabarits qu'il remplace sont ceux des thèmes, et le mécanisme qui prévient les systèmes externes d'un paiement reçu est détaillé sur la page consacrée aux webhooks.

À côté

Au-dessus