Фільтр товарів 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, який фільтр Datepicker порівняти не може.
Чому поля 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) для Checkbox або Умова текстового пошуку (Text search conditional) (LIKE або EXACT) для Пошук за текстом (Search by text).
Прапорець (Checkbox) — це один прапорець для одного ключа. Він знаходить товари, значення яких 1 (поля True / False), інше Значення пошуку (Search value), наприклад yes, або, якщо Опція пошуку (Search option) має значення Значення існує (Value exists), усі товари із заповненим полем.
Якщо саме збережене значення містить кому, змініть роздільник для всіх списків Drop-down і Multi Drop-down, а потім перепишіть списки з |:
/*
* 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
Фільтр Datepicker за замовчуванням порівнює позначки часу 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) тут не дає придатних дат. Гак діє на кожен фільтр Datepicker на сайті, тож усі вони тоді мають вказувати на поля ACF Date Picker. Для періоду дії (від / до) додайте початкове й кінцеве поля як два окремі фільтри.
Поля Checkbox і з множинним вибором: два виходи
Рекомендовано: перенести значення в таксономію
Дані з кількома значеннями на товар — саме для того й існують таксономії. З таксономією ви отримуєте прапорець для кожного значення, лічильники, логіку AND або OR між вибраними значеннями та підтримку Turbo mode, чого метаполе запропонувати не може. Відмовлятися від ACF для редагування не потрібно:
- Створіть таксономію товарів, наприклад Комплектація (Equipment), як власну таксономію або як глобальний атрибут у Товари → Атрибути (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. Знайте обмеження: Multi Drop-down знаходить товари, які мають будь-яке з вибраних значень, а не всі одразу; пошук LIKE '%…%' не може використати індекс бази даних і сповільнюється на великих каталогах; а сніпет не діє в Turbo mode. Докладніше про гак — на сторінці woof_get_meta_query.
Варіації, Turbo mode і власні сітки товарів
- Значення у варіацій не шукаються. Запит магазину повертає батьківські товари й перевіряє власні метадані батька. Атрибути працюють для варіацій, бо батько несе всі терміни своїх варіацій; метазначення — ні. Зберігайте значення в батьківському товарі.
- Turbo mode фільтрує в браузері з власного файлу даних, який містить лише ключі, додані на вкладці Meta Data. Поля, показані через розширення ACF, і PHP-гаки, як-от сніпети вище, там не використовуються. Див. усунення проблем із Turbo mode.
- 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, указавши тип і налаштування поля, ключ метаданих та приклад збереженого значення, і ми розглянемо.