HUSKY - WooCommerce Product Filter Professional

Фільтр товарів WooCommerce не відображається на мобільному: причини

На комп’ютері фільтр працює, а на телефоні бічна панель зникла, кнопка Відкрити фільтр (Open filter) не з’являється або з’являється, але нічого не робить. Фільтр товарів WooCommerce, який не відображається на мобільному, рідко буває справді зламаним. Мобільний режим HUSKY складається з трьох частин: сервер визначає, що відвідувач користується телефоном, скрипт переносить кнопку на її місце, а дотик до кнопки відкриває форму як повноекранну панель. Кожну з цих частин може зупинити тема, конструктор сторінок, кеш або оптимізатор. Цей посібник показує, яка саме частина не спрацювала, і як це виправити.

Як працює мобільний режим HUSKY

Багато тем взагалі не показують бічну панель на телефонах. Якщо фільтр — це віджет бічної панелі і більше нічого не налаштовано, цього вже досить, щоб пояснити його відсутність. Мобільний режим — це спосіб плагіна дати телефонам кнопку, яка відкриває фільтр. Глобального перемикача «мобільний» у налаштуваннях немає; мобільний режим вмикається для кожної форми фільтра окремо:

  • Віджет: у віджеті HUSKY встановіть Мобільний режим (Mobile mode) у значення Так.
  • Шорткод: [woof sid="mobile" mobile_mode=1]. Атрибут sid обов’язковий; без нього mobile_mode ігнорується.
  • Front builder: увімкніть Мобільний режим (Mobile mode) у параметрах форми [woof_front_builder].

Коли сторінку згенеровано для телефона, плагін виводить цю форму прихованою і додає до неї дві кнопки: Відкрити фільтр (Open filter) і Закрити фільтр (Close filter). На комп’ютерах та сама форма відображається як зазвичай. Коли сторінка завантажується на телефоні, скрипт переносить кнопку Відкрити фільтр (Open filter) із прихованої форми у видиме місце:

  1. у контейнер, який виводить шорткод [woof_mobile], якщо він є на сторінці;
  2. інакше в елемент, що відповідає селектору .woocommerce-products-header, — блок із заголовком магазину або категорії в стандартному шаблоні архіву WooCommerce.

Дотик до кнопки додає формі клас woof_show_filter_for_mobile, і вона перетворюється на фіксовану повноекранну панель поверх сторінки. У режимі AJAX панель закривається сама після кожного фільтрування, щоб відвідувач побачив нові товари.

Більшість проблем пояснюють два факти. По-перше, «телефон» визначається на сервері функцією WordPress wp_is_mobile() за заголовками запиту, а не за шириною екрана. По-друге, [woof_mobile] лише позначає місце: він нічого не показує, якщо на тій самій сторінці немає форми з увімкненим мобільним режимом.

Кнопка «Відкрити фільтр» не з’являється

У шаблоні немає для неї місця. У шаблонах конструктора тем Elementor і Divi, макетах Avada, власних сторінках, що виводять товари шорткодом [products], та в багатьох нестандартних темах часто немає блоку .woocommerce-products-header. Тоді кнопка залишається всередині прихованої форми. Розмістіть [woof_mobile] точно там, де має бути кнопка, зазвичай над товарами, у віджеті або блоці «Шорткод». Це найпоширеніше виправлення. На комп’ютерах він нічого не виводить, тож може залишатися на сторінці.

Якщо в цьому шаблоні неможливо розмістити шорткод, вкажіть кнопці власний елемент через хук woof_mobile_btn_place_container. Надайте цьому елементу унікальний ID (в Elementor: Додатково → CSS ID (Advanced → CSS ID)) і використайте його:

/*
 * HUSKY: where to put the mobile "Open filter" button.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_mobile_btn_place_container', function ($selector) {
    return '#filter-button-place';
});

Використовуйте селектор, який відповідає лише одному елементу. Широкий клас, наприклад .elementor-widget-container, скопіює кнопку в кожен відповідний елемент на сторінці. Хук не застосовується, якщо на сторінці є контейнер [woof_mobile].

Інші причини, чому кнопки немає:

  • Тема приховує це місце на телефонах (шапка або панель, що відображається лише на комп’ютерах). Виберіть місце, яке видно на мобільних.
  • Спочатку кнопка є, а після фільтрування зникає: контейнер [woof_mobile] стоїть усередині списку товарів, який замінює AJAX. Перенесіть його над список.
  • Оптимізація JavaScript відкладає скрипти до першого дотику або прокручування («відкласти виконання JavaScript» у WP Rocket та подібних функціях). Кнопка переноситься лише тоді, коли виконується скрипт плагіна. Виключіть /wp-content/plugins/woocommerce-products-filter/ з відкладення, defer і об’єднання, потім очистьте кеші. Подробиці — у статті фільтр із WP Rocket і кешуванням.
  • Оптимізація CSS (об’єднання або «видалення невикористаного CSS») прибрала стилі плагіна, тож кнопка є на сторінці, але прихована або без оформлення. Виключіть і CSS плагіна.
  • Ви перевіряєте на планшеті. Safari на iPad і Chrome на більших планшетах Android за замовчуванням запитують настільну версію сайтів, тому ці планшети отримують настільний макет. Якщо тема приховує бічну панель за ширини планшета, фільтра там не буде; покажіть бічну панель за допомогою CSS або розмістіть форму в області вмісту.

Кнопка є, але нічого не відкривається

Форма розташована всередині прихованого елемента. Кнопка вже перенесена, але панель — це сама форма, яка залишається на своєму початковому місці. Якщо тема приховує бічну панель на телефонах через display: none, панель відкривається всередині прихованого блока і залишається невидимою. Є три виходи:

  • Показати бічну панель на телефонах за допомогою CSS. Форма HUSKY усередині неї залишається прихованою, доки не торкнуться кнопки, але стають видимими й інші віджети цієї панелі, тож це підходить для бічної панелі, де є лише фільтр.
  • Перенести форму з мобільним режимом із бічної панелі в область вмісту, наприклад над товари.
  • Залишити віджет для комп’ютерів (його Мобільний режим (Mobile mode) — Ні) і дозволити плагіну розміщувати фільтр над товарами лише на телефонах: Параметри → Автоматично розміщувати фільтр → Так, але лише для мобільних пристроїв (Options → Set filter automatically → Yes, but only for mobile devices) плюс Дизайн → Приховувати автофільтр за замовчуванням → Так (Design → Hide auto filter by default → Yes) для кнопки показати/приховати. Для цього потрібен шаблон, що виконує стандартний цикл товарів WooCommerce.

Типове правило для першого способу, із селектором, адаптованим до вашої теми:

/* Theme hides #secondary (sidebar) on phones: keep it for the HUSKY panel */
@media (max-width: 768px) {
    body.woocommerce-page #secondary {
        display: block;
    }
}

Те саме відбувається, коли фільтр розташований у висувній панелі теми (off-canvas) або у спливному вікні Elementor: висувна панель чи спливне вікно мають власну видимість і скрипти, і панель фільтра не може відкритися зсередини. Використовуйте або висувну панель, або мобільний режим HUSKY, але не обидва одночасно.

У sid є пробіл. Синтаксис скінів на кшталт sid="flat_grey woof_auto_3_columns" працює для вигляду форми, але у версії 3.4.6 мобільна кнопка не може знайти форму, у якої sid складається з двох слів. Для форми з мобільним режимом використовуйте sid з одного слова.

Є дві копії фільтра. У конструкторах сторінок часто є одна секція для комп’ютера і дубль для мобільного, приховані адаптивною видимістю. Обидві є в HTML, їх лише приховує CSS, тож дві форми з однаковими ідентифікаторами конфліктують: секції перестають відкриватися, з’являються дві іконки фільтра, або кнопка відкриває копію, яку не видно. Залишайте один фільтр на сторінці і дозвольте мобільному режиму обслуговувати телефони.

Помилка скрипта. Відкрийте сторінку на телефоні або в емуляції пристрою на комп’ютері після перезавантаження і перегляньте консоль браузера. Помилка в будь-якому скрипті, завантаженому раніше за скрипт HUSKY, зупиняє і його.

Мобільний макет на комп’ютері, настільний макет на телефоні

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

  • WP Rocket: увімкніть кешування для мобільних і Окремі файли кешу для мобільних пристроїв (Separate cache files for mobile devices).
  • LiteSpeed Cache: увімкніть Кешувати мобільні (Cache Mobile).
  • Кешування сторінок у Cloudflare, Varnish або кеш хостингу: кешуйте за типом пристрою або виключіть сторінки магазину і категорій.

Після зміни очистьте всі кеші. Те саме стосується видимості розширення slideout на мобільних і параметра Автоматично розміщувати фільтр (Set filter automatically) зі значеннями Так, але лише для мобільних пристроїв (Yes, but only for mobile devices) та Так, але лише для комп’ютерів (Yes, but only for desktop), які також використовують wp_is_mobile().

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

Проблеми всередині відкритої панелі

Випадаючі списки згорнуті, порожні або викликають клавіатуру. Випадаючі списки Chosen і SelectWoo обчислюють свою ширину під час завантаження сторінки, коли форма ще прихована, а ще вони мають поле пошуку, яке викликає клавіатуру телефона. Найчистіше виправлення — Дизайн → Скін випадаючого списку → Рідний (Design → Drop-down skin → Native): тоді телефони показують власний список вибору, без поля пошуку і проблем із шириною. Щоб залишити Chosen або SelectWoo, задайте їм мінімальну ширину:

/* HUSKY: drop-downs collapsed in a hidden or narrow container */
.woof .chosen-container,
.woof .select2-container {
    min-width: 200px;
}

Панель напівпрозора, схована під липкою шапкою або в ній невидимий текст. За замовчуванням панель трохи прозора і використовує z-index: 9999, який деякі липкі шапки перевищують. Налаштуйте її у власному CSS:

/* HUSKY mobile panel: opaque, above the sticky header, readable text */
.woof_show_filter_for_mobile.woof {
    opacity: 1;
    z-index: 100000;
}
.woof_show_filter_for_mobile.woof h4,
.woof_show_filter_for_mobile.woof label {
    color: #333;
}

Якщо панель усе одно відкривається під шапкою (шапка перебуває в контексті накладання, вище якого панель піднятися не може), додайте padding-top: 90px; до першого правила, щоб кнопка Закрити фільтр (Close filter) починалася під шапкою.

Панель закривається після кожного дотику. З автовідправленням і AJAX кожен вибір запускає фільтрування, а панель закривається, щоб показати результати. Якщо відвідувачі зазвичай поєднують кілька варіантів, вимкніть автовідправлення для цієї форми, [woof sid="mobile" mobile_mode=1 autosubmit=0], щоб вони спочатку вибирали, а потім торкалися кнопки фільтра.

Дрібні збої на iPhone. Зсунутий текст-заповнювач у полі текстового пошуку виправляє .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; }. Лічильники товарів у фільтрах типу «мітки», що віддаляються від своїх міток, виправляє .woof_container_label .woof_list_label li { position: relative; }.

Зміна кнопки

Вигляд кнопки задається на вкладці Дизайн (Design): Зображення для кнопки мобільного фільтра (Image for mobile filter button), Текст для кнопки мобільного фільтра (Text for mobile filter button), Зображення для закриття мобільного фільтра (Image to close mobile filter) і Текст для закриття мобільного фільтра (Text to close mobile filter). Введіть -1 у полі зображення, щоб показувати лише текст, або в полі тексту, щоб показувати лише іконку. Відступи й колір — це звичайний CSS для .woof_show_mobile_filter, наприклад .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }.

Основні кроки налаштування дивіться в статті як відобразити фільтр на мобільних пристроях; усі атрибути головного шорткоду — у довіднику [woof].

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

  • На сторінці одна форма фільтра з увімкненим мобільним режимом (параметр віджета, або mobile_mode=1 із sid з одного слова, або параметр Front builder).
  • [woof_mobile] розміщено там, де має бути кнопка, поза списком товарів, у місці, видимому на телефонах.
  • Сама форма не розташована в бічній панелі, висувній панелі чи спливному вікні, прихованих на телефонах.
  • JavaScript і CSS плагіна виключено з відкладення, defer, об’єднання та видалення невикористаного CSS.
  • Кеш сторінок зберігає окремі копії для мобільних пристроїв, і всі кеші очищено.
  • Перевірено на справжньому телефоні або в емуляції пристрою з перезавантаженням, без входу в обліковий запис.

Якщо фільтр усе одно не відображається на телефоні, відкрийте тему на форумі підтримки HUSKY і вкажіть посилання на сторінку, налаштування шорткоду або віджета, які ви використовуєте, та помилки з консолі браузера.