Фильтр товаров 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 товаров»:
- Группа полей должна быть привязана по типу записи. HUSKY подхватывает только группы, в правилах Расположение (Location) которых есть Тип записи равен Товар (Post Type is equal to Product). Группа, которая показывается только по правилу вроде категории товара, пропускается, и ее поля никогда не попадают на вкладку Структура (Structure).
- Значение каждого варианта должно совпадать с его меткой. В ACF вариант, записанный как
xl : Extra large, сохраняет в товареxl, но расширение ACF ищет метку,Extra large, и ничего не находит. Работают варианты, записанные одним словом в строке (значение и метка совпадают) или отличающиеся только регистром букв, напримерred : Red. Метки с символами кавычек не совпадают никогда. - Множественный выбор должен быть выключен. Поле 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 / False | 1 или 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
- Найдите настоящий мета-ключ. Это имя поля (Имя поля (Field Name)) в ACF (например,
body_type), а не его метка. На вкладке Мета-данные (Meta Data) кнопка Получить ключи любого товара по его ID (Get keys from any product by its ID) выводит все ключи товара. Каждое поле ACF встречается дважды:body_typeхранит значение, а_body_typeхранит внутреннюю ссылку ACF на поле. Используйте ключ без подчеркивания. Ключи чувствительны к регистру и никогда не содержат пробелов или скобок. - Добавьте ключ через Добавить свой ключ вручную (Add Custom key by hands) или из списка, введите название и выберите отображение и тип. Для текстовых значений выберите строка (string). При типе число (number) MySQL перед сравнением превращает текст вроде
Coupeв 0, и фильтр возвращает каждый товар, у которого есть этот ключ, — со стороны это выглядит как «фильтр ничего не делает». - Перечислите варианты для Выпадающего списка (Drop-down) и Мультивыпадающего списка (Multi Drop-down). Мета-поле — свободный текст, поэтому HUSKY не может сам построить список значений; вы пишете его сами через запятую. Используйте
title^value, когда видимое название отличается от сохраненного значения. Для вариантов ACFcoupe : Coupeиsuv : SUV / Crossoverэто выглядит так:
Часть послеCoupe^coupe,SUV / Crossover^suv^должна быть в точности тем, что сохранил ACF, то есть значением варианта, а не его меткой. - Сохраните, откройте вкладку Структура (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 для редактирования при этом не нужно:
- Создайте таксономию товаров, например Комплектация, как пользовательскую таксономию или как глобальный атрибут в разделе Товары → Атрибуты (Products → Attributes).
- В ACF замените поле Checkbox полем Таксономия (Taxonomy), которое указывает на нее, с включенными Сохранять термины (Save Terms) и Загружать термины (Load Terms). Тогда ACF назначает товару выбранные термины вместо хранения массива.
- Товары получают свои термины при повторном сохранении; для большого каталога сделайте это массово. После этого таксономия появляется на вкладке Структура (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, указав тип и настройки поля, мета-ключ и пример сохраненного значения, и мы посмотрим.