HUSKY - WooCommerce Product Filter Professional

Filtre année marque modèle WooCommerce avec listes déroulantes dépendantes

Un filtre WooCommerce année marque modèle demande d’abord la marque, propose ensuite uniquement les modèles de cette marque, puis uniquement les années de ce modèle, et affiche les pièces compatibles. HUSKY le construit avec le type de filtre Liste déroulante hiérarchique (Hierarchy drop-down). Son bon fonctionnement dépend moins des réglages que de la manière dont les données des véhicules sont stockées : les listes déroulantes ne peuvent suivre qu’une structure parent-enfant qui existe déjà dans une seule taxonomie. Vous trouverez ci-dessous le fonctionnement des listes déroulantes dépendantes, la façon de structurer les données, la configuration, et les points à vérifier lorsque la deuxième liste reste vide.

Comment fonctionne un filtre année marque modèle dans HUSKY

La Liste déroulante hiérarchique lit une taxonomie hiérarchique, de la même nature que l’arborescence des catégories de produits. La première liste affiche les termes de premier niveau (les marques). Lorsque le visiteur choisit Audi, le formulaire est redessiné et la deuxième liste affiche les enfants d’Audi (ses modèles), puis les enfants du modèle choisi (ses années), aussi loin que descend l’arborescence.

La dépendance vient de l’arborescence elle-même, et non des produits. Après Audi, la deuxième liste montre les modèles d’Audi et rien d’autre, même si certaines pièces conviennent aussi à une BMW. C’est exactement ce qu’il faut à un sélecteur de véhicule, et cela a trois conséquences :

  • La marque, le modèle et l’année doivent être des niveaux de la même taxonomie. Une taxonomie de marques et une taxonomie de modèles ne peuvent pas être chaînées, pas plus que les catégories de produits et les étiquettes.
  • Les attributs de produit (pa_make, pa_model) ne peuvent pas être chaînés, car les attributs WooCommerce n’ont pas de termes parents et enfants.
  • Les champs personnalisés (champs ACF, valeurs de métadonnées issues d’un import) ne peuvent pas être utilisés, car ce type ne fonctionne qu’avec des termes de taxonomie.

Chaque choix remplace le précédent dans la recherche : après Audi → A4 → 2015, la recherche ne contient que le dernier terme, par exemple vehicle=2015-a4. Sur la page de résultats, le plugin reconstruit toute la chaîne à partir de ce terme, si bien que les listes affichent de nouveau Audi, A4 et 2015.

Structurez d’abord les données des véhicules

Catégories de produits ou taxonomie distincte

Vous pouvez construire l’arborescence dans les catégories de produits (Marque → Modèle → Année), et cela fonctionne. Dans une boutique de pièces détachées, cependant, les catégories décrivent en général la pièce (freins, filtres, éclairage) et les visiteurs veulent filtrer selon les deux. Créez alors une taxonomie hiérarchique distincte pour les produits, par exemple Véhicules (Vehicles), avec Custom Post Type UI ou votre propre code. Créer une taxonomie personnalisée en détaille les étapes ; l’essentiel est de régler Hiérarchique (Hierarchical) sur vrai et de la rattacher aux produits.

Une branche par modèle

Choisissez l’ordre dans lequel pensent vos clients ; Marque → Modèle → Année est le plus courant. Chaque modèle a ses propres termes d’année, de sorte que le terme 2015 existe une fois sous A4 et une fois sous Golf. C’est correct : WordPress autorise le même nom sous des parents différents et rend le second slug unique en ajoutant le slug du parent (par exemple 2015-a4). Pour les plages d’années, nommez un terme « 2012–2016 » et gardez un slug tel que 2012-2016. Si vous utilisez l’extension de requête d’URL SEO, évitez -and-, -or- et -to- à l’intérieur des slugs : le plugin les utilise comme séparateurs dans les URL de filtre.

Affectez les produits à chaque véhicule compatible

Une pièce qui convient à l’Audi A3 2012–2016 et à la BMW X5 2016–2018 est affectée aux deux termes d’année. Avec la logique OU (OR) par défaut, il suffit d’affecter uniquement le dernier niveau : lorsqu’un visiteur n’a choisi que la marque, WordPress inclut les termes enfants dans la recherche. Si vous réglez Logique de filtrage (Logic of filtering) sur ET (AND) pour cette taxonomie, le plugin cesse d’inclure les termes enfants, et le produit doit aussi être affecté à la marque et au modèle. La FAQ sur le filtrage de la hiérarchie des catégories propose un code qui coche automatiquement les termes parents à l’enregistrement d’un produit.

Pour des milliers de produits, affectez les termes par import. L’outil d’import de produits standard de WooCommerce comprend les chemins dans la colonne Catégories : Audi > A4 > 2015 crée les termes manquants et affecte le produit au dernier, et plusieurs chemins sont séparés par des virgules. Pour une taxonomie personnalisée, il faut un outil d’import qui prend en charge les taxonomies personnalisées.

Produits universels

Aucun réglage ne permet à un produit de correspondre à tous les véhicules. Soit vous affectez les produits universels à chaque terme du dernier niveau, en acceptant qu’aucune année n’apparaisse jamais vide, soit vous les laissez en dehors de l’arborescence des véhicules et vous placez, à côté du sélecteur, un lien vers une catégorie « Accessoires universels ».

Configurer la liste déroulante hiérarchique

  1. Dans WooCommerce → Réglages → Products Filter → Extensions (WooCommerce → Settings → Products Filter → Extensions), activez Liste déroulante hiérarchique (Hierarchy drop-down) et enregistrez.
  2. Dans l’onglet Structure, activez votre taxonomie de véhicules et choisissez Liste déroulante hiérarchique (Hierarchy drop-down) comme type.
  3. Ouvrez les options supplémentaires de la taxonomie (l’icône d’engrenage) et renseignez Libellé personnalisé de la taxonomie (Taxonomy custom label), par exemple Make+Model+Year^Find parts for your car.
  4. Dans la même fenêtre, réglez Afficher le libellé du titre (Show title label) sur Oui (Yes) si vous voulez le titre du bloc, et Toujours afficher la chaîne (Show chain always) sur Oui (Yes) si les trois listes doivent être visibles dès le départ.
  5. Dans l’onglet Options, activez Afficher le nombre (Show count), Recomptage dynamique (Dynamic recount) et Masquer les termes vides (Hide empty terms) si les marques, modèles et années sans produits ne doivent pas être proposés (plus de détails dans comment masquer les termes vides).

Dans le libellé, les parties séparées par + sont, dans l’ordre, les textes indicatifs des listes déroulantes : la première liste affiche « Marque », la deuxième « Modèle », la troisième « Année ». Le texte après ^ est le titre du bloc. Sans ^, le titre du bloc serait la chaîne entière, signes plus compris. Avec Toujours afficher la chaîne (Show chain always), le plugin dessine autant de listes qu’il y a de parties ; celles qui ne peuvent pas encore être utilisées sont désactivées et affichent leur texte indicatif jusqu’au choix du niveau précédent.

Faire apparaître la liste suivante sans rechargement de la page

La liste suivante est construite par le serveur à partir du choix en cours, le navigateur doit donc demander un nouveau formulaire après chaque choix. Deux réglages déterminent comment : autosubmit et ajax_redraw dans le shortcode [woof], ou Envoi automatique (Autosubmit) et Redessin AJAX du formulaire (Form AJAX redrawing) dans le widget. Lorsqu’une liste change, le plugin ne réagit que si l’envoi automatique est activé.

autosubmitajax_redrawCe qui se passe après chaque choix
00 ou 1Rien. La liste suivante n’apparaît qu’après un clic du visiteur sur Filtrer (Filter) et le chargement des résultats.
10Chaque choix lance la recherche : les produits sont mis à jour et la liste suivante arrive avec eux. Convient à la barre latérale de la boutique.
11Chaque choix se contente de redessiner le formulaire en arrière-plan, sans rechercher de produits. Le bouton Filtrer (Filter) lance la recherche. Convient à un sélecteur de véhicule.

Un sélecteur qui n’affiche que les listes de véhicules ressemble à ceci (remplacez vehicle par le slug de votre taxonomie) :

[woof tax_only="vehicle" by_only="none" autosubmit=1 ajax_redraw=1]

tax_only limite le formulaire à la taxonomie des véhicules et by_only="none" masque le prix, la recherche textuelle et les autres filtres qui ne portent pas sur une taxonomie. Le plugin lit autosubmit et ajax_redraw dans le premier formulaire de filtre de la page, si bien qu’un second formulaire HUSKY (une recherche dans l’en-tête, un widget de barre latérale) peut modifier le comportement du sélecteur. Gardez un seul formulaire par page autant que possible.

Une zone de recherche de véhicule sur la page d’accueil

Placez le shortcode ci-dessus sur la page d’accueil. Sur une page qui n’est pas une archive de la boutique, le bouton Filtrer (Filter) ouvre la page de la boutique avec le véhicule choisi ; ajoutez redirect="https://example.com/parts/" pour envoyer les visiteurs vers une autre page de résultats. La page de la boutique peut conserver son filtre habituel en barre latérale ; si elle affiche elle aussi la taxonomie des véhicules sous forme de liste déroulante hiérarchique, la chaîne arrive présélectionnée. Les règles de redirection, le mode AJAX et la page d’accueil statique sont traités dans le filtre de produits sur la page d’accueil ou une page personnalisée.

Lorsque les données sont des attributs : les solutions de remplacement

Si la marque, le modèle et l’année sont déjà stockés comme attributs, les listes ne peuvent pas dépendre les unes des autres par une arborescence. Deux options s’en approchent :

  • Recomptage dynamique avec termes vides masqués. Avec les mêmes réglages autosubmit et ajax_redraw, une fois que le visiteur a choisi Ford, tout modèle sans produit parmi les résultats Ford est masqué. La limite : le plugin ne masque que les valeurs qui n’ont aucun produit dans les résultats en cours. Une pièce qui convient à une Ford Focus et à une Toyota Yaris garde Yaris dans la liste des modèles après le choix de Ford, et une pièce vendue pour 1994–2024 laisse toutes les années visibles. Le plugin ne peut pas savoir quelle année appartient à quel modèle, car les attributs n’ont aucun lien entre eux.
  • Le filtre pas à pas ([woof_step]) affiche les filtres un par un, comme un assistant. Il fonctionne avec n’importe quels filtres, attributs compris, mais applique la même règle de pertinence, de sorte que les mêmes fuites subsistent.

Pour une compatibilité exacte, déplacez les données dans une seule taxonomie hiérarchique ; c’est un import à faire une seule fois.

Listes déroulantes sur une seule ligne

Par défaut, les listes déroulantes sont empilées. Pour les placer côte à côte dans une zone large (au-dessus des produits ou sur la page d’accueil), ajoutez ce CSS dans Apparence → Personnaliser → CSS additionnel (Appearance → Customize → Additional CSS) ou dans la feuille de style de votre thème enfant. Il fonctionne avec les habillages de listes natif, Chosen et SelectWoo, et passe sur des lignes séparées sur les écrans étroits :

/* HUSKY: hierarchy drop-downs side by side */
.woof_container_select_hierarchy .woof_block_html_items {
    display: flex;
    flex-wrap: wrap;
    gap: 10px;
}
.woof_container_select_hierarchy .woof_block_html_items > select,
.woof_container_select_hierarchy .woof_block_html_items > .chosen-container,
.woof_container_select_hierarchy .woof_block_html_items > .select2-container {
    flex: 1 1 180px;
    min-width: 0;
}

Si la liste suivante reste vide ou désactivée

  • L’envoi automatique est désactivé. Avec autosubmit=0, un choix ne fait rien tant que Filtrer (Filter) n’est pas cliqué, même avec ajax_redraw=1. Utilisez les combinaisons du tableau.
  • Un autre formulaire contrôle la page. Retirez les autres formulaires HUSKY de la page et testez de nouveau.
  • Le terme choisi n’a pas d’enfants. Vérifiez l’arborescence dans l’écran d’administration de la taxonomie. Un modèle sans termes d’année arrête la chaîne à ce niveau ; avec Toujours afficher la chaîne (Show chain always), la liste des années reste désactivée.
  • Les enfants n’ont pas de produits. Avec Masquer les termes vides (Hide empty terms) activé, les modèles et années sans produits ne sont pas proposés. Si aucune option du premier niveau n’a de produits, le plugin masque tout le bloc après le chargement de la page : le sélecteur apparaît un instant, puis disparaît.
  • Les nouveaux termes manquent. Avec Cache des termes (Cache terms) activé, cliquez sur vider le cache des termes (clear terms cache) dans Avancé → Options (Advanced → Options) après l’import de nouveaux véhicules.
  • Le mode Turbo est activé. Il remplace la requête de recherche normale par la sienne. Si la chaîne ne s’ouvre pas, testez une fois avec le mode Turbo désactivé.
  • L’arborescence est dans les catégories de produits et vous êtes sur une page de catégorie. La chaîne y commence à la catégorie courante, et sur une catégorie du dernier niveau (une année) le bloc n’est pas affiché ; voir pourquoi le filtre n’affiche que les sous-catégories sur une page de catégorie.

Si la chaîne ne s’ouvre toujours pas, ouvrez un sujet sur le forum d’assistance HUSKY en indiquant le lien de la page, les réglages du shortcode ou du widget que vous utilisez et le libellé personnalisé de la taxonomie.