HUSKY - WooCommerce Product Filter Professional

Dostosowanie CSS filtra produktów WooCommerce: skórki, tytuły, poprawki

Dostosowanie CSS filtra produktów WooCommerce zwykle zaczyna się od jednego drobnego życzenia: pól wyboru w kolorze marki, mniejszych tytułów, listy rozwijanej pasującej do motywu albo poprawki dla motywu, który rysuje drugie pole obok każdego pola wyboru. HUSKY pokrywa część tych potrzeb ustawieniami, a reszta wymaga kilku linijek CSS, gdy już wiesz, gdzie je umieścić i które klasy wskazać. Ten przewodnik podaje jedno i drugie, a także poprawki dla konfliktów z motywami, które widzimy najczęściej.

Najpierw ustawienia, potem CSS

Karta Wygląd (WooCommerce → Ustawienia → Products Filter → Wygląd (Design)) zmienia wygląd bez kodu:

  • Skórka przycisków radio i pól wyboru (Radio and checkboxes skin): skórki płaskie, minimalne i kwadratowe w dziesięciu kolorach albo Żaden (none) dla własnych pól przeglądarki.
  • Skórka listy rozwijanej (Drop-down skin): Natywna (Native), Chosen lub SelectWoo.
  • Skórka suwaka zakresu (Range-slider skin) dla suwaka ion, Używaj wskazówki (Use tooltip) i Ikona wskazówki (Tooltip icon), obrazy przełącznika i „więcej/mniej” oraz nakładka ładowania.

Wszystko inne trafia do Zaawansowane (Advanced) → Kod (Code) → Własny kod CSS (Custom CSS code). HUSKY drukuje ten kod zaraz po własnym arkuszu stylów na każdej stronie, na której się ładuje, i przechowuje go w swoich ustawieniach, więc aktualizacje wtyczki go nie ruszają. Wklejaj wyłącznie zwykłe reguły CSS: znaczniki HTML, takie jak <style>, są usuwane przy zapisie ustawień, a ukośniki wsteczne nie są zachowywane niezawodnie, więc symbol wpisz bezpośrednio (content: "✓") zamiast sekwencji ucieczki CSS, jak \2713. Równie dobrze działa Dodatkowy CSS (Additional CSS) w Customizerze motywu lub arkusz stylów motywu potomnego. Nigdy nie edytuj pliku wtyczki css/front.css: następna aktualizacja go zastąpi.

Link do pliku własnych stylów css frontendu (Custom front css styles file link) na końcu karty Wygląd to inne narzędzie. Ładuje Twój plik zamiast front.css, a nie obok niego, więc używaj go tylko do całkowitego przepisania stylów, zaczynając od kopii pliku wtyczki.

Jak sprawić, by Twoje reguły wygrywały

Arkusze stylów motywów często ładują się po wtyczce i używają długich selektorów, a kilka reguł wtyczki ma !important. Zaczynaj każdą regułę od .woof albo body .woof, gdy motyw nadal wygrywa, i dodawaj !important tylko tam, gdzie robi to już wtyczka lub motyw. Aby ostylować jeden filtr, a pozostałe zostawić w spokoju, nadaj mu identyfikator atrybutem sid: [woof sid="sidebar"] dodaje do formularza klasę woof_sid_sidebar. Identyfikator ma być jednym słowem bez spacji. Trzy identyfikatory mają gotowe style w arkuszu wtyczki: flat_grey, flat_dark i flat_white. Widget zawsze używa woof_sid_widget. Automatyczny filtr nad produktami bierze swoje klasy z ustawienia skórki: woof_sid_auto_shortcode ze skórką Domyślne (Default) oraz woof_sid_flat_grey plus woof_auto_2_columns z płaską szarą skórką, od której zaczyna nowa instalacja; sprawdź formularz w inspektorze, aby zobaczyć, która dotyczy Twojej witryny.

Mapa klas

ElementSelektor
Cały formularz filtra.woof, .woof_sid_<sid>
Jeden blok filtra.woof_container, według typu .woof_container_checkbox, .woof_container_radio, .woof_container_select; według taksonomii .woof_container_product_cat, .woof_container_pa_color
Tytuł bloku.woof_container_inner h4
Lista i elementy.woof_list, .woof_list li; podkategorie .woof_childs_list
Pole wyboru, etykieta, licznikinput.woof_checkbox_term, .woof_checkbox_label, .woof_checkbox_count; zaznaczone .woof_checkbox_label_selected
Przycisk radio i etykietainput.woof_radio_term, .woof_radio_label
Przyciski-etykiety.woof_list_label .woof_label_term, zaznaczony .woof_label_term.checked
Natywna lista rozwijanaselect.woof_select
Przyciski Filtruj i Resetuj.woof_submit_search_form_container button, .woof_submit_search_form, .woof_reset_search_form

Inspektor przeglądarki (kliknij element prawym przyciskiem, Zbadaj (Inspect)) pokazuje dokładne klasy Twojego filtra i to, która reguła wygrywa. Dobrym źródłem gotowych przykładów jest CSS używany na stronie demo.

Pola wyboru i przyciski radio: kolor, rozmiar i ostrość

Skórki płaskie, minimalne i kwadratowe rysują każde pole z małego sprite'a obrazów: jeden obraz zawiera obok siebie stany niezaznaczony, zaznaczony i wyłączony, a CSS pokazuje odpowiednią jego część. Wynikają z tego dwie konsekwencje: CSS nie może zmienić koloru pola, a zmiana jego width, height lub skali pokazuje sąsiednie stany albo czyni obraz rozmytym i pikselowym. Wybierz kolor skórki najbliższy Twojemu projektowi albo przełącz się na pola przeglądarki.

Dla koloru marki lub większego pola ustaw Skórka przycisków radio i pól wyboru (Radio and checkboxes skin) na Żaden (none) i stylizuj natywne elementy input. accent-color koloruje je we wszystkich aktualnych przeglądarkach:

/* 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;
}

Jeśli po tym pola nadal mają wygląd z motywu, motyw przestylowuje każde pole wyboru w witrynie; zobacz sekcję o konfliktach z motywami poniżej. Jeśli zostajesz przy skórce, nadal możesz zastąpić jej sprite przekolorowaną kopią o tym samym układzie (obrazy są w folderze wtyczki js/icheck/skins/) za pomocą reguły background-image na klasie skórki, na przykład .woof .icheckbox_flat-blue. Dla w pełni własnych elementów bez CSS rozszerzenie Smart Designer buduje w panelu administracyjnym projekty pól wyboru, przycisków radio i przełączników; zobacz jak stworzyć własny element filtra.

Zwykłe pola migają, zanim pojawi się skórka

Skórki są nakładane przez JavaScript po załadowaniu strony, więc przez chwilę widoczne są własne pola przeglądarki. Opóźniony JavaScript z wtyczki optymalizującej wydłuża tę chwilę; zobacz optymalizacja JavaScript a filtr. Przy każdej skórce innej niż Żaden (none) ukryj elementy input, dopóki skórka ich nie opakuje:

/* 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;
}

Skórka przenosi każdy input do własnego elementu pola, więc reguła przestaje pasować, gdy tylko skórka jest gotowa. Przy skórce ustawionej na Żaden (none) ukryłaby pola na stałe, więc tam jej nie używaj.

Długie etykiety, odstępy i przyciski-etykiety

Wtyczka wyświetla każdą etykietę jako blok liniowy obok jej pola. Gdy nazwa kategorii lub atrybutu jest dłuższa niż wiersz, cała etykieta spada pod pole wyboru. Użyj jednej z dwóch poprawek, zależnie od pożądanego wyglądu:

/* 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;
}

Dostosuj 35px do szerokości swoich pól. Co do odstępów, wtyczka nadaje każdemu blokowi 5 px dolnego dopełnienia i 9 px dolnego marginesu, a każdej etykiecie 4 px dopełnienia powyżej i poniżej:

/* 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;
}

Dla typu Etykieta (label) (określenia jako przyciski) wtyczka ustawia jasnoszare pole oraz niebieski stan po najechaniu i zaznaczeniu. Równe szerokości i własne kolory:

.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;
}

Wcięcia podkategorii i ich zwijanie opisuje artykuł zwijane drzewa kategorii.

Tytuły: czcionka, rozmiar i znacznik nagłówka

Tytuły bloków to elementy h4 wewnątrz .woof_container_inner, także tytuł filtra cen, więc dziedziczą styl h4 motywu:

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

Aby użyć innego znacznika, na przykład dopasowanego do struktury nagłówków Twojej strony, skorzystaj z filtra woof_title_tag. Zwróć p lub span, jeśli tytuły w ogóle nie mają być nagłówkami:

/*
 * 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';
});

Reguły napisane dla h4 przestają wtedy działać: własny margines wtyczki, style tytułów wbudowanych identyfikatorów filtrów flat_grey i flat_dark oraz Twój własny CSS. Przepisz je dla nowego znacznika, na przykład .woof .woof_container_inner h3.

Nagłówek nad całym widgetem to co innego. W pasku bocznym motywu używa on znaczników tytułu widgetu, które motyw definiuje dla wszystkich widgetów; woof_widget_title_tag (domyślnie h3) działa tylko wtedy, gdy widget jest drukowany bez tych znaczników. Aby zmienić teksty tytułów, a nie ich styl, zobacz jak zmienić nazwy tytułów filtrów.

Listy rozwijane: Natywna, Chosen lub SelectWoo

Gdy style motywu kolidują z listami rozwijanymi (ucięty tekst, źle ustawione tagi w listach wielokrotnego wyboru, błędne kolory), przełącz Skórka listy rozwijanej (Drop-down skin), zanim zaczniesz pisać CSS. Każda skórka to inna biblioteka, a konflikt często znika po zmianie. Fragmenty kodu używające filtra woof_use_chosen niczego już nie zmieniają; decyduje ustawienie.

  • Natywna (Native): element select przeglądarki, stylizowany przez Twój motyw. Celuj w .woof select.woof_select.
  • Chosen: pole to .chosen-container z .chosen-single (pojedynczy wybór) lub .chosen-choices (wielokrotny), a otwarta lista .chosen-results li znajduje się wewnątrz filtra, więc .woof obejmuje wszystko.
  • SelectWoo: pole to .select2-container wewnątrz filtra, ale otwarta lista jest doczepiana na końcu strony. Reguł dla .select2-dropdown nie da się ograniczyć za pomocą .woof, a ponadto wpływają na inne pola SelectWoo, takie jak pole kraju w kasie.
/* 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;
}

Wskazówki

Ikona informacji obok tytułu bloku otwiera po kliknięciu tekst z opcji Wskazówka (Tooltip) tego bloku. Używa biblioteki Tooltipster z motywem 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;
}

Puste okna wskazówek albo wskazówki w innych miejscach witryny zamieniające się w szare kwadraty oznaczają, że inny skrypt na stronie używa tej samej lub kolidującej biblioteki wskazówek (zgłaszano to z motywem Flatsome i wtyczkami odznak produktów). Ustaw Używaj wskazówki (Use tooltip) na Nie (No) na karcie Wygląd; ikony informacji znikną wtedy z filtra.

Nazwy pojawiające się nad próbkami kolorów i obrazów to zwykły CSS (p.woof_tooltip span.woof_tooltip_data). Jeśli taka nazwa zasłania sąsiednią próbkę i przechwytuje jej kliknięcia, przepuść kliknięcia przez nią:

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

Konflikty z motywami: podwójne pola, krzyżyki i wyrównanie

Wiele motywów stylizuje każdą listę, etykietę i pole wyboru na stronie, także filtr. Zbadaj zbłąkany element, aby znaleźć regułę motywu, a następnie wyłącz ją tylko wewnątrz .woof.

  • Dwa pola przy każdym elemencie. Motyw rysuje własne pole wyboru za pomocą pseudoelementu na etykietach. Listy HUSKY nie używają pseudoelementów, więc można je tam bezpiecznie usunąć:
    .woof .woof_list label::before,
    .woof .woof_list label::after {
        display: none !important;
    }
  • Krzyżyki, strzałki lub ikony przed elementami. Reguła motywu dla list w widgetach dodaje zawartość przed każdym li:
    .woof .woof_list li::before {
        content: none !important;
    }
  • Punktor obok całego widgetu. Motyw drukuje widgety jako elementy listy: li.WOOF_Widget { list-style: none; }.
  • Wyśrodkowane lub ucięte pola. body .woof .woof_redraw_zone { text-align: left; } naprawia wyśrodkowany tekst z motywu; treść ucięta na krawędzi paska bocznego zwykle pochodzi z overflow: hidden na widgecie, więc ustaw .widget.WOOF_Widget { overflow: visible; }.
  • Niewidoczne pola wyboru. Reguła motywu ukrywa elementy input lub pola skórki; najpierw wypróbuj inną skórkę, potem poszukaj reguły w inspektorze.

Różne style na urządzeniach mobilnych lub w trakcie wyszukiwania opisują artykuły CSS zależny od urządzenia i stylizowanie strony podczas filtrowania.

Lista kontrolna

  • Skórka, skórka listy rozwijanej i wskazówki wybrane na karcie Wygląd, zanim zaczniesz pisać CSS.
  • CSS w Własny kod CSS (Custom CSS code) lub w motywie, nigdy w folderze wtyczki; zwykłe reguły, bez sekwencji ucieczki.
  • Każda reguła zaczyna się od .woof lub klasy .woof_sid_.
  • Skórka Żaden (none) plus accent-color dla kolorów marki; bez zmiany rozmiaru skórek ze sprite'ami.
  • Po zmianie woof_title_tag przepisane reguły dla h4.
  • Pamięci podręczne i optymalizacja CSS wyczyszczone, zanim ocenisz wynik.

W przypadku konkretnego układu, którego te reguły nie obejmują, opublikuj link do strony i opis docelowego wyglądu na forum wsparcia HUSKY; FAQ o drobnych dostosowaniach CSS wyjaśnia, co dołączyć.