HUSKY - WooCommerce Product Filter Professional

Режим Turbo HUSKY не працює: сірий фільтр і зниклі товари

Коли режим Turbo у HUSKY не працює, симптоми здаються не пов’язаними між собою: фільтр залишається сірим, категорія не повертає жодного товару, нові товари не з’являються, лічильники хибні або AJAX-режим неможливо вимкнути. Майже всі вони випливають з одного конструктивного рішення: в режимі Turbo фільтрація відбувається в браузері відвідувача, за заздалегідь сформованим файлом із даними про товари. Нижче описано, як цей файл створюється й використовується, і наведено способи усунення кожного симптому.

Як працює режим Turbo і коли його варто використовувати

У звичайному режимі кожен клік по фільтру змушує сервер виконувати запит WooCommerce і рахувати товари для кожного терміна. Режим Turbo переносить цю роботу в браузер. HUSKY записує всі опубліковані товари та їхні варіації в один JSON-файл (за замовчуванням у wp-content/uploads/uploads_woof_turbo_mode/) з ID, назвою, артикулом, цінами, статусом наявності, термінами кожної таксономії товарів і значеннями полів Meta filter. Браузер завантажує його на кожній сторінці сайту, де працює плагін (обмежте ці сторінки за допомогою Ініціалізувати плагін лише на таких сторінках сайту (Init plugin on the next site pages only) на вкладці Додатково (Advanced)), знаходить відповідні товари й малює лічильники; сервер лише виводить знайдені товари за їхніми ID.

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

Вмикайте його в правильному порядку

  1. WooCommerce → Налаштування → Products Filter → Розширення (Extensions): позначте Режим Turbo (Turbo mode) і збережіть.
  2. Додатково (Advanced) → Режим Turbo (Turbo mode): установіть для Увімкнути режим Turbo (Enable turbo mode) значення Так (Yes) і збережіть.
  3. Натисніть Оновити зараз! (Update now!) під Перезібрати дані товарів зараз! (Reassemble products data now!) і не закривайте сторінку, доки не з’явиться Файл оновлено!!! (File updated!!!). Без файлу фільтр не може шукати.
  4. Виберіть Період WordPress Cron (WordPress Cron period) та Де зберігати файл даних товарів (Where to keep products data file) і збережіть.
  5. На вкладці Опції (Options) задайте Показувати лічильник (Show count), Динамічний перерахунок (Dynamic recount) і Приховувати порожні терміни (Hide empty terms): у режимі Turbo це окремі копії цих параметрів (пояснення нижче). Потім очистьте кеш сторінок і кеш CDN.

Фільтр сірий і ніколи не стає клікабельним

Сірий шар — це елемент із класом woof_turbo_mode_overlay. Він закриває фільтр із першої миті, а скрипт режиму Turbo прибирає його після того, як файл завантажено й лічильники намальовано. Якщо шар лишається, цей скрипт не завершив роботу:

  • Скрипти відкладені, з атрибутом defer або об’єднані. Функції оптимізації в WP Rocket, LiteSpeed Cache та подібних плагінах можуть запускати скрипти із запізненням, не в тому порядку або взагалі не запускати. Режиму Turbo потрібні ext/turbo_mode/js/turbo_mode.js і ext/quick_search/js/alasql/alasql.min.js із wp-content/plugins/woocommerce-products-filter/ після jQuery. Виключіть папку плагіна з відкладання, defer та об’єднання, а потім очистьте всі кеші; винятки пояснено в статті фільтр із WP Rocket і кешуванням.
  • Помилка JavaScript. Відкрийте консоль браузера (F12) і перезавантажте сторінку. Перша червона помилка вказує на скрипт, що зупинив решту.
  • Великий файл на повільному з’єднанні. На вкладці Network перевірте розмір і час завантаження data_0000_xxx.json. Якщо через завантаження фільтр залишається сірим по кілька секунд, каталог завеликий для режиму Turbo.

Приховування шару через 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/, тому на підсайті мультисайту або коли папку uploads перенесено в інше місце, запит повертає 404. У такому разі зберігайте файл у папці плагіна.

Товари не знайдено або зникають після фільтрації

Режим Turbo повертає лише товари, що є у файлі, і зіставляє їх із даними, збереженими там. Перевірте обидва аспекти з консолі браузера на сторінці з фільтром, коли він уже завантажився:

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 записів, і варіації рахуються також. Магазин із 2000 варіативних товарів по вісім варіацій у кожного вже має 18 000. Кнопка обробляє найновіші товари першими, тож пропущеними виявляються ваші найстаріші товари. Якщо лічильник біля кнопки зупинився на Товари та варіації: 15000 (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 — ні: товар, позначений лише в категорії «Кросівки для бігу», відображається на сторінці «Взуття» до першого кліку по фільтру, а потім зникає; термін «Взуття» у фільтрі його не знаходить, а лічильник «Взуття» його не враховує. Позначайте в таких товарів кожен рівень ланцюжка («Взуття» і «Кросівки для бігу»), наприклад, масовим редагуванням у розділі Товари → Усі товари, а потім перебудуйте файл.

Приховані товари та товари, яких немає в наявності

Товари, у яких Видимість у каталозі (Catalog visibility) має значення Лише магазин (Shop only) або Прихований (Hidden), вважаються прихованими від пошуку, і режим Turbo ніколи не повертає їх після фільтрації, що б не було встановлено в Враховувати видимість у каталозі (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 посеред процесу.

Період 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 записів потрібно щонайменше 2000 запитів із проміжком у п’ять секунд, це близько трьох годин безперервного трафіку, а на малолюдному сайті — кілька днів.
  • Перша автоматична перебудова відбувається через один повний період після збереження розкладу, тому після вмикання натисніть Оновити зараз! (Update now!).
  • Період відліковується від завершення попередньої перебудови. min1 запускає наступну через хвилину, тож сайт перебудовується постійно; використовуйте його лише для невеликих каталогів.
  • Якщо натиснути Оновити зараз! (Update now!) під час автоматичної перебудови, її тимчасовий файл також видаляється; коли автоматичний процес завершується, він замінює ваш повний файл тією частиною, яку встиг побудувати після цього. Якщо товари знову зникають через кілька годин після ручної перебудови, натисніть кнопку ще раз.

На сайті з малим трафіком запити можна забезпечити серверним завданням cron; у FAQ чому не працюють автоматичні оновлення за cron показано налаштування та обмеження PHP. Викликайте його щохвилини, а не раз на добу, адже кожен виклик додає одну партію. Якщо ви обмежили плагін параметром Ініціалізувати плагін лише на таких сторінках сайту (Init plugin on the next site pages only), нехай він звертається до /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 потрібен AJAX, і він має власні налаштування лічильників

Поки режим Turbo увімкнено, HUSKY при кожному завантаженні сторінки скидає чотири налаштування: Спробувати перевести магазин на AJAX (Try to ajaxify the shop) стає Так (Yes), а звичайні Показувати лічильник (Show count), Динамічний перерахунок (Dynamic recount) і Приховувати порожні терміни (Hide empty terms) стають Ні (No). Тоді на вкладці Опції (Options) з’являються власні копії цих трьох параметрів режиму Turbo під тими самими назвами, а Динамічний перерахунок (Dynamic recount) пропонує Так, для всіх пристроїв (Yes, for all devices) або Так, лише для ПК (Yes, only for PC).

  • AJAX неможливо вимкнути, поки увімкнено режим Turbo. Установіть для Увімкнути режим Turbo (Enable turbo mode) значення Ні (No), збережіть і лише потім змінюйте Спробувати перевести магазин на AJAX (Try to ajaxify the shop).
  • Якщо після AJAX-фільтрації сітка товарів теми ламається (один товар у рядку, втрачені колонки, зламана пагінація), режим Turbo успадковує це: див. налаштування кількості колонок в AJAX-режимі і проблеми з пагінацією в AJAX-режимі або не вмикайте режим Turbo для цієї теми.
  • Після вимкнення режиму Turbo задайте Показувати лічильник (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; до нього вони не застосовуються.

Чого режим Turbo не вміє

  • Елемент Ієрархічний випадний список (Hierarchy drop-down) з ним не працює, як зазначено на сторінці розширення Turbo mode.
  • Лічильники та Приховувати порожні терміни (Hide empty terms) працюють для стандартних елементів (прапорці, радіокнопки, випадні списки, колір, зображення, мітка, слайдер). Елементи, створені в Smart Designer, лічильників не отримують.
  • В наявності (In stock) враховує лише власний статус наявності кожного товару; налаштування, що перевіряє варіації, не діє, тому фільтр за розміром усе ще може показувати варіації, яких немає в наявності.
  • Текстовий пошук порівнює введені слова лише з назвами товарів, навіть якщо елемент текстового пошуку налаштовано на пошук в описах або інших полях. Окремий елемент пошуку за артикулом працює.
  • Умови, додані в PHP, не беруть участі в пошуку, оскільки вирішує, які товари підходять, браузер. Власний код на woof_products_query або pre_get_posts, власні розширення та плагіни, що обмежують товари для постачальника чи групи клієнтів, можуть щонайбільше приховати частину знайдених товарів уже після пошуку, через що лічильники та пагінація розходяться.

Якщо вашому магазину потрібно щось із цього або ціни та наявність змінюються щогодини, вимкніть режим Turbo й пришвидшіть звичайний режим за допомогою кешування.

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

  • У консолі немає червоних помилок; скрипти плагіна виключені з відкладання, defer та об’єднання.
  • woof_turbo_mode_file.length збігається з кількістю опублікованих товарів і варіацій; лічильник не зупинився на ліміті.
  • Файл перебудовано після останнього імпорту або зміни фільтра; кеш сторінок і CDN очищено.
  • Товари позначені в усьому ланцюжку категорій і мають видимість Магазин і результати пошуку (Shop and search results).
  • Налаштування лічильників задано в копіях режиму Turbo, а також повторно після вимкнення режиму Turbo.

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