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. Смещённый placeholder в поле текстового поиска исправляется правилом .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; }. Счётчики товаров у фильтров-меток (label), уезжающие от своих меток, исправляются правилом .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 со ссылкой на страницу, настройками используемого шорткода или виджета и ошибками из консоли браузера.