Jak zwinąć podkategorie w filtrze kategorii WooCommerce
Filtr kategorii, który wypisuje każdą podkategorię, zamienia się w ścianę pól wyboru. Większość sklepów chce zamiast tego drzewa: kategorie nadrzędne widoczne, podkategorie zwinięte pod znakiem plus, a czasem kategorie nadrzędne pokazane jako zwykłe nagłówki. Aby zwinąć podkategorie w filtrze kategorii WooCommerce zbudowanym w HUSKY, pracujesz z dwoma osobnymi mechanizmami, które łatwo pomylić: małym otwieraczem +/- obok kategorii mającej elementy podrzędne oraz przełącznikiem w tytule bloku, który zwija cały blok filtra. Mają różne ustawienia i inaczej przechowują swój stan, co tłumaczy większość niespodzianek typu „otwiera się samo”.
Zwijanie podkategorii w filtrze kategorii WooCommerce
Na karcie Opcje (Options) wtyczki ustaw Ukryj elementy podrzędne w polach wyboru i przełącznikach typu radio (Hide childs in checkboxes and radio) na Tak (Yes) (nowe instalacje mają ją już włączoną). Każda lista podkategorii jest wtedy drukowana jako ukryta, a każde określenie mające elementy podrzędne dostaje po swojej nazwie otwieracz: mały plus zmieniający się w minus, gdy gałąź jest otwarta. Działa na każdej głębokości, więc podkategoria z własnymi elementami podrzędnymi dostaje własny otwieracz.
- Dotyczy tylko typów filtra Pole Wyboru (Checkbox) i Radio. Typy z listą rozwijaną nigdy nie zwijają podkategorii (zobacz ostatnią sekcję).
- Przy wartości Nie (No) wszystkie podkategorie są zawsze widoczne i nie ma otwieraczy.
- Dla długiej listy kategorii najwyższego poziomu otwórz dodatkowe opcje (additional options) taksonomii (przycisk z kołem zębatym obok niej na karcie Struktura (Structure)) i wypełnij Ilość nie przełączanych określeń (Not toggled terms count): pokazywana jest tylko tyle określeń, a przycisk Pokaż więcej (Show more) odsłania resztę.
Jeśli niektóre kategorie nadrzędne w ogóle nie powinny wyświetlać w filtrze swoich podkategorii, usuwa je hak woof_terms_where_hidden_childs. Działa dla pól wyboru, przycisków radio i list rozwijanych:
/*
* 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;
});
Zwróć 1 dla każdego określenia, aby pokazać tylko najwyższy poziom.
Dlaczego otwarte podkategorie pozostają otwarte po przeładowaniu
Gdy odwiedzający kliknie otwieracz, wtyczka zapisuje stan tej gałęzi w lokalnej pamięci przeglądarki (local storage). Przy każdym załadowaniu strony i po każdym przerysowaniu filtra przez AJAX gałęzie zapisane jako otwarte są otwierane ponownie. Local storage nie wygasa, więc gałąź otwarta podczas testów w zeszłym tygodniu jest w Twojej przeglądarce otwarta do dziś, podczas gdy nowy odwiedzający widzi wszystko zamknięte. Stan domyślny zawsze sprawdzaj w oknie prywatnym.
Z tego rozwiązania wynikają dwa skutki uboczne:
- O tym, która gałąź jest otwarta, decyduje zapisany stan, a nie bieżący wybór. Odwiedzający, który trafia przez przefiltrowany link, na przykład z pozycji menu wskazującej filtr podkategorii, może zastać wybraną podkategorię ukrytą w zamkniętej gałęzi.
- Stan jest przechowywany pod klasą elementu listy nadrzędnego. Kategorie najwyższego poziomu mają własną klasę (
woof_term_15i tak dalej), ale elementy poniżej pierwszego poziomu jej nie mają, więc wszystkie gałęzie poniżej pierwszego poziomu dzielą jeden zapisany stan: otwórz jedną gałąź drugiego poziomu, a po następnym załadowaniu strony otwarte będą wszystkie gałęzie drugiego poziomu.
Nie ma ustawienia wyłączającego tę pamięć, a edycje js/front.js sugerowane w tym celu w przeszłości giną przy każdej aktualizacji. Poniższy fragment robi to z poziomu Twojego motywu. Wtyczka wywołuje zdarzenie woof_init_search_form za każdym razem, gdy zbuduje filtr, przy załadowaniu strony i po przerysowaniach AJAX; fragment nasłuchuje go i ustawia każdą gałąź od nowa: otwartą, jeśli zawiera wybrane określenie, w przeciwnym razie zamkniętą.
/*
* 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);
Aby pokazać każdą gałąź domyślnie otwartą, zachowując otwieracze, zmień wiersz var open na var open = true;.
Zwijanie całych bloków filtra pod ich tytułami
Drugi mechanizm ukrywa cały blok oprócz jego tytułu. Otwórz dodatkowe opcje taksonomii na karcie Struktura (Structure) i ustaw opcję przełącznika na Tak, pokaż jako zamknięte (Yes, show as closed) lub Tak, pokaż jako otwarte (Yes, show as opened). W wersji 3.4.6 ta opcja ma w oknie taksonomii etykietę Pokaż przycisk przełączania dla radio (Show toggle button for radio), ale jest to przełącznik bloku tej taksonomii. Tytuł musi być widoczny (Pokaż etykietę tytułu (Show title label) = Tak (Yes)), ponieważ przełącznik znajduje się w nim. Na karcie Wygląd (Design) opcja Przełącz typ bloku (Toggle block type) wybiera tekst lub obrazy, a sąsiednie pola ustawiają teksty (domyślnie + i -) albo dwa obrazy o wymiarach około 20×20 px.
Stan bloku nie jest zapamiętywany w przeglądarce. Serwer ustawia go przy każdej stronie: blok ustawiony na pokazanie jako zamknięty otwiera się, gdy któreś z jego określeń jest częścią bieżącego filtra, więc odwiedzający widzi, co jest wybrane. Aby bloki pozostawały zamknięte nawet wtedy albo aby wymusić ich otwarcie, użyj haka 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
});
Hak otrzymuje tylko stan, a nie taksonomię, więc dotyczy każdego bloku z włączonym przełącznikiem.
Spraw, by cały tytuł był klikalny
Domyślnie blok otwiera tylko +/-. FAQ o dodaniu tytułu do obszaru przełącznika podpina kliknięcie przy załadowaniu strony. Poniższa wersja korzysta z delegowania zdarzeń, więc działa nadal po przerysowaniu formularza przez filtrowanie AJAX, i ignoruje kliknięcia samego +/-, które w przeciwnym razie przełączyłyby blok dwa razy:
/*
* 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);
Jeśli zmieniłeś znacznik tytułu hakiem woof_title_tag, zamień h4 na swój znacznik. Przełącznik tekstowy jest linkiem, więc jego kolor ustawia się w CSS, na przykład .woof_container_inner h4 a.woof_front_toggle { color: #222; }.
Aby zwinąć kilka bloków pod jednym nagłówkiem, na przykład wszystkie atrybuty pod „Więcej filtrów”, użyj rozszerzenia Sections. Po jego aktywacji na karcie Rozszerzenia (Extensions) jego ustawienia w Zaawansowane (Advanced) → Sekcje (Sections) obejmują zakres elementów filtra w rozwijaną i zwijaną sekcję; Zachowanie sekcji (Sections behavior) Jako pole wyboru (As checkbox) pozwala mieć otwartych kilka sekcji naraz, a Jako radio (As radio) utrzymuje otwartą tylko jedną.
Pokaż kategorię nadrzędną jako nagłówek bez pola wyboru
Gdy produkty są przypisane tylko do podkategorii, kategoria nadrzędna lepiej sprawdza się jako nagłówek. Przy wybranej opcji Skórka przycisków radio i pól wyboru (Radio and checkboxes skin) na karcie Wygląd (Design) prawdziwy element input jest opakowany w div, którego klasa to nazwa skórki z łącznikiem: skórka square_blue daje icheckbox_square-blue (oraz iradio_square-blue dla przycisków radio). CSS napisany z icheckbox_square_grey, z podkreślnikiem, nie pasuje więc do niczego. Poniższe reguły działają z każdą skórką i ze zwykłymi elementami input. Skrypt wtyczki dodaje klasę woof_childs_list_li do każdego elementu mającego elementy podrzędne, na każdym poziomie. Umieść CSS w Zaawansowane (Advanced) → Kod (Code) → Własny kod CSS (Custom CSS code) lub w swoim motywie:
/* 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;
}
Tylko dla jednej kategorii najwyższego poziomu użyj jej klasy określenia, na przykład .woof_term_123 > div[class*="icheckbox_"]. Elementy poniżej pierwszego poziomu nie mają klasy określenia; wskaż je przez listę ich elementu nadrzędnego: ul.woof_childs_list_123 > li.woof_childs_list_li > div[class*="icheckbox_"].
Nazwa kategorii nadrzędnej nadal jest etykietą swojego ukrytego elementu input, więc kliknięcie jej wybrałoby kategorię nadrzędną. Następny fragment zamienia to kliknięcie na otwieranie i zamykanie gałęzi. To także odpowiedź, gdy zostawiasz pola wyboru, ale chcesz, by kliknięcie nazwy kategorii rozwijało jej podkategorie:
/*
* 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);
Dla innej taksonomii zamień product_cat na jej slug, na przykład .woof_container_pa_brand.
Podkategorie bez wcięcia lub w jednym wierszu
Wtyczka wcina każdą listę podkategorii o 17 px. Gdy podkategorie ustawiają się pod kategorią nadrzędną, jakby same były nadrzędne, reguła motywu dla list w widgetach lub paskach bocznych usuwa to dopełnienie silniejszym selektorem. Przywróć je:
.woof .woof_block_html_items .woof_childs_list {
padding: 0 0 0 17px !important;
}
Podkategorie obok siebie w jednym rzędzie zwykle wynikają z opcji bloku Wyświetl elementy w rzędzie (Display items in a row): ustawia ona w linii każde określenie bez elementów podrzędnych, także podkategorie. Dla drzewa ustaw ją na Nie (No). Jeśli opcja jest wyłączona, poszukaj reguły motywu nadającej listom display: flex lub elementom listy display: inline-block.
Jeśli plus i minus otwieraczy są słabo widoczne na Twoim tle, zastąp je na karcie Wygląd (Design) opcjami Obraz dla otwartych podkategorii (Image for subcategories open) (plus) i Obraz dla zamkniętych podkategorii (Image for subcategories close) (minus). Są wyświetlane w polu 13×13 px, więc używaj prostych ikon o wysokim kontraście.
Filtry kategorii z listą rozwijaną
Typy Lista rozwijana (Drop-down) i Lista rozwijana wielokrotnego wyboru (Multi drop-down) nie potrafią zwijać podkategorii. Pojedyncza lista rozwijana wcina podkategorie spacjami; lista wielokrotnego wyboru wypisuje je płasko. Każda opcja podkategorii ma klasę z jej głębokością, woof-padding-1, woof-padding-2 i tak dalej, podczas gdy opcje najwyższego poziomu jej nie mają. Przeglądarki pozwalają na niewielką stylizację natywnych opcji, ale przy opcji Skórka listy rozwijanej (Drop-down skin) ustawionej na Chosen klasy trafiają do widocznej listy, więc możesz oznaczyć poziomy:
/* 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; }
Jeśli odwiedzający mają najpierw wybrać kategorię nadrzędną, a potem jej podkategorię w drugiej liście rozwijanej, użyj rozszerzenia Hierarchy drop-down; konfigurację pokazuje artykuł o filtrze rocznik, marka i model.
Lista kontrolna
- Blok kategorii używa typu Pole Wyboru (Checkbox) lub Radio, a Ukryj elementy podrzędne w polach wyboru i przełącznikach typu radio (Hide childs in checkboxes and radio) ma wartość Tak (Yes).
- Stan domyślny sprawdzono w oknie prywatnym, a nie w przeglądarce pamiętającej otwarte gałęzie.
- Fragment kodu dla gałęzi jest na miejscu, jeśli gałęzie mają podążać za wyborem, a nie za wcześniejszymi kliknięciami odwiedzającego.
- Przełączniki bloków ustawiono w dodatkowych opcjach taksonomii, tytuł jest pokazany, a
woof_block_toggle_stateużyto tylko wtedy, gdy domyślne otwieranie przy wyborze jest niepożądane. - Własny CSS używa klasy skórki z łącznikiem albo postaci
[class*="icheckbox_"], a pamięci podręczne strony i przeglądarki wyczyszczono po każdej zmianie.
Jeśli drzewo nadal nie zachowuje się tak, jak opisano, otwórz wątek na forum wsparcia HUSKY z linkiem do strony filtra i ustawieniami bloku kategorii.