Connecter le filtre HUSKY à un tableau de produits WooCommerce
Le filtre intégré à un tableau de produits couvre l’essentiel : prix, UGS (SKU), stock, catégories et attributs. Lorsque vos clients ont besoin de filtres qui dépendent les uns des autres, d’options limitées à ce qui est réellement disponible, ou d’un lien vers le résultat filtré, connectez un tableau de produits WooCommerce au filtre HUSKY (WooCommerce Products Filter, aussi connu sous le nom de WOOF). Le tableau affiche alors exactement les produits que trouve HUSKY, avec ses propres colonnes, son tri et sa pagination. Voici comment fonctionne la connexion, les deux shortcodes qu’elle utilise, et comment en tirer des filtres dépendants et des URL de filtre partageables.
Ce que le filtre intégré au tableau ne fait pas
L’onglet Filtre (Filter) d’un tableau construit un filtre AJAX rapide, qui suffit pour de nombreux tableaux. Il a des limites volontaires :
- Pas d’options dépendantes. Chaque élément liste tous les termes non vides de sa taxonomie dans l’ensemble de la boutique. Choisir Produit A dans une liste déroulante ne réduit pas les tailles proposées dans la suivante.
- Pas de compteurs, pas de masquage des impasses. Un client peut choisir une combinaison qui ne renvoie rien, et ne l’apprend qu’en voyant le tableau vide.
- Pas d’état du filtre dans l’URL. Le filtre agit à l’intérieur de la page ; une vue filtrée ne peut donc être ni mise en favori ni envoyée à quelqu’un.
- Des contrôles simples. Les noms de termes longs sont tronqués dans une liste à sélection multiple étroite, et il n’y a ni pastilles de couleur, ni images, ni formulaires par étapes.
HUSKY fait tout cela. C’est un plugin distinct de la même équipe, disponible sur wordpress.org, et le tableau dispose d’une connexion prête à l’emploi pour lui.
Connecter le filtre HUSKY à un tableau de produits WooCommerce
Lorsqu’un tableau a filter_provider='woof', chaque requête de ses lignes transmet à HUSKY les paramètres HUSKY actuels, HUSKY calcule les ID des produits correspondants, et le tableau n’affiche que ces produits, en gardant ses propres colonnes, son tri et sa pagination. La connexion est intégrée au plugin de tableaux ; il n’y a donc rien à ajouter dans functions.php ; le code de la page woot_filter_provider_ correspond au même mécanisme, à titre de référence.
- Installez et activez HUSKY. Dans WooCommerce → Réglages (Settings) → Filtre de produits (Products Filter), sous l’onglet Structure, activez les taxonomies et les éléments que le filtre doit proposer (catégories, attributs, prix, etc.) et enregistrez.
- Placez le filtre et le tableau sur la même page :
Remplacez[woof ajax_redraw=1 autosubmit=1 redirect="https://example.com/price-list/"] [woot id=1 filter_provider='woof']1par l’ID de votre tableau et l’adresse par celle de cette même page. L’attributredirectest important : sur une page ordinaire (tout sauf une archive de catégorie, d’étiquette ou d’attribut de produit), HUSKY construit ses liens de recherche sur la page boutique ; sans lui, une recherche peut donc envoyer le client vers la boutique, où le tableau n’est pas présent. Le filtre peut aussi se placer dans un widget de barre latérale de cette page ; le widget HUSKY propose les mêmes réglages sous Rediriger vers (Redirect to) et Redessin AJAX du formulaire (Form AJAX redrawing). - Vérifiez les guillemets. Saisissez les shortcodes dans un éditeur de code ou dans un bloc Shortcode. Les traitements de texte et certains éditeurs transforment
'woof'en’woof’avec des guillemets typographiques ; la valeur de l’attribut ne vaut alors pluswoof, et le tableau ignore le filtre sans aucune erreur. Vous pouvez aussi supprimer les guillemets :filter_provider=wooffonctionne. - Désactivez le filtre et la recherche propres au tableau. Avec
filter_provider='woof', le tableau confie le filtrage à HUSKY, et la plupart des éléments de son propre onglet Filtre, ainsi que son champ Recherche par titre (search by title), cessent de restreindre les résultats. Laissez l’onglet Filtre vide ou activez Désactiver le formulaire de filtre (Disable filter form) dans les Options du tableau, désactivez-y Afficher la recherche par titre (Show search by title), et utilisez à la place la recherche textuelle de HUSKY, comme décrit dans la recherche dans un tableau de produits par description.
Avec ou sans rechargement de page
L’attribut ajax_redraw=1 détermine la manière dont la page réagit à un changement de filtre.
[woof ajax_redraw=1 autosubmit=1]: sans rechargement. À chaque changement, HUSKY ne redessine que son formulaire, avec les compteurs mis à jour, et l’annonce par un événement JavaScript ; le tableau écoute cet événement et recharge ses lignes avec le nouveau filtre. Après le premier changement, le tableau masque le bouton Filtrer (Filter) de HUSKY, puisqu’il se met à jour tout seul. Pour masquer le bouton dès le départ, ajoutez.woof[data-ajax-redraw="1"] .woof_submit_search_form { display: none; }au CSS personnalisé de votre thème.[woof redirect="..."]sansajax_redraw: avec rechargement. Chaque changement (ou le bouton Filtrer (Filter), si l’envoi automatique est désactivé) recharge la page avec le filtre dans l’URL, et le tableau le lit au chargement. L’usage est plus lent, mais la barre d’adresse contient toujours le filtre actuel.
D’anciennes instructions utilisent [woof is_ajax=1]. is_ajax est un attribut de [woof_products] et non de [woof], qui l’ignore ; cette combinaison fonctionne donc en mode rechargement. N’ajoutez pas [woof_products] à la page du tableau : il afficherait une seconde liste de produits classique sous le tableau.
Des filtres dépendants qui n’affichent que les options disponibles
Les filtres dépendants sont une fonctionnalité de HUSKY appelée Recomptage dynamique (Dynamic recount). Lorsqu’un client sélectionne une valeur dans une section, HUSKY recalcule toutes les autres sections pour les produits restants, de sorte que les options sans résultat disparaissent. Dans WooCommerce → Réglages (Settings) → Filtre de produits (Products Filter) → Options :
- Afficher le compteur (Show count) : Oui. Le recomptage s’appuie sur les compteurs.
- Recomptage dynamique (Dynamic recount) : Oui. Les compteurs suivent la sélection en cours.
- Masquer les termes vides (Hide empty terms) : Oui. Les options dont le compteur vaut 0 sont masquées au lieu d’être affichées en grisé.
Choisissez Produit A, et la section des tailles n’affiche que Small et Medium si c’est tout ce que propose le Produit A. Avec ajax_redraw=1, cela se produit sur place ; en mode rechargement, après le rechargement.
Deux réglages voisins méritent d’être connus. Des sections différentes se restreignent toujours mutuellement : une couleur et une taille doivent correspondre toutes les deux. Au sein d’une même section, deux cases cochées signifient par défaut l’une ou l’autre ; pour exiger les deux termes sur un même produit, ouvrez les options supplémentaires de cette taxonomie sous l’onglet Structure et réglez Logique de filtrage (Logic of filtering) sur AND. Pour une sélection guidée, où le client répond à une question à la fois (couleur de base, puis nom de la couleur, puis style), HUSKY propose une extension de filtre par étapes avec le shortcode [woof_step] ; activez-la sous l’onglet Extensions et consultez sa documentation sur le site de HUSKY.
Des URL partageables avec les filtres actuels
HUSKY conserve le filtre dans des paramètres d’URL : l’indicateur de recherche swoof=1 plus un paramètre par section, par exemple :
https://example.com/price-list/?swoof=1&product_cat=shirts&pa_color=red,blue
Un tableau avec filter_provider='woof' lit ces paramètres au chargement de la page ; le lien ouvre donc le tableau déjà filtré, avec les mêmes options cochées dans le formulaire HUSKY. C’est ainsi que vous pouvez partager un tableau filtré avec un client, le glisser dans une newsletter ou relier un élément de menu à une sélection prête à l’emploi.
En mode rechargement, la barre d’adresse contient toujours le lien actuel, prêt à être copié. En mode sans rechargement, la barre d’adresse n’est pas mise à jour de façon fiable à chaque changement ; si les liens partageables comptent plus que d’éviter les rechargements, utilisez donc [woof] sans ajax_redraw. Un lien peut aussi être construit à la main à partir des slugs des termes, affichés sous Produits → Catégories et Produits → Attributs.
Autres plugins de filtre : le sélecteur du conteneur de produits et le hook
De nombreux plugins de filtre demandent un « conteneur de produits » ou un « sélecteur de la liste de produits », ul.products par défaut, et en remplacent le contenu après le filtrage. Dans un tableau de produits, les lignes se trouvent dans .woot-table tbody, une ligne par produit. Saisir ce sélecteur ne suffit toutefois généralement pas : un tel plugin place son propre balisage de produits, les cartes de la boucle de la boutique, dans le corps du tableau au lieu de lignes de tableau, et les colonnes, le tri et la pagination du tableau ne correspondent plus à ce qui est affiché.
Une connexion qui fonctionne transmet les résultats du filtre à la requête propre du tableau. Le tableau appelle le filtre woot_filter_provider_{name} pour chaque tableau avec filter_provider='{name}', avec les arguments de la requête, les données du filtre et les arguments du shortcode, et le plugin restreint la requête, généralement en définissant post__in avec les ID que son filtre a trouvés. La page woot_filter_provider_ présente l’adaptation complète pour HUSKY comme modèle, et le hook woot_wp_query_args couvre les cas plus simples où un tableau n’a besoin que d’une sélection fixe. Le plugin de filtre doit aussi indiquer au tableau quand se redessiner, comme HUSKY le fait avec son événement ; cette partie relève de son développeur.
Liste de vérification pour le dépannage
- Le tableau ignore le filtre : cherchez des guillemets typographiques autour de
woofdans le shortcode, et vérifiez que HUSKY est actif. - Un changement de filtre ouvre la page boutique : ajoutez
redirectavec l’adresse de la page du tableau à[woof]. - Le filtre n’a aucun élément : aucune taxonomie ni aucun élément n’est activé sous l’onglet Structure de HUSKY.
- Rien ne se passe après un changement en mode sans rechargement : l’attribut doit être exactement
ajax_redraw=1, et la console du navigateur ne doit contenir aucune erreur JavaScript. Excluez les scripts des deux plugins des options de report et de regroupement du JavaScript des plugins d’optimisation. - Le filtre est absent de la page : si Initialiser le plugin uniquement sur les pages suivantes du site (Init plugin on the next site pages only) est utilisé sous l’onglet Avancé (Advanced) de HUSKY, ajoutez la page du tableau à sa liste.
- Le tableau affiche les bons produits mais les options ne disparaissent pas : Afficher le compteur (Show count), Recomptage dynamique (Dynamic recount) et Masquer les termes vides (Hide empty terms) doivent tous être réglés sur Oui.
- Une seconde liste de produits apparaît sous le tableau : retirez
[woof_products]de la page.
Si le tableau et le filtre ne fonctionnent toujours pas ensemble, ouvrez un sujet sur le forum d’assistance WOOT en joignant un lien vers la page.