Unterkategorien im WooCommerce-Kategoriefilter einklappen
Ein Kategoriefilter, der jede Unterkategorie auflistet, wird zu einer Wand aus Checkboxen. Die meisten Shops wünschen sich stattdessen einen Baum: Hauptkategorien sichtbar, Unterkategorien hinter einem Pluszeichen eingeklappt, manchmal die Hauptkategorien als schlichte Überschriften. Um Unterkategorien in einem mit HUSKY gebauten WooCommerce-Kategoriefilter einzuklappen, arbeiten Sie mit zwei getrennten Mechanismen, die sich leicht verwechseln lassen: dem kleinen +/- neben einer Kategorie mit Unterkategorien und dem Umschalter im Blocktitel, der den ganzen Filterblock einklappt. Sie haben unterschiedliche Einstellungen und speichern ihren Zustand auf verschiedene Weise, was die meisten „es öffnet sich von selbst“-Überraschungen erklärt.
Unterkategorien im WooCommerce-Kategoriefilter einklappen
Setzen Sie im Tab Optionen (Options) des Plugins Verstecke untergeordnete Elemente in Checkboxen und Schaltknöpfen (Hide childs in checkboxes and radio) auf Ja (Yes) (neue Installationen haben es bereits aktiv). Jede Liste von Unterkategorien wird dann verborgen ausgegeben, und jeder Begriff mit Unterkategorien erhält hinter seinem Namen ein Öffnungssymbol: ein kleines Plus, das zu einem Minus wird, wenn der Zweig geöffnet ist. Es funktioniert in jeder Tiefe, sodass auch eine Unterkategorie mit eigenen Unterkategorien ihr eigenes Öffnungssymbol bekommt.
- Es gilt nur für die Filtertypen Checkbox und Radio. Dropdown-Typen klappen Unterkategorien nie ein (siehe den letzten Abschnitt).
- Bei Nein (No) sind alle Unterkategorien immer sichtbar, und es gibt keine Öffnungssymbole.
- Öffnen Sie bei einer langen Liste von Hauptkategorien die Zusatzoptionen (additional options) der Taxonomie (der Zahnrad-Button daneben im Tab Struktur (Structure)) und füllen Sie Nicht umgeschaltete Begriffe zählen (Not toggled terms count) aus: Es werden nur so viele Begriffe angezeigt, und ein Button Weitere Produkte (Show more) zeigt den Rest.
Sollen manche Hauptkategorien ihre Unterkategorien im Filter gar nicht auflisten, entfernt der Hook woof_terms_where_hidden_childs sie. Er funktioniert bei Checkboxen, Radiobuttons und Dropdowns:
/*
* 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;
});
Geben Sie 1 für jeden Begriff zurück, um nur die oberste Ebene zu zeigen.
Warum geöffnete Unterkategorien nach dem Neuladen geöffnet bleiben
Klickt ein Besucher auf ein Öffnungssymbol, speichert das Plugin den Zustand dieses Zweigs im lokalen Speicher (Local Storage) des Browsers. Bei jedem Laden der Seite und nach jedem AJAX-Neuzeichnen des Filters werden als geöffnet gespeicherte Zweige wieder geöffnet. Der lokale Speicher läuft nicht ab, daher ist ein Zweig, den Sie letzte Woche beim Testen geöffnet haben, in Ihrem Browser heute noch offen, während ein neuer Besucher alles geschlossen sieht. Prüfen Sie den Standardzustand deshalb immer in einem privaten Fenster.
Aus diesem Aufbau ergeben sich zwei Nebenwirkungen:
- Der gespeicherte Zustand entscheidet, welcher Zweig offen ist, nicht die aktuelle Auswahl. Ein Besucher, der über einen gefilterten Link kommt, etwa von einem Menüpunkt, der auf einen Unterkategorie-Filter zeigt, findet die gewählte Unterkategorie womöglich in einem geschlossenen Zweig versteckt.
- Der Zustand wird unter der Klasse des Listeneintrags des übergeordneten Elements gespeichert. Hauptkategorien haben eine eigene Klasse (
woof_term_15und so weiter), Einträge unterhalb der ersten Ebene aber nicht, daher teilen sich alle Zweige unterhalb der ersten Ebene einen gespeicherten Zustand: Öffnen Sie einen Zweig der zweiten Ebene, und nach dem nächsten Laden der Seite ist jeder Zweig der zweiten Ebene offen.
Es gibt keine Einstellung, die das Gedächtnis abschaltet, und die früher dafür empfohlenen Änderungen an js/front.js gehen bei jedem Update verloren. Das folgende Snippet erledigt es stattdessen aus Ihrem Theme. Das Plugin löst das Ereignis woof_init_search_form aus, sooft es den Filter aufgebaut hat, beim Laden der Seite und nach AJAX-Neuzeichnungen; das Snippet hört darauf und setzt jeden Zweig neu: offen, wenn er einen gewählten Begriff enthält, sonst geschlossen.
/*
* 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);
Um jeden Zweig standardmäßig geöffnet zu zeigen und dabei die Öffnungssymbole zu behalten, ändern Sie die Zeile var open in var open = true;.
Ganze Filterblöcke unter ihren Titeln einklappen
Der zweite Mechanismus verbirgt einen ganzen Block bis auf seinen Titel. Öffnen Sie die Zusatzoptionen der Taxonomie im Tab Struktur (Structure) und setzen Sie die Umschalt-Option auf Ja, als geschlossen anzeigen (Yes, show as closed) oder Ja, als geöffnet anzeigen (Yes, show as opened). In 3.4.6 heißt diese Option im Popup der Taxonomie Umschalt-Button für Radio anzeigen (Show toggle button for radio), ist aber der Umschalter des Blocks dieser Taxonomie. Der Titel muss sichtbar sein (Titel-Label anzeigen (Show title label) = Ja (Yes)), denn der Umschalter sitzt darin. Im Tab Design wählt Blocktyp umschalten (Toggle block type) Text oder Bilder, und die Felder daneben legen die Texte fest (standardmäßig + und -) oder zwei Bilder von etwa 20×20 px.
Der Zustand des Blocks wird nicht im Browser gespeichert. Der Server setzt ihn bei jeder Seite: Ein auf „als geschlossen anzeigen“ gesetzter Block öffnet sich, wenn einer seiner Begriffe Teil des aktuellen Filters ist, sodass der Besucher sieht, was gewählt ist. Um Blöcke auch dann geschlossen zu halten oder sie offen zu erzwingen, verwenden Sie den 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
});
Der Hook erhält nur den Zustand, nicht die Taxonomie, und gilt daher für jeden Block, bei dem der Umschalter aktiviert ist.
Den ganzen Titel klickbar machen
Standardmäßig öffnet nur das +/- einen Block. Die FAQ zum Einbeziehen des Titels in den Umschalter hängt den Klick beim Laden der Seite an. Die folgende Version ist delegiert, funktioniert also weiter, nachdem das AJAX-Filtern das Formular neu gezeichnet hat, und ignoriert Klicks auf das +/- selbst, die den Block sonst doppelt umschalten würden:
/*
* 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);
Haben Sie den Titel-Tag mit dem Hook woof_title_tag geändert, ersetzen Sie h4 durch Ihren Tag. Ein Text-Umschalter ist ein Link, seine Farbe stellen Sie daher mit CSS ein, etwa .woof_container_inner h4 a.woof_front_toggle { color: #222; }.
Um mehrere Blöcke unter einer Überschrift einzuklappen, zum Beispiel alle Attribute unter „Weitere Filter“, nutzen Sie die Erweiterung Sections. Ist sie im Tab Erweiterungen (Extensions) aktiv, fassen ihre Einstellungen unter Erweitert (Advanced) → Abschnitte (Sections) eine Reihe von Filterelementen zu einem auf- und zuklappbaren Abschnitt zusammen; mit Abschnittsverhalten (Sections behavior) Als Checkbox (As checkbox) können mehrere Abschnitte gleichzeitig offen sein, Als Schaltknopf (As radio) hält nur einen offen.
Eine Hauptkategorie als Überschrift ohne Checkbox anzeigen
Sind Produkte nur Unterkategorien zugeordnet, funktioniert die Hauptkategorie besser als Überschrift. Ist im Tab Design ein Schaltknopf- und Checkbox-Skin (Radio and checkboxes skin) gewählt, wird der eigentliche Input in ein div gehüllt, dessen Klasse der Skin-Name mit Bindestrich ist: Der Skin square_blue ergibt icheckbox_square-blue (und iradio_square-blue für Radiobuttons). CSS, das mit icheckbox_square_grey mit Unterstrich geschrieben ist, trifft deshalb nichts. Die folgenden Regeln funktionieren mit jedem Skin und mit einfachen Inputs. Das Skript des Plugins fügt jedem Eintrag mit Unterkategorien auf jeder Ebene die Klasse woof_childs_list_li hinzu. Setzen Sie das CSS in Erweitert (Advanced) → Code → Individueller CSS-Code (Custom CSS code) oder in Ihr Theme:
/* 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;
}
Nur für eine Hauptkategorie verwenden Sie ihre Begriffsklasse, zum Beispiel .woof_term_123 > div[class*="icheckbox_"]. Einträge unterhalb der ersten Ebene haben keine Begriffsklasse; sprechen Sie sie über die Liste ihres übergeordneten Elements an: ul.woof_childs_list_123 > li.woof_childs_list_li > div[class*="icheckbox_"].
Der Name einer Hauptkategorie ist weiterhin ein Label seines verborgenen Inputs, ein Klick darauf würde die Hauptkategorie also auswählen. Das nächste Snippet verwandelt diesen Klick in das Öffnen und Schließen des Zweigs. Es ist auch die Antwort, wenn Sie die Checkboxen behalten, aber ein Klick auf den Kategorienamen seine Unterkategorien aufklappen soll:
/*
* 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);
Ersetzen Sie für eine andere Taxonomie product_cat durch deren Slug, zum Beispiel .woof_container_pa_brand.
Unterkategorien nicht eingerückt oder in einer Zeile
Das Plugin rückt jede Liste von Unterkategorien um 17 px ein. Stehen Unterkategorien bündig unter der Hauptkategorie, als wären sie selbst Hauptkategorien, entfernt eine Theme-Regel für Listen in Widgets oder Seitenleisten mit einem stärkeren Selektor diesen Innenabstand. Stellen Sie ihn wieder her:
.woof .woof_block_html_items .woof_childs_list {
padding: 0 0 0 17px !important;
}
Unterkategorien nebeneinander in einer Zeile stammen meist von der Blockoption Elemente in einer Reihe anzeigen (Display items in a row): Sie setzt jeden Begriff ohne Unterkategorien inline, Unterkategorien eingeschlossen. Setzen Sie sie für einen Baum auf Nein (No). Ist die Option aus, suchen Sie nach einer Theme-Regel, die Listen display: flex oder Listeneinträgen display: inline-block gibt.
Sind Plus und Minus der Öffnungssymbole auf Ihrem Hintergrund schwer zu erkennen, ersetzen Sie sie im Tab Design durch Bild für geöffnete Unterkategorien (Image for subcategories open) (das Plus) und Bild für geschlossene Unterkategorien (Image for subcategories close) (das Minus). Sie werden in einem Kästchen von 13×13 px angezeigt, verwenden Sie also einfache Symbole mit hohem Kontrast.
Kategoriefilter als Dropdown
Die Typen Dropdown-Liste (Drop-down) und Multi Dropdown (Multi drop-down) können Unterkategorien nicht einklappen. Das einfache Dropdown rückt Unterkategorien mit Leerzeichen ein; das Multi-Dropdown listet sie flach auf. Jede Option einer Unterkategorie trägt eine Klasse mit ihrer Tiefe, woof-padding-1, woof-padding-2 und so weiter, während Optionen der obersten Ebene keine haben. Browser erlauben nur wenig Gestaltung nativer Optionen, doch mit dem Dropdown-Skin (Drop-down skin) Chosen erreichen die Klassen die sichtbare Liste, sodass Sie die Ebenen markieren können:
/* 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; }
Sollen Besucher zuerst eine Hauptkategorie und dann in einem zweiten Dropdown deren Unterkategorie wählen, verwenden Sie die Erweiterung Hierarchy drop-down; der Artikel zu einem Filter nach Jahr, Marke und Modell zeigt die Einrichtung.
Checkliste
- Der Kategorieblock nutzt den Typ Checkbox oder Radio, und Verstecke untergeordnete Elemente in Checkboxen und Schaltknöpfen (Hide childs in checkboxes and radio) steht auf Ja (Yes).
- Der Standardzustand wurde in einem privaten Fenster geprüft, nicht in einem Browser, der geöffnete Zweige speichert.
- Das Zweig-Snippet ist eingebaut, wenn Zweige der Auswahl statt den früheren Klicks des Besuchers folgen sollen.
- Block-Umschalter sind in den Zusatzoptionen der Taxonomie gesetzt, der Titel wird angezeigt, und
woof_block_toggle_statekommt nur zum Einsatz, wenn das standardmäßige Öffnen bei Auswahl nicht gewünscht ist. - Das eigene CSS verwendet die Skin-Klasse mit Bindestrich oder die Form
[class*="icheckbox_"], und Seiten- und Browser-Caches wurden nach jeder Änderung geleert.
Verhält sich der Baum weiterhin nicht wie beschrieben, eröffnen Sie im HUSKY-Support-Forum ein Thema mit einem Link zur Filterseite und den Einstellungen des Kategorieblocks.