HUSKY - WooCommerce Product Filter Professional

Replier les sous-catégories dans un filtre de catégories WooCommerce

Un filtre de catégories qui liste toutes les sous-catégories devient un mur de cases à cocher. La plupart des boutiques veulent plutôt une arborescence : catégories parentes visibles, sous-catégories repliées sous un signe plus, et parfois des parents affichés comme de simples titres. Pour replier les sous-catégories dans un filtre de catégories WooCommerce créé avec HUSKY, vous travaillez avec deux mécanismes distincts, faciles à confondre : le petit ouvreur +/- à côté d’une catégorie qui a des enfants, et la bascule dans le titre du bloc qui replie tout le bloc du filtre. Ils ont des réglages différents et conservent leur état de manières différentes, ce qui explique la plupart des surprises du type « ça s’ouvre tout seul ».

Replier les sous-catégories dans le filtre de catégories WooCommerce

Dans l’onglet Options du plugin, réglez Masquer les enfants dans les cases à cocher et boutons radio (Hide childs in checkboxes and radio) sur Oui (Yes) (les nouvelles installations l’ont déjà activé). Chaque liste de sous-catégories est alors affichée masquée, et chaque terme qui a des enfants reçoit un ouvreur après son nom : un petit plus qui devient un moins lorsque la branche est ouverte. Cela fonctionne à toutes les profondeurs : une sous-catégorie qui a ses propres enfants obtient son propre ouvreur.

  • Cela ne s’applique qu’aux types de filtre Case à cocher (Checkbox) et Bouton radio (Radio). Les types en liste déroulante ne replient jamais les sous-catégories (voir la dernière section).
  • Avec Non (No), toutes les sous-catégories sont toujours visibles et il n’y a pas d’ouvreurs.
  • Pour une longue liste de catégories de premier niveau, ouvrez les options supplémentaires (additional options) de la taxonomie (le bouton en forme de roue dentée à côté d’elle dans l’onglet Structure) et renseignez Nombre de termes non repliés (Not toggled terms count) : seul ce nombre de termes est affiché, et un bouton Afficher plus (Show more) révèle le reste.

Si certains parents ne doivent pas lister leurs sous-catégories dans le filtre, le hook woof_terms_where_hidden_childs les supprime. Il fonctionne pour les cases à cocher, les boutons radio et les listes déroulantes :

/*
 * Product filter: list these parent categories without their subcategories.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_terms_where_hidden_childs', function ($term_id) {
    $parents = array(15, 27); // IDs of the parent categories
    return in_array((int) $term_id, $parents, true) ? 1 : 0;
});

Renvoyez 1 pour chaque terme afin de n’afficher que le premier niveau.

Pourquoi les sous-catégories ouvertes restent ouvertes après un rechargement

Lorsqu’un visiteur clique sur un ouvreur, le plugin enregistre l’état de cette branche dans le stockage local du navigateur. À chaque chargement de page, et après chaque redessin AJAX du filtre, les branches enregistrées comme ouvertes sont de nouveau ouvertes. Le stockage local n’expire pas : une branche que vous avez ouverte lors d’un test la semaine dernière est donc toujours ouverte dans votre navigateur aujourd’hui, alors qu’un nouveau visiteur voit tout fermé. Vérifiez toujours l’état par défaut dans une fenêtre de navigation privée.

Deux effets secondaires découlent de cette conception :

  • L’état enregistré décide quelle branche est ouverte, pas la sélection en cours. Un visiteur qui arrive par un lien filtré, par exemple depuis un élément de menu qui pointe vers un filtre de sous-catégorie, peut trouver la sous-catégorie sélectionnée cachée dans une branche fermée.
  • L’état est stocké sous la classe de l’élément de liste du parent. Les catégories de premier niveau ont leur propre classe (woof_term_15 et ainsi de suite), mais les éléments situés sous le premier niveau n’en ont pas ; toutes les branches sous le premier niveau partagent donc un seul état enregistré : ouvrez une branche de deuxième niveau, et au prochain chargement de page, toutes les branches de deuxième niveau sont ouvertes.

Aucun réglage ne permet de désactiver cette mémoire, et les modifications de js/front.js suggérées autrefois pour cela sont perdues à chaque mise à jour. L’extrait ci-dessous le fait depuis votre thème. Le plugin déclenche l’événement woof_init_search_form chaque fois qu’il a construit le filtre, au chargement de la page et après les redessins AJAX ; l’extrait l’écoute et redéfinit chaque branche : ouverte si elle contient un terme sélectionné, fermée sinon.

/*
 * Product filter: ignore remembered branches. A branch of subcategories is
 * open only when it contains a selected term.
 * Child theme functions.php or a code snippets plugin.
 */
add_action('wp_footer', function () {
    ?>
    <script>
    document.addEventListener('woof_init_search_form', function () {
        jQuery('ul.woof_childs_list').each(function () {
            var list = jQuery(this);
            var sign = list.parent('li').children('.woof_childs_list_opener').find('span');
            if (!sign.length) {
                return; // this list has no +/- opener
            }
            var open = list.find('input:checked').length > 0;
            list.toggle(open);
            sign.toggleClass('woof_is_opened', open).toggleClass('woof_is_closed', !open);
        });
    });
    </script>
    <?php
}, 100);

Pour afficher chaque branche ouverte par défaut tout en conservant les ouvreurs, remplacez la ligne var open par var open = true;.

Replier des blocs de filtre entiers sous leurs titres

Le second mécanisme masque tout un bloc sauf son titre. Ouvrez les options supplémentaires de la taxonomie dans l’onglet Structure et réglez l’option de bascule sur Oui, afficher fermé (Yes, show as closed) ou Oui, afficher ouvert (Yes, show as opened). Dans la version 3.4.6, cette option s’intitule Afficher le bouton de bascule pour radio (Show toggle button for radio) dans la fenêtre de la taxonomie, mais c’est bien la bascule du bloc de cette taxonomie. Le titre doit être visible (Afficher le libellé du titre (Show title label) = Oui (Yes)), car la bascule se trouve dans le titre. Dans l’onglet Design, Type de bascule du bloc (Toggle block type) choisit le texte ou les images, et les champs voisins définissent les textes (par défaut + et -) ou deux images d’environ 20×20 px.

L’état d’un bloc n’est pas mémorisé dans le navigateur. Le serveur le définit à chaque page : un bloc réglé pour s’afficher fermé s’ouvre lorsqu’un de ses termes fait partie du filtre actuel, afin que le visiteur voie ce qui est sélectionné. Pour garder les blocs fermés même dans ce cas, ou pour les forcer à rester ouverts, utilisez le hook woof_block_toggle_state :

/*
 * Product filter: blocks with a toggle always start closed.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_block_toggle_state', function ($block_is_closed) {
    return true; // true = closed, false = opened
});

Le hook ne reçoit que l’état, pas la taxonomie ; il s’applique donc à tous les blocs dont la bascule est activée.

Rendre tout le titre cliquable

Par défaut, seul le +/- ouvre un bloc. La FAQ sur l’inclusion du titre dans la bascule attache le clic au chargement de la page. La version ci-dessous est déléguée : elle continue de fonctionner après qu’un filtrage AJAX a redessiné le formulaire, et elle ignore les clics sur le +/- lui-même, qui basculeraient sinon le bloc deux fois :

/*
 * Product filter: a click anywhere on a block title opens or closes the block.
 * Child theme functions.php or a code snippets plugin.
 */
add_action('wp_footer', function () {
    ?>
    <style>.woof_container_inner > h4:has(> .woof_front_toggle) { cursor: pointer; }</style>
    <script>
    jQuery(document).on('click', '.woof_container_inner > h4', function (e) {
        if (jQuery(e.target).closest('.woof_front_toggle, .woof_tooltip_header').length) {
            return; // the +/- or the tooltip icon was clicked
        }
        jQuery(this).children('.woof_front_toggle').trigger('click');
    });
    </script>
    <?php
}, 100);

Si vous avez changé la balise de titre avec le hook woof_title_tag, remplacez h4 par votre balise. Une bascule en texte est un lien ; sa couleur se définit donc avec du CSS tel que .woof_container_inner h4 a.woof_front_toggle { color: #222; }.

Pour replier plusieurs blocs sous un seul titre, par exemple tous les attributs sous « Plus de filtres », utilisez l’extension Sections. Une fois activée dans l’onglet Extensions, ses réglages sous Avancé (Advanced) → Sections regroupent une série d’éléments de filtre dans une section ouvrable et refermable ; Comportement des sections (Sections behavior) Comme case à cocher (As checkbox) permet d’ouvrir plusieurs sections à la fois, Comme bouton radio (As radio) n’en garde qu’une ouverte.

Afficher une catégorie parente comme un titre sans case à cocher

Lorsque les produits sont assignés uniquement aux sous-catégories, le parent fonctionne mieux comme un titre. Lorsqu’un Habillage des boutons radio et des cases à cocher (Radio and checkboxes skin) est sélectionné dans l’onglet Design, le vrai champ est enveloppé dans un div dont la classe est le nom de l’habillage avec un trait d’union : l’habillage square_blue donne icheckbox_square-blue (et iradio_square-blue pour les boutons radio). Un CSS écrit avec icheckbox_square_grey, avec un tiret bas, ne correspond donc à rien. Les règles ci-dessous fonctionnent avec n’importe quel habillage et avec des champs simples. Le script du plugin ajoute la classe woof_childs_list_li à chaque élément qui a des enfants, à tous les niveaux. Placez le CSS dans Avancé (Advanced) → Code → CSS personnalisé (Custom CSS code) ou dans votre thème :

/* Product categories filter: parents become headings without a box */
.woof_container_product_cat li.woof_childs_list_li > input,
.woof_container_product_cat li.woof_childs_list_li > div[class*="icheckbox_"],
.woof_container_product_cat li.woof_childs_list_li > div[class*="iradio_"] {
    display: none !important;
}
.woof_container_product_cat li.woof_childs_list_li > label {
    font-weight: bold;
    cursor: pointer;
}

Pour une seule catégorie de premier niveau, utilisez sa classe de terme, par exemple .woof_term_123 > div[class*="icheckbox_"]. Les éléments situés sous le premier niveau n’ont pas de classe de terme ; ciblez-les par la liste de leur parent : ul.woof_childs_list_123 > li.woof_childs_list_li > div[class*="icheckbox_"].

Le nom d’un parent reste le libellé de son champ masqué ; un clic dessus sélectionnerait donc le parent. L’extrait suivant transforme ce clic en ouverture et fermeture de la branche. C’est aussi la réponse si vous gardez les cases à cocher mais souhaitez qu’un clic sur le nom de la catégorie déplie ses sous-catégories :

/*
 * Product filter: a click on the name of a parent category opens or closes
 * its subcategories instead of selecting it.
 * Child theme functions.php or a code snippets plugin.
 */
add_action('wp_footer', function () {
    ?>
    <script>
    document.addEventListener('click', function (e) {
        var label = e.target.closest ? e.target.closest('.woof_container_product_cat li.woof_childs_list_li > label') : null;
        if (!label) {
            return;
        }
        e.preventDefault(); // do not select the parent
        e.stopPropagation();
        jQuery(label).siblings('.woof_childs_list_opener').find('span').trigger('click');
    }, true);
    </script>
    <?php
}, 100);

Pour une autre taxonomie, remplacez product_cat par son slug, par exemple .woof_container_pa_brand.

Sous-catégories non indentées, ou sur une seule ligne

Le plugin indente chaque liste de sous-catégories de 17 px. Lorsque les sous-catégories s’alignent sous le parent comme si elles étaient elles-mêmes des parents, une règle du thème pour les listes dans les widgets ou les barres latérales supprime cette marge avec un sélecteur plus fort. Rétablissez-la :

.woof .woof_block_html_items .woof_childs_list {
    padding: 0 0 0 17px !important;
}

Des sous-catégories côte à côte sur une seule ligne viennent généralement de l’option de bloc Afficher les éléments en ligne (Display items in a row) : elle place en ligne tous les termes sans enfants, sous-catégories comprises. Réglez-la sur Non (No) pour une arborescence. Si l’option est désactivée, cherchez une règle du thème qui donne aux listes display: flex ou aux éléments de liste display: inline-block.

Si le plus et le moins des ouvreurs sont difficiles à voir sur votre arrière-plan, remplacez-les dans l’onglet Design par Image pour sous-catégories ouvertes (Image for subcategories open) (le plus) et Image pour sous-catégories fermées (Image for subcategories close) (le moins). Elles sont affichées dans une boîte de 13×13 px ; utilisez donc des icônes simples et très contrastées.

Filtres de catégories en liste déroulante

Les types Liste déroulante (Drop-down) et Liste déroulante multiple (Multi drop-down) ne peuvent pas replier les sous-catégories. La liste déroulante simple indente les sous-catégories avec des espaces ; la liste déroulante multiple les liste à plat. Chaque option de sous-catégorie porte une classe indiquant sa profondeur, woof-padding-1, woof-padding-2 et ainsi de suite, tandis que les options de premier niveau n’en ont pas. Les navigateurs permettent peu de stylisation des options natives, mais avec Habillage des listes déroulantes (Drop-down skin) réglé sur Chosen, les classes atteignent la liste visible, ce qui vous permet de marquer les niveaux :

/* Category drop-downs with the Chosen skin: bold top level */
.woof_container_product_cat .chosen-results li.active-result:not([class*="woof-padding-"]) {
    font-weight: bold;
}
/* Multi drop-down: indent subcategories by level */
.woof_container_mselect.woof_container_product_cat .chosen-results li.woof-padding-1 { padding-left: 20px; }
.woof_container_mselect.woof_container_product_cat .chosen-results li.woof-padding-2 { padding-left: 34px; }

Si les visiteurs doivent choisir d’abord un parent, puis sa sous-catégorie dans une seconde liste déroulante, utilisez l’extension Hierarchy drop-down ; l’article sur un filtre année, marque et modèle montre la configuration.

Liste de contrôle

  • Le bloc de catégories utilise le type Case à cocher (Checkbox) ou Bouton radio (Radio) et Masquer les enfants dans les cases à cocher et boutons radio (Hide childs in checkboxes and radio) est sur Oui (Yes).
  • L’état par défaut a été vérifié dans une fenêtre de navigation privée, et non dans un navigateur qui mémorise les branches ouvertes.
  • L’extrait sur les branches est en place si les branches doivent suivre la sélection plutôt que les clics précédents du visiteur.
  • Les bascules de blocs sont définies dans les options supplémentaires de la taxonomie, le titre est affiché, et woof_block_toggle_state n’est utilisé que si l’ouverture par défaut à la sélection n’est pas souhaitée.
  • Le CSS personnalisé utilise la classe d’habillage avec trait d’union ou la forme [class*="icheckbox_"], et les caches de la page et du navigateur ont été vidés après chaque modification.

Si l’arborescence ne se comporte toujours pas comme décrit, ouvrez un sujet sur le forum d’assistance de HUSKY avec un lien vers la page du filtre et les réglages du bloc de catégories.