Как свернуть подкатегории в фильтре категорий WooCommerce
Фильтр категорий, перечисляющий каждую подкатегорию, превращается в стену из чекбоксов. Большинству магазинов нужно дерево: родительские категории на виду, подкатегории свёрнуты под знаком плюс, а иногда родители показаны как обычные заголовки. Чтобы свернуть подкатегории в фильтре категорий WooCommerce, построенном на HUSKY, вы работаете с двумя отдельными механизмами, которые легко перепутать: маленький переключатель +/- рядом с категорией, у которой есть дочерние, и переключатель в заголовке блока, сворачивающий весь блок фильтра. У них разные настройки и разный способ хранить состояние, чем объясняется большинство сюрпризов вида «оно открывается само».
Свернуть подкатегории в фильтре категорий WooCommerce
На вкладке плагина Опции (Options) установите Скрывать дочерние в чекбоксах и радиокнопках (Hide childs in checkboxes and radio) в значение Да (Yes) (в новых установках оно уже включено). Каждый список подкатегорий тогда выводится скрытым, а у каждого термина с дочерними появляется переключатель после названия: маленький плюс, который превращается в минус, когда ветвь открыта. Он работает на любой глубине, так что у подкатегории со своими дочерними есть собственный переключатель.
- Он применяется только к типам фильтра Чекбокс (Checkbox) и Радиокнопка (Radio). Типы с выпадающим списком подкатегории не сворачивают (см. последний раздел).
- При значении Нет (No) все подкатегории всегда видны, переключателей нет.
- Для длинного списка категорий верхнего уровня откройте дополнительные опции (additional options) таксономии (кнопка с шестерёнкой рядом с ней на вкладке Структура (Structure)) и заполните Число несворачиваемых терминов (Not toggled terms count): показывается только столько терминов, а остальные открывает кнопка Показать больше (Show more).
Если у некоторых родителей подкатегории в фильтре вообще не нужны, их убирает хук woof_terms_where_hidden_childs. Он работает для чекбоксов, радиокнопок и выпадающих списков:
/*
* 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;
});
Верните 1 для каждого термина, чтобы показывать только верхний уровень.
Почему открытые подкатегории остаются открытыми после перезагрузки
Когда посетитель щёлкает переключатель, плагин сохраняет состояние этой ветви в локальном хранилище браузера (local storage). При каждой загрузке страницы и после каждой перерисовки фильтра через AJAX ветви, сохранённые как открытые, открываются снова. Локальное хранилище не истекает, поэтому ветвь, которую вы открыли при тестировании на прошлой неделе, открыта в вашем браузере и сегодня, а новый посетитель видит всё закрытым. Всегда проверяйте состояние по умолчанию в приватном окне.
Из такого устройства вытекают два побочных эффекта:
- Сохранённое состояние определяет, какая ветвь открыта, а не текущий выбор. Посетитель, пришедший по отфильтрованной ссылке, например из пункта меню, ведущего на фильтр по подкатегории, может обнаружить выбранную подкатегорию скрытой внутри закрытой ветви.
- Состояние хранится под классом элемента списка родителя. У категорий верхнего уровня есть собственный класс (
woof_term_15и так далее), а у элементов ниже первого уровня его нет, поэтому все ветви ниже первого уровня делят одно сохранённое состояние: откройте одну ветвь второго уровня, и после следующей загрузки страницы открыты все ветви второго уровня.
Настройки, отключающей эту память, нет, а правки js/front.js, которые когда-то предлагали для этого, пропадают при каждом обновлении. Приведённый ниже сниппет делает это из вашей темы. Плагин вызывает событие woof_init_search_form каждый раз, когда построил фильтр, при загрузке страницы и после перерисовки через AJAX; сниппет слушает его и заново задаёт состояние каждой ветви: открыта, если содержит выбранный термин, иначе закрыта.
/*
* 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);
Чтобы показывать все ветви открытыми по умолчанию, сохранив переключатели, замените строку var open на var open = true;.
Сворачивать целые блоки фильтра под их заголовками
Второй механизм скрывает весь блок, кроме заголовка. Откройте дополнительные опции таксономии на вкладке Структура (Structure) и установите опцию переключателя в значение Да, показывать закрытым (Yes, show as closed) или Да, показывать открытым (Yes, show as opened). В версии 3.4.6 эта опция в окне таксономии называется Показывать кнопку переключения для радио (Show toggle button for radio), но это переключатель блока данной таксономии. Заголовок должен быть виден (Показывать заголовок (Show title label) = Да (Yes)), потому что переключатель находится внутри него. На вкладке Дизайн (Design) параметр Тип переключателя блока (Toggle block type) выбирает текст или изображения, а соседние поля задают тексты (по умолчанию + и -) или два изображения примерно 20×20 px.
Состояние блока в браузере не запоминается. Его задаёт сервер на каждой странице: блок, настроенный как закрытый, открывается, когда один из его терминов входит в текущий фильтр, так что посетитель видит, что выбрано. Чтобы блоки оставались закрытыми и в этом случае или чтобы принудительно их открывать, используйте хук 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
});
Хук получает только состояние, но не таксономию, поэтому применяется к каждому блоку, у которого включён переключатель.
Сделать кликабельным весь заголовок
По умолчанию блок открывает только +/-. FAQ о том, как включить в переключатель и заголовок, навешивает клик при загрузке страницы. Версия ниже делегированная, поэтому продолжает работать после того, как фильтрация через AJAX перерисует форму, и игнорирует клики по самому +/-, которые иначе переключили бы блок дважды:
/*
* 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);
Если вы меняли тег заголовка хуком woof_title_tag, замените h4 вашим тегом. Текстовый переключатель — это ссылка, поэтому её цвет задаётся CSS, например .woof_container_inner h4 a.woof_front_toggle { color: #222; }.
Чтобы свернуть несколько блоков под одним заголовком, например все атрибуты под «Дополнительные фильтры», используйте расширение Sections. Когда оно активно на вкладке Расширения (Extensions), его настройки в разделе Продвинутые (Advanced) → Секции (Sections) оборачивают диапазон элементов фильтра в открываемую и закрываемую секцию; Поведение секций (Sections behavior) Как чекбокс (As checkbox) позволяет держать открытыми несколько секций одновременно, Как радио (As radio) оставляет открытой только одну.
Показать родительскую категорию как заголовок без чекбокса
Когда товары назначены только подкатегориям, родитель лучше работает как заголовок. Если на вкладке Дизайн (Design) выбран Скин радиокнопок и чекбоксов (Radio and checkboxes skin), настоящий input оборачивается в div, класс которого — имя скина с дефисом: скин square_blue даёт icheckbox_square-blue (и iradio_square-blue для радиокнопок). CSS, написанный с icheckbox_square_grey, то есть с подчёркиванием, поэтому ничему не соответствует. Приведённые ниже правила работают с любым скином и с обычными input. Скрипт плагина добавляет класс woof_childs_list_li каждому элементу, у которого есть дочерние, на любом уровне. Поместите CSS в Продвинутые (Advanced) → Код (Code) → Свой CSS-код (Custom CSS code) или в вашу тему:
/* 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;
}
Только для одной категории верхнего уровня используйте её класс термина, например .woof_term_123 > div[class*="icheckbox_"]. У элементов ниже первого уровня класса термина нет; нацеливайтесь на них через список их родителя: ul.woof_childs_list_123 > li.woof_childs_list_li > div[class*="icheckbox_"].
Название родителя по-прежнему является подписью своего скрытого input, поэтому щелчок по нему выберет родителя. Следующий сниппет превращает этот щелчок в открытие и закрытие ветви. Это также ответ на случай, когда вы оставляете чекбоксы, но хотите, чтобы щелчок по названию категории раскрывал её подкатегории:
/*
* 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);
Для другой таксономии замените product_cat её слагом, например .woof_container_pa_brand.
Подкатегории без отступа или в одну строку
Плагин делает отступ 17 px у каждого списка подкатегорий. Когда подкатегории выстраиваются под родителем так, будто сами являются родителями, правило темы для списков в виджетах или боковых колонках убирает этот отступ с более сильным селектором. Верните его:
.woof .woof_block_html_items .woof_childs_list {
padding: 0 0 0 17px !important;
}
Подкатегории рядом в одной строке обычно возникают из-за опции блока Показывать элементы в строку (Display items in a row): она выводит в строку каждый термин без дочерних, включая подкатегории. Для дерева установите Нет (No). Если опция выключена, поищите правило темы, которое задаёт спискам display: flex, а элементам списка — display: inline-block.
Если плюс и минус переключателей плохо видны на вашем фоне, замените их на вкладке Дизайн (Design) параметрами Изображение для открытых подкатегорий (Image for subcategories open) (плюс) и Изображение для закрытых подкатегорий (Image for subcategories close) (минус). Они отображаются в блоке 13×13 px, поэтому используйте простые контрастные значки.
Фильтры категорий в виде выпадающего списка
Типы Выпадающий список (Drop-down) и Выпадающий список с множественным выбором (Multi drop-down) подкатегории сворачивать не умеют. Одиночный выпадающий список делает отступы у подкатегорий пробелами; список с множественным выбором выводит их плоско. Каждый вариант-подкатегория несёт класс с глубиной, woof-padding-1, woof-padding-2 и так далее, а у вариантов верхнего уровня его нет. Браузеры позволяют лишь немного оформлять нативные варианты, но если Скин выпадающего списка (Drop-down skin) установлен в Chosen, классы попадают в видимый список, и уровни можно выделить:
/* 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; }
Если посетитель должен сначала выбрать родителя, а затем его подкатегорию во втором выпадающем списке, используйте расширение Hierarchy drop-down; настройка показана в статье о фильтре по году, марке и модели.
Контрольный список
- Блок категорий использует тип Чекбокс (Checkbox) или Радиокнопка (Radio), а Скрывать дочерние в чекбоксах и радиокнопках (Hide childs in checkboxes and radio) установлено в Да (Yes).
- Состояние по умолчанию проверено в приватном окне, а не в браузере, который помнит открытые ветви.
- Сниппет для ветвей установлен, если ветви должны следовать выбору, а не прежним щелчкам посетителя.
- Переключатели блоков заданы в дополнительных опциях таксономии, заголовок показывается, а
woof_block_toggle_stateиспользуется, только если открытие по выбору, действующее по умолчанию, не нужно. - Свой CSS использует класс скина с дефисом или форму
[class*="icheckbox_"], а кэши страницы и браузера очищались после каждого изменения.
Если дерево по-прежнему ведёт себя не так, как описано, создайте тему на форуме поддержки HUSKY со ссылкой на страницу фильтра и настройками блока категорий.