HUSKY - WooCommerce Product Filter Professional

Фильтр товаров WooCommerce по полю ACF: типы, настройка и решения

Фильтровать товары WooCommerce по значениям полей ACF с помощью HUSKY можно, но только если поле хранит значение в виде, который запрос к базе данных способен сравнить. Поля с одним значением (Select, Radio Button, True / False, Number, Text, Date Picker) фильтруются без проблем. Поля Checkbox и поля Select с включенной опцией Множественный выбор (Select Multiple) либо вообще не появляются в фильтре, либо показывают варианты, которые всегда находят 0 товаров. Ниже — как HUSKY читает данные ACF, какие типы полей работают, как настроить каждый из них и что делать с полями с несколькими значениями.

Два способа, которыми HUSKY читает поля ACF

ACF сохраняет каждое поле как обычные мета-данные товара: одна строка в таблице wp_postmeta под именем поля (Имя поля (Field Name)) с сохраненным значением. В HUSKY есть два встроенных расширения, которые фильтруют по таким строкам. Оба системные и всегда активны, так что включать ничего не нужно.

  • Расширение ACF (Поля ACF (ACF fields)) автоматически находит ваши группы полей ACF и выводит их поля Select, Radio Button и True / False на вкладке Структура (Structure) в формате Field label (Group title). Установите выпадающий список рядом с полем в Да (Yes), сохраните, и поле попадет в фильтр. Другие типы полей не выводятся вообще. Подробности — на странице расширения ACF.
  • Вкладка Meta Data (расширение Мета-фильтр (Meta filter)) работает с любым мета-ключом, ACF или нет. Вы сами добавляете ключ и выбираете, как он показывается: Ползунок (Slider), Поиск по тексту (Search by text), Флажок (Checkbox), Выпадающий список (Drop-down), Мультивыпадающий список (Multi Drop-down) или Выбор даты (Datepicker), а также какого типа данные он содержит: число (number), строка (string) или дата (date). См. фильтр по мета-полям.

Расширение ACF настраивается быстрее, но у него есть три правила, которые объясняют большинство сообщений «поля нет» и «0 товаров»:

  1. Группа полей должна быть привязана по типу записи. HUSKY подхватывает только группы, в правилах Расположение (Location) которых есть Тип записи равен Товар (Post Type is equal to Product). Группа, которая показывается только по правилу вроде категории товара, пропускается, и ее поля никогда не попадают на вкладку Структура (Structure).
  2. Значение каждого варианта должно совпадать с его меткой. В ACF вариант, записанный как xl : Extra large, сохраняет в товаре xl, но расширение ACF ищет метку, Extra large, и ничего не находит. Работают варианты, записанные одним словом в строке (значение и метка совпадают) или отличающиеся только регистром букв, например red : Red. Метки с символами кавычек не совпадают никогда.
  3. Множественный выбор должен быть выключен. Поле Select с включенной опцией Множественный выбор (Select Multiple) в списке по-прежнему есть, но товаров не находит — по причине, объясненной ниже.

Если поле нарушает одно из этих правил, фильтруйте его через вкладку Meta Data, где вы сами управляете ключом и точными значениями.

Какие типы полей ACF можно фильтровать

Тип поля ACFЧто сохраняется в товареКак фильтровать в HUSKY
Select (одиночный), Radio ButtonЗначение одного вариантаРасширение ACF или Meta Data: Выпадающий список (Drop-down) / Мультивыпадающий список (Multi Drop-down)
Button GroupЗначение одного вариантаMeta Data: Выпадающий список (Drop-down) / Мультивыпадающий список (Multi Drop-down)
True / False1 или 0Расширение ACF или Meta Data: Флажок (Checkbox)
Number, RangeЧислоMeta Data: Ползунок (Slider), тип число (number)
Text, Email, URLСтрокаMeta Data: Поиск по тексту (Search by text) или Выпадающий список (Drop-down) с перечисленными значениями
Date PickerДата в виде 20250131 (Ymd)Meta Data: Выбор даты (Datepicker) плюс один хук (см. ниже)
Checkbox, Select с Множественный выбор (Select Multiple), Relationship / Post Object / Taxonomy с несколькими значениямиСериализованный массивОбычным сравнением нельзя; см. два выхода ниже
Repeater, Flexible ContentПронумерованные строки вроде specs_0_widthКак одно поле не фильтруются

Поля внутри поля Group сохраняются под именем groupname_fieldname и фильтруются как поля своего типа. Date Time Picker сохраняет текст вроде 2025-01-31 14:00:00, который фильтр с выбором даты сравнить не может.

Почему поля Checkbox и мультивыбор ничего не находят

Когда поле может хранить несколько значений, ACF упаковывает их в одну строку в сериализованном формате PHP. Автомобиль с кондиционером и подогревом сидений получает одну строку мета-данных такого вида:

a:2:{i:0;s:2:"ac";i:1;s:12:"heated_seats";}

Расширение ACF и отображения «Выпадающий список», «Мультивыпадающий список» и «Флажок» просят базу данных найти строки, где значение равно выбранному варианту. Но ac не равно этой строке целиком, поэтому результат — 0. Выключение опции Множественный выбор (Select Multiple) в ACF не исправляет уже существующие товары: их значения остаются сериализованными, пока каждый товар не будет сохранен заново с одним значением.

Настройка поля ACF на вкладке Meta Data

  1. Найдите настоящий мета-ключ. Это имя поля (Имя поля (Field Name)) в ACF (например, body_type), а не его метка. На вкладке Мета-данные (Meta Data) кнопка Получить ключи любого товара по его ID (Get keys from any product by its ID) выводит все ключи товара. Каждое поле ACF встречается дважды: body_type хранит значение, а _body_type хранит внутреннюю ссылку ACF на поле. Используйте ключ без подчеркивания. Ключи чувствительны к регистру и никогда не содержат пробелов или скобок.
  2. Добавьте ключ через Добавить свой ключ вручную (Add Custom key by hands) или из списка, введите название и выберите отображение и тип. Для текстовых значений выберите строка (string). При типе число (number) MySQL перед сравнением превращает текст вроде Coupe в 0, и фильтр возвращает каждый товар, у которого есть этот ключ, — со стороны это выглядит как «фильтр ничего не делает».
  3. Перечислите варианты для Выпадающего списка (Drop-down) и Мультивыпадающего списка (Multi Drop-down). Мета-поле — свободный текст, поэтому HUSKY не может сам построить список значений; вы пишете его сами через запятую. Используйте title^value, когда видимое название отличается от сохраненного значения. Для вариантов ACF coupe : Coupe и suv : SUV / Crossover это выглядит так:
    Coupe^coupe,SUV / Crossover^suv
    Часть после ^ должна быть в точности тем, что сохранил ACF, то есть значением варианта, а не его меткой.
  4. Сохраните, откройте вкладку Структура (Structure), установите новый элемент в Да (Yes), перетащите его на место и сохраните снова. Значок шестеренки рядом с ним содержит собственные опции отображения, например Параметр поиска (Search option) и Значение поиска (Search value) для флажка или Условие текстового поиска (Text search conditional) (LIKE или EXACT) для Поиск по тексту (Search by text).

Флажок (Checkbox) — это одиночный флажок для одного ключа. Он находит товары, у которых значение равно 1 (поля True / False), другому Значению поиска (Search value), например yes, или, при Параметре поиска (Search option) со значением Значение существует (Value exists), каждый товар, у которого поле заполнено.

Если само сохраненное значение содержит запятую, измените разделитель для всех списков «Выпадающий список» и «Мультивыпадающий список», а затем перепишите списки через |:

/*
 * HUSKY: separate meta filter options with | instead of a comma.
 * Child theme functions.php or a code snippets plugin.
 * Example list afterwards: Wood, oak|Wood, pine|Metal
 */
add_filter( 'woof_meta_options_separator', function ( $separator ) {
    return '|';
} );

Поля Number и Range подходят для Ползунка (Slider); диапазоны, шаги и десятичные дроби разобраны в статье фильтры-ползунки диапазона для атрибутов и мета-полей.

Фильтр по полю даты ACF

Фильтр с выбором даты по умолчанию сравнивает метки времени Unix, тогда как Date Picker в ACF сохраняет даты в виде 20250131. Хук woof_meta_use_acf_dateformat заставляет фильтр перед поиском преобразовать выбранные даты в тот же формат:

/*
 * HUSKY: Datepicker meta filters search ACF Date Picker values (Ymd).
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'woof_meta_use_acf_dateformat', '__return_true' );

Добавьте ключ ACF на вкладке Meta Data с отображением Выбор даты (Datepicker) и оставьте тип число (number): преобразованные даты сравниваются как числа, а тип дата (date) здесь не дает пригодных дат. Хук действует на каждый фильтр с выбором даты на сайте, поэтому все они должны указывать на поля Date Picker из ACF. Для периода действия (от / до) добавьте начальное и конечное поля как два отдельных фильтра.

Поля Checkbox и мультивыбора: два выхода

Рекомендуется: перенести значения в таксономию

Данные с несколькими значениями на товар — это то, для чего созданы таксономии. С таксономией вы получаете флажок для каждого значения, счетчики, логику И или ИЛИ между выбранными значениями и поддержку режима Turbo, чего мета-поле предложить не может. Отказываться от ACF для редактирования при этом не нужно:

  1. Создайте таксономию товаров, например Комплектация, как пользовательскую таксономию или как глобальный атрибут в разделе Товары → Атрибуты (Products → Attributes).
  2. В ACF замените поле Checkbox полем Таксономия (Taxonomy), которое указывает на нее, с включенными Сохранять термины (Save Terms) и Загружать термины (Load Terms). Тогда ACF назначает товару выбранные термины вместо хранения массива.
  3. Товары получают свои термины при повторном сохранении; для большого каталога сделайте это массово. После этого таксономия появляется на вкладке Структура (Structure) HUSKY, как любая другая.

Оставить поле: искать внутри сохраненного массива

Если поле должно остаться как есть, можно изменить сравнение. Сниппет ниже превращает условие «равно» в HUSKY для перечисленных ключей в поиск LIKE по значению в кавычках, так что ac становится LIKE '%"ac"%' и совпадает с элементом внутри сериализованной строки, но не с ac_rear. Он же исправляет счетчики у вариантов.

/*
 * HUSKY: Drop-down / Multi Drop-down meta filters for ACF Checkbox
 * and Select Multiple fields (values stored as serialized arrays).
 * Child theme functions.php or a code snippets plugin.
 */
function my_husky_serialized_keys() {
    return array( 'equipment' ); // ACF field names
}

function my_husky_match_serialized( $meta_query ) {
    if ( ! is_array( $meta_query ) ) {
        return $meta_query;
    }
    foreach ( $meta_query as $i => $clause ) {
        if ( ! is_array( $clause ) ) {
            continue;
        }
        if ( isset( $clause['key'], $clause['value'], $clause['compare'] )
            && '=' === $clause['compare']
            && is_scalar( $clause['value'] )
            && in_array( $clause['key'], my_husky_serialized_keys(), true ) ) {
            $meta_query[ $i ]['compare'] = 'LIKE';
            $meta_query[ $i ]['value']   = '"' . $clause['value'] . '"';
            $meta_query[ $i ]['type']    = 'CHAR';
        } else {
            $meta_query[ $i ] = my_husky_match_serialized( $clause );
        }
    }
    return $meta_query;
}

// Products found by the filter
add_filter( 'woof_get_meta_query', 'my_husky_match_serialized', 100 );

// Counts next to the options (Show count + Dynamic recount)
add_filter( 'woof_dynamic_count_attr', function ( $args ) {
    if ( isset( $args['meta_query'] ) ) {
        $args['meta_query'] = my_husky_match_serialized( $args['meta_query'] );
    }
    return $args;
}, 100 );

Затем добавьте equipment на вкладке Meta Data как Выпадающий список (Drop-down) или Мультивыпадающий список (Multi Drop-down), тип строка (string), со значениями вариантов ACF после ^, например Air conditioning^ac,Heated seats^heated_seats. Учитывайте ограничения: Мультивыпадающий список находит товары, у которых есть любое из выбранных значений, а не все; поиск LIKE '%…%' не может использовать индекс базы данных и замедляется на больших каталогах; а в режиме Turbo сниппет не применяется. Подробнее о хуке — на странице woof_get_meta_query.

Вариации, режим Turbo и пользовательские сетки товаров

  • Значения у вариаций не ищутся. Запрос магазина возвращает родительские товары и проверяет собственные мета-данные родителя. Атрибуты для вариаций работают, потому что родитель несет термины всех своих вариаций; мета-значения — нет. Помещайте значение в родительский товар.
  • Режим Turbo фильтрует в браузере по собственному файлу данных, в который попадают только ключи, добавленные на вкладке Meta Data. Поля, показанные через расширение ACF, и PHP-хуки, такие как сниппеты выше, там не используются. См. устранение неполадок режима Turbo.
  • URL меняется, но по-прежнему показываются все товары. Тогда дело не в поле: сетка конструктора страниц или пользовательский шаблон выполняет собственный запрос и игнорирует все фильтры. Решение описано в статье URL фильтра меняется, но товары не фильтруются.

Если фильтр ACF все еще не находит товары

  • Проверьте, что на самом деле сохранено. В phpMyAdmin или аналогичном инструменте выполните SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = 123 с ID товара (и вашим префиксом таблиц). Значение, начинающееся с a:, — это сериализованный массив; ключ, отличающийся от ожидаемого, означает, что ACF сохраняет под другим именем.
  • Вкладка Meta Data: ключ без ведущего подчеркивания, в том же регистре; тип строка (string) для текста; сохраненное значение варианта после ^.
  • Для расширения ACF: расположение группы — Тип записи равен Товар (Post Type is equal to Product), значения вариантов совпадают с метками, Множественный выбор (Select Multiple) выключен, а товары сохранены заново после его изменения.
  • Значение находится у родительского товара, а не у вариаций.
  • Фильтр по таксономии на той же странице работает. Если нет, сначала исправьте сетку товаров.

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