Filtres WooCommerce qui ne fonctionnent pas : quatre symptômes, quatre causes

D’où le filtre tire ses données

Un filtre de boutique affiche les valeurs des attributs, c’est-à-dire des caractéristiques comme la couleur, la taille ou la matière. WooCommerce a deux sortes d’attributs, et ce sont elles qui décident si le filtre voit quelque chose.

La documentation WooCommerce sur les catégories, étiquettes et attributs explique que les attributs servent à filtrer les produits et à construire les variations. La documentation du bloc de filtre par attribut de l’extension de recherche le dit encore plus clairement : le bloc de filtre par attribut ne prend en charge que les attributs globaux.

Symptôme 1 : le filtre n’affiche aucun produit

Un client clique sur « Rouge » et voit une liste vide, alors que la boutique a des produits rouges.

Cause : la couleur des produits rouges est saisie comme attribut personnalisé ou dans la description, et non comme terme d’un attribut global. Le filtre cherche les produits rattachés au terme « Rouge » de la liste globale et n’en trouve aucun.

Vérifiez l’onglet Attributs d’un de ces produits. Un attribut global a un nom tiré de la liste et des termes choisis dans un menu déroulant. Un attribut personnalisé a un champ texte avec des valeurs séparées par une barre verticale.

Symptôme 2 : une valeur ou tout un attribut manque dans le filtre

Vous avez cinq couleurs, et le filtre en affiche trois. Ou il n’y a pas de filtre par taille du tout.

Il y a en général trois causes. Certains produits ont un attribut personnalisé au lieu d’un attribut global. Le terme existe dans la liste, mais aucun produit publié et en stock ne l’a : le filtre le masque donc. Ou le bloc de filtre a été réglé sur un seul attribut. Dans les thèmes à blocs, vous réglez les blocs de filtres dans Apparence → Éditeur, dans le modèle du catalogue, et la documentation du bloc de filtres de produits décrit leur fonctionnement.

Symptôme 3 : les mêmes valeurs apparaissent deux fois

Le filtre affiche « Noir », « noir » et « Nior ». Ou « XL » et « xl ». Chacune mène à un autre ensemble de produits.

Cause : des imports depuis plusieurs fichiers, ou des valeurs ajoutées à la main. Pour WooCommerce, ce sont des termes distincts. La solution consiste à en choisir un, à y rattacher tous les produits, et seulement ensuite à supprimer celui qui est vide. L’ordre compte, car supprimer un terme qui a encore des produits le détache de ces produits.

Un import CSV permet aussi de créer facilement un attribut personnalisé au lieu d’un attribut global. Le guide de Barn2 sur l’import d’attributs explique comment l’éviter.

Symptôme 4 : le filtre affiche des résultats faux ou périmés

Le filtre affiche un produit qu’il ne devrait pas, une taille épuisée, ou l’état d’il y a quelques jours.

Les causes sont techniques :

• le cache d’une extension de cache ou de l’extension de filtres elle-même,
• la table de recherche des attributs de WooCommerce, qui peut prendre du retard après un import ; dans les versions récentes, vous la régénérez dans WooCommerce → État → Outils,
• une extension de filtres qui regarde les attributs du produit et non le stock d’une variation précise,
• un conflit entre deux extensions de filtres, ou entre une extension de filtres et une extension de recherche.

Ici, ce sont les réglages et la documentation de l’extension de filtres qui tranchent. La présentation de Themeisle traite aussi des blocs de filtres intégrés et de leurs limites.

Un attribut pour les filtres, pour la description ou pour les variations

Chaque attribut de la page produit a deux cases à cocher, et toutes deux agissent sur ce que voit le client.

« Visible sur la page produit » affiche l’attribut dans l’onglet d’informations complémentaires. Cela n’agit pas sur le filtre, mais aide les clients à comparer les produits.

« Utilisé pour les variations » fait de l’attribut la base des variations, par exemple les tailles d’un sweat. Un tel attribut peut tout de même fonctionner dans le filtre s’il est global. Mais le filtre et le stock commencent alors à dépendre l’un de l’autre : un produit dont le XL est épuisé peut apparaître quand on choisit XL, selon l’extension de filtres.

Une bonne règle : gardez comme attributs globaux les caractéristiques selon lesquelles les clients choisissent, comme la couleur, la taille, la matière ou la marque. Les détails descriptifs propres à un seul produit peuvent rester personnalisés ou aller dans la description. Réservez les catégories et les étiquettes aux groupes de produits, pas aux couleurs ni aux tailles.

Comment remettre les attributs en ordre pas à pas

Un ordre qui évite de perdre des données :

1. Listez les attributs globaux dans Produits → Attributs, avec leurs termes.
2. Trouvez les produits aux attributs personnalisés qui devraient être globaux.
3. Trouvez les termes en double et choisissez celui qui reste.
4. Rattachez les produits aux bons termes globaux, en commençant par une catégorie.
5. Vérifiez le filtre de cette catégorie dans une fenêtre de navigation privée.
6. Supprimez les termes en double devenus vides.
7. Videz le cache et vérifiez les filtres des autres catégories.

Avec quelques produits, vous le faites dans l’administration. Avec quelques centaines, cela représente de nombreuses soirées à ouvrir les produits un par un.

Comment le chat vous aide

L’extension TellMyShop pour WordPress et WooCommerce lit la liste des attributs et de leurs termes ainsi que les données des produits, même dans la version gratuite TellMyShop Free. Votre chat (Claude ou ChatGPT) trouve les produits sans attributs, avec des attributs personnalisés au lieu d’attributs globaux, et avec des termes en double, puis prépare un plan de remise en ordre.

Dans TellMyShop Pro, le chat règle les attributs des produits dès l’activation de la licence, sans interrupteur, par lots de 50 produits au maximum. Chaque lot a un aperçu, l’enregistrement se fait après votre accord, et l’historique des modifications vous permet d’annuler chaque modification. Un exemple de conversation, avec des valeurs d’exemple :