HUSKY - WooCommerce Product Filter Professional

Фільтр товарів WooCommerce не працює з WP Rocket і кешуванням

Коли фільтр товарів WooCommerce не працює з WP Rocket або іншим плагіном оптимізації, картина майже завжди однакова: поки ви авторизовані, усе працює, а для відвідувачів кліки нічого не роблять, індикатор завантаження крутиться безкінечно, або повзунок ціни виглядає як звичайне текстове поле. HUSKY віддає однаковий код обом категоріям. Різниця в тому, що кешування й оптимізація JavaScript зазвичай оминають авторизованих адміністраторів, тож ви ніколи не бачите оптимізовану сторінку, яку отримують відвідувачі. Нижче: як за хвилину прочитати помилку, що саме виключати у WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Optimizer і Cloudflare та як не дати кешу сторінок зламати AJAX-фільтрацію помилкою nonce error.

Чому фільтр працює для адміністраторів і не працює для відвідувачів

Фронтенд фільтра — це не один файл скрипта, а ланцюжок, який має виконуватися у фіксованому порядку:

  1. jQuery, від якого залежить кожен скрипт фільтра.
  2. Вбудований блок налаштувань, що виводиться на сторінку (у вихідному коді це <script id="woof_front-js-before">). Він задає змінні, потрібні фільтру: woof_current_values, woof_is_ajax, swoof_search_slug, woof_ext_init_functions, токен безпеки woof_front_nonce та інші.
  3. Файли плагіна з /wp-content/plugins/woocommerce-products-filter/: js/front.js, який зчитує ці змінні, скрипти елементів фільтра та розширень, а також jQuery-додатки, як-от iCheck (оформлення чекбоксів), ion.rangeSlider (повзунки) і plainOverlay (накладка завантаження).

Оптимізація й кешування ламають цей ланцюжок трьома способами. Оптимізація змінює порядок, наприклад відкладає файли, але не вбудований блок, або навпаки. Вона переміщує чи переписує вбудований блок під час об’єднання або мініфікації. А кеш сторінок зберігає HTML, у якому є дані з терміном дії — токен безпеки. Більшість плагінів кешування й оптимізації віддають авторизованим користувачам сторінку без кешу й без оптимізації, тому вигляд адміністратора доводить лише те, що сам фільтр справний.

Спершу прочитайте консоль браузера

Відкрийте магазин у приватному вікні, де ви не авторизовані. Натисніть F12 (Cmd+Option+I на Mac), відкрийте вкладку Консоль (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 definedjQuery відкладено, але код, якому він потрібен, виконався раніше
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 використовує його). Другий відповідає кожному файлу плагіна та його розширень. Третій відповідає вбудованим блокам: їхні id і змінні всередині починаються з 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 → Settings → 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) на вкладці Options або сторінка з [woof_products is_ajax=1]) і з атрибутом ajax_redraw фільтр запитує в сервера нові товари й надсилає токен woof_front_nonce, узятий зі сторінки. Сервер перевіряє його і, якщо токен недійсний, відповідає простим текстом nonce error. Скрипт очікує JSON, не може прочитати цю відповідь, і індикатор завантаження залишається на екрані.

Токен створюється під час генерації HTML. Для неавторизованих відвідувачів nonce у WordPress діє щонайменше 12 і щонайбільше 24 години. Сторінка з кешу, старша за цей термін, містить недійсний токен. Тому проблема з’являється на кешованих сторінках через добу після створення кешу, і тому перезавантаження іноді допомагає: воно потрапляє на свіжу копію. Очищення кешу виправляє це лише на кілька годин. Тривалі виправлення:

  • Тримайте час життя кешу HTML-сторінок меншим за 12 годин. Типові 10 годин у WP Rocket безпечні; довге кешування 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, Cmd+Shift+R на Mac).
  • Відфільтроване посилання відкривається без вибраних значень, або чистий магазин відкривається зі старим вибором. Кеш вважає URL з різними рядками запиту однією сторінкою. Кожен URL ?swoof=1&... має кешуватися окремо або не кешуватися взагалі, тому ніколи не налаштовуйте кеш ігнорувати рядки запиту в URL магазину.
  • Мобільний фільтр з’являється на десктопі або навпаки. Мобільний режим фільтра та деякі розширення вирішують на сервері, за user agent браузера, що виводити. Сторінку, кешовану для телефона, не можна віддавати десктопу: увімкніть окремі файли кешу для мобільних пристроїв.
  • Перше відвідування нової комбінації фільтрів повільніше: для цього URL ще немає кешованої копії. Про загальну швидкість див. прискорення фільтрації у великих каталогах.

Безпечний порядок перевірки

  1. Працюйте в приватному вікні, без авторизації, з відкритою консоллю.
  2. Вимкніть усю оптимізацію JavaScript (мініфікацію, об’єднання, відкладення, затримку, Rocket Loader) і очистьте кожен шар кешу. Якщо фільтр тепер працює, причина в оптимізації. Якщо він і далі не працює, причина десь в іншому місці: прочитайте першу помилку в консолі й перевірте з типовою темою на тестовій копії сайту.
  3. Вмикайте опції назад по одній, очищайте кеш і перевіряйте після кожної. Коли якась опція ламає фільтр, додайте до неї три рядки виключень або залиште її вимкненою.
  4. В режимі AJAX перевірте фільтр ще раз на сторінці, яка пролежала в кеші добу. Відсутність nonce error означає, що термін життя кешу або токена налаштовано правильно.
  5. Перевірте як на телефоні, так і на десктопі, а також на другій сторінці результатів.

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