WooCommerce 11.1 : galeries d’images par variation et droit de rétractation intégrés

WooCommerce 11.1, publiée le 1er septembre, intègre deux fonctions qui demandaient jusqu’ici une extension : des galeries d’images propres à chaque variation de produit, et un formulaire de demande de rétractation pour les clients européens. La version accélère aussi nettement les appels REST et Store API. Voici comment en profiter et ce que les développeurs doivent vérifier.

Les galeries par variation, activées pour tout le monde

Les galeries de variations sont désormais activées sur toutes les boutiques. Le bouton expérimental disparaît de l’écran Fonctionnalités, et la mise à jour de base de données 11.1.0-1 active la fonction même sur les boutiques qui l’avaient désactivée. L’extension WooCommerce Additional Variation Images est en cours de retrait.

Concrètement, pour un t-shirt en trois couleurs, chaque couleur peut avoir sa propre série de photos. Si vous utilisez Additional Variation Images ou une solution tierce équivalente, testez sur une copie de la boutique : deux systèmes de galeries actifs en même temps risquent de donner des doublons d’images ou des scripts en conflit sur la fiche produit. Côté vidéo, la 11.1 ajoute, en bêta et désactivée par défaut, la possibilité de placer des vidéos téléversées localement dans la galerie produit, via WooCommerce > Réglages > Avancé > Fonctionnalités > Product gallery videos.

Le droit de rétractation dans Mon compte

Pour les boutiques qui vendent dans l’Union européenne, WooCommerce 11.1 ajoute le « droit de rétractation de commande ». La fonction est désactivée par défaut et s’active dans WooCommerce > Réglages > Avancé > Fonctionnalités. Elle crée une page /my-account/withdraw-order/ où le client soumet sa demande, sans avoir besoin de se connecter.

Le marchand reçoit un e-mail et une notification dans le tableau de bord. Selon une réponse de l’équipe WooCommerce sous l’annonce, si le numéro de commande et l’adresse e-mail de facturation correspondent, la demande est enregistrée en note de commande ; sinon, elle est acceptée quand même et signalée pour un traitement manuel. Point important : la rétractation et le remboursement restent des opérations manuelles. Le formulaire facilite la demande, il ne rembourse rien.

Depuis WooCommerce 11.2, deux e-mails dédiés (accusé de réception client et notification marchand) se configurent dans WooCommerce > Réglages > E-mails. Faites relire leurs textes par la personne qui gère vos conditions générales de vente : le formulaire ne remplace pas l’information légale due au client.

Plus rapide côté API

WooCommerce n’enregistre plus ses blocs et motifs sur les requêtes qui ne peuvent pas les afficher (cron, AJAX, REST). D’après les notes de version, les requêtes Store API et REST sont 30 à 42 % plus rapides. Les produits variables profitent aussi de corrections qui réduisent les requêtes N+1 et les requêtes de cache de prix. Dans l’administration, un nouveau point d’accès /wc-analytics/activity-panel/counts remplace trois anciens et fait passer six requêtes par chargement de page à une seule.

Si votre extension affiche des blocs WooCommerce dans un contexte AJAX ou REST (un rendu de bloc dans une modale, par exemple), elle doit réactiver l’enregistrement avec le filtre prévu. Dans le cas le plus simple :

add_filter( 'woocommerce_should_register_blocks', '__return_true' );

Restreignez plutôt cette réactivation à vos propres requêtes, sinon vous perdez le gain de performance pour tout le site.

Les autres points pour les développeurs

• remove_order_items() mémorise les ID d’articles présents au moment de la demande : les articles ajoutés avant $order->save() ne sont plus supprimés. Si vous avez un data store de commandes personnalisé, revoyez get_item_ids() et delete_items_by_ids().
• is_rest_api_request() considère maintenant un paramètre rest_route non vide comme une requête REST.
• Les anciens drapeaux de fonctionnalités stables de WooCommerce Admin sont retirés : Features::is_enabled() et window.wcAdminFeatures émettent des avertissements de dépréciation.
• search_products() met ses conditions OR entre parenthèses : les résultats de recherche peuvent changer.
• Les remboursements REST acceptent compute_totals: true, et un point d’accès /refunds/preview calcule un remboursement sans l’appliquer.
• Le checkout Store API accepte un champ expected_total et renvoie une erreur 409 si le montant facturé ne correspond pas.

grep -rnE "Features::is_enabled|wcAdminFeatures|get_product_gallery_image_count" wp-content/plugins/mon-extension/

Ce qu’il faut retenir

• Les galeries par variation sont actives partout : vérifiez la cohabitation avec Additional Variation Images ou une extension équivalente.
• Le formulaire de rétractation européen s’active dans Réglages > Avancé > Fonctionnalités ; remboursement et rétractation restent manuels.
• REST et Store API gagnent 30 à 42 % de vitesse grâce au non-enregistrement des blocs, avec un filtre pour les cas particuliers.
• Repérez dans votre code les appels dépréciés aux drapeaux de fonctionnalités de WooCommerce Admin.

Photo d’illustration : Artem Beliaikin from Moscow, Russia, Wikimedia Commons, CC BY 2.0.