HUSKY - WooCommerce Product Filter Professional

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

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

Сначала настройки, потом CSS

Вкладка «Дизайн» (WooCommerce → Настройки → Products Filter → Дизайн (Design)) меняет внешний вид без кода:

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

Всё остальное помещается в Продвинутые (Advanced) → Код (Code) → Свой CSS-код (Custom CSS code). HUSKY выводит этот код сразу после собственной таблицы стилей на каждой странице, где он загружается, и хранит его в своих настройках, поэтому обновления плагина его не затрагивают. Вставляйте только обычные правила CSS: HTML-теги вроде <style> при сохранении настроек удаляются, а обратные косые черты сохраняются ненадёжно, поэтому записывайте символ напрямую (content: "✓"), а не через CSS-экранирование вроде \2713. Так же хорошо работают Дополнительные стили (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 со скином flat grey, с которого начинается новая установка; осмотрите форму, чтобы увидеть, какой из них на вашем сайте.

Карта классов

ЭлементСелектор
Вся форма фильтра.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) и оформите нативные элементы input. 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), скройте элементы input, пока скин их не обернёт:

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

Скин переносит каждый input в собственный элемент-квадратик, поэтому правило перестаёт срабатывать, как только скин готов. Если выбрано нет (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; }.
  • Невидимые чекбоксы. Правило темы скрывает элементы input или квадратики скина; сначала попробуйте другой скин, затем найдите правило в инспекторе.

О разных стилях на мобильных устройствах или во время выполнения поиска см. CSS для разных устройств и оформление страницы во время фильтрации.

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

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

Если вам нужна конкретная раскладка, которую эти правила не покрывают, опубликуйте ссылку на страницу и описание желаемого вида на форуме поддержки HUSKY; что указать, объясняет FAQ о небольших CSS-доработках.