
WooCommerce 11.1 et 11.2 : nouveautés et risques de régression
WooCommerce 11.1 ajoute le droit de rétractation UE et des outils de remboursement API, tandis que 11.2 modifie les hooks produit. Ce qu'il faut vérifier.

WooCommerce publie une nouvelle version mineure environ une fois par mois, et deux sorties retiennent particulièrement l'attention en ce moment : la version 11.1, qui apporte un ensemble de fonctionnalités vraiment utiles pour les marchands et les développeurs d'API, et la version 11.2, qui s'annonce comme une mise à jour de performance modifiant discrètement le déclenchement de certains des hooks les plus utilisés de l'extension. Si vous gérez une boutique WooCommerce ou maintenez du code personnalisé pour l'une d'elles, il vaut la peine de comprendre ces deux évolutions avant qu'elles n'arrivent sur votre site de production.
Ce guide passe en revue ce qui est confirmé pour WooCommerce 11.1, ce que WooCommerce a déjà divulgué concernant les changements de hooks produit de la version 11.2, et comment préparer chaque mise à jour sans casser le tunnel de commande, vos extensions personnalisées ou votre catalogue de produits.
En bref (TL;DR)
- WooCommerce 11.1 (en bêta au moment de la rédaction, avec une sortie finale visée pour le 1er septembre 2026) ajoute un parcours de rétractation de commande pour l'UE, des améliorations pour les remboursements via l'API REST, une vérification du total lors du paiement, ainsi que plusieurs correctifs de performance et de bogues pour les produits variables et l'import/export CSV.
- WooCommerce 11.2 n'a pas encore publié ses notes de version complètes, mais le blog développeurs de WooCommerce a déjà signalé un changement majeur (breaking change) : l'enregistrement et le réordonnancement des produits ignoreront certains appels de hooks qui étaient auparavant déclenchés à chaque requête, à des fins d'optimisation des performances.
- Si une extension ou du code personnalisé sur votre site s'accroche à
set_object_terms,woocommerce_after_single_product_orderingouwoocommerce_after_product_ordering, il doit être audité avant de passer à la version 11.2.- Sauvegardez votre boutique et testez ces deux mises à jour sur un environnement de staging avant de toucher à la production, en particulier si vous utilisez du code personnalisé autour des produits ou du paiement.
Nouveautés de WooCommerce 11.1
Fin août 2026, WooCommerce 11.1 est en version bêta, avec une sortie finale stable visée par WooCommerce pour le 1er septembre 2026. Les numéros de version bêta et les dates exactes de sortie pouvant évoluer, consultez le changelog de WooCommerce pour connaître le statut actuel avant de planifier une mise à jour. Les fonctionnalités ci-dessous correspondent à ce que WooCommerce a documenté pour cette version jusqu'à présent.
Prise en charge du droit de rétractation dans l'UE
WooCommerce 11.1 introduit un parcours natif de rétractation de commande, conçu pour les marchands qui doivent respecter les règles européennes relatives au droit de rétractation pour les achats en ligne. Les propriétaires de boutique peuvent l'activer dans WooCommerce → Réglages → Avancé → Fonctionnalités. Une fois activé, les clients disposent d'une nouvelle page dans leur compte à l'adresse /my-account/withdraw-order/ où ils peuvent soumettre une demande de rétractation pour une commande éligible. Les demandes correspondant à une commande existante par e-mail et numéro de commande sont automatiquement associées à cette commande, et le marchand reçoit une notification ainsi qu'une alerte dans la boîte de réception WooCommerce.
Il s'agit d'une brique utile, mais pas d'une solution de conformité complète. Elle vous offre un moyen structuré de recevoir et de suivre les demandes de rétractation, mais il reste de votre ressort de vérifier auprès de votre conseiller juridique que votre politique de retour, vos délais et votre gestion des remboursements respectent bien le droit européen de la consommation — une mise à jour d'extension ne peut pas le garantir à elle seule.
Améliorations des remboursements via l'API REST
Les développeurs qui travaillent avec l'API REST de WooCommerce bénéficient de deux améliorations pour les remboursements de commandes. Le point de terminaison de remboursement existant (POST /wc/v3/orders/{id}/refunds) accepte désormais un paramètre compute_totals afin que le serveur puisse recalculer les totaux du remboursement au lieu d'obliger le client à effectuer ce calcul. Un nouveau point de terminaison d'aperçu fait également son apparition, POST /wc/v3/orders/{id}/refunds/preview, qui permet de valider un remboursement avant de l'appliquer réellement — à confirmer toutefois dans le changelog final lors de la sortie de la version 11.1, les chemins exacts des fonctionnalités en bêta pouvant évoluer avant la publication. Si vous avez développé des outils de remboursement sur mesure, un tableau de bord de support ou une intégration marketplace par-dessus l'API WooCommerce, cela supprime une source de logique de calcul dupliquée et réduit le risque qu'une demande de remboursement échoue après avoir déjà annoncé au client qu'elle avait réussi.
Vérification du total au moment du paiement
Le point de terminaison de paiement de la Store API gagne un champ optionnel expected_total. Si le client soumet un total attendu qui ne correspond pas à ce que WooCommerce calcule côté serveur, la requête est rejetée avec une erreur plutôt que d'être validée silencieusement à un prix différent. Cela élimine toute une catégorie de bogues d'écart de prix qui peuvent apparaître dans les tunnels de paiement personnalisés, les boutiques headless ou les extensions de paiement tierces lorsque les totaux côté client et côté serveur se désynchronisent, par exemple après la modification d'un code promo, d'une règle fiscale ou d'une méthode d'expédition en cours de session.
Correctifs de performance et de fiabilité
Plusieurs correctifs ciblent des zones qui touchent les boutiques disposant de catalogues volumineux :
- L'import et l'export CSV de produits reçoivent des correctifs pour la préservation des termes lors d'un nouvel envoi, la suppression involontaire d'images et la gestion des devises, ainsi qu'une meilleure gestion de la création de variations pendant l'import.
- Les produits variables bénéficient de plusieurs réductions du nombre de requêtes (correctifs « N+1 ») lors du chargement des variations, des recherches d'attributs et de la mise en cache des prix, aussi bien dans l'éditeur de produits que sur la boutique en ligne.
- L'enregistrement des blocs est désormais ignoré lors des requêtes cron, AJAX et REST lorsqu'il n'est pas nécessaire, réduisant la surcharge sur ces types de requêtes tout en conservant l'enregistrement à la demande là où il est réellement requis.
Aucune de ces évolutions n'est une fonctionnalité phare, mais ce sont des changements qui comptent d'autant plus que votre catalogue s'agrandit, et ils méritent d'être testés si vous gérez une boutique avec un grand nombre de produits variables ou si vous dépendez d'imports CSV réguliers.
Autres changements destinés aux développeurs
Quelques changements plus modestes méritent d'être connus si vous maintenez du code personnalisé ou des extensions :
is_rest_api_request()détecte désormais correctement les requêtes utilisant le paramètre de requête?rest_route=, et pas uniquement les URL REST à permaliens propres.ProductGalleryUtils::get_product_gallery_image_count()est dépréciée.- Le balisage HTML du sélecteur de quantité a été réorganisé pour améliorer l'accessibilité aux lecteurs d'écran et la navigation au clavier (conformité WCAG).
- Les symboles monétaires ont été mis à jour pour les devises MOP et ZMW.
- Les fournisseurs de contenu intégrable de l'éditeur d'e-mails ont été étendus pour inclure YouTube, Vimeo, VideoPress, TikTok et Dailymotion, et les fonctions de rappel des balises de personnalisation reçoivent désormais un paramètre de type de contenu de destination afin que les balises soient correctement échappées selon qu'il s'agit d'e-mails HTML ou en texte brut.
Deux fonctionnalités expérimentales activables sur option font également partie de cette version : une approche unifiée de chargement des ressources pour l'éditeur de blocs — dont WooCommerce indique qu'elle réduit sensiblement le nombre de ressources chargées et de requêtes réseau dans ses propres tests — ainsi qu'un premier socle de stockage, protégé par un drapeau de fonctionnalité, pour les vidéos de galerie produit. Toutes deux sont facultatives dans la section Fonctionnalités expérimentales et vous n'avez pas besoin d'y toucher pour profiter du reste des apports de la version 11.1.
WooCommerce 11.2 : ce qui a déjà été annoncé
WooCommerce n'a pas encore publié les notes de version complètes de la version 11.2 ; aucune date de sortie n'est donc confirmée au moment de la rédaction. Ce qui a en revanche été publié, c'est un avis aux développeurs concernant un changement majeur (breaking change) à venir dans la façon dont l'enregistrement et le réordonnancement des produits déclenchent leurs hooks. WooCommerce publie ces avertissements avant une sortie précisément parce que ce changement peut casser silencieusement des extensions et du code personnalisé ; il vaut donc mieux l'anticiper dès maintenant plutôt que d'attendre les notes de version complètes.
La sauvegarde produit ignorera certains appels de hooks
Le processus d'enregistrement des produits dans WooCommerce appelle actuellement wp_set_object_terms() et delete_post_meta() même lorsque les valeurs enregistrées correspondent déjà à ce qui est en base. Dans la version 11.2, ces appels sont ignorés lorsque rien n'a réellement changé, ce qui, selon WooCommerce, peut réduire jusqu'à 45 % les requêtes SQL par enregistrement sur les boutiques comptant de nombreux produits.
Conséquence pratique : le hook set_object_terms se déclenchera moins souvent qu'aujourd'hui, car il ne s'exécutera que lorsqu'une affectation de terme change réellement. Si vous (ou une extension dont vous dépendez) avez du code comme :
add_action( 'set_object_terms', 'my_custom_sync_function', 10, 6 );et que ce code suppose que le hook se déclenche à chaque sauvegarde de produit, que les catégories, étiquettes ou attributs aient changé ou non, il risque de ne plus s'exécuter dans des situations où il fonctionnait auparavant. WooCommerce recommande de vérifier si votre fonction de rappel a réellement besoin d'un événement de modification de terme ou si elle cherche en réalité à réagir à n'importe quelle sauvegarde de produit — dans ce second cas, des hooks comme woocommerce_update_product ou save_post_product constituent désormais le choix le plus fiable.
Le réordonnancement des produits adopte un nouvel algorithme
WooCommerce remplace également l'algorithme sous-jacent utilisé lorsque vous réordonnez des produits par glisser-déposer dans la vue catalogue de l'administration. L'approche actuelle réindexe l'ensemble du catalogue à chaque réorganisation ; la nouvelle utilise un positionnement par plages afin de ne toucher que les produits effectivement déplacés, ce qui compte énormément sur les boutiques aux catalogues volumineux où une réindexation complète est coûteuse.
Deux hooks associés sont dépréciés :
woocommerce_after_single_product_orderingwoocommerce_after_product_ordering
Ils sont remplacés par deux hooks plus spécifiques :
woocommerce_product_ordering_process_reindexed_products, qui se déclenche après une réindexation complète du cataloguewoocommerce_product_ordering_process_moved_products, qui se déclenche après le repositionnement de produits spécifiques
clean_post_cache continue de se déclencher comme avant et n'est pas affecté. Si votre code s'accroche encore aux actions de réordonnancement dépréciées, il continuera de fonctionner, mais WooCommerce précise que leur utilisation déclenche un repli vers l'ancien algorithme de réordonnancement non optimisé : vous renonceriez donc au gain de performance plutôt que d'obtenir une erreur.
Qui est réellement concerné
Si vous n'utilisez ni extensions personnalisées, ni mu-plugins, ni code de thème qui s'accrochent à l'enregistrement ou au réordonnancement des produits, ce changement passera largement inaperçu ; le cœur de WooCommerce et ses fonctionnalités intégrées sont déjà adaptés. Cela concerne avant tout les agences et les développeurs qui maintiennent des outils personnalisés de synchronisation de catalogue, des extensions multivendeurs ou de marketplace, des intégrations tierces de gestion de stock ou d'ERP, ainsi que tout outil d'administration qui réagit au réordonnancement ou au ré-étiquetage des produits. Si cela correspond à votre configuration, il est judicieux de rechercher dès maintenant les noms de hooks ci-dessus dans votre base de code afin de ne pas avoir à déboguer une panne silencieuse la semaine où la version 11.2 sortira.
Faut-il mettre à jour maintenant ? Liste de contrôle pratique
Aucune de ces deux versions n'est un correctif de sécurité d'urgence ; il n'y a donc aucune raison de déployer précipitamment l'une ou l'autre sur une boutique en production le jour même de sa sortie. Une démarche courte et méthodique vous fera gagner plus de temps qu'elle ne vous en coûtera :
- Effectuez une sauvegarde récente avant de toucher quoi que ce soit. MagicWP inclut des sauvegardes à la demande que vous pouvez déclencher juste avant la mise à jour d'une extension ou du cœur, en plus des sauvegardes quotidiennes automatiques, afin de toujours disposer d'un point de restauration propre en cas d'imprévu.
- Clonez votre site sur un environnement de staging. Testez-y la mise à jour en premier, jamais directement en production. C'est également là que vous repérerez un écart de total au paiement, un import CSV défaillant ou une extension personnalisée qui a silencieusement cessé de synchroniser les termes de produits.
- Recherchez les noms de hooks ci-dessus dans votre base de code. Une simple recherche globale sur
set_object_terms,woocommerce_after_single_product_orderingetwoocommerce_after_product_orderingvous dira en quelques minutes si la version 11.2 nécessite des adaptations de code de votre côté. - Consultez les changelogs de vos extensions WooCommerce actives pour vérifier les notes de compatibilité explicites avec les versions 11.1 ou 11.2 avant de mettre à jour la production, en particulier pour les passerelles de paiement, les extensions d'abonnement et les intégrations de stock.
- Mettez à jour la production pendant les heures creuses, et surveillez attentivement vos journaux d'erreurs ainsi que le flux de commandes durant les premières heures qui suivent.
- Si vous utilisez l'API REST ou la Store API de WooCommerce, testez tout particulièrement la création de remboursements et la validation de commande sur la mise à jour en staging, car toutes deux évoluent dans la version 11.1.
Foire aux questions
Quand WooCommerce 11.1 sortira-t-il officiellement ? Fin août 2026, WooCommerce 11.1 est en bêta avec une sortie finale visée pour le 1er septembre 2026. Les calendriers de bêta pouvant bouger, vérifiez le statut actuel dans le changelog officiel de WooCommerce avant de vous baser sur une date précise.
WooCommerce 11.2 est-il déjà disponible ? Non. Seul un avis aux développeurs concernant les prochains changements de hooks produit a été publié pour le moment ; les notes de version complètes et la date de sortie de la version 11.2 n'ont pas encore été annoncées à l'heure où nous écrivons ces lignes.
WooCommerce 11.1 va-t-il casser mon site ?
Pour la majorité des boutiques, non. Les changements sont additifs (nouveaux points de terminaison, nouvelle option dans les réglages et correctifs de performance). Le principal risque concerne les tunnels de paiement personnalisés ou les intégrations API qui ne prennent pas encore en compte la nouvelle vérification expected_total, puisqu'un total incohérent sera désormais rejeté au lieu d'être accepté silencieusement.
Qu'est-ce que la fonctionnalité de rétractation de commande UE dans WooCommerce 11.1 ? Il s'agit d'un parcours intégré et optionnel qui permet aux clients de soumettre une demande de rétractation pour une commande depuis leur page de compte, et qui avertit le marchand lorsqu'ils le font. C'est un outil pour faciliter la gestion des demandes de rétractation, pas une garantie que votre boutique respecte les exigences de protection des consommateurs d'un pays donné.
Dois-je mettre à jour du code personnalisé avant WooCommerce 11.2 ?
Uniquement si votre code s'accroche à set_object_terms en partant du principe qu'il se déclenche à chaque sauvegarde de produit, ou aux actions désormais dépréciées woocommerce_after_single_product_ordering / woocommerce_after_product_ordering. Si aucune de vos extensions ni aucun code personnalisé ne touche à ces hooks, aucune modification n'est nécessaire.
Comment tester une mise à jour WooCommerce en toute sécurité ? Clonez votre site en ligne vers un environnement de staging, appliquez-y d'abord la mise à jour et parcourez vos flux habituels de paiement, de remboursement et de gestion des produits avant de mettre à jour la production. Un outil de staging en un clic rend cette étape suffisamment rapide pour l'appliquer à chaque mise à jour, et pas seulement aux versions majeures.
Que se passe-t-il si je continue d'utiliser les hooks de réordonnancement de produits dépréciés ? Ils continueront de se déclencher, mais WooCommerce indique que leur utilisation force la boutique à revenir à l'ancien algorithme de réordonnancement non optimisé au lieu du nouvel algorithme par plages : vous conservez donc la fonctionnalité, mais vous perdez le gain de performance.
Faut-il passer à WooCommerce 11.1 dès sa sortie ? Il n'est pas nécessaire de se précipiter le jour même. Laissez passer quelques jours pour voir apparaître d'éventuels premiers retours de bogues, testez d'abord sur staging, puis mettez à jour la production pendant une plage horaire de faible trafic.
Conclusion
WooCommerce 11.1 est une version solide et pragmatique : une fonctionnalité utile liée à la conformité avec le droit de rétractation, de vraies améliorations sur l'API de remboursement pour quiconque développe sur WooCommerce, un garde-fou au paiement qui comble un véritable écart d'intégrité tarifaire, et un lot de correctifs de performance qui comptent sur les catalogues importants. WooCommerce 11.2, avant même la publication de ses notes de version complètes, a déjà annoncé le changement le plus structurant pour les développeurs : les hooks d'enregistrement et de réordonnancement des produits sont optimisés d'une manière qui peut interrompre silencieusement du code qui reposait sur l'ancien comportement. Aucune des deux mises à jour n'est à craindre, mais toutes deux récompensent un minimum de préparation : une recherche de noms de hooks dans votre base de code, un test en staging et une sauvegarde avant de toucher à la production.
Si vous recherchez un hébergement qui fasse de ce type de test sécurisé une routine plutôt qu'une corvée, l'hébergement WooCommerce infogéré de MagicWP inclut le staging en un clic et les sauvegardes à la demande, afin que tester une nouvelle version de WooCommerce ne vous coûte que quelques minutes au lieu d'un après-midi risqué.
Recevez le meilleur de MagicWP par e-mail.
Notes techniques mensuelles, actualités du produit et conseils sur les performances de WordPress. Aucun spam, désabonnement à tout moment.

