Come comprimere le sottocategorie nel filtro per categorie WooCommerce
Un filtro per categorie che elenca ogni sottocategoria si trasforma in un muro di caselle di controllo. La maggior parte dei negozi preferisce un albero: le categorie principali visibili, le sottocategorie ripiegate sotto un segno più, a volte con i genitori mostrati come semplici intestazioni. Per comprimere le sottocategorie in un filtro per categorie WooCommerce creato con HUSKY si lavora con due meccanismi distinti, facili da confondere: il piccolo apritore +/- accanto a una categoria che ha figli e l'interruttore nel titolo del blocco che ripiega l'intero blocco del filtro. Hanno impostazioni diverse e conservano il loro stato in modi diversi, il che spiega la maggior parte delle sorprese del tipo «si apre da solo».
Comprimere le sottocategorie nel filtro per categorie WooCommerce
Nella scheda Opzioni (Options) del plugin imposta Nascondi i figli in caselle di controllo e radio (Hide childs in checkboxes and radio) su Sì (Yes) (le nuove installazioni lo hanno già attivo). Ogni elenco di sottocategorie viene allora stampato nascosto, e ogni termine che ha figli riceve un apritore dopo il nome: un piccolo più che diventa un meno quando il ramo è aperto. Funziona a ogni livello di profondità, quindi una sottocategoria con figli propri ha un apritore proprio.
- Si applica solo ai tipi di filtro Casella di controllo (Checkbox) e Radio. I tipi a tendina non ripiegano mai le sottocategorie (vedi l'ultima sezione).
- Con No, tutte le sottocategorie sono sempre visibili e non ci sono apritori.
- Per un lungo elenco di categorie di primo livello, apri le opzioni aggiuntive (additional options) della tassonomia (il pulsante a ingranaggio accanto ad essa nella scheda Struttura (Structure)) e compila Numero di termini non comprimibili (Not toggled terms count): vengono mostrati solo quei termini, e un pulsante Mostra altro (Show more) rivela il resto.
Se alcuni genitori non devono elencare affatto le loro sottocategorie nel filtro, l'hook woof_terms_where_hidden_childs le rimuove. Funziona per caselle di controllo, pulsanti radio e menu a tendina:
/*
* 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;
});
Restituisci 1 per ogni termine per mostrare solo il primo livello.
Perché le sottocategorie aperte restano aperte dopo un ricaricamento
Quando un visitatore fa clic su un apritore, il plugin salva lo stato di quel ramo nel local storage del browser. A ogni caricamento della pagina, e dopo ogni ridisegno AJAX del filtro, i rami salvati come aperti vengono riaperti. Il local storage non scade, quindi un ramo che hai aperto la settimana scorsa durante un test è ancora aperto oggi nel tuo browser, mentre un nuovo visitatore vede tutto chiuso. Controlla sempre lo stato predefinito in una finestra privata.
Da questa progettazione derivano due effetti collaterali:
- Lo stato salvato decide quale ramo è aperto, non la selezione corrente. Un visitatore che arriva tramite un link filtrato, ad esempio da una voce di menu che punta al filtro di una sottocategoria, può trovare la sottocategoria selezionata nascosta dentro un ramo chiuso.
- Lo stato è memorizzato sotto la classe dell'elemento di elenco del genitore. Le categorie di primo livello hanno una classe propria (
woof_term_15e così via), ma gli elementi sotto il primo livello no, quindi tutti i rami sotto il primo livello condividono un unico stato memorizzato: apri un ramo di secondo livello e, al caricamento successivo della pagina, tutti i rami di secondo livello sono aperti.
Non esiste un'impostazione per disattivare la memoria, e le modifiche a js/front.js suggerite in passato per questo scopo si perdono a ogni aggiornamento. Lo snippet qui sotto lo fa invece dal tuo tema. Il plugin genera l'evento woof_init_search_form ogni volta che ha costruito il filtro, al caricamento della pagina e dopo i ridisegni AJAX; lo snippet lo ascolta e reimposta ogni ramo: aperto se contiene un termine selezionato, chiuso altrimenti.
/*
* 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);
Per mostrare ogni ramo aperto per impostazione predefinita mantenendo gli apritori, cambia la riga var open in var open = true;.
Ripiegare interi blocchi del filtro sotto i loro titoli
Il secondo meccanismo nasconde un intero blocco tranne il titolo. Apri le opzioni aggiuntive della tassonomia nella scheda Struttura (Structure) e imposta l'opzione dell'interruttore su Sì, mostra chiuso (Yes, show as closed) oppure Sì, mostra aperto (Yes, show as opened). Nella versione 3.4.6 questa opzione si chiama Mostra il pulsante di apertura per radio (Show toggle button for radio) nella finestra della tassonomia, ma è l'interruttore del blocco di quella tassonomia. Il titolo deve essere visibile (Mostra l'etichetta del titolo (Show title label) = Sì (Yes)), perché l'interruttore si trova al suo interno. Nella scheda Design, Tipo di interruttore del blocco (Toggle block type) sceglie tra testo e immagini, e i campi accanto impostano i testi (per impostazione predefinita + e -) o due immagini di circa 20×20 px.
Lo stato del blocco non viene memorizzato nel browser. Lo imposta il server a ogni pagina: un blocco impostato per essere mostrato chiuso si apre quando uno dei suoi termini fa parte del filtro corrente, così il visitatore vede ciò che è selezionato. Per mantenere i blocchi chiusi anche in quel caso, o per forzarli aperti, usa l'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
});
L'hook riceve solo lo stato, non la tassonomia, quindi si applica a ogni blocco che ha l'interruttore attivo.
Rendere cliccabile l'intero titolo
Per impostazione predefinita solo il +/- apre un blocco. Le FAQ su come far includere il titolo nell'interruttore collegano il clic al caricamento della pagina. La versione qui sotto è delegata, quindi continua a funzionare dopo che il filtraggio AJAX ridisegna il modulo, e ignora i clic sul +/- stesso, che altrimenti aprirebbero e chiuderebbero il blocco due volte:
/*
* 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);
Se hai cambiato il tag del titolo con l'hook woof_title_tag, sostituisci h4 con il tuo tag. Un interruttore di testo è un link, quindi il suo colore si imposta con CSS come .woof_container_inner h4 a.woof_front_toggle { color: #222; }.
Per ripiegare più blocchi sotto un'unica intestazione, ad esempio tutti gli attributi sotto «Altri filtri», usa l'estensione Sections. Una volta attiva nella scheda Estensioni (Extensions), le sue impostazioni in Avanzate (Advanced) → Sezioni (Sections) racchiudono un intervallo di elementi del filtro in una sezione apribile e chiudibile; con Comportamento delle sezioni (Sections behavior) Come casella di controllo (As checkbox) più sezioni possono essere aperte contemporaneamente, con Come radio (As radio) ne resta aperta una sola.
Mostrare una categoria genitore come intestazione senza casella di controllo
Quando i prodotti sono assegnati solo alle sottocategorie, il genitore funziona meglio come intestazione. Con una Skin per pulsanti radio e caselle di controllo (Radio and checkboxes skin) selezionata nella scheda Design, l'input reale è avvolto in un div la cui classe è il nome della skin con un trattino: la skin square_blue dà icheckbox_square-blue (e iradio_square-blue per i pulsanti radio). Il CSS scritto con icheckbox_square_grey, con il trattino basso, non corrisponde quindi a nulla. Le regole qui sotto funzionano con qualsiasi skin e con input semplici. Lo script del plugin aggiunge la classe woof_childs_list_li a ogni elemento che ha figli, a ogni livello. Inserisci il CSS in Avanzate (Advanced) → Codice (Code) → Codice CSS personalizzato (Custom CSS code) o nel tuo tema:
/* 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;
}
Per una sola categoria di primo livello, usa la sua classe del termine, ad esempio .woof_term_123 > div[class*="icheckbox_"]. Gli elementi sotto il primo livello non hanno una classe del termine; raggiungili tramite l'elenco del loro genitore: ul.woof_childs_list_123 > li.woof_childs_list_li > div[class*="icheckbox_"].
Il nome di un genitore è ancora l'etichetta del suo input nascosto, quindi un clic su di esso selezionerebbe il genitore. Lo snippet successivo trasforma quel clic nell'apertura e chiusura del ramo. È anche la risposta quando mantieni le caselle di controllo ma vuoi che un clic sul nome della categoria ne espanda le sottocategorie:
/*
* 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);
Per un'altra tassonomia sostituisci product_cat con il suo slug, ad esempio .woof_container_pa_brand.
Sottocategorie senza rientro, o su un'unica riga
Il plugin fa rientrare ogni elenco di sottocategorie di 17 px. Quando le sottocategorie si allineano sotto il genitore come se fossero genitori anch'esse, una regola del tema per gli elenchi nei widget o nelle barre laterali rimuove quel padding con un selettore più forte. Ripristinalo:
.woof .woof_block_html_items .woof_childs_list {
padding: 0 0 0 17px !important;
}
Sottocategorie affiancate su un'unica riga derivano di solito dall'opzione del blocco Mostra gli elementi su una riga (Display items in a row): mette in linea ogni termine senza figli, sottocategorie comprese. Impostala su No per un albero. Se l'opzione è disattivata, cerca una regola del tema che assegna agli elenchi display: flex o agli elementi di elenco display: inline-block.
Se il più e il meno degli apritori si vedono male sul tuo sfondo, sostituiscili nella scheda Design con Immagine per sottocategorie aperte (Image for subcategories open) (il più) e Immagine per sottocategorie chiuse (Image for subcategories close) (il meno). Vengono mostrate in un riquadro di 13×13 px, quindi usa icone semplici e ad alto contrasto.
Filtri per categorie a tendina
I tipi Menu a tendina (Drop-down) e Menu a tendina multiplo (Multi drop-down) non possono ripiegare le sottocategorie. Il menu a tendina singolo fa rientrare le sottocategorie con degli spazi; quello multiplo le elenca in piano. Ogni opzione di sottocategoria ha una classe con la sua profondità, woof-padding-1, woof-padding-2 e così via, mentre le opzioni di primo livello non ne hanno. I browser consentono poco stile sulle opzioni native, ma con Skin del menu a tendina (Drop-down skin) impostata su Chosen le classi raggiungono l'elenco visibile, quindi puoi segnare i livelli:
/* 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; }
Se i visitatori devono scegliere prima un genitore e poi la sua sottocategoria in un secondo menu a tendina, usa l'estensione Hierarchy drop-down; l'articolo su un filtro per anno, marca e modello mostra la configurazione.
Checklist
- Il blocco delle categorie usa il tipo Casella di controllo (Checkbox) o Radio e Nascondi i figli in caselle di controllo e radio (Hide childs in checkboxes and radio) è su Sì (Yes).
- Lo stato predefinito è stato verificato in una finestra privata, non in un browser che ricorda i rami aperti.
- Lo snippet dei rami è presente se i rami devono seguire la selezione invece dei clic precedenti del visitatore.
- Gli interruttori dei blocchi sono impostati nelle opzioni aggiuntive della tassonomia, il titolo è visibile e
woof_block_toggle_statesi usa solo se l'apertura predefinita alla selezione non è desiderata. - Il CSS personalizzato usa la classe della skin con il trattino o la forma
[class*="icheckbox_"], e le cache della pagina e del browser sono state svuotate dopo ogni modifica.
Se l'albero continua a non comportarsi come descritto, apri un argomento nel forum di supporto di HUSKY con il link alla pagina del filtro e le impostazioni del blocco delle categorie.