HUSKY - WooCommerce Product Filter Professional

Налаштування CSS фільтра товарів WooCommerce: скіни, заголовки, виправлення

Налаштування CSS для фільтра товарів WooCommerce зазвичай починається з одного невеликого бажання: прапорці фірмового кольору, дрібніші заголовки, випадний список у стилі теми або виправлення теми, яка малює другий квадратик біля кожного прапорця. Частину цього HUSKY закриває налаштуваннями, а решта потребує кількох рядків CSS, якщо знати, куди їх додати і які класи вибирати. Цей посібник дає і те, і те, а також виправлення найчастіших конфліктів із темами.

Спершу налаштування, потім CSS

Вкладка «Дизайн» (WooCommerce → Налаштування (Settings) → Products Filter → Дизайн (Design)) змінює вигляд без коду:

  • Скін радіокнопок і прапорців (Radio and checkboxes skin): плоский, мінімалістичний і квадратний скіни в десяти кольорах або немає (none) для власних квадратиків браузера.
  • Скін випадного списку (Drop-down skin): Вбудований (Native), Chosen або SelectWoo.
  • Скін повзунка діапазону (Range-slider skin) для ion-повзунка, Використовувати підказку (Use tooltip) і Значок підказки (Tooltip icon), зображення перемикача й «більше/менше», а також накладка завантаження.

Усе інше йде в Додатково (Advanced) → Код (Code) → Власний CSS-код (Custom CSS code). HUSKY виводить цей код одразу після власної таблиці стилів на кожній сторінці, де він завантажується, і зберігає його у своїх налаштуваннях, тому оновлення плагіна його не торкаються. Вставляйте лише прості правила CSS: HTML-теги, як-от <style>, під час збереження налаштувань вилучаються, а зворотні скісні риски зберігаються ненадійно, тож записуйте символ безпосередньо (content: "✓") замість CSS-екранування на кшталт \2713. Додатковий CSS (Additional CSS) теми в кастомайзері або таблиця стилів дочірньої теми підходять так само. Ніколи не редагуйте файл плагіна css/front.css: наступне оновлення його замінить.

Посилання на власний файл стилів front css (Custom front css styles file link) наприкінці вкладки «Дизайн» це інший інструмент. Він завантажує ваш файл замість front.css, а не на додачу до нього, тож використовуйте його лише для повного переписування, яке починається з копії файлу плагіна.

Як зробити, щоб ваші правила перемагали

Таблиці стилів тем часто завантажуються після плагіна й використовують довгі селектори, а кілька правил плагіна містять !important. Починайте кожне правило з .woof або з body .woof, якщо тема все ще перемагає, і додавайте !important лише там, де його вже використовують плагін чи тема. Щоб стилізувати один фільтр і не чіпати інші, дайте йому ID через атрибут sid: [woof sid="sidebar"] додає до форми клас woof_sid_sidebar. Робіть ID одним словом без пробілів. Три ID мають готові стилі в таблиці стилів плагіна: flat_grey, flat_dark і flat_white. Віджет завжди використовує woof_sid_widget. Автоматичний фільтр над товарами бере класи з налаштування скіна: woof_sid_auto_shortcode зі скіном За замовчуванням (Default) і woof_sid_flat_grey разом із woof_auto_2_columns з плоским сірим скіном, з яким починається нова установка; огляньте форму, щоб побачити, який клас використовує ваш сайт.

Карта класів

ЕлементСелектор
Уся форма фільтра.woof, .woof_sid_<sid>
Один блок фільтра.woof_container, за типом .woof_container_checkbox, .woof_container_radio, .woof_container_select; за таксономією .woof_container_product_cat, .woof_container_pa_color
Заголовок блока.woof_container_inner h4
Список і його елементи.woof_list, .woof_list li; підкатегорії .woof_childs_list
Прапорець, мітка, лічильникinput.woof_checkbox_term, .woof_checkbox_label, .woof_checkbox_count; вибраний .woof_checkbox_label_selected
Радіокнопка і міткаinput.woof_radio_term, .woof_radio_label
Кнопки-мітки.woof_list_label .woof_label_term, вибрана .woof_label_term.checked
Вбудований випадний списокselect.woof_select
Кнопки «Фільтрувати» і «Скинути».woof_submit_search_form_container button, .woof_submit_search_form, .woof_reset_search_form

Інспектор браузера (клацніть елемент правою кнопкою миші, Переглянути код (Inspect)) показує точні класи вашого фільтра і те, яке правило перемагає. Хорошим джерелом готових прикладів є CSS, використаний на демосайті.

Прапорці й радіокнопки: колір, розмір і чіткість

Плоский, мінімалістичний і квадратний скіни малюють кожен квадратик із невеликого спрайта зображень: одна картинка містить стани «не вибрано», «вибрано» й «вимкнено» поруч, а CSS показує потрібну частину. Звідси два наслідки: CSS не може перефарбувати квадратик, а зміна його width, height або масштабу показує сусідні стани або робить його розмитим і пікселізованим. Виберіть колір скіна, найближчий до вашого дизайну, або перейдіть на квадратики браузера.

Для фірмового кольору або більшого квадратика встановіть Скін радіокнопок і прапорців (Radio and checkboxes skin) у значення немає (none) і стилізуйте рідні поля. accent-color фарбує їх в усіх сучасних браузерах:

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

Якщо після цього квадратики зберігають вигляд теми, тема переоформлює кожен прапорець на сайті; дивіться розділ про конфлікти з темами нижче. Якщо ви залишаєте скін, його спрайт усе одно можна замінити перефарбованою копією з таким самим розташуванням (зображення лежать у папці плагіна js/icheck/skins/) правилом background-image для класу скіна, наприклад .woof .icheckbox_flat-blue. Для повністю власних елементів без CSS розширення Smart Designer створює в адмінці дизайни прапорців, радіокнопок і перемикачів; дивіться як створити власний елемент фільтра.

Прості квадратики блимають, перш ніж з’являється скін

Скіни застосовує JavaScript після завантаження сторінки, тому на мить видно власні квадратики браузера. Відкладений JavaScript від плагіна оптимізації подовжує цю мить; дивіться оптимізація JavaScript і фільтр. З будь-яким скіном, окрім немає (none), приховайте поля, доки скін їх не обгорне:

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

Скін переміщує кожне поле у власний елемент-обгортку, тож правило перестає підходити, щойно скін готовий. Якщо скін установлено в немає (none), воно сховало б квадратики назавжди, тож там його не використовуйте.

Довгі мітки, відступи й кнопки-мітки

Плагін відображає кожну мітку як рядковий блок біля її квадратика. Коли назва категорії чи атрибута довша за рядок, уся мітка падає під прапорець. Скористайтеся одним із цих двох виправлень залежно від бажаного вигляду:

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

Підгоніть 35px під ширину ваших квадратиків. Щодо відступів, плагін задає кожному блоку 5 px внутрішнього відступу знизу й 9 px зовнішнього відступу знизу, а кожній мітці по 4 px внутрішнього відступу зверху й знизу:

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

Для типу мітка (label) (терміни як кнопки) плагін задає світло-сірий блок, а також синій колір при наведенні та у вибраному стані. Однакова ширина і власні кольори:

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

Відступи підкатегорій і їх згортання описано в статті згортувані дерева категорій.

Заголовки: шрифт, розмір і тег заголовка

Заголовки блоків це елементи h4 усередині .woof_container_inner, зокрема й заголовок фільтра ціни, тому вони успадковують стиль h4 теми:

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

Щоб використати інший тег, наприклад під структуру заголовків вашої сторінки, скористайтеся фільтром woof_title_tag. Повертайте p або span, якщо заголовки взагалі не мають бути заголовками:

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

Правила, написані для h4, тоді перестають діяти: власний відступ плагіна, стилі заголовків вбудованих ID фільтрів flat_grey і flat_dark, а також ваш власний CSS. Перепишіть їх для нового тега, наприклад .woof .woof_container_inner h3.

Заголовок над усім віджетом це інше. На бічній панелі теми він використовує розмітку заголовка віджета, яку тема визначає для всіх віджетів; woof_widget_title_tag (за замовчуванням h3) застосовується лише тоді, коли віджет виводиться без цієї розмітки. Щоб змінити тексти заголовків, а не їхній стиль, дивіться як перейменувати заголовки фільтрів.

Випадні списки: Native, Chosen або SelectWoo

Коли стилі теми конфліктують із випадними списками (обрізаний текст, зсунуті теги в списках множинного вибору, неправильні кольори), перемкніть Скін випадного списку (Drop-down skin), перш ніж писати CSS. Кожен скін це окрема бібліотека, і конфлікт часто зникає з іншою. Фрагменти, що використовують фільтр woof_use_chosen, більше нічого не змінюють; вирішує налаштування.

  • Вбудований (Native): select браузера, оформлений вашою темою. Вибирайте .woof select.woof_select.
  • Chosen: поле це .chosen-container з .chosen-single (одиничний вибір) або .chosen-choices (множинний), а відкритий список .chosen-results li лежить усередині фільтра, тому .woof обмежує все.
  • SelectWoo: поле це .select2-container усередині фільтра, але відкритий список приєднується в кінець сторінки. Правила для .select2-dropdown не можна обмежити через .woof, і вони також впливають на інші поля SelectWoo, як-от поле країни під час оформлення замовлення.
/* 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;
}

Підказки

Значок інформації біля заголовка блока при натисканні відкриває текст з опції Підказка (Tooltip) цього блока. Вона використовує бібліотеку Tooltipster із темою 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;
}

Порожні блоки підказок або підказки деінде на сайті, що перетворюються на сірі квадрати, означають, що інший скрипт на сторінці використовує ту саму або конфліктну бібліотеку підказок (про це повідомляли з темою Flatsome і з плагінами значків товарів). Встановіть Використовувати підказку (Use tooltip) у Ні (No) на вкладці «Дизайн»; значки інформації тоді зникнуть із фільтра.

Назви, що з’являються над зразками кольорів і зображень, це звичайний CSS (p.woof_tooltip span.woof_tooltip_data). Якщо така назва накриває сусідній зразок і перехоплює його кліки, нехай кліки проходять крізь неї:

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

Конфлікти з темою: подвійні квадратики, решітки й вирівнювання

Багато тем стилізують кожен список, мітку й прапорець на сторінці, у тому числі фільтр. Огляньте зайвий елемент, щоб знайти правило теми, а потім вимкніть його лише всередині .woof.

  • Два квадратики на елемент. Тема малює власний прапорець псевдоелементом на мітках. Списки HUSKY псевдоелементів не використовують, тож їх там можна безпечно прибрати:
    .woof .woof_list label::before,
    .woof .woof_list label::after {
        display: none !important;
    }
  • Решітки, стрілки чи значки перед елементами. Правило теми для списків віджетів додає вміст перед кожним li:
    .woof .woof_list li::before {
        content: none !important;
    }
  • Маркер біля всього віджета. Тема виводить віджети як елементи списку: li.WOOF_Widget { list-style: none; }.
  • Центровані або обрізані поля. body .woof .woof_redraw_zone { text-align: left; } виправляє центрований текст від теми; вміст, обрізаний на краю бічної панелі, зазвичай походить від overflow: hidden на віджеті, тож задайте .widget.WOOF_Widget { overflow: visible; }.
  • Невидимі прапорці. Правило теми ховає поля або квадратики скіна; спершу спробуйте інший скін, а тоді шукайте правило в інспекторі.

Про різні стилі для мобільних пристроїв або під час виконання пошуку дивіться CSS залежно від пристрою та стилізація сторінки під час фільтрування.

Контрольний список

  • Скін, скін випадного списку та підказки вибрано на вкладці «Дизайн», перш ніж писати CSS.
  • CSS у Власний CSS-код (Custom CSS code) або в темі, ніколи в папці плагіна; прості правила, без екранування.
  • Кожне правило починається з .woof або з класу .woof_sid_.
  • Скін немає (none) плюс accent-color для фірмових кольорів; без зміни розміру спрайтових скінів.
  • Після зміни woof_title_tag правила для h4 переписано.
  • Кеші та оптимізацію CSS очищено, перш ніж оцінювати результат.

Для конкретного макета, який ці правила не покривають, опублікуйте на форумі підтримки HUSKY посилання на сторінку й опис потрібного вигляду; у FAQ про невеликі зміни CSS пояснено, що вказати.