HUSKY Turbo Mode не работает: серый фильтр и пропавшие товары
Когда Turbo Mode в HUSKY не работает, симптомы выглядят не связанными между собой: фильтр остаётся серым, категория не возвращает товаров, новые товары не появляются, счётчики неверны, а режим AJAX не удаётся отключить. Почти все эти проблемы вытекают из одного архитектурного решения: в Turbo Mode фильтрация выполняется в браузере посетителя по заранее собранному файлу с данными о товарах. Ниже описано, как этот файл создаётся и используется, и приведено решение для каждого симптома.
Как работает Turbo Mode и когда его стоит применять
В обычном режиме при каждом клике по фильтру сервер выполняет запрос WooCommerce и считает товары для каждого термина. Turbo Mode переносит эту работу в браузер. HUSKY записывает все опубликованные товары и их вариации в один JSON-файл (по умолчанию в wp-content/uploads/uploads_woof_turbo_mode/): ID, название, артикул, цены, статус наличия, термины каждой таксономии товаров и значения полей Meta filter. Браузер скачивает его на каждой странице сайта, где работает плагин (ограничьте список таких страниц настройкой Инициализировать плагин только на следующих страницах сайта (Init plugin on the next site pages only) на вкладке Дополнительно (Advanced)), находит подходящие товары и рисует счётчики; сервер лишь выводит найденные товары по их ID.
Поэтому результаты настолько же актуальны, насколько актуален файл; товар, которого в нём нет, найти нельзя; применяются только условия, понятные браузеру; а каждый посетитель скачивает весь каталог, что при десятках тысяч товаров и вариаций означает мегабайты и медленный старт на телефонах. Turbo Mode оправдан на слабом сервере при умеренном каталоге, который меняется нечасто. Если сервер справляется с запросами, сначала попробуйте обычный режим с кэшами, описанными в статье как ускорить фильтрацию товаров в больших каталогах.
Включайте в правильном порядке
- WooCommerce → Настройки → Products Filter → Расширения (Extensions): отметьте Turbo Mode (Turbo mode) и сохраните.
- Дополнительно (Advanced) → Turbo Mode (Turbo mode): установите Включить Turbo Mode (Enable turbo mode) в значение Да (Yes) и сохраните.
- Нажмите Обновить сейчас! (Update now!) в блоке Пересобрать данные о товарах сейчас! (Reassemble products data now!) и не закрывайте страницу, пока не появится Файл обновлён!!! (File updated!!!). Без файла фильтр не может искать.
- Выберите Период WordPress Cron (WordPress Cron period) и Где хранить файл с данными о товарах (Where to keep products data file) и сохраните.
- На вкладке Опции (Options) задайте Показывать количество (Show count), Динамический пересчёт (Dynamic recount) и Скрывать пустые термины (Hide empty terms): в Turbo Mode это отдельные копии настроек (подробнее ниже). Затем очистите кэш страниц и кэш CDN.
Фильтр серый и не становится кликабельным
Серый слой — это элемент с классом woof_turbo_mode_overlay. Он закрывает фильтр с самого начала, а скрипт Turbo Mode убирает его после загрузки файла и отрисовки счётчиков. Если слой остался, скрипт не отработал до конца:
- Скрипты отложены, перенесены или объединены. Функции оптимизации в WP Rocket, LiteSpeed Cache и подобных плагинах могут запускать скрипты с опозданием, не в том порядке или вообще не запускать. Turbo Mode нужны
ext/turbo_mode/js/turbo_mode.jsиext/quick_search/js/alasql/alasql.min.jsизwp-content/plugins/woocommerce-products-filter/после jQuery. Исключите папку плагина из delay, defer и объединения, затем очистите все кэши; исключения описаны в статье фильтр, WP Rocket и кэширование. - Ошибка JavaScript. Откройте консоль браузера (F12) и перезагрузите страницу. Первая красная ошибка указывает на скрипт, из-за которого остановились остальные.
- Большой файл на медленном соединении. На вкладке Network посмотрите размер и время загрузки
data_0000_xxx.json. Если загрузка держит фильтр серым несколько секунд, каталог слишком велик для Turbo Mode.
Скрытие слоя через CSS (.woof_turbo_mode_overlay{display:none;}) лишь прячет симптом: фильтр станет кликабельным, но без загруженного файла искать он не сможет.
Если файл загрузить не удаётся, вместо фильтра выводится сообщение Oh no! It looks like the filter can't open the search file. Проверьте следующее:
- файл существует. Файл, хранящийся в папке плагина (plugins\woocommerce-products-filter\ext\turbo_mode\data), удаляется при каждом обновлении плагина, поэтому после обновлений пересоберите его или храните в wp-uploads\uploads_woof_turbo_mode;
- ни правило сервера, ни плагин безопасности не блокируют файлы
.jsonв uploads: откройте адрес файла из вкладки Network напрямую; - адрес верный. Плагин запрашивает
wp-content/uploads/uploads_woof_turbo_mode/, поэтому на подсайте multisite или при перенесённой папке uploads запрос возвращает 404. В этом случае храните файл в папке плагина.
Товары не найдены или пропадают после фильтрации
Turbo Mode возвращает только те товары, которые есть в файле, и сопоставляет их с хранящимися там данными. Проверьте и то и другое из консоли браузера на странице с фильтром, когда он уже загрузился:
woof_turbo_mode_file.length // records in the file: products + variations
woof_turbo_mode_file.find(p => p.id == 123) // what is stored for product 123
Сравните первое число с количеством опубликованных товаров плюс вариаций; в WP-CLI его выдаёт команда wp post list --post_type=product,product_variation --post_status=publish --format=count. Если для товара возвращается undefined, его нет в файле. Если он там есть, посмотрите его taxonomies и stock.
Файл устарел
Новые товары, изменённые категории, атрибуты, цены и остатки попадают в фильтр только после следующей пересборки. Типичные признаки: новый товар виден на странице магазина, но исчезает после первого клика по фильтру; у новых терминов счётчик равен 0; последние страницы пагинации пусты; элемент Meta filter, добавленный после последней пересборки, ничего не находит. Пересобирайте файл после импорта и после изменения элементов фильтра.
Лимит в 15 000
Обновить сейчас! (Update now!) останавливается после 15 000 записей, причём вариации тоже считаются. У магазина с 2 000 вариативных товаров по восемь вариаций в каждом их уже 18 000. Кнопка обрабатывает сначала самые новые товары, поэтому не попадают в файл самые старые. Если счётчик рядом с кнопкой остановился на Products and Variants: 15000, вы упёрлись в лимит. Поднимите его хуком woof_turbo_mode_products_limit и пересоберите файл:
/*
* HUSKY Turbo mode: let "Update now" write up to 40,000 products and variations.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_turbo_mode_products_limit', function ($limit) {
return 40000;
});
Этот хук не ограничивает плановую пересборку: она обрабатывает весь каталог.
Товары в подкатегориях не находятся
В файле хранятся только те категории, которые отмечены у каждого товара, а браузер сравнивает их буквально: дерева категорий он не знает. WordPress показывает товары подкатегорий в родительской категории, а Turbo Mode — нет: товар, отмеченный только в категории «Беговые кроссовки», отображается на странице «Обувь» до первого клика по фильтру, а потом исчезает, термин «Обувь» в фильтре его не находит, а счётчик «Обувь» его не учитывает. Отметьте у таких товаров все уровни цепочки («Обувь» и «Беговые кроссовки»), например массовым редактированием в разделе Товары → Все товары, и пересоберите файл.
Скрытые товары и товары не в наличии
Товары с видимостью в каталоге Только магазин (Shop only) или Скрыто (Hidden) (настройка Видимость в каталоге (Catalog visibility)) считаются скрытыми от поиска, и Turbo Mode никогда не возвращает их после фильтрации, что бы ни стояло в Учитывать видимость в каталоге (Listen catalog visibility). Поэтому товар с видимостью Только магазин (Shop only) появляется на странице магазина и пропадает после первого клика; если его нужно фильтровать, установите Магазин и результаты поиска (Shop and search results). Если в WooCommerce включена настройка Скрывать товары, отсутствующие на складе, из каталога (Hide out of stock items from the catalog), товары не в наличии в файл не попадают, а товар, который снова появился в наличии, остаётся пропущенным до следующей пересборки.
Языки WPML
При работе с WPML HUSKY записывает отдельный файл для каждого языка (data_0000_en.json, data_0000_de.json) и загружает файл текущего языка. Товара без перевода в файле этого языка нет, поэтому после перевода пересоберите файл.
Как поддерживать файл поиска в актуальном состоянии
Обновить сейчас! (Update now!) собирает файл пакетами по десять товаров или вариаций, не чаще одного пакета в секунду, и показывает счётчик Products and Variants. Каждый пакет перезаписывает весь файл, поэтому 15 000 записей занимают не менее 25 минут. В отличие от плановой пересборки, кнопка сначала удаляет текущий файл, и пока сборка не завершится, сайт фильтрует по неполным данным: запускайте её в спокойное время, не закрывайте страницу и не отключайте Turbo Mode посреди процесса.
Период WordPress Cron (WordPress Cron period) задаёт автоматическую пересборку: ежедневно (daily), еженедельно (weekly) (по умолчанию), дважды в месяц (twicemonthly), ежемесячно (monthly), каждую минуту (min1) или без обновления (without update). Несмотря на название, это не событие WP-Cron. HUSKY ведёт собственное расписание (опция woof_turbo_init_wpcrone_): когда подходит срок пересборки, каждый запрос, загружающий WordPress вместе с плагином (не чаще одного раза в пять секунд), добавляет следующие десять записей во временный файл, который заменяет рабочий после последнего пакета. До этого момента посетители получают прежние данные. Из этого следует:
- WP Crontrol и похожие инструменты это расписание не показывают, а
DISABLE_WP_CRONего не останавливает. - Скорость зависит от запросов, доходящих до PHP; страницы, отданные из кэша страниц, не в счёт. Для 20 000 записей нужно не менее 2 000 запросов с интервалом в пять секунд — почти три часа непрерывного трафика, а на малопосещаемом сайте дни.
- Первая автоматическая пересборка наступает через полный период после сохранения расписания, поэтому после включения нажмите Обновить сейчас! (Update now!).
- Период отсчитывается от конца предыдущей пересборки. Значение каждую минуту (min1) запускает следующую пересборку через минуту, и сайт пересобирает файл постоянно; используйте его только для небольших каталогов.
- Если нажать Обновить сейчас! (Update now!) во время автоматической пересборки, будет удалён и её временный файл; когда автоматический запуск завершится, он заменит ваш полный файл частью, собранной после этого. Если товары снова пропадают спустя несколько часов после ручной пересборки, нажмите кнопку ещё раз.
На сайте с низким трафиком нужные запросы может обеспечить задание cron на сервере; в FAQ почему не работают автоматические обновления по cron показаны настройка и ограничения PHP. Вызывайте его каждую минуту, а не раз в сутки, потому что каждый вызов добавляет один пакет. Если вы ограничили плагин настройкой Инициализировать плагин только на следующих страницах сайта (Init plugin on the next site pages only), пусть cron обращается к /wp-admin/admin-ajax.php, где плагин загружается всегда. Но и тогда добавляется лишь 600 записей в час, поэтому для каталогов, которые меняются массово, нажимайте Обновить сейчас! (Update now!) после каждого импорта.
Другие периоды можно добавить хуком woof_turbo_mode_schedules, не редактируя файлы плагина; затем выберите новый период и сохраните:
/*
* HUSKY Turbo mode: add "every 12 hours" to WordPress Cron period.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_turbo_mode_schedules', function ($schedules) {
$schedules['every_12_hours'] = array(
'name' => 'every 12 hours',
'value' => 12 * HOUR_IN_SECONDS,
);
return $schedules;
});
После каждой пересборки файл сохраняет прежний адрес. Если CDN или браузер кэширует файлы .json, посетители могут продолжать получать старые данные: исключите папку uploads_woof_turbo_mode из кэширования CDN или очищайте её после пересборок.
Turbo Mode требует AJAX и имеет собственные настройки счётчиков
Пока Turbo Mode включён, HUSKY при каждой загрузке страницы сбрасывает четыре настройки: Попытаться перевести магазин на AJAX (Try to ajaxify the shop) принимает значение Да (Yes), а обычные Показывать количество (Show count), Динамический пересчёт (Dynamic recount) и Скрывать пустые термины (Hide empty terms) — значение Нет (No). Тогда на вкладке Опции (Options) появляются собственные копии этих трёх настроек Turbo Mode под теми же названиями, а у Динамического пересчёта (Dynamic recount) можно выбрать Да, для всех устройств (Yes, for all devices) или Да, только для ПК (Yes, only for PC).
- Пока включён Turbo Mode, AJAX отключить нельзя. Установите Включить Turbo Mode (Enable turbo mode) в значение Нет (No), сохраните и только затем меняйте Попытаться перевести магазин на AJAX (Try to ajaxify the shop).
- Если сетка товаров темы ломается после AJAX-фильтрации (один товар в строке, пропавшие столбцы, сломанная пагинация), Turbo Mode наследует эту проблему: см. настройку числа столбцов в режиме AJAX и проблемы с пагинацией в режиме AJAX либо оставьте Turbo Mode выключенным для этой темы.
- После отключения Turbo Mode задайте Показывать количество (Show count), Динамический пересчёт (Dynamic recount) и Скрывать пустые термины (Hide empty terms) заново: они по-прежнему Нет (No), поэтому в этот момент счётчики и пропадают.
- Скрывать пустые термины (Hide empty terms) работает только при включённых Показывать количество (Show count) и Динамический пересчёт (Dynamic recount); если выключить Показывать количество (Show count), две другие настройки тоже выключаются.
- Настройки Кэшировать число динамического пересчёта для каждого элемента в фильтре (Cache dynamic recount number for each item in filter), Кэшировать термины (Cache terms) и Оптимизировать фильтр по цене (Optimize price filter) пропадают из Дополнительно → Опции, пока включён Turbo Mode; к нему они не относятся.
Чего Turbo Mode не умеет
- Элемент Иерархический выпадающий список (Hierarchy drop-down) с ним не работает, как указано на странице расширения Turbo Mode.
- Счётчики и Скрывать пустые термины (Hide empty terms) работают для стандартных элементов (флажок, переключатель, выпадающие списки, цвет, изображение, метка, слайдер). Для элементов, созданных в Smart Designer, счётчиков нет.
- В наличии (In stock) учитывает только собственный статус наличия каждого товара; настройка, проверяющая вариации, не действует, поэтому фильтр по размеру всё равно может показывать вариации, которых нет в наличии.
- Текстовый поиск сравнивает введённые слова только с названиями товаров, даже если элемент текстового поиска настроен на поиск в описаниях или других полях. Отдельный элемент поиска по артикулу работает.
- Условия, добавленные в PHP, в поиске не участвуют, потому что решение о том, какие товары подходят, принимает браузер. Пользовательский код на
woof_products_queryилиpre_get_posts, собственные расширения и плагины, ограничивающие товары по продавцу или группе покупателей, могут лишь скрыть часть найденных товаров уже после поиска, из-за чего счётчики и пагинация перестают совпадать.
Если вашему магазину нужна любая из этих возможностей или цены и остатки меняются каждый час, отключите Turbo Mode и ускорьте обычный режим с помощью кэширования.
Контрольный список
- В консоли нет красных ошибок; скрипты плагина исключены из delay, defer и объединения.
woof_turbo_mode_file.lengthсовпадает с числом опубликованных товаров плюс вариаций; счётчик не остановился на лимите.- Файл пересобран после последнего импорта или изменения фильтра; кэш страниц и CDN очищены.
- Товары отмечены во всей цепочке категорий и имеют видимость Магазин и результаты поиска (Shop and search results).
- Настройки счётчиков заданы в копиях Turbo Mode и заданы заново после его отключения.
Если фильтр по-прежнему работает неправильно, создайте тему на форуме поддержки HUSKY и укажите ссылку на страницу, ошибки консоли, значение woof_turbo_mode_file.length и количество ваших товаров и вариаций.