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 → Настройки → Товары → Склад): он скрывает футболку только тогда, когда не осталось ни одного размера. Вопрос «есть ли размер M?» нужно задавать вариациям, а фильтр задаёт его только тогда, когда вы ему об этом скажете.

Заставьте HUSKY проверять остаток выбранного размера

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

  1. Откройте WooCommerce → Настройки → 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) их сохраняет; если они тоже не должны подходить, добавьте элемент Исключить товары на предзаказе (Exclude products on backorder), у которого есть та же настройка Искать в товарах и их вариациях (Search in products and their variations). Проверьте также, что именно записал импорт: вариация, сохранённая как На предзаказе (On backorder) вместо Нет в наличии (Out of stock), остаётся в результатах.

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

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

  • остатки изменяются импортом или инструментом синхронизации, которые пишут прямо в базу данных вместо сохранения товаров через WooCommerce;
  • фоновые действия не выполняются, например потому, что WP-Cron отключён без замены серверным cron. Тогда ожидающие действия с хуком woocommerce_run_product_attribute_lookup_update_callback накапливаются в WooCommerce → Статус → Запланированные действия (Scheduled Actions);
  • полное перестроение таблицы было прервано.

Тогда фильтр работает со старыми данными об остатках, и результаты выглядят случайными. Чтобы перестроить таблицу, откройте WooCommerce → Статус → Инструменты и нажмите Перегенерировать (Regenerate) рядом с Перегенерировать таблицу поиска по атрибутам товаров (Regenerate the product attributes lookup table). Операция выполняется в фоне пакетами; пока она не закончится, на кнопке отображается Идёт заполнение (Filling in progress) со счётчиком. FAQ о неработающих фильтрах по цене и наличию описывает те же инструменты. Если остатки меняются часто, рассмотрите WooCommerce → Настройки → Товары → Дополнительно → Таблица поиска по атрибутам товаров (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).
  • Таблица поиска перегенерирована после импортов, и в запланированных действиях не застряли обновления таблицы.
  • Кэш пересчёта и кэш страниц очищены после изменения остатков; режим Turbo выключен.

Если фильтр по-прежнему возвращает товар, у которого выбранный размер распродан, создайте тему на форуме поддержки HUSKY со ссылкой на фильтр, товаром и статусом наличия его вариаций.