HUSKY - WooCommerce Product Filter Professional

Filtre WooCommerce par taille : variations en rupture de stock affichées, la solution

Un client coche la taille M, et le filtre WooCommerce par taille lui montre un T-shirt dont la variation M est en rupture de stock. La page produit indique alors que la taille est épuisée, et le client s’en va. Le filtre n’est pas cassé : par défaut, il juge un produit variable d’après son produit parent, exactement comme WooCommerce, et le parent reste en stock tant qu’une de ses variations l’est. Voici pourquoi le filtre affiche des variations en rupture de stock, le réglage de HUSKY qui lui fait vérifier le stock de la taille sélectionnée, les règles que suit cette vérification, et ce qu’il faut corriger quand les résultats ou les compteurs restent faux.

Pourquoi le filtre par taille affiche des variations épuisées

Dans WooCommerce, un produit variable se compose de deux types d’enregistrements. Le produit parent est ce que listent les pages de la boutique et des catégories. Son onglet Attributs (Attributes) contient les valeurs (Taille : S, M, L ; Couleur : noir, rouge), et ces valeurs sont rattachées au parent sous forme de termes d’attribut. Chaque variation, comme M / noir, est un enregistrement distinct avec son propre prix et son propre stock.

Un filtre par attribut cherche les produits parents qui possèdent le terme sélectionné. Si le T-shirt liste M dans son onglet Attributs (Attributes), il correspond à la taille M, quel que soit le stock de la variation M. Le statut de stock du parent n’aide pas non plus : WooCommerce le maintient sur En stock (In stock) tant qu’au moins une variation est en stock (ou sur Sur commande (On backorder) si l’une est sur commande) et ne le passe sur En rupture de stock (Out of stock) que lorsque toutes les variations sont épuisées. Pour la même raison, l’option WooCommerce Masquer les produits en rupture de stock du catalogue (Hide out of stock items from the catalog) (WooCommerce → Réglages → Produits → Inventaire) ne règle pas le problème : elle ne masque le T-shirt que lorsque toutes ses tailles ont disparu. La question « la taille M est-elle disponible ? » doit être posée aux variations, et le filtre ne la pose que si vous le lui demandez.

Faire vérifier à HUSKY le stock de la taille sélectionnée

La vérification des variations appartient à l’élément In stock. Dans HUSKY 3.4.6, c’est une extension intégrée toujours active ; il n’y a donc rien à activer dans l’onglet Extensions (Extensions).

  1. Ouvrez WooCommerce → Réglages → Products Filter, onglet Structure (Structure), et trouvez la ligne En stock (In stock). Réglez-la sur Oui (Yes) si les clients doivent voir la case à cocher.
  2. Cliquez sur le bouton en forme d’engrenage à côté (options supplémentaires (additional options)). Dans la fenêtre qui s’ouvre, réglez le premier paramètre, Rechercher dans les produits variables (Search in variable produts), sur Rechercher dans les produits et leurs variations (Search in products and their variations). La valeur par défaut, Produits simples uniquement (Simple products only), ne regarde que le statut de stock propre à chaque produit, qui est celui du parent pour un produit variable.
  3. Laissez Utiliser la nouvelle base de données (Use new DB.) sur Oui (Yes) et choisissez Case à cocher (Checkbox) ou Interrupteur (Switcher) sous Affichage (View).
  4. Enregistrez, videz le cache de pages et testez : choisissez une taille que vous savez épuisée sur un produit, cochez En stock (In stock), et ce produit doit disparaître des résultats.

La vérification ne s’exécute que lorsque En stock (In stock) fait partie de la recherche et qu’au moins un attribut de produit (une taxonomie pa_ comme Taille ou Couleur) est sélectionné. Sans En stock (In stock), le filtrage par attribut reste basé sur le parent. Ce réglage coûte du travail supplémentaire à la base de données, c’est pourquoi il est désactivé par défaut ; voyez la section sur la vitesse plus bas.

Appliquer « En stock » sans case à cocher

Si les tailles épuisées ne doivent jamais correspondre, vous n’avez pas à compter sur les clients pour cocher la case. Le filtre woof_get_request_data peut ajouter la condition de stock à chaque recherche exécutée par le plugin :

/*
 * HUSKY: always search in-stock products only.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_get_request_data', function ($data) {
    $data['stock'] = 'instock';
    return $data;
});

Cela retire aussi les produits simples en rupture de stock et les produits variables entièrement épuisés de toutes les listes de produits que contrôle le filtre, comme décrit dans la FAQ sur l’affichage des seuls produits en stock. Réglez la ligne En stock (In stock) sur Non (No), afin que les clients ne voient pas une case toujours cochée.

Si les produits en rupture doivent rester visibles pendant la navigation et ne disparaître que lorsque le client filtre par un attribut, n’ajoutez la condition que lorsqu’un attribut figure dans la recherche :

/*
 * HUSKY: apply In stock only when a product attribute (pa_*) is being filtered.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_get_request_data', function ($data) {
    foreach (array_keys($data) as $key) {
        if (strpos($key, 'pa_') === 0) {
            $data['stock'] = 'instock';
            break;
        }
    }
    return $data;
});

Comment la vérification des variations décide

Avec Utiliser la nouvelle base de données (Use new DB.) sur Oui (Yes), HUSKY lit la table de recherche des attributs de produits de WooCommerce, où chaque variation a une ligne par valeur d’attribut, accompagnée d’un indicateur de stock. Pour chaque produit variable, il rassemble les variations qui portent l’une des valeurs sélectionnées, et retire le produit lorsque de telles variations existent et qu’aucune n’est en stock. Cette règle explique les résultats qui semblent étranges au premier abord :

ProduitRechercheRésultat
S en stock, M épuiséTaille M + En stockMasqué
S en stock, M épuiséTaille S ou M + En stockAffiché : S est disponible
M listé dans l’onglet Attributs (Attributes), mais aucune variation M n’existeTaille M + En stockAffiché : aucune variation M ne peut être en rupture de stock
Une variation réglée sur Toutes les tailles (Any Size), en stockTaille L + En stockAffiché : une variation Toutes les tailles (Any Size) compte pour chaque taille listée sur le produit
M / noir épuisé, M / rouge et S / noir en stockTaille M + Couleur noir + En stockAffiché : chaque valeur sélectionnée a une variation en stock
Variation M Sur commande (On backorder)Taille M + En stockAffiché : une variation sur commande compte comme disponible

La troisième ligne est un problème de données, pas un problème de filtre. Une valeur qui reste dans l’onglet Attributs (Attributes) du parent après la suppression de sa variation, ou qui n’a jamais servi pour une variation, continue de correspondre et d’être comptée. Ne gardez que les valeurs qui ont des variations, ou créez la variation et marquez-la En rupture de stock (Out of stock).

Les deux dernières lignes sont les limites de la vérification. Les valeurs d’attributs différents sont vérifiées une à une, et non comme la combinaison exacte choisie par le client ; un produit peut donc encore apparaître lorsque cette combinaison précise est épuisée. Les variations sur commande sont achetables, de sorte que En stock (In stock) les conserve ; si elles ne doivent pas correspondre non plus, ajoutez l’élément Exclude products on backorder, qui possède le même réglage Rechercher dans les produits et leurs variations (Search in products and their variations). Vérifiez aussi ce qu’un import a réellement écrit : une variation enregistrée comme Sur commande (On backorder) au lieu de En rupture de stock (Out of stock) reste dans les résultats.

Résultats toujours faux : actualiser la table de recherche WooCommerce

La table de recherche (wc_product_attributes_lookup) appartient à WooCommerce. Elle est mise à jour lorsqu’un produit ou une variation est enregistré via WooCommerce, par défaut avec un court délai : WooCommerce planifie la mise à jour comme une action en arrière-plan. La table prend du retard lorsque :

  • le stock est modifié par un import ou un outil de synchronisation qui écrit directement dans la base de données au lieu d’enregistrer les produits via WooCommerce ;
  • les actions en arrière-plan ne s’exécutent pas, par exemple parce que WP-Cron est désactivé sans cron serveur pour le remplacer. Les actions en attente avec le hook woocommerce_run_product_attribute_lookup_update_callback s’accumulent alors sous WooCommerce → Statut → Actions planifiées ;
  • une régénération complète de la table a été interrompue.

Le filtre travaille alors avec d’anciennes données de stock, et les résultats paraissent aléatoires. Pour reconstruire la table, ouvrez WooCommerce → Statut → Outils et cliquez sur Régénérer (Regenerate) à côté de Régénérer la table de recherche des attributs de produits (Regenerate the product attributes lookup table). L’opération s’exécute en arrière-plan par lots ; le bouton affiche Remplissage en cours (Filling in progress) avec un compteur jusqu’à la fin. La FAQ sur les filtres de prix et de stock qui ne fonctionnent pas traite des mêmes outils. Si le stock change souvent, envisagez WooCommerce → Réglages → Produits → Avancé → Table de recherche des attributs de produits (Product attributes lookup table) → Mises à jour directes (Direct updates), qui met la table à jour au moment où un produit est enregistré.

Pour un test, ou quand la table ne peut pas être maintenue à jour, réglez Utiliser la nouvelle base de données (Use new DB.) sur Non (No). HUSKY lit alors les variations elles-mêmes (leurs valeurs _stock_status et attribute_pa_…). C’est plus lent avec beaucoup de variations et la règle est plus stricte : un produit est retiré dès qu’une variation portant une valeur sélectionnée est en rupture de stock, si bien que « Taille S ou M » masque le T-shirt du tableau ci-dessus. Pour obtenir la même règle qu’avec la table de recherche, ajoutez :

/*
 * HUSKY, In stock with "Use new DB." = No: keep a variable product when at least
 * one variation with a selected value is in stock.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_exclude_existing_variations', '__return_true');

Compteurs qui incluent des variations en rupture de stock

Les nombres à côté des tailles proviennent des mêmes requêtes que les résultats ; ils suivent donc les mêmes règles.

  • Sans En stock (In stock) dans la recherche, le compteur de M inclut tous les produits qui ont M sur leur parent, épuisés ou non. Avec En stock (In stock) actif (coché, ou imposé par le snippet ci-dessus) et la recherche dans les variations activée, chaque taille est comptée avec la vérification des variations pour cette taille.
  • Ajoutez Recomptage dynamique (Dynamic recount) et Masquer les termes vides (Hide empty terms) (onglet Options (Options)) et une taille dont le compteur tombe à zéro disparaît du filtre : les tailles épuisées ne sont alors plus proposées du tout.
  • Si WooCommerce masque les produits en rupture de stock, gardez Tenir compte de la visibilité dans le catalogue (Listen catalog visibility) (Advanced → Options) sur Oui (Yes). Avec Non (No), les compteurs incluent aussi les produits que WooCommerce masque, et un terme peut afficher un nombre alors que ses résultats sont vides.
  • Avec Mettre en cache le nombre de recomptage dynamique pour chaque élément du filtre (Cache dynamic recount number for each item in filter) (Advanced → Options), les compteurs sont stockés et ne suivent pas les changements de stock tant que le cache n’est pas nettoyé automatiquement ou avec le bouton vider le cache (clear cache). Un cache de pages peut aussi servir d’anciens nombres.

Vitesse : le coût de la vérification des variations

Chaque recherche qui combine un attribut avec En stock (In stock) exécute des requêtes supplémentaires : deux sur la table de recherche avec Utiliser la nouvelle base de données (Use new DB.) sur Oui (Yes), ou une sur toutes les variations correspondantes avec Non (No). Avec Recomptage dynamique (Dynamic recount), la vérification s’exécute aussi pour chaque valeur qui reçoit un compteur ; un filtre de 40 tailles et couleurs la répète donc 40 fois par page. Avec des dizaines de milliers de variations, cela se remarque.

  • Gardez Utiliser la nouvelle base de données (Use new DB.) sur Oui (Yes) et la table de recherche à jour ; c’est la méthode la plus rapide.
  • Activez Mettre en cache le nombre de recomptage dynamique pour chaque élément du filtre (Cache dynamic recount number for each item in filter) et choisissez un intervalle de nettoyage automatique adapté à la vitesse à laquelle votre stock change.
  • D’autres options sont décrites dans comment accélérer le filtrage de produits dans les grands catalogues.

Le mode Turbo n’est pas un raccourci ici. Il filtre dans le navigateur du visiteur à partir d’un fichier prégénéré, et sa vérification En stock (In stock) ne regarde que le statut de stock propre à chaque produit : le réglage sur les variations n’a aucun effet, et les changements de stock n’apparaissent qu’après la reconstruction du fichier. Si les tailles épuisées ne doivent pas correspondre, gardez le mode Turbo désactivé ; ses autres limites sont listées dans le dépannage du mode Turbo.

Liste de contrôle

  • En stock (In stock) → engrenage → Rechercher dans les produits et leurs variations (Search in products and their variations) sélectionné et enregistré.
  • En stock (In stock) fait partie de la recherche : coché par le client ou imposé avec woof_get_request_data.
  • Les produits variables ne listent que les valeurs d’attribut qui ont des variations.
  • Les variations épuisées ont le statut En rupture de stock (Out of stock), et non Sur commande (On backorder).
  • La table de recherche a été régénérée après les imports, et aucune mise à jour de la table n’est bloquée dans les actions planifiées.
  • Cache de recomptage et cache de pages vidés après les changements de stock ; mode Turbo désactivé.

Si le filtre renvoie encore un produit dont la taille sélectionnée est épuisée, ouvrez un sujet sur le forum de support de HUSKY avec le lien du filtre, le produit et le statut de stock de ses variations.