HUSKY - WooCommerce Product Filter Professional

Фільтр WooCommerce за розміром показує варіації без наявності: як виправити

Покупець відмічає розмір M, і фільтр WooCommerce за розміром показує футболку, у якої варіація M закінчилася. На сторінці товару сказано, що розмір розпродано, і покупець іде. Фільтр не зламаний: за замовчуванням він оцінює змінний товар за батьківським товаром, так само як і WooCommerce, а батьківський товар залишається в наявності, доки в наявності є хоча б одна його варіація. Нижче: чому фільтр показує варіації, яких немає в наявності, яке налаштування HUSKY змушує його перевіряти наявність вибраного розміру, за якими правилами працює ця перевірка та що виправити, якщо результати або лічильники все ще неправильні.

Чому фільтр за розміром показує розпродані варіації

У WooCommerce змінний товар — це записи двох видів. Батьківський товар — те, що перелічують сторінки магазину й категорій. Його вкладка Атрибути (Attributes) містить значення (Розмір: S, M, L; Колір: чорний, червоний), і ці значення прив’язані до батьківського товару як терміни атрибутів. Кожна варіація, наприклад M / чорний, — окремий запис із власною ціною та власним залишком.

Фільтр за атрибутом шукає батьківські товари, що мають вибраний термін. Якщо в футболки у вкладці Атрибути (Attributes) вказано M, вона відповідає розміру M незалежно від залишку варіації M. Допомоги немає й від статусу наявності батьківського товару: WooCommerce тримає його як В наявності (In stock), поки в наявності є хоча б одна варіація (або Очікується надходження (On backorder), якщо одна з них під замовлення), і перемикає на Немає в наявності (Out of stock) лише тоді, коли розпродано всі варіації. З тієї самої причини опція WooCommerce Приховувати товари, яких немає в наявності, з каталогу (Hide out of stock items from the catalog) (WooCommerce → Settings → Products → Inventory) цієї проблеми не вирішує: вона приховує футболку лише тоді, коли закінчилися всі розміри. Питання «чи є розмір M?» треба ставити варіаціям, а фільтр ставить його лише тоді, коли ви про це скажете.

Змусьте HUSKY перевіряти наявність вибраного розміру

Перевірка варіацій належить елементу В наявності (In stock). У HUSKY 3.4.6 це вбудоване розширення, яке завжди активне, тож нічого вмикати на вкладці Розширення (Extensions) не потрібно.

  1. Відкрийте WooCommerce → Settings → Products Filter, вкладка Структура (Structure), і знайдіть рядок В наявності (In stock). Встановіть Так (Yes), якщо покупці мають бачити чекбокс.
  2. Натисніть кнопку з шестірнею поруч із ним (додаткові параметри (additional options)). У вікні, що відкриється, встановіть перше налаштування, Пошук у змінних товарах (Search in variable produts), у значення Шукати в товарах та їхніх варіаціях (Search in products and their variations). Типове значення, Лише прості товари (Simple products only), дивиться лише на власний статус наявності кожного товару, який для змінного товару є статусом батьківського.
  3. Залиште Використовувати нову БД (Use new DB.) у значенні Так (Yes) і виберіть Чекбокс (Checkbox) або Перемикач (Switcher) у полі Вигляд (View).
  4. Збережіть, очистьте кеш сторінок і перевірте: виберіть розмір, який, як ви знаєте, розпродано в одному товарі, відмітьте В наявності (In stock), і цей товар має зникнути з результатів.

Перевірка виконується лише тоді, коли В наявності (In stock) входить до пошуку й вибрано принаймні один атрибут товару (таксономію pa_, як-от Розмір або Колір). Без В наявності (In stock) фільтрація за атрибутами залишається прив’язаною до батьківського товару. Це налаштування вимагає додаткової роботи бази даних, тому за замовчуванням вимкнене; див. розділ про швидкість нижче.

Застосувати «В наявності» без чекбокса

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

/*
 * HUSKY: always search in-stock products only.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_get_request_data', function ($data) {
    $data['stock'] = 'instock';
    return $data;
});

Це також прибирає прості товари, яких немає в наявності, і повністю розпродані змінні товари з кожного списку товарів, яким керує фільтр, як описано в FAQ про показ лише товарів у наявності. Встановіть рядок В наявності (In stock) у значення Ні (No), щоб покупці не бачили чекбокс, який завжди відмічено.

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

/*
 * HUSKY: apply In stock only when a product attribute (pa_*) is being filtered.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_get_request_data', function ($data) {
    foreach (array_keys($data) as $key) {
        if (strpos($key, 'pa_') === 0) {
            $data['stock'] = 'instock';
            break;
        }
    }
    return $data;
});

Як перевірка варіацій ухвалює рішення

Коли Використовувати нову БД (Use new DB.) має значення Так (Yes), HUSKY зчитує таблицю пошуку атрибутів товарів WooCommerce, де кожна варіація має рядок для кожного значення свого атрибута разом із прапорцем наявності. Для кожного змінного товару він збирає варіації, що мають будь-яке з вибраних значень, і прибирає товар, якщо такі варіації існують і жодної з них немає в наявності. Це правило пояснює результати, що спочатку здаються дивними:

ТоварПошукРезультат
S в наявності, M розпроданоРозмір M + В наявностіПриховано
S в наявності, M розпроданоРозмір S або M + В наявностіПоказано: S доступний
M указано у вкладці Атрибути (Attributes), але варіації M не існуєРозмір M + В наявностіПоказано: варіація M не може бути відсутня в наявності
Одна варіація встановлена як Будь-який розмір (Any Size), в наявностіРозмір L + В наявностіПоказано: варіація Будь-який розмір (Any Size) рахується для кожного розміру, указаного в товарі
M / чорний розпродано, M / червоний і S / чорний в наявностіРозмір M + Колір чорний + В наявностіПоказано: кожне вибране значення має варіацію в наявності
Варіація M Очікується надходження (On backorder)Розмір M + В наявностіПоказано: замовлення наперед вважається доступним

Третій рядок — проблема даних, а не фільтра. Значення, яке залишилося у вкладці Атрибути (Attributes) батьківського товару після видалення його варіації або яке ніколи не використовувалося для варіації, і далі збігається та враховується. Залишайте лише значення, що мають варіації, або створіть варіацію й позначте її як Немає в наявності (Out of stock).

Останні два рядки — це межі перевірки. Значення різних атрибутів перевіряються окремо, а не як точна комбінація, яку вибрав покупець, тому товар усе ще може з’явитися, коли саме ця комбінація розпродана. Варіації під замовлення можна купити, тому В наявності (In stock) їх зберігає; якщо вони також не повинні збігатися, додайте елемент Виключити товари під замовлення, який має те саме налаштування Шукати в товарах та їхніх варіаціях (Search in products and their variations). Також перевірте, що саме записав імпорт: варіація, збережена як Очікується надходження (On backorder) замість Немає в наявності (Out of stock), залишається в результатах.

Результати все ще неправильні: оновіть таблицю пошуку WooCommerce

Таблиця пошуку (wc_product_attributes_lookup) належить WooCommerce. Вона оновлюється, коли товар або варіацію зберігають через WooCommerce, за замовчуванням із невеликою затримкою: WooCommerce планує оновлення як фонову дію. Таблиця відстає, коли:

  • залишки змінює імпорт або інструмент синхронізації, який пише прямо в базу даних, а не зберігає товари через WooCommerce;
  • фонові дії не виконуються, наприклад, через вимкнений WP-Cron без серверного cron на заміну. Тоді в WooCommerce → Status → Scheduled Actions накопичуються відкладені дії з гаком woocommerce_run_product_attribute_lookup_update_callback;
  • повну регенерацію таблиці було перервано.

Тоді фільтр працює зі старими даними про залишки, і результати здаються випадковими. Щоб перебудувати таблицю, відкрийте WooCommerce → Status → Tools і натисніть Регенерувати (Regenerate) поруч із Регенерувати таблицю пошуку атрибутів товарів (Regenerate the product attributes lookup table). Вона виконується у фоні порціями; кнопка показує Виконується заповнення (Filling in progress) із лічильником, доки процес не завершиться. FAQ про фільтри за ціною й наявністю, що не працюють розглядає ті самі інструменти. Якщо залишки змінюються часто, розгляньте WooCommerce → Settings → Products → Advanced → Таблиця пошуку атрибутів товарів (Product attributes lookup table) → Прямі оновлення (Direct updates), що оновлює таблицю в момент збереження товару.

Для перевірки або коли таблицю неможливо підтримувати актуальною встановіть Використовувати нову БД (Use new DB.) у значення Ні (No). Тоді HUSKY зчитує самі варіації (їхні значення _stock_status і attribute_pa_…). Це повільніше при великій кількості варіацій і працює за суворішим правилом: товар прибирається, якщо будь-якої варіації з вибраним значенням немає в наявності, тому «Розмір S або M» ховає футболку з таблиці вище. Щоб отримати те саме правило, що й з таблицею пошуку, додайте:

/*
 * HUSKY, In stock with "Use new DB." = No: keep a variable product when at least
 * one variation with a selected value is in stock.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_exclude_existing_variations', '__return_true');

Лічильники, що враховують варіації, яких немає в наявності

Числа поруч із розмірами беруться з тих самих запитів, що й результати, тому підпорядковуються тим самим правилам.

  • Без В наявності (In stock) у пошуку лічильник M включає кожен товар, що має M у батьківському товарі, розпроданий чи ні. Коли В наявності (In stock) активне (відмічене або примусово ввімкнене сніпетом вище) і пошук за варіаціями увімкнено, кожен розмір рахується з перевіркою варіацій для цього розміру.
  • Додайте до цього Динамічний перерахунок (Dynamic recount) і Приховувати порожні терміни (Hide empty terms) (вкладка Опції (Options)), і розмір, лічильник якого падає до нуля, зникає з фільтра, тож розпродані розміри більше не пропонуються взагалі.
  • Якщо WooCommerce приховує товари, яких немає в наявності, залиште Враховувати видимість у каталозі (Listen catalog visibility) (Advanced → Options) у значенні Так (Yes). Зі значенням Ні (No) лічильники також включають товари, які приховує WooCommerce, і термін може показувати кількість, коли його результати порожні.
  • З опцією Кешувати число динамічного перерахунку для кожного елемента у фільтрі (Cache dynamic recount number for each item in filter) (Advanced → Options) лічильники зберігаються й не відстежують зміни залишків, доки кеш не очиститься автоматично або кнопкою очистити кеш (clear cache). Кеш сторінок також може віддавати старі числа.

Швидкість: ціна перевірки варіацій

Кожен пошук, що поєднує атрибут з В наявності (In stock), виконує додаткові запити: два до таблиці пошуку, коли Використовувати нову БД (Use new DB.) має значення Так (Yes), або один по всіх відповідних варіаціях зі значенням Ні (No). З Динамічним перерахунком (Dynamic recount) перевірка виконується ще й для кожного значення, що отримує лічильник, тож фільтр із 40 розмірами й кольорами повторює її 40 разів на сторінку. Якщо варіацій десятки тисяч, це помітно.

  • Тримайте Використовувати нову БД (Use new DB.) у значенні Так (Yes) і підтримуйте таблицю пошуку актуальною; це швидший метод.
  • Увімкніть Кешувати число динамічного перерахунку для кожного елемента у фільтрі (Cache dynamic recount number for each item in filter) і виберіть інтервал автоочищення, що відповідає швидкості змін ваших залишків.
  • Більше можливостей — у статті як прискорити фільтрацію товарів у великих каталогах.

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

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

  • В наявності (In stock) → шестірня → вибрано й збережено Шукати в товарах та їхніх варіаціях (Search in products and their variations).
  • В наявності (In stock) входить до пошуку: відмічене покупцем або примусово ввімкнене через woof_get_request_data.
  • Змінні товари перелічують лише ті значення атрибутів, що мають варіації.
  • Розпродані варіації мають статус Немає в наявності (Out of stock), а не Очікується надходження (On backorder).
  • Таблицю пошуку регенеровано після імпортів, і жодні оновлення таблиці не застрягли в Scheduled Actions.
  • Кеш перерахунку й кеш сторінок очищено після змін залишків; режим Turbo вимкнено.

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