HUSKY - WooCommerce Product Filter Professional

Як згорнути підкатегорії у фільтрі категорій 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 для кожного терміна, щоб показувати лише верхній рівень.

Чому відкриті підкатегорії залишаються відкритими після перезавантаження

Коли відвідувач натискає перемикач, плагін зберігає стан цієї гілки в локальному сховищі браузера. На кожному завантаженні сторінки та після кожного перемальовування фільтра через 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), справжнє поле обгортається в div, клас якого це назва скіна з дефісом: скін square_blue дає icheckbox_square-blue (і iradio_square-blue для радіокнопок). CSS, записаний із icheckbox_square_grey, з підкресленням, тому нічому не відповідає. Правила нижче працюють з будь-яким скіном і зі звичайними полями. Скрипт плагіна додає клас 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_"].

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

/*
 * 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, указавши посилання на сторінку з фільтром і налаштування блока категорій.