HUSKY - WooCommerce Product Filter Professional

WooCommerce Produktfilter per CSS anpassen: Skins, Titel, Lösungen

Die CSS-Anpassung des WooCommerce-Produktfilters beginnt meist mit einem kleinen Wunsch: Checkboxen in der Markenfarbe, kleinere Titel, ein Dropdown, das zum Theme passt, oder eine Korrektur für ein Theme, das neben jeder Checkbox ein zweites Kästchen zeichnet. HUSKY deckt einen Teil davon mit Einstellungen ab, den Rest erledigen ein paar Zeilen CSS, sobald Sie wissen, wohin sie gehören und welche Klassen Sie ansprechen müssen. Diese Anleitung liefert beides, dazu die Lösungen für die Theme-Konflikte, die wir am häufigsten sehen.

Erst Einstellungen, dann CSS

Der Tab Design (WooCommerce → Einstellungen → Products Filter → Design) verändert das Aussehen ohne Code:

  • Schaltknopf- und Checkbox-Skin (Radio and checkboxes skin): die Skins flat, minimal und square in zehn Farben oder Keine (none) für die eigenen Kästchen des Browsers.
  • Dropdown-Skin (Drop-down skin): Native, Chosen oder SelectWoo.
  • Bereichs-Slider-Skin (Range-slider skin) für den Ion-Bereichsregler, Verwenden Sie den Tooltip (Use tooltip) und Tooltip-Symbol (Tooltip icon), die Bilder für Auf- und Zuklappen (Toggle) und für „mehr/weniger“ sowie das Lade-Overlay.

Alles andere gehört in Erweitert (Advanced) → Code → Individueller CSS-Code (Custom CSS code). HUSKY gibt diesen Code auf jeder Seite, auf der es geladen wird, direkt nach seinem eigenen Stylesheet aus und speichert ihn in seinen Einstellungen, sodass Plugin-Updates ihn nicht berühren. Fügen Sie ausschließlich einfache CSS-Regeln ein: HTML-Tags wie <style> werden beim Speichern der Einstellungen entfernt, und Backslashes bleiben nicht zuverlässig erhalten. Schreiben Sie ein Symbol daher direkt (content: "✓") statt als CSS-Escape wie \2713. Das Zusätzliche CSS (Additional CSS) des Themes im Customizer oder ein Stylesheet des Child-Themes funktioniert genauso gut. Bearbeiten Sie niemals die Datei css/front.css des Plugins: Das nächste Update ersetzt sie.

Dateilink für individuelle Front-CSS-Stile (Custom front css styles file link) am Ende des Tabs Design ist ein anderes Werkzeug. Es lädt Ihre Datei anstelle von front.css, nicht zusätzlich, nutzen Sie es also nur für eine vollständige Neufassung, die von einer Kopie der Plugin-Datei ausgeht.

Ihre Regeln durchsetzen

Theme-Stylesheets laden oft nach dem Plugin und verwenden lange Selektoren, und einige Regeln des Plugins tragen !important. Beginnen Sie jede Regel mit .woof oder mit body .woof, wenn das Theme weiterhin gewinnt, und setzen Sie !important nur dort ein, wo Plugin oder Theme es bereits verwenden. Um einen einzelnen Filter zu gestalten und die anderen unberührt zu lassen, geben Sie ihm mit dem Attribut sid eine ID: [woof sid="sidebar"] fügt dem Formular die Klasse woof_sid_sidebar hinzu. Halten Sie die ID bei einem Wort ohne Leerzeichen. Drei IDs bringen fertige Stile im Stylesheet des Plugins mit: flat_grey, flat_dark und flat_white. Das Widget verwendet immer woof_sid_widget. Der automatische Filter über den Produkten übernimmt seine Klassen aus der Skin-Einstellung: woof_sid_auto_shortcode beim Skin Standard (Default) und woof_sid_flat_grey plus woof_auto_2_columns beim grauen Flat-Skin, mit dem eine Neuinstallation startet; untersuchen Sie das Formular, um zu sehen, welcher auf Ihrer Seite verwendet wird.

Die Klassenübersicht

ElementSelektor
Gesamtes Filterformular.woof, .woof_sid_<sid>
Ein Filterblock.woof_container, nach Typ .woof_container_checkbox, .woof_container_radio, .woof_container_select; nach Taxonomie .woof_container_product_cat, .woof_container_pa_color
Blocktitel.woof_container_inner h4
Liste und Einträge.woof_list, .woof_list li; Unterkategorien .woof_childs_list
Checkbox, Label, Anzahlinput.woof_checkbox_term, .woof_checkbox_label, .woof_checkbox_count; ausgewählt .woof_checkbox_label_selected
Radiobutton und Labelinput.woof_radio_term, .woof_radio_label
Label-Buttons.woof_list_label .woof_label_term, ausgewählt .woof_label_term.checked
Natives Dropdownselect.woof_select
Buttons Filtern und Zurücksetzen.woof_submit_search_form_container button, .woof_submit_search_form, .woof_reset_search_form

Der Inspektor des Browsers (Rechtsklick auf ein Element, Untersuchen (Inspect)) zeigt die genauen Klassen Ihres Filters und welche Regel gewinnt. Das auf der Demo-Seite verwendete CSS ist eine gute Quelle für fertige Beispiele.

Checkboxen und Radiobuttons: Farbe, Größe und Schärfe

Die Skins flat, minimal und square zeichnen jedes Kästchen aus einem kleinen Bild-Sprite: Ein Bild enthält den nicht ausgewählten, den ausgewählten und den deaktivierten Zustand nebeneinander, und CSS zeigt den passenden Ausschnitt. Daraus folgen zwei Dinge: CSS kann das Kästchen nicht umfärben, und eine Änderung von width, height oder Skalierung zeigt benachbarte Zustände oder macht es unscharf und verpixelt. Wählen Sie die Skin-Farbe, die Ihrem Design am nächsten kommt, oder wechseln Sie zu den Kästchen des Browsers.

Für eine Markenfarbe oder ein größeres Kästchen setzen Sie Schaltknopf- und Checkbox-Skin (Radio and checkboxes skin) auf Keine (none) und gestalten die nativen Inputs. accent-color färbt sie in allen aktuellen Browsern ein:

/* Skin "none": colour and size of the browser's own boxes */
.woof .woof_list input.woof_checkbox_term,
.woof .woof_list input.woof_radio_term {
    accent-color: #1f7a4d;
    width: 18px;
    height: 18px;
}

Behalten die Kästchen danach das Aussehen des Themes, gestaltet das Theme jede Checkbox der Seite um; siehe den Abschnitt zu Theme-Konflikten weiter unten. Behalten Sie einen Skin, können Sie dessen Sprite dennoch durch eine umgefärbte Kopie desselben Layouts ersetzen (die Bilder liegen im Ordner js/icheck/skins/ des Plugins), und zwar über eine background-image-Regel auf der Klasse des Skins, zum Beispiel .woof .icheckbox_flat-blue. Für völlig eigene Elemente ohne CSS baut die Erweiterung Smart Designer Designs für Checkboxen, Radiobuttons und Schalter im Admin; siehe so erstellen Sie Ihr eigenes Filterelement.

Einfache Kästchen blitzen auf, bevor der Skin erscheint

Skins werden per JavaScript nach dem Laden der Seite angewendet, daher sind kurz die eigenen Kästchen des Browsers zu sehen. Verzögertes JavaScript eines Optimierungs-Plugins verlängert diesen Moment; siehe JavaScript-Optimierung und der Filter. Verbergen Sie bei jedem anderen Skin als Keine (none) die Inputs, bis der Skin sie umhüllt:

/* Only with a skin other than "none": hide inputs until the skin wraps them */
.woof .woof_list li > input.woof_checkbox_term,
.woof .woof_list li > input.woof_radio_term {
    visibility: hidden;
}

Der Skin verschiebt jeden Input in ein eigenes Kästchen-Element, daher trifft die Regel nicht mehr zu, sobald der Skin bereit ist. Bei dem Skin Keine (none) würde sie die Kästchen dauerhaft verbergen, verwenden Sie sie dort also nicht.

Lange Labels, Abstände und Label-Buttons

Das Plugin zeigt jedes Label als Inline-Block neben seinem Kästchen an. Ist der Name einer Kategorie oder eines Attributs länger als die Zeile, rutscht das ganze Label unter die Checkbox. Nutzen Sie je nach gewünschtem Aussehen eine dieser beiden Lösungen:

/* A: the text starts next to the box and wraps underneath it */
.woof .woof_list label {
    display: inline !important;
}

/* B: the text stays in its own column next to the box */
.woof .woof_list label {
    max-width: calc(100% - 35px);
    vertical-align: top;
}

Passen Sie 35px an die Breite Ihrer Kästchen an. Bei den Abständen gibt das Plugin jedem Block 5 px Innenabstand unten und 9 px Außenabstand unten sowie jedem Label 4 px Innenabstand oben und unten:

/* Tighter filter: less space between blocks and between items */
.woof .woof_container {
    margin-bottom: 4px;
    padding-bottom: 0;
}
.woof .woof_list label {
    padding-top: 2px;
    padding-bottom: 2px;
}
.woof .woof_checkbox_count {
    margin-left: 6px;
    color: #888;
}

Beim Typ Bezeichnung (label) (Begriffe als Buttons) setzt das Plugin ein hellgraues Kästchen sowie einen blauen Hover- und Auswahlzustand. Gleiche Breiten und eigene Farben:

.woof .woof_list_label .woof_label_term {
    min-width: 60px;
}
.woof .woof_list_label li .woof_label_term:hover,
.woof .woof_list_label li .woof_label_term.checked {
    background-color: #1f7a4d;
    border-color: #1f7a4d;
}

Einrückung und Einklappen von Unterkategorien behandeln die einklappbaren Kategoriebäume.

Titel: Schrift, Größe und Überschrift-Tag

Blocktitel sind h4-Elemente innerhalb von .woof_container_inner, auch der Titel des Preisfilters, und erben daher den h4-Stil des Themes:

.woof .woof_container_inner h4 {
    font-family: inherit;
    font-size: 15px;
    font-weight: 600;
    text-transform: none;
    margin-bottom: 6px;
}

Für einen anderen Tag, etwa passend zur Überschriftenstruktur Ihrer Seite, verwenden Sie den Filter woof_title_tag. Geben Sie p oder span zurück, wenn die Titel gar keine Überschriften sein sollen:

/*
 * HUSKY: print filter block titles as <h3> instead of <h4>.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_title_tag', function ($tag) {
    return 'h3';
});

Für h4 geschriebene Regeln greifen dann nicht mehr: der eigene Außenabstand des Plugins, die Titelstile der eingebauten Filter-IDs flat_grey und flat_dark sowie Ihr eigenes CSS. Schreiben Sie sie für den neuen Tag um, zum Beispiel .woof .woof_container_inner h3.

Die Überschrift über dem gesamten Widget ist etwas anderes. In der Seitenleiste eines Themes verwendet sie das Markup für Widget-Titel, das das Theme für alle Widgets festlegt; woof_widget_title_tag (Standard h3) gilt nur, wenn das Widget ohne dieses Markup ausgegeben wird. Um die Texte der Titel statt ihres Stils zu ändern, siehe so benennen Sie Filtertitel um.

Dropdowns: Native, Chosen oder SelectWoo

Kollidieren die Stile eines Themes mit den Dropdowns (abgeschnittener Text, falsch platzierte Tags in Mehrfachauswahlen, falsche Farben), wechseln Sie den Dropdown-Skin (Drop-down skin), bevor Sie CSS schreiben. Jeder Skin ist eine andere Bibliothek, und der Konflikt verschwindet oft mit einer anderen. Snippets mit dem Filter woof_use_chosen ändern nichts mehr; die Einstellung entscheidet.

  • Native: das select des Browsers, gestaltet von Ihrem Theme. Sprechen Sie .woof select.woof_select an.
  • Chosen: Das Kästchen ist .chosen-container mit .chosen-single (einzeln) oder .chosen-choices (mehrfach), und die geöffnete Liste .chosen-results li liegt innerhalb des Filters, sodass .woof alles eingrenzt.
  • SelectWoo: Das Kästchen ist .select2-container innerhalb des Filters, die geöffnete Liste aber hängt am Ende der Seite. Regeln für .select2-dropdown lassen sich nicht mit .woof eingrenzen und betreffen auch andere SelectWoo-Felder, etwa das Länderfeld an der Kasse.
/* Chosen: closed box and open list */
.woof .chosen-container-single .chosen-single {
    text-align: left;
    background: #fff;
    border-color: #ccc;
    border-radius: 4px;
}
.woof .chosen-container .chosen-results li {
    font-size: 15px;
    color: #222;
}

Tooltips

Das Info-Symbol neben einem Blocktitel öffnet per Klick den Text aus der Option Tooltip des Blocks. Es nutzt die Bibliothek Tooltipster mit ihrem Theme noir:

.tooltipster-sidetip.tooltipster-noir .tooltipster-box {
    background: #fff;
    border: 1px solid #ddd;
    border-radius: 6px;
}
.tooltipster-sidetip.tooltipster-noir .tooltipster-content {
    color: #333;
    font-size: 14px;
}

Leere Tooltip-Kästchen oder Tooltips an anderer Stelle der Seite, die zu grauen Quadraten werden, bedeuten, dass ein anderes Skript auf der Seite dieselbe oder eine kollidierende Tooltip-Bibliothek nutzt (gemeldet beim Theme Flatsome und bei Plugins für Produkt-Badges). Setzen Sie Verwenden Sie den Tooltip (Use tooltip) im Tab Design auf Nein (No); die Info-Symbole verschwinden dann aus dem Filter.

Die Namen, die über Farb- und Bildmustern erscheinen, sind reines CSS (p.woof_tooltip span.woof_tooltip_data). Verdeckt ein solcher Name das benachbarte Muster und fängt dessen Klicks ab, lassen Sie Klicks hindurchgehen:

.woof p.woof_tooltip span.woof_tooltip_data {
    pointer-events: none;
}

Theme-Konflikte: doppelte Kästchen, Rautezeichen und Ausrichtung

Viele Themes gestalten jede Liste, jedes Label und jede Checkbox der Seite, den Filter eingeschlossen. Untersuchen Sie das störende Element, um die Theme-Regel zu finden, und schalten Sie sie dann nur innerhalb von .woof ab.

  • Zwei Kästchen pro Eintrag. Das Theme zeichnet seine eigene Checkbox mit einem Pseudo-Element an Labels. Die Listen von HUSKY verwenden keine Pseudo-Elemente, daher lassen sie sich dort gefahrlos entfernen:
    .woof .woof_list label::before,
    .woof .woof_list label::after {
        display: none !important;
    }
  • Rautezeichen, Pfeile oder Symbole vor den Einträgen. Eine Theme-Regel für Widget-Listen fügt vor jedem li Inhalt hinzu:
    .woof .woof_list li::before {
        content: none !important;
    }
  • Ein Aufzählungspunkt neben dem ganzen Widget. Das Theme gibt Widgets als Listeneinträge aus: li.WOOF_Widget { list-style: none; }.
  • Zentrierte oder abgeschnittene Felder. body .woof .woof_redraw_zone { text-align: left; } behebt zentrierten Text aus dem Theme; am Rand der Seitenleiste abgeschnittener Inhalt stammt meist von overflow: hidden am Widget, setzen Sie also .widget.WOOF_Widget { overflow: visible; }.
  • Unsichtbare Checkboxen. Eine Theme-Regel verbirgt Inputs oder die Kästchen des Skins; probieren Sie zuerst einen anderen Skin und suchen Sie dann im Inspektor nach der Regel.

Für abweichende Stile auf Mobilgeräten oder während einer laufenden Suche siehe CSS je Gerät und die Seite während des Filterns gestalten.

Checkliste

  • Skin, Dropdown-Skin und Tooltips im Tab Design gewählt, bevor CSS geschrieben wird.
  • CSS in Individueller CSS-Code (Custom CSS code) oder im Theme, nie im Plugin-Ordner; einfache Regeln, keine Escapes.
  • Jede Regel beginnt mit .woof oder einer .woof_sid_-Klasse.
  • Skin Keine (none) plus accent-color für Markenfarben; keine Größenänderung bei Sprite-Skins.
  • Nach einer Änderung mit woof_title_tag die Regeln für h4 umgeschrieben.
  • Caches und CSS-Optimierung geleert, bevor das Ergebnis beurteilt wird.

Für ein bestimmtes Layout, das diese Regeln nicht abdecken, posten Sie im HUSKY-Support-Forum den Link zur Seite und eine Beschreibung des gewünschten Aussehens; die FAQ zu kleinen CSS-Anpassungen erklärt, was dazugehört.