Rechercher dans un tableau de produits WooCommerce par description et SKU
Le champ de recherche situé au-dessus d’un tableau de produits ne cherche que dans les titres des produits : un client qui saisit un mot de la description ne trouve donc rien. Pour rechercher dans un tableau de produits WooCommerce par description, description courte ou SKU, vous élargissez ce que ce champ recherche grâce à un attribut de shortcode, ou vous ajoutez des champs de recherche distincts au filtre du tableau. Vous trouverez ci-dessous le fonctionnement de la recherche intégrée, la manière de l’étendre et les raisons pour lesquelles un champ de recherche semble parfois ne rien faire.
Comment fonctionne la recherche intégrée d’un tableau de produits
Chaque tableau comporte un champ de recherche par titre placé au-dessus de lui. Il est contrôlé par trois lignes de l’onglet Options du tableau :
- Afficher la recherche par titre (Show search by title) : affiche ou masque le champ.
- Nombre minimal de caractères (Min symbols count) : la recherche la plus courte que le champ accepte, 3 par défaut.
- Texte indicatif de la recherche par titre (Search by title placeholder) : le texte d’indication à l’intérieur du champ.
Les mêmes réglages sont possibles pour chaque shortcode avec hide_text_search=1, text_search_min_symbols=2 et text_search_placeholder='Find a product'. La position du champ par rapport au formulaire de filtre est expliquée dans comment définir la position du filtre par titre d’article.
Trois détails de son comportement expliquent la plupart des signalements du type « la recherche ne fonctionne pas » :
- Elle recherche à la touche Entrée, pas pendant la saisie. Le tableau recharge ses lignes lorsque le client appuie sur Entrée (la touche de recherche du clavier d’un téléphone). Échap ou le petit × du champ efface la recherche.
- Une recherche trop courte est ignorée. Avec moins de caractères que Nombre minimal de caractères (Min symbols count), le champ reçoit une bordure rouge en pointillés et rien n’est envoyé. Réduisez cette valeur si vos produits ont des noms ou des codes courts.
- Elle recherche le texte tel qu’il est saisi. La recherche trouve les produits dont le titre contient le texte saisi d’un seul tenant, sans tenir compte de la casse. chemise rouge trouve « Chemise rouge, manches longues », mais pas « Chemise de couleur rouge ».
Rechercher dans le tableau de produits WooCommerce par description et extrait
Dans WooCommerce, la description longue du produit est stockée comme contenu de l’article (post_content) et la description courte comme extrait (post_excerpt). L’attribut woot_text_search_by de [woot] définit dans lesquels de ces champs le champ de recherche cherche :
[woot id=1 woot_text_search_by='post_title,post_content,post_excerpt']
Un produit est trouvé lorsque l’un des champs listés contient le texte recherché. Toute combinaison fonctionne, par exemple 'post_title,post_excerpt' pour laisser de côté les descriptions longues. Trois règles s’appliquent à la valeur :
- Séparés par des virgules, sans espaces. Chaque nom doit correspondre exactement. Avec
'post_title, post_content', le second nom commence par une espace, n’est pas reconnu et est supprimé sans avertissement : la recherche reste alors limitée aux titres. - Guillemets droits. Les éditeurs qui transforment
'en’collent le guillemet au premier et au dernier nom, et les deux sont supprimés. Si aucun nom valide ne reste, la recherche ne filtre rien et chaque recherche renvoie tous les produits. Saisissez le shortcode dans un bloc Shortcode ou dans un éditeur de code, ou omettez les guillemets :woot_text_search_by=post_title,post_content,post_excerptfonctionne aussi. - Uniquement ces trois champs.
post_title,post_contentetpost_excerptsont les seuls noms acceptés ; tout le reste est ignoré. Le SKU et les champs personnalisés se recherchent par le filtre, comme indiqué plus bas.
Le réglage s’applique aussi à l’élément Titre (Title) du formulaire de filtre du tableau, car les deux champs envoient la même recherche. Le texte trouvé dans la description n’est pas mis en évidence ; pour que les clients le voient, ajoutez la colonne Contenu (Content) ou Extrait (Excerpt).
Pour définir les champs d’un tableau partout où il apparaît, y compris pour la recherche [woot_drop_down] décrite plus bas, qui n’a pas d’attribut de ce type, ajoutez-les par du code :
/*
* Products table #1: the search field also looks in the description
* and the short description. Child theme functions.php or a code snippets plugin.
*/
add_filter('woot_review_shortcode_args', function ($args) {
if (isset($args['id']) && (int) $args['id'] === 1) {
$args['woot_text_search_by'] = 'post_title,post_content,post_excerpt';
}
return $args;
});
Champs de recherche distincts et recherche par SKU dans le filtre
Au lieu d’un seul champ pour tout, l’onglet Filtre (Filter) du tableau peut afficher des champs de texte distincts : Titre (Title), Contenu (Content), Extrait (Excerpt) et SKU. Chacun ne recherche que dans son propre champ, ils se combinent entre eux et avec les autres éléments du filtre, et, comme le champ principal, ils se déclenchent à la touche Entrée. Dans leurs options, chacun propose un Texte indicatif (Placeholder) et une Largeur (Width), et les champs titre, contenu et extrait ont aussi une Longueur minimale (Minlength).
L’élément SKU est le moyen de rechercher par SKU. Son option Logique de recherche (Search logic) permet de choisir entre LIKE (le SKU contient le texte saisi, de sorte que A12 trouve aussi A123) et EXACT (le SKU entier doit correspondre). Deux limites :
- Il recherche le SKU du produit situé dans la ligne. Dans un tableau classique, les lignes sont des produits : les SKU des variations, qui appartiennent aux enregistrements de variations, ne sont donc pas trouvés. Un tableau qui liste les variations comme des lignes, comme le décrit afficher les variations sur des lignes distinctes, les trouve.
- Les espaces et les tirets comptent. ZDUP112 ne correspond pas à ZDUP 112 ; si les clients saisissent les codes de différentes manières, conservez les SKU dans un seul format.
Un champ de recherche sur d’autres pages : [woot_drop_down]
Pour placer une recherche de produits dans l’en-tête, une barre latérale ou la page de la boutique, utilisez [woot_drop_down]. Il affiche un champ de recherche et, lorsque le client appuie sur Entrée, un tableau de résultats se déroule sous lui :
[woot_drop_down id=1 placeholder='Search products' width='100%' height=400]
id est le tableau dont les colonnes servent aux résultats, height la hauteur maximale de la liste déroulante en pixels, et skin définit l’apparence des résultats ; sans lui, ils utilisent l’apparence par défaut, et non le skin du tableau. Il recherche dans les titres, sauf si le tableau reçoit woot_text_search_by par le code ci-dessus. Des exemples de placement figurent dans comment ajouter un champ de recherche avec un tableau déroulant.
Recherche de texte avec le filtre HUSKY
Lorsque le tableau est connecté au filtre de produits HUSKY avec filter_provider='woof', comme le décrit connecter le filtre HUSKY à un tableau de produits WooCommerce, sa recherche de texte peut servir de champ de recherche. Activez Recherche par texte (Search by text) dans l’onglet Structure de HUSKY (ou placez [woof_text_filter]) et, dans ses options supplémentaires, réglez Comportement (Behavior) sur les champs à rechercher, par exemple titre ou contenu ou extrait ; +SKU ajoute le SKU au même champ. Elle se distingue utilement de la recherche propre au tableau : elle découpe le texte en mots et trouve les produits qui les contiennent tous, dans n’importe quel ordre, de sorte que rouge chemise trouve aussi « Chemise en coton rouge ». Elle offre en outre l’autocomplétion et peut rechercher dans des champs personnalisés. Utilisez-la à la place du champ propre au tableau : dès que HUSKY est le fournisseur de filtre, le tableau lui confie le filtrage et son champ de recherche par titre ne restreint plus les résultats ; désactivez donc Afficher la recherche par titre (Show search by title) pour ce tableau.
Vitesse sur les grands catalogues
Les deux recherches utilisent LIKE avec le texte au milieu d’une valeur, ce que la base de données ne peut pas résoudre à partir d’un index : chaque recherche lit les champs recherchés de tous les produits. Les titres sont courts, ce qui reste rapide même avec des milliers de produits. Les descriptions sont souvent longues, et la recherche dans post_content coûte nettement plus cher sur un grand catalogue. Ne recherchez dans les descriptions que dans les tableaux qui en ont besoin, et gardez Nombre minimal de caractères (Min symbols count) à 3 ou plus, pour qu’une ou deux lettres ne déclenchent pas une recherche dans toutes les descriptions.
Si la recherche ne fonctionne toujours pas
- Appuyez sur Entrée après la saisie et vérifiez que le texte compte au moins Nombre minimal de caractères (Min symbols count) caractères.
- Les descriptions ne sont pas recherchées : cherchez des espaces ou des guillemets typographiques dans
woot_text_search_by. - Chaque recherche renvoie tous les produits : l’attribut ne contient aucun nom de champ valide.
- Le shortcode contient
mode='json'oumode='to_json': ces tableaux chargent toutes les lignes d’un coup et les recherchent dans le navigateur, par titre uniquement et sans formulaire de filtre, si bien quewoot_text_search_byest sans effet. Supprimez l’attribut pour rechercher côté serveur. - Le champ est absent : Afficher la recherche par titre (Show search by title) est désactivé, ou le shortcode contient
hide_text_search=1.
Si rien de tout cela n’aide, ouvrez un sujet sur le forum d’assistance WOOT avec un lien vers la page et le shortcode que vous utilisez.