Filtrowanie produktów WooCommerce według pola ACF: typy i konfiguracja
Produkty WooCommerce możesz filtrować według wartości pól ACF za pomocą HUSKY, ale tylko wtedy, gdy pole zapisuje wartość w postaci, którą zapytanie do bazy danych potrafi porównać. Pola jednowartościowe (Select, Radio Button, True / False, Number, Text, Date Picker) filtrują się bez problemu. Pola Checkbox oraz pola Select z włączoną opcją Wybór wielokrotny (Select Multiple) albo w ogóle nie pojawiają się w filtrze, albo pokazują opcje, które zawsze znajdują 0 produktów. Poniżej wyjaśniamy, jak HUSKY odczytuje dane ACF, które typy pól działają, jak skonfigurować każdy z nich i co zrobić z polami wielowartościowymi.
Dwa sposoby, w jakie HUSKY odczytuje pola ACF
ACF zapisuje każde pole jako zwykłe metadane produktu: jeden wiersz w tabeli wp_postmeta, pod nazwą Nazwa pola (Field Name), z zapisaną wartością. HUSKY ma dwa wbudowane rozszerzenia, które filtrują według takich wierszy. Oba są rozszerzeniami systemowymi, zawsze aktywnymi, więc niczego nie trzeba włączać.
- Rozszerzenie ACF (Pola ACF (ACF fields)) automatycznie znajduje Twoje grupy pól ACF i wypisuje ich pola Select, Radio Button i True / False na karcie Struktura (Structure) jako Etykieta pola (Tytuł grupy) (Field label (Group title)). Ustaw listę rozwijaną obok pola na Tak (Yes), zapisz, a pole znajdzie się w filtrze. Inne typy pól nie są w ogóle wypisywane. Szczegóły na stronie rozszerzenia ACF.
- Karta Meta Dane (rozszerzenie Filtr meta (Meta filter)) działa z dowolnym kluczem meta, ACF lub nie. Klucz dodajesz samodzielnie i wybierasz sposób wyświetlania: Suwak (Slider), Wyszukaj wg tekstu (Search by text), Pole Wyboru (Checkbox), Lista rozwijana (Drop-down), Lista rozwijana wielokrotnego wyboru (Multi Drop-down) lub Pole wyboru daty (Datepicker), oraz typ przechowywanych danych: liczba (number), ciąg (string) lub data (date). Zobacz filtrowanie według pól meta.
Rozszerzenie ACF konfiguruje się szybciej, ale ma trzy reguły, które wyjaśniają większość zgłoszeń „pole nie jest widoczne” i „0 produktów”:
- Grupa pól musi być przypisana według typu wpisu. HUSKY wykrywa tylko grupy, których reguły Lokalizacja (Location) zawierają Typ wpisu jest równy Produkt (Post Type is equal to Product). Grupa wyświetlana tylko według reguły takiej jak kategoria produktu jest pomijana, więc jej pola nigdy nie trafiają na kartę Struktura (Structure).
- Wartość każdej opcji musi odpowiadać jej etykiecie. W ACF opcja zapisana jako
xl : Extra largezapisuje w produkciexl, ale rozszerzenie ACF wyszukuje etykietę,Extra large, i niczego nie znajduje. Działają opcje zapisane jako pojedyncze słowo w wierszu (wartość i etykieta są takie same) lub różniące się tylko wielkością liter, na przykładred : Red. Etykiety zawierające znaki cudzysłowu nigdy nie pasują. - Wybór wielokrotny musi być wyłączony. Pole Select z włączoną opcją Wybór wielokrotny (Select Multiple) nadal jest wypisywane, ale nie znajduje produktów z powodu wyjaśnionego poniżej.
Jeśli pole łamie którąś z tych reguł, filtruj je zamiast tego przez kartę Meta Dane, gdzie sam kontrolujesz klucz i dokładne wartości.
Które typy pól ACF można filtrować
| Typ pola ACF | Co jest zapisywane w produkcie | Jak filtrować w HUSKY |
|---|---|---|
| Select (pojedynczy), Radio Button | Wartość jednej opcji | Rozszerzenie ACF lub Meta Dane Lista rozwijana (Drop-down) / Lista rozwijana wielokrotnego wyboru (Multi Drop-down) |
| Button Group | Wartość jednej opcji | Meta Dane Lista rozwijana (Drop-down) / Lista rozwijana wielokrotnego wyboru (Multi Drop-down) |
| True / False | 1 lub 0 | Rozszerzenie ACF lub Meta Dane Pole Wyboru (Checkbox) |
| Number, Range | Liczba | Meta Dane Suwak (Slider), typ liczba (number) |
| Text, Email, URL | Ciąg znaków | Meta Dane Wyszukaj wg tekstu (Search by text) lub Lista rozwijana (Drop-down) z wypisanymi wartościami |
| Date Picker | Data w postaci 20250131 (Ymd) | Meta Dane Pole wyboru daty (Datepicker) plus jeden hak (zobacz poniżej) |
| Checkbox, Select z Wybór wielokrotny (Select Multiple), wielowartościowe Relationship / Post Object / Taxonomy | Zserializowana tablica | Nie przy zwykłym porównaniu; zobacz dwa wyjścia poniżej |
| Repeater, Flexible Content | Ponumerowane wiersze, takie jak specs_0_width | Nie da się filtrować jako jedno pole |
Pola wewnątrz pola Group są zapisywane pod nazwą groupname_fieldname i filtrują się jak ich własny typ. Date Time Picker zapisuje tekst taki jak 2025-01-31 14:00:00, którego filtr pola wyboru daty nie potrafi porównać.
Dlaczego pola Checkbox i wielokrotnego wyboru niczego nie znajdują
Gdy pole może przechowywać kilka wartości, ACF pakuje je w jeden ciąg w formacie serializacji PHP. Samochód z klimatyzacją i podgrzewanymi fotelami dostaje jeden wiersz meta w takiej postaci:
a:2:{i:0;s:2:"ac";i:1;s:12:"heated_seats";}
Rozszerzenie ACF oraz widoki Lista rozwijana, Lista rozwijana wielokrotnego wyboru i Pole Wyboru pytają bazę danych o wiersze, w których wartość jest równa wybranej opcji. Wartość ac nie jest równa temu całemu ciągowi, więc wynik to 0. Wyłączenie Wybór wielokrotny (Select Multiple) w ACF nie naprawia istniejących produktów: ich wartości pozostają zserializowane, dopóki każdy produkt nie zostanie zapisany ponownie z pojedynczą wartością.
Konfiguracja pola ACF na karcie Meta Dane
- Znajdź prawdziwy klucz meta. To Nazwa pola (Field Name) w ACF (na przykład
body_type), a nie jego etykieta. Na karcie Meta Dane (Meta Data) opcja Pozyskaj klucze dowolnego produktu wg jego ID (Get keys from any product by its ID) wypisuje wszystkie klucze produktu. Każde pole ACF pojawia się dwa razy:body_typezawiera wartość, a_body_typewewnętrzne odwołanie ACF do pola. Użyj klucza bez podkreślenia. W kluczach wielkość liter ma znaczenie i nigdy nie zawierają spacji ani nawiasów. - Dodaj klucz przez Dodaj własny klucz ręcznie (Add Custom key by hands) albo z listy, wpisz tytuł i wybierz widok oraz typ. Dla wartości tekstowych wybierz ciąg (string). Przy liczba (number) MySQL przed porównaniem zamienia tekst taki jak
Coupena 0, a filtr zwraca każdy produkt, który ma ten klucz, co wygląda jak „filtr nic nie robi”. - Wypisz opcje dla Lista rozwijana (Drop-down) i Lista rozwijana wielokrotnego wyboru (Multi Drop-down). Pole meta to dowolny tekst, więc HUSKY nie może samodzielnie zbudować listy wartości; wpisujesz ją sam, rozdzielając przecinkami. Użyj
title^value, gdy widoczny tytuł różni się od zapisanej wartości. Dla opcji ACFcoupe : Coupeisuv : SUV / Crossoverwygląda to tak:
Część poCoupe^coupe,SUV / Crossover^suv^musi być dokładnie tym, co zapisało ACF, czyli wartością opcji, a nie jej etykietą. - Zapisz, otwórz kartę Struktura (Structure), ustaw nowy element na Tak (Yes), przeciągnij go na miejsce i zapisz ponownie. Ikona koła zębatego obok zawiera własne opcje widoku, na przykład Opcje wyszukiwania (Search option) i Wartość wyszukiwania (Search value) dla Pola Wyboru albo Warunek wyszukiwania tekstowego (Text search conditional) (PODOBNIE (LIKE) lub DOKŁADNY (EXACT)) dla Wyszukaj wg tekstu (Search by text).
Pole Wyboru (Checkbox) to pojedyncze pole wyboru dla jednego klucza. Znajduje produkty, których wartość to 1 (pola True / False), inna Wartość wyszukiwania (Search value), taka jak yes, albo, przy Opcje wyszukiwania (Search option) ustawionym na Wartość istnieje (Value exists), każdy produkt, który ma wypełnione to pole.
Jeśli sama zapisana wartość zawiera przecinek, zmień separator dla wszystkich list Lista rozwijana i Lista rozwijana wielokrotnego wyboru, a następnie przepisz listy, używając |:
/*
* 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 '|';
} );
Pola Number i Range należą do Suwak (Slider); zakresy, kroki i wartości dziesiętne opisano w artykule filtry z suwakiem zakresu dla atrybutów i pól meta.
Filtrowanie według pola daty ACF
Filtr pola wyboru daty domyślnie porównuje znaczniki czasu Unix, podczas gdy Date Picker w ACF zapisuje daty jako 20250131. Hak woof_meta_use_acf_dateformat sprawia, że filtr przed wyszukiwaniem konwertuje wybrane daty do tego samego formatu:
/*
* 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' );
Dodaj klucz ACF na karcie Meta Dane z widokiem Pole wyboru daty (Datepicker) i pozostaw typ liczba (number): przekonwertowane daty są porównywane jako liczby, a typ data (date) nie daje tu użytecznych dat. Hak dotyczy każdego filtra pola wyboru daty w witrynie, więc wszystkie muszą wtedy wskazywać pola ACF Date Picker. Dla okresu ważności (od / do) dodaj pola początku i końca jako dwa osobne filtry.
Pola Checkbox i wielokrotnego wyboru: dwa wyjścia
Zalecane: przenieś wartości do taksonomii
Dane z kilkoma wartościami na produkt to dokładnie to, do czego służą taksonomie. Z taksonomią dostajesz pole wyboru dla każdej wartości, liczniki, logikę AND lub OR między wybranymi wartościami oraz obsługę trybu Turbo, czego pole meta nie zapewnia. Nie musisz rezygnować z ACF przy edycji:
- Utwórz taksonomię produktów, na przykład Wyposażenie, jako taksonomię niestandardową albo atrybut globalny w Produkty → Atrybuty (Products → Attributes).
- W ACF zastąp pole Checkbox polem Taksonomia (Taxonomy) wskazującym na nią, z włączonymi opcjami Zapisz terminy (Save Terms) i Wczytaj terminy (Load Terms). ACF przypisuje wtedy wybrane terminy do produktu zamiast zapisywać tablicę.
- Produkty otrzymują swoje terminy po ponownym zapisaniu; w dużym katalogu zrób to zbiorczo. Taksonomia pojawia się wtedy na karcie Struktura (Structure) HUSKY jak każda inna.
Zachowaj pole: wyszukiwanie wewnątrz zapisanej tablicy
Jeśli pole musi pozostać bez zmian, można zmienić sposób porównania. Poniższy fragment kodu zamienia warunek „jest równe” w HUSKY dla wymienionych kluczy na wyszukiwanie LIKE wartości w cudzysłowach, więc ac staje się LIKE '%"ac"%' i pasuje do elementu wewnątrz zserializowanego ciągu, ale nie do ac_rear. Naprawia też liczniki opcji.
/*
* 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 );
Następnie dodaj equipment na karcie Meta Dane jako Lista rozwijana (Drop-down) lub Lista rozwijana wielokrotnego wyboru (Multi Drop-down), typ ciąg (string), z wartościami opcji ACF po ^, na przykład Air conditioning^ac,Heated seats^heated_seats. Znaj ograniczenia: Lista rozwijana wielokrotnego wyboru znajduje produkty, które mają dowolną z wybranych wartości, a nie wszystkie; wyszukiwanie LIKE '%…%' nie może użyć indeksu bazy danych i zwalnia w dużych katalogach; a fragment kodu nie działa w trybie Turbo. Więcej o haku na stronie woof_get_meta_query.
Warianty, tryb Turbo i niestandardowe siatki produktów
- Wartości w wariantach nie są przeszukiwane. Zapytanie sklepu zwraca produkty nadrzędne i sprawdza ich własne metadane. Atrybuty działają dla wariantów, ponieważ produkt nadrzędny zawiera wszystkie terminy swoich wariantów; wartości meta nie. Umieść wartość w produkcie nadrzędnym.
- Tryb Turbo filtruje w przeglądarce na podstawie własnego pliku danych, który zawiera tylko klucze dodane na karcie Meta Dane. Pola pokazywane przez rozszerzenie ACF oraz haki PHP, takie jak powyższe fragmenty kodu, nie są tam używane. Zobacz rozwiązywanie problemów z trybem Turbo.
- Adres URL się zmienia, ale nadal widać wszystkie produkty. Wtedy problem nie leży w polu: siatka kreatora stron lub niestandardowy szablon wykonuje własne zapytanie i ignoruje wszystkie filtry. Rozwiązanie znajdziesz w artykule adres URL filtra się zmienia, ale produkty nie są filtrowane.
Jeśli filtr ACF nadal nie znajduje produktów
- Sprawdź, co naprawdę jest zapisane. W phpMyAdmin lub podobnym narzędziu uruchom
SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = 123z identyfikatorem produktu (i Twoim prefiksem tabel). Wartość zaczynająca się oda:to zserializowana tablica; inny klucz niż oczekiwany oznacza, że ACF zapisuje pod inną nazwą. - Karta Meta Dane: klucz bez początkowego podkreślenia, z taką samą wielkością liter; typ ciąg (string) dla tekstu; zapisana wartość opcji po
^. - Dla rozszerzenia ACF: lokalizacja grupy to Typ wpisu jest równy Produkt (Post Type is equal to Product), wartości opcji odpowiadają etykietom, Wybór wielokrotny (Select Multiple) jest wyłączony, a produkty zostały zapisane ponownie po zmianie.
- Wartość znajduje się w produkcie nadrzędnym, a nie w wariantach.
- Filtr taksonomii działa na tej samej stronie. Jeśli nie, najpierw napraw siatkę produktów.
Jeśli wszystkie punkty się zgadzają, a filtr nadal nic nie znajduje, otwórz wątek na forum wsparcia HUSKY, podając typ i ustawienia pola, klucz meta oraz próbkę zapisanej wartości, a my się temu przyjrzymy.