Filtrer les produits WooCommerce par champ ACF : types, réglages, solutions
Avec HUSKY, vous pouvez filtrer les produits WooCommerce par valeurs de champs ACF, mais seulement lorsque le champ stocke sa valeur sous une forme qu’une requête de base de données peut comparer. Les champs à valeur unique (Select, Radio Button, True / False, Number, Text, Date Picker) se filtrent sans problème. Les champs Checkbox et les champs Select dont l’option Select Multiple est activée n’apparaissent jamais dans le filtre, ou affichent des options qui ne trouvent toujours aucun produit. Voici comment HUSKY lit les données ACF, quels types de champs fonctionnent, comment configurer chacun d’eux, et que faire des champs à valeurs multiples.
Deux façons dont HUSKY lit les champs ACF
ACF enregistre chaque champ comme une métadonnée de produit ordinaire : une ligne dans la table wp_postmeta, sous le Nom du champ (Field Name), contenant la valeur enregistrée. HUSKY intègre deux extensions qui filtrent à partir de telles lignes. Toutes deux sont des extensions système, toujours actives : il n’y a donc rien à activer.
- L’extension ACF (Champs ACF (ACF fields)) trouve automatiquement vos groupes de champs ACF et liste leurs champs Select, Radio Button et True / False dans l’onglet Structure (Structure) sous la forme Libellé du champ (Titre du groupe) (Field label (Group title)). Réglez la liste déroulante à côté d’un champ sur Oui (Yes), enregistrez, et le champ fait partie du filtre. Les autres types de champs ne sont pas listés du tout. Les détails se trouvent sur la page de l’extension ACF.
- L’onglet Données méta (extension Filtre méta (Meta filter)) fonctionne avec n’importe quelle clé méta, ACF ou non. Vous ajoutez vous-même la clé et choisissez comment elle est affichée : Curseur (Slider), Recherche par texte (Search by text), Case à cocher (Checkbox), Liste déroulante (Drop-down), Liste déroulante multiple (Multi Drop-down) ou Sélecteur de date (Datepicker), ainsi que le type de données qu’elle contient : nombre (number), chaîne (string) ou date (date). Voir filtrer par champs méta.
L’extension ACF est plus rapide à configurer, mais elle obéit à trois règles qui expliquent la plupart des signalements « le champ est absent » et « 0 produit » :
- Le groupe de champs doit être affecté par type de contenu. HUSKY ne prend en compte que les groupes dont les règles d’Emplacement (Location) contiennent Le type de publication est égal à Produit (Post Type is equal to Product). Un groupe affiché uniquement par une règle telle que la catégorie de produits est ignoré, et ses champs n’arrivent jamais dans l’onglet Structure (Structure).
- La valeur de chaque choix doit correspondre à son libellé. Dans ACF, un choix écrit
xl : Extra largeenregistrexlsur le produit, mais l’extension ACF recherche le libellé,Extra large, et ne trouve rien. Les choix écrits avec un seul mot par ligne (la valeur et le libellé sont identiques), ou qui ne diffèrent que par la casse, commered : Red, fonctionnent. Les libellés qui contiennent des guillemets ne correspondent jamais. - Select Multiple doit être désactivé. Un champ Select dont l’option Select Multiple est activée est toujours listé, mais ne trouve aucun produit, pour la raison expliquée plus bas.
Si un champ enfreint l’une de ces règles, filtrez-le plutôt par l’onglet Données méta, où vous maîtrisez la clé et les valeurs exactes.
Quels types de champs ACF peuvent être filtrés
| Type de champ ACF | Ce qui est enregistré sur le produit | Comment le filtrer dans HUSKY |
|---|---|---|
| Select (valeur unique), Radio Button | La valeur d’un choix | Extension ACF, ou Données méta Liste déroulante (Drop-down) / Liste déroulante multiple (Multi Drop-down) |
| Button Group | La valeur d’un choix | Données méta Liste déroulante (Drop-down) / Liste déroulante multiple (Multi Drop-down) |
| True / False | 1 ou 0 | Extension ACF, ou Données méta Case à cocher (Checkbox) |
| Number, Range | Un nombre | Données méta Curseur (Slider), type nombre (number) |
| Text, Email, URL | Une chaîne de caractères | Données méta Recherche par texte (Search by text), ou Liste déroulante (Drop-down) avec les valeurs listées |
| Date Picker | Une date sous la forme 20250131 (Ymd) | Données méta Sélecteur de date (Datepicker) plus un hook (voir plus bas) |
| Checkbox, Select avec Select Multiple, Relationship / Post Object / Taxonomy à valeurs multiples | Un tableau sérialisé | Pas avec une comparaison normale ; voir les deux solutions ci-dessous |
| Repeater, Flexible Content | Des lignes numérotées telles que specs_0_width | Ne se filtre pas comme un champ unique |
Les champs d’un champ Group sont enregistrés sous groupname_fieldname et se filtrent comme leur propre type. Un Date Time Picker enregistre un texte tel que 2025-01-31 14:00:00, que le filtre Sélecteur de date ne peut pas comparer.
Pourquoi les champs Checkbox et à sélection multiple ne trouvent rien
Lorsqu’un champ peut contenir plusieurs valeurs, ACF les regroupe dans une seule chaîne au format sérialisé de PHP. Une voiture dotée de la climatisation et de sièges chauffants reçoit une ligne de métadonnées comme celle-ci :
a:2:{i:0;s:2:"ac";i:1;s:12:"heated_seats";}
L’extension ACF et les affichages Liste déroulante, Liste déroulante multiple et Case à cocher demandent à la base de données les lignes dont la valeur est égale à (equals) l’option sélectionnée. ac n’est pas égal à cette chaîne entière : le résultat est donc 0. Désactiver Select Multiple dans ACF ne répare pas les produits existants : leurs valeurs restent sérialisées tant que chaque produit n’a pas été enregistré à nouveau avec une valeur unique.
Configurer un champ ACF dans l’onglet Données méta
- Trouvez la véritable clé méta. C’est le Nom du champ (Field Name) dans ACF (par exemple
body_type), et non son libellé. Dans l’onglet Données méta (Meta Data), Obtenir les clés de n’importe quel produit à partir de son ID (Get keys from any product by its ID) liste toutes les clés d’un produit. Chaque champ ACF apparaît deux fois :body_typecontient la valeur,_body_typecontient la référence interne du champ pour ACF. Utilisez la clé sans le trait de soulignement. Les clés sont sensibles à la casse et ne contiennent jamais d’espaces ni de crochets. - Ajoutez la clé avec Ajouter une clé personnalisée à la main (Add Custom key by hands) ou depuis la liste, saisissez un titre, et choisissez l’affichage et le type. Pour des valeurs textuelles, choisissez chaîne (string). Avec nombre (number), MySQL convertit un texte tel que
Coupeen 0 avant la comparaison, et le filtre renvoie tous les produits qui possèdent la clé, ce qui donne l’impression que « le filtre ne fait rien ». - Listez les options pour Liste déroulante (Drop-down) et Liste déroulante multiple (Multi Drop-down). Un champ méta est un texte libre : HUSKY ne peut donc pas construire lui-même la liste des valeurs ; vous l’écrivez, séparée par des virgules. Utilisez
titre^valeurlorsque le titre visible diffère de la valeur enregistrée. Pour les choix ACFcoupe : Coupeetsuv : SUV / Crossover, cela donne :
La partie aprèsCoupe^coupe,SUV / Crossover^suv^doit être exactement ce qu’ACF a enregistré, la valeur du choix, et non son libellé. - Enregistrez, ouvrez l’onglet Structure (Structure), réglez le nouvel élément sur Oui (Yes), faites-le glisser à sa place et enregistrez de nouveau. L’icône en forme de roue dentée à côté contient les options propres à l’affichage, par exemple Option de recherche (Search option) et Valeur de recherche (Search value) pour une Case à cocher, ou Condition de recherche textuelle (Text search conditional) (LIKE (LIKE) ou EXACT (EXACT)) pour Recherche par texte (Search by text).
Une Case à cocher (Checkbox) est une case unique pour une clé. Elle trouve les produits dont la valeur est 1 (champs True / False), une autre Valeur de recherche (Search value) telle que yes ou, avec Option de recherche (Search option) réglée sur La valeur existe (Value exists), tous les produits dont le champ est renseigné.
Si une valeur enregistrée contient elle-même une virgule, changez le séparateur de toutes les listes Liste déroulante et Liste déroulante multiple, puis réécrivez les listes avec | :
/*
* HUSKY: separate meta filter options with | instead of a comma.
* Child theme functions.php or a code snippets plugin.
* Example list afterwards: Wood, oak|Wood, pine|Metal
*/
add_filter( 'woof_meta_options_separator', function ( $separator ) {
return '|';
} );
Les champs Number et Range ont leur place dans un Curseur (Slider) ; les plages, les pas et les décimales sont traités dans les filtres à curseur de plage pour les attributs et les champs méta.
Filtrer par un champ de date ACF
Le filtre Sélecteur de date compare par défaut des horodatages Unix, alors que le Date Picker d’ACF enregistre les dates sous la forme 20250131. Le hook woof_meta_use_acf_dateformat fait en sorte que le filtre convertisse les dates choisies dans le même format avant la recherche :
/*
* HUSKY: Datepicker meta filters search ACF Date Picker values (Ymd).
* Child theme functions.php or a code snippets plugin.
*/
add_filter( 'woof_meta_use_acf_dateformat', '__return_true' );
Ajoutez la clé ACF dans l’onglet Données méta avec l’affichage Sélecteur de date (Datepicker) et conservez le type nombre (number) : les dates converties sont comparées comme des nombres, et le type date (date) ne produit pas ici de dates exploitables. Le hook s’applique à chaque filtre Sélecteur de date du site ; tous doivent donc pointer vers des champs ACF Date Picker. Pour une période de validité (du / au), ajoutez les champs de début et de fin comme deux filtres distincts.
Champs Checkbox et à sélection multiple : deux solutions
Recommandé : déplacer les valeurs vers une taxonomie
Les données à plusieurs valeurs par produit sont précisément ce pour quoi les taxonomies existent. Avec une taxonomie, vous obtenez une case à cocher pour chaque valeur, des compteurs, une logique AND ou OR entre les valeurs sélectionnées et la prise en charge du mode Turbo, ce qu’un champ méta ne peut pas offrir. Vous n’avez pas à renoncer à ACF pour la saisie :
- Créez une taxonomie de produits, par exemple Équipement (Equipment), sous forme de taxonomie personnalisée ou d’attribut global sous Produits → Attributs (Products → Attributes).
- Dans ACF, remplacez le champ Checkbox par un champ Taxonomie (Taxonomy) qui pointe vers elle, avec Enregistrer les termes (Save Terms) et Charger les termes (Load Terms) activés. ACF attribue alors les termes choisis au produit au lieu de stocker un tableau.
- Les produits reçoivent leurs termes lorsqu’ils sont enregistrés à nouveau ; pour un grand catalogue, faites-le en masse. La taxonomie apparaît ensuite dans l’onglet Structure (Structure) de HUSKY comme n’importe quelle autre.
Conserver le champ : rechercher dans le tableau stocké
Si le champ doit rester tel quel, la comparaison peut être modifiée. L’extrait ci-dessous transforme la condition « égal à » de HUSKY, pour les clés listées, en une recherche LIKE de la valeur entre guillemets : ac devient LIKE '%"ac"%' et correspond à l’élément à l’intérieur de la chaîne sérialisée, mais pas à ac_rear. Il corrige aussi les compteurs d’options.
/*
* HUSKY: Drop-down / Multi Drop-down meta filters for ACF Checkbox
* and Select Multiple fields (values stored as serialized arrays).
* Child theme functions.php or a code snippets plugin.
*/
function my_husky_serialized_keys() {
return array( 'equipment' ); // ACF field names
}
function my_husky_match_serialized( $meta_query ) {
if ( ! is_array( $meta_query ) ) {
return $meta_query;
}
foreach ( $meta_query as $i => $clause ) {
if ( ! is_array( $clause ) ) {
continue;
}
if ( isset( $clause['key'], $clause['value'], $clause['compare'] )
&& '=' === $clause['compare']
&& is_scalar( $clause['value'] )
&& in_array( $clause['key'], my_husky_serialized_keys(), true ) ) {
$meta_query[ $i ]['compare'] = 'LIKE';
$meta_query[ $i ]['value'] = '"' . $clause['value'] . '"';
$meta_query[ $i ]['type'] = 'CHAR';
} else {
$meta_query[ $i ] = my_husky_match_serialized( $clause );
}
}
return $meta_query;
}
// Products found by the filter
add_filter( 'woof_get_meta_query', 'my_husky_match_serialized', 100 );
// Counts next to the options (Show count + Dynamic recount)
add_filter( 'woof_dynamic_count_attr', function ( $args ) {
if ( isset( $args['meta_query'] ) ) {
$args['meta_query'] = my_husky_match_serialized( $args['meta_query'] );
}
return $args;
}, 100 );
Ajoutez ensuite equipment dans l’onglet Données méta comme Liste déroulante (Drop-down) ou Liste déroulante multiple (Multi Drop-down), de type chaîne (string), avec les valeurs de choix ACF après ^, par exemple Air conditioning^ac,Heated seats^heated_seats. Connaissez les limites : une Liste déroulante multiple trouve les produits qui ont l’une quelconque (any) des valeurs sélectionnées, et non toutes ; une recherche LIKE '%…%' ne peut pas utiliser d’index de base de données et devient plus lente sur de grands catalogues ; et l’extrait ne s’applique pas en mode Turbo. Plus d’informations sur le hook sur la page woof_get_meta_query.
Variations, mode Turbo et grilles de produits personnalisées
- Les valeurs des variations ne sont pas recherchées. La requête de la boutique renvoie les produits parents et vérifie les métadonnées du parent lui-même. Les attributs fonctionnent pour les variations parce que le parent porte tous les termes de ses variations ; ce n’est pas le cas des valeurs méta. Placez la valeur sur le produit parent.
- Le mode Turbo filtre dans le navigateur à partir de son propre fichier de données, qui n’inclut que les clés ajoutées dans l’onglet Données méta. Les champs affichés par l’extension ACF, et les hooks PHP tels que les extraits ci-dessus, n’y sont pas utilisés. Voir le dépannage du mode Turbo.
- L’URL change mais tous les produits sont toujours affichés. Le problème ne vient alors pas du champ : la grille du constructeur de pages ou le modèle personnalisé exécute sa propre requête et ignore tous les filtres. La solution se trouve dans l’URL du filtre change mais les produits ne sont pas filtrés.
Si le filtre ACF ne trouve toujours aucun produit
- Vérifiez ce qui est réellement enregistré. Dans phpMyAdmin ou un outil similaire, exécutez
SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = 123avec l’ID d’un produit (et le préfixe de vos tables). Une valeur qui commence para:est un tableau sérialisé ; une clé différente de celle attendue signifie qu’ACF enregistre sous un autre nom. - Onglet Données méta : la clé sans trait de soulignement initial, avec la même casse ; type chaîne (string) pour du texte ; la valeur de choix enregistrée après
^. - Pour l’extension ACF : l’emplacement du groupe est Le type de publication est égal à Produit (Post Type is equal to Product), les valeurs de choix correspondent à leurs libellés, Select Multiple est désactivé et les produits ont été enregistrés à nouveau après la modification.
- La valeur se trouve sur le produit parent, et non sur les variations.
- Un filtre de taxonomie fonctionne sur la même page. Si ce n’est pas le cas, corrigez d’abord la grille de produits.
Si tous les points sont corrects et que le filtre ne trouve toujours rien, ouvrez un sujet sur le forum d’assistance HUSKY en indiquant le type et les réglages du champ, la clé méta et un exemple de valeur enregistrée, et nous nous pencherons dessus.