Фильтр товаров WooCommerce не работает с WP Rocket и кэшем
Если фильтр товаров WooCommerce не работает с WP Rocket или другим плагином оптимизации, картина почти всегда одна и та же: пока вы авторизованы, всё работает, а у посетителей клики ничего не делают, индикатор загрузки крутится бесконечно, а слайдер цены превращается в обычное текстовое поле. HUSKY отдаёт обоим один и тот же код. Разница в том, что кэширование и оптимизация JavaScript обычно обходят авторизованных администраторов, поэтому вы никогда не видите оптимизированную страницу, которую получают посетители. Ниже: как за минуту прочитать ошибку, что именно исключить в WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Optimizer и Cloudflare и как не дать кэшу страниц сломать AJAX-фильтрацию ошибкой nonce error.
Почему фильтр работает у администратора и не работает у посетителей
Фронтенд фильтра — это не один файл скрипта, а цепочка, которая должна выполняться в строго определённом порядке:
- jQuery, от которого зависят все скрипты фильтра.
- Встроенный блок настроек, выводимый прямо в страницу (в исходном коде это
<script id="woof_front-js-before">). Он задаёт переменные, нужные фильтру:woof_current_values,woof_is_ajax,swoof_search_slug,woof_ext_init_functions, токен безопасностиwoof_front_nonceи другие. - Файлы плагина из
/wp-content/plugins/woocommerce-products-filter/:js/front.js, который читает эти переменные, скрипты элементов фильтра и расширений, а также jQuery-дополнения, такие как iCheck (оформление чекбоксов), ion.rangeSlider (слайдеры) и plainOverlay (оверлей загрузки).
Оптимизация и кэширование ломают эту цепочку тремя способами. Оптимизация меняет порядок, например откладывает файлы, но не встроенный блок, или наоборот. Она переносит или переписывает встроенный блок при объединении и минификации. А кэш страниц сохраняет HTML, в котором есть данные со сроком действия: токен безопасности. Большинство плагинов кэширования и оптимизации отдают авторизованным пользователям страницу без кэша и без оптимизации, поэтому вид из админки доказывает лишь одно: сам фильтр работает.
Сначала откройте консоль браузера
Откройте магазин в приватном окне, где вы не авторизованы. Нажмите F12 (на Mac — Cmd+Option+I), откройте вкладку Консоль (Console), перезагрузите страницу и кликните по фильтру. Первая красная ошибка подскажет, где искать причину.
| Сообщение в консоли | Что оно означает |
|---|---|
woof_current_values is not defined, то же самое для woof_is_ajax, swoof_search_slug, woof_ext_init_functions (Firefox: assignment to undeclared variable, Safari: Can't find variable) | Встроенный блок настроек не выполнился до front.js: его отложили, перенесли, удалили или сломали |
jQuery is not defined | jQuery отложен или загружается с задержкой, а код, которому он нужен, выполнился раньше |
iCheck is not a function, plainOverlay is not a function, ionRangeSlider is not a function | Файл дополнения не загрузился, либо вторая копия jQuery загрузилась после него и заменила объект jQuery |
woof_husky_txt is not defined | Блок данных текстового поиска был вырезан или отделён от своего файла |
SyntaxError с указанием на встроенный блок | Некорректный код во встроенном блоке, часто из поля для собственного JavaScript в настройках плагина (см. ниже) |
Identifier 'woof_front_nonce' has already been declared | Блок настроек выполнился дважды: оптимизатор или тема с AJAX-переходами между страницами повторно запустили встроенные скрипты |
"nonce error" is not valid JSON | Страница отдана из кэша, и срок действия её токена безопасности истёк |
Unexpected token '<' ... is not valid JSON | Сервер ответил на запрос фильтра HTML-кодом: уведомлением PHP, страницей файрвола или страницей из кэша |
Bad escaped character in JSON | Что-то переписало AJAX-ответ по пути к браузеру |
Ошибок нет вообще, но слайдер выглядит как обычное поле, значки + для раскрытия иерархических списков отсутствуют, а клики ничего не делают: скрипты ещё не выполнились. Так выглядят функции «отложить JavaScript до взаимодействия пользователя». Откройте исходный код страницы и найдите woof_front: если у тегов скриптов есть тип вроде rocketlazyloadscript или litespeed/javascript, их удерживает оптимизатор. Если woof_front в исходном коде нет вовсе, проверьте поле Инициализировать плагин только на следующих страницах сайта (Init plugin on the next site pages only) (Продвинутые → Код (Advanced → Code)): если в нём перечислены страницы, плагин загружается только на них.
Что исключить из оптимизации JavaScript
Правило одинаково в любом инструменте: jQuery, встроенные блоки и файлы плагина должны оставаться вместе и в исходном порядке. Исключить только front.js — частая полумера, которая не помогает, потому что блок настроек и jQuery всё равно откладываются. Эти три строки закрывают всё:
/wp-includes/js/jquery/
woocommerce-products-filter
woof_
Первая строка соответствует jQuery и jQuery UI (им пользуется слайдер цены в стиле WooCommerce). Вторая соответствует каждому файлу плагина и его расширений. Третья соответствует встроенным блокам: их идентификаторы и переменные внутри них начинаются с woof_. Поля исключений в плагинах оптимизации обычно сопоставляют ключевое слово и с URL файла, и с содержимым встроенных скриптов.
- WP Rocket. В разделе Оптимизация файлов (File Optimization) добавьте эти строки в исключаемые файлы опции Отложить выполнение JavaScript (Delay JavaScript execution); если фильтр всё равно не работает, добавьте их и в исключения опции Загружать JavaScript отложенно (Load JavaScript deferred) либо отключите эту опцию. Если для опции Оптимизировать доставку CSS (Optimize CSS delivery) выбрано удаление неиспользуемого CSS, добавьте стили плагина и классы
.woofв её белый список CSS: многие классы фильтра появляются только после выполнения JavaScript, поэтому при сканировании статичной страницы они считаются неиспользуемыми. - LiteSpeed Cache. Обычные причины — Объединение JS (JS Combine) и Отложенная загрузка JS (Load JS Deferred) (отложенная или с задержкой); добавьте эти строки в исключения для JS и в исключения для отложенной загрузки. Если запрос фильтра выполняется, но товары не обновляются, а в консоли появляется
Bad escaped character in JSON, отключите Сопоставление CDN (CDN Mapping): в подтверждённых случаях именно оно переписывало AJAX-ответ. - Autoptimize. При агрегации JavaScript jQuery попадает в объединённый файл в конце страницы, а встроенный код остаётся на месте и выполняется слишком рано. Оставьте
js/jquery/jquery.min.jsиwoocommerce-products-filterв поле Исключить скрипты из Autoptimize (Exclude scripts from Autoptimize). - SiteGround Speed Optimizer, WP-Optimize и похожие. Опции объединения, отложенной загрузки и «отложить встроенные скрипты» требуют тех же исключений либо должны быть отключены.
- Cloudflare Rocket Loader. Он загружает все скрипты асинхронно, включая встроенные блоки, а ещё мешает запуску расширения Фронтенд-конструктор фильтра (Filter front builder). Отключите его в настройках скорости Cloudflare, затем очистите кэш Cloudflare.
- Минификация HTML, которая «удаляет лишние символы», может повредить встроенные скрипты. Отключите в ней минификацию встроенного JavaScript.
- Код темы или сниппета на фильтре
script_loader_tag. WordPress пропускает встроенный блок через этот фильтр вместе с тегом скрипта, поэтому код, который удаляет атрибуты или заменяет кавычки, может его испортить. Удалите такой код или ограничьте его другими обработчиками.
Две настройки внутри фильтра
Поле JavaScript-код после завершения AJAX (JavaScript code after AJAX is done) (WooCommerce → Настройки → Products Filter → Продвинутые → Код (Advanced → Code)) вставляется во встроенный блок настроек как тело функции. Опечатка в нём, например незакрытая скобка, ломает весь блок, и все переменные фильтра становятся «not defined». Для проверки очистите поле; чтобы выполнить код после фильтрации, надёжнее использовать событие woof_ajax_done.
Опция Оптимизировать загрузку JavaScript-файлов HUSKY (Optimize loading of HUSKY JavaScript files) (Продвинутые → Опции (Advanced → Options)) переключает два способа загрузки: значение Нет (No) загружает front.js и ещё четыре отдельных скрипта для радиокнопок, чекбоксов и выпадающих списков; значение Да (Yes) загружает один сжатый файл, js/front_comprssd.js, в подвале страницы. Некоторые конфигурации оптимизаторов работают с одним значением и не работают с другим. Попробуйте оба, очищая все кэши после каждого изменения.
Кэш страниц и «nonce error»
В режиме AJAX (Пытаться использовать AJAX в магазине (Try to ajaxify the shop) на вкладке «Опции» или страница с [woof_products is_ajax=1]) и с атрибутом ajax_redraw фильтр запрашивает у сервера новые товары и отправляет токен woof_front_nonce, взятый со страницы. Сервер проверяет его и, если он недействителен, отвечает простым текстом nonce error. Скрипт ожидает JSON, не может прочитать такой ответ, и индикатор загрузки остаётся на экране.
Токен создаётся при генерации HTML. Для неавторизованных посетителей nonce-токены WordPress действуют не менее 12 и не более 24 часов. Страница из кэша, которая старше этого срока, содержит «мёртвый» токен. Поэтому проблема появляется на кэшированных страницах через сутки после создания кэша и поэтому иногда помогает перезагрузка: она случайно попадает на свежую копию. Очистка кэша решает проблему всего на несколько часов. Долговременные решения:
- Держите срок жизни кэша HTML-страниц меньше 12 часов. Срок WP Rocket по умолчанию, 10 часов, безопасен; типичный виновник — долгое кэширование HTML на CDN.
- Не кэшируйте HTML магазина и категорий на CDN. В Cloudflare добавьте правило кэширования, которое обходит кэш для магазина, URL
/product-category/и любой другой страницы с фильтром, а кэш страниц WordPress, соблюдающий собственный срок жизни, оставьте. Обхода только для отфильтрованных URL недостаточно: токен, которым пользуется посетитель, берётся со страницы, где начинается фильтрация. - Продлите срок жизни именно этого токена. Начиная с WordPress 6.1 фильтр nonce_life получает имя действия, поэтому токен фильтра может жить дольше, не затрагивая другие nonce на сайте. Токен защищает только публичный запрос списка товаров.
/*
* HUSKY: keep the filter token valid longer than the page cache lifespan.
* A token is valid for at least half of this time (here: 2 days).
* Child theme functions.php or a code snippets plugin.
*/
add_filter('nonce_life', function ($life, $action = -1) {
if ('woof_front_nonce' === $action) {
return 4 * DAY_IN_SECONDS;
}
return $life;
}, 10, 2);
Обычный режим перенаправления, без AJAX и без ajax_redraw, токен вообще не использует: каждое изменение фильтра загружает новый URL, и кэш страниц может отдавать отфильтрованные URL как любые другие страницы. Если вы вызываете фильтр из собственного кода, например отправляете свой jQuery-запрос к woof_draw_products, данные запроса должны включать nonce_filter: woof_front_nonce, иначе сервер ответит nonce error даже без всякого кэша.
Устаревшие фильтры и другие побочные эффекты кэша
- Изменённые настройки фильтра не отображаются. Настройки входят в кэшируемый HTML и во встроенный блок. После их сохранения очистите все слои кэша: плагин кэширования, серверный кэш (Varnish, Nginx, кэш хостинга), CDN, а затем обновите страницу в браузере без кэша (Ctrl+F5, на Mac — Cmd+Shift+R).
- Ссылка с фильтром открывается без выбранных значений, а чистый магазин — со старыми выбранными. Кэш считает URL с разными строками запроса одной страницей. Каждый URL вида
?swoof=1&...нужно кэшировать отдельно или не кэшировать вовсе, поэтому никогда не включайте в кэше игнорирование строк запроса для URL магазина. - Мобильный фильтр появляется на десктопе или наоборот. Мобильный режим фильтра и некоторые расширения решают на сервере, что выводить, по user agent браузера. Страницу, закэшированную для телефона, нельзя отдавать на десктоп: включите отдельные файлы кэша для мобильных устройств.
- Первое посещение новой комбинации фильтра медленнее: у этого URL ещё нет копии в кэше. Об общей скорости читайте в статье как ускорить фильтрацию в больших каталогах.
Безопасный порядок проверки
- Работайте в приватном окне, без авторизации, с открытой консолью.
- Отключите всю оптимизацию JavaScript (минификацию, объединение, отложенную загрузку, задержку, Rocket Loader) и очистите все слои кэша. Если фильтр заработал, причина в оптимизации. Если по-прежнему не работает, причина в другом: прочитайте первую ошибку в консоли и проверьте со стандартной темой на тестовой копии сайта.
- Включайте опции обратно по одной, каждый раз очищая кэш и проверяя. Когда какая-то из них ломает фильтр, добавьте в неё три строки исключений или оставьте её отключённой.
- В режиме AJAX проверьте фильтр ещё раз на странице, которая пролежала в кэше сутки. Если nonce error нет, срок жизни кэша или токена выбран правильно.
- Проверьте и на телефоне, и на десктопе, а также на второй странице результатов.
Если после этих шагов фильтр по-прежнему работает только для авторизованных пользователей, создайте тему на форуме поддержки HUSKY со ссылкой на страницу, первой ошибкой из консоли и списком включённых опций оптимизации, и мы посмотрим.