WooCommerce-Produkte nach ACF-Feld filtern: Feldtypen, Einrichtung, Lösungen
Mit HUSKY können Sie WooCommerce-Produkte nach ACF-Feldwerten filtern, aber nur dann, wenn das Feld seinen Wert in einer Form speichert, die eine Datenbankabfrage vergleichen kann. Felder mit einem einzelnen Wert (Select, Radio Button, True / False, Number, Text, Date Picker) lassen sich problemlos filtern. Checkbox-Felder und Select-Felder mit eingeschalteter Mehrfachauswahl (Select Multiple) erscheinen entweder gar nicht im Filter oder zeigen Optionen, die immer 0 Produkte finden. Im Folgenden erfahren Sie, wie HUSKY ACF-Daten liest, welche Feldtypen funktionieren, wie Sie jeden einrichten und was bei Feldern mit mehreren Werten zu tun ist.
Zwei Wege, wie HUSKY ACF-Felder liest
ACF speichert jedes Feld als gewöhnliche Produkt-Metadaten: eine Zeile in der Tabelle wp_postmeta, unter dem Feldnamen (Field Name) des Feldes, mit dem gespeicherten Wert. HUSKY hat zwei integrierte Erweiterungen, die nach solchen Zeilen filtern. Beide sind Systemerweiterungen und immer aktiv, es muss also nichts eingeschaltet werden.
- Die ACF-Erweiterung (ACF-Felder (ACF fields)) findet Ihre ACF-Feldgruppen automatisch und listet deren Select-, Radio-Button- und True / False-Felder im Tab Struktur (Structure) als Feldbezeichnung (Gruppentitel) (Field label (Group title)) auf. Stellen Sie die Auswahlliste neben einem Feld auf Ja (Yes), speichern Sie, und das Feld ist im Filter. Andere Feldtypen werden überhaupt nicht aufgelistet. Details finden Sie auf der Seite der ACF-Erweiterung.
- Der Tab Metadaten (Erweiterung Metafilter (Meta filter)) funktioniert mit jedem Meta-Schlüssel, ob ACF oder nicht. Sie fügen den Schlüssel selbst hinzu und legen fest, wie er angezeigt wird: Schieberegler (Slider), Suche nach Text (Search by text), Checkbox, Dropdown-Liste (Drop-down), Multi Dropdown (Multi Drop-down) oder Datumsauswahl (Datepicker), und welchen Datentyp er enthält: Zahl (number), string oder Datum (date). Siehe Filtern nach Meta-Feldern.
Die ACF-Erweiterung ist schneller eingerichtet, hat aber drei Regeln, die die meisten Meldungen „das Feld fehlt“ und „0 Produkte“ erklären:
- Die Feldgruppe muss nach Beitragstyp zugewiesen sein. HUSKY erfasst nur Gruppen, deren Position (Location)-Regeln Beitragstyp ist gleich Produkt (Post Type is equal to Product) enthalten. Eine Gruppe, die nur durch eine Regel wie die Produktkategorie angezeigt wird, wird übersprungen, ihre Felder erreichen den Tab Struktur (Structure) also nie.
- Der Wert jeder Auswahloption muss ihrer Bezeichnung entsprechen. Eine in ACF als
xl : Extra largegeschriebene Option speichertxlam Produkt, doch die ACF-Erweiterung sucht nach der BezeichnungExtra largeund findet nichts. Optionen, die als ein einzelnes Wort pro Zeile geschrieben sind (Wert und Bezeichnung sind gleich) oder sich nur in der Groß- und Kleinschreibung unterscheiden, wiered : Red, funktionieren. Bezeichnungen mit Anführungszeichen passen nie. - Mehrfachauswahl muss ausgeschaltet sein. Ein Select-Feld mit aktivierter Mehrfachauswahl (Select Multiple) wird weiterhin aufgelistet, findet aber keine Produkte, aus dem unten erklärten Grund.
Verstößt ein Feld gegen eine dieser Regeln, filtern Sie es stattdessen über den Tab Metadaten, wo Sie den Schlüssel und die genauen Werte selbst steuern.
Welche ACF-Feldtypen sich filtern lassen
| ACF-Feldtyp | Was am Produkt gespeichert wird | So filtern Sie in HUSKY |
|---|---|---|
| Select (einzeln), Radio Button | Ein Auswahlwert | ACF-Erweiterung oder Metadaten Dropdown-Liste (Drop-down) / Multi Dropdown (Multi Drop-down) |
| Button Group | Ein Auswahlwert | Metadaten Dropdown-Liste (Drop-down) / Multi Dropdown (Multi Drop-down) |
| True / False | 1 oder 0 | ACF-Erweiterung oder Metadaten Checkbox |
| Number, Range | Eine Zahl | Metadaten Schieberegler (Slider), Typ Zahl (number) |
| Text, Email, URL | Eine Zeichenkette | Metadaten Suche nach Text (Search by text) oder Dropdown-Liste (Drop-down) mit aufgelisteten Werten |
| Date Picker | Ein Datum als 20250131 (Ymd) | Metadaten Datumsauswahl (Datepicker) plus ein Hook (siehe unten) |
| Checkbox, Select mit Mehrfachauswahl (Select Multiple), Relationship / Post Object / Taxonomy mit mehreren Werten | Ein serialisiertes Array | Nicht mit einem normalen Vergleich; siehe die zwei Auswege unten |
| Repeater, Flexible Content | Nummerierte Zeilen wie specs_0_width | Nicht als ein Feld filterbar |
Felder innerhalb eines Group-Feldes werden unter groupname_fieldname gespeichert und lassen sich wie ihr eigener Typ filtern. Ein Date Time Picker speichert Text wie 2025-01-31 14:00:00, den der Filter Datumsauswahl nicht vergleichen kann.
Warum Checkbox- und Mehrfachauswahlfelder nichts finden
Kann ein Feld mehrere Werte enthalten, packt ACF sie im serialisierten Format von PHP in eine einzige Zeichenkette. Ein Auto mit Klimaanlage und Sitzheizung erhält eine Meta-Zeile wie diese:
a:2:{i:0;s:2:"ac";i:1;s:12:"heated_seats";}
Die ACF-Erweiterung und die Ansichten Dropdown-Liste, Multi Dropdown und Checkbox fragen die Datenbank nach Zeilen, deren Wert gleich (equals) der gewählten Option ist. ac ist nicht gleich dieser ganzen Zeichenkette, das Ergebnis ist also 0. Das Ausschalten der Mehrfachauswahl (Select Multiple) in ACF repariert bestehende Produkte nicht: Ihre Werte bleiben serialisiert, bis jedes Produkt erneut mit einem einzelnen Wert gespeichert wird.
Ein ACF-Feld im Tab Metadaten einrichten
- Den echten Meta-Schlüssel finden. Es ist der Feldname (Field Name) des Feldes in ACF (zum Beispiel
body_type), nicht seine Bezeichnung. Im Tab Metadaten (Meta Data) listet Schlüssel eines beliebigen Produkts anhand seiner ID abrufen (Get keys from any product by its ID) alle Schlüssel eines Produkts auf. Jedes ACF-Feld erscheint zweimal:body_typeenthält den Wert,_body_typeden internen Feldverweis von ACF. Verwenden Sie den Schlüssel ohne Unterstrich. Bei Schlüsseln wird zwischen Groß- und Kleinschreibung unterschieden, und sie enthalten nie Leerzeichen oder Klammern. - Den Schlüssel hinzufügen mit Fügen Sie den individuellen Schlüssel von Hand hinzu (Add Custom key by hands) oder aus der Liste, einen Titel eingeben und die Ansicht und den Typ wählen. Für Textwerte wählen Sie string. Bei Zahl (number) wandelt MySQL Text wie
Coupevor dem Vergleich in 0 um, und der Filter liefert jedes Produkt, das den Schlüssel hat, was aussieht wie „der Filter tut nichts“. - Die Optionen auflisten für Dropdown-Liste (Drop-down) und Multi Dropdown (Multi Drop-down). Ein Meta-Feld ist Freitext, HUSKY kann die Werteliste also nicht selbst erstellen; Sie schreiben sie, durch Kommas getrennt. Verwenden Sie
title^value, wenn sich der sichtbare Titel vom gespeicherten Wert unterscheidet. Für die ACF-Optionencoupe : Coupeundsuv : SUV / Crossoversieht das so aus:
Der Teil nachCoupe^coupe,SUV / Crossover^suv^muss genau dem entsprechen, was ACF gespeichert hat, dem Optionswert, nicht der Bezeichnung. - Speichern, den Tab Struktur (Structure) öffnen, das neue Element auf Ja (Yes) stellen, es an die richtige Stelle ziehen und erneut speichern. Das Zahnrad-Symbol daneben enthält die eigenen Optionen der Ansicht, zum Beispiel Suchoption (Search option) und Suchwert (Search value) für eine Checkbox oder Textsuche bedingt (Text search conditional) (Ähnlich (LIKE) oder GENAU (EXACT)) für Suche nach Text (Search by text).
Eine Checkbox ist ein einzelnes Kontrollkästchen für einen Schlüssel. Sie findet Produkte, deren Wert 1 ist (True / False-Felder), einen anderen Suchwert (Search value) wie yes hat oder, mit Suchoption (Search option) auf Wert existiert (Value exists), bei denen das Feld ausgefüllt ist.
Enthält ein gespeicherter Wert selbst ein Komma, ändern Sie das Trennzeichen für alle Dropdown- und Multi-Dropdown-Listen und schreiben Sie die Listen dann mit | neu:
/*
* 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- und Range-Felder gehören in einen Schieberegler (Slider); Bereiche, Schrittweiten und Dezimalzahlen werden in Schieberegler-Filter für Attribute und Meta-Felder behandelt.
Nach einem ACF-Datumsfeld filtern
Der Datumsauswahl-Filter vergleicht standardmäßig Unix-Zeitstempel, während der Date Picker von ACF Datumsangaben als 20250131 speichert. Der Hook woof_meta_use_acf_dateformat bewirkt, dass der Filter die gewählten Datumsangaben vor der Suche in dasselbe Format umwandelt:
/*
* 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' );
Fügen Sie den ACF-Schlüssel im Tab Metadaten mit der Ansicht Datumsauswahl (Datepicker) hinzu und lassen Sie den Typ auf Zahl (number): Die umgewandelten Datumsangaben werden als Zahlen verglichen, und der Typ Datum (date) liefert hier keine brauchbaren Daten. Der Hook gilt für jeden Datumsauswahl-Filter der Website; alle müssen dann auf ACF-Date-Picker-Felder zeigen. Für einen Gültigkeitszeitraum (von / bis) fügen Sie das Start- und das Endfeld als zwei getrennte Filter hinzu.
Checkbox- und Mehrfachauswahlfelder: zwei Auswege
Empfohlen: die Werte in eine Taxonomie verschieben
Daten mit mehreren Werten pro Produkt sind genau das, wofür Taxonomien gemacht sind. Mit einer Taxonomie erhalten Sie eine Checkbox für jeden Wert, Zähler, UND- oder ODER-Logik zwischen den gewählten Werten und Unterstützung für den Turbo-Modus, was ein Meta-Feld nicht bieten kann. Sie müssen ACF für die Bearbeitung nicht aufgeben:
- Legen Sie eine Produkttaxonomie an, zum Beispiel Ausstattung (Equipment), als benutzerdefinierte Taxonomie oder als globales Attribut unter Produkte → Attribute (Products → Attributes).
- Ersetzen Sie in ACF das Checkbox-Feld durch ein Taxonomie (Taxonomy)-Feld, das darauf verweist, mit eingeschalteten Optionen Begriffe speichern (Save Terms) und Begriffe laden (Load Terms). ACF weist dem Produkt dann die gewählten Begriffe zu, statt ein Array zu speichern.
- Produkte erhalten ihre Begriffe, wenn sie erneut gespeichert werden; bei einem großen Katalog erledigen Sie das per Massenbearbeitung. Die Taxonomie erscheint dann wie jede andere im Tab Struktur (Structure) von HUSKY.
Das Feld behalten: im gespeicherten Array suchen
Muss das Feld bleiben, wie es ist, lässt sich der Vergleich ändern. Das folgende Snippet wandelt die „ist gleich“-Bedingung von HUSKY für die aufgelisteten Schlüssel in eine LIKE-Suche nach dem in Anführungszeichen gesetzten Wert um: ac wird zu LIKE '%"ac"%' und trifft das Element innerhalb der serialisierten Zeichenkette, aber nicht ac_rear. Es korrigiert auch die Zähler der Optionen.
/*
* 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 );
Fügen Sie dann equipment im Tab Metadaten als Dropdown-Liste (Drop-down) oder Multi Dropdown (Multi Drop-down) hinzu, Typ string, mit den ACF-Optionswerten nach ^, zum Beispiel Air conditioning^ac,Heated seats^heated_seats. Beachten Sie die Grenzen: Ein Multi Dropdown findet Produkte, die einen beliebigen (any) der gewählten Werte haben, nicht alle; eine LIKE '%…%'-Suche kann keinen Datenbankindex nutzen und wird bei großen Katalogen langsamer; und das Snippet greift im Turbo-Modus nicht. Mehr zum Hook auf der Seite woof_get_meta_query.
Variationen, Turbo-Modus und benutzerdefinierte Produktraster
- Werte an Variationen werden nicht durchsucht. Die Shop-Abfrage liefert übergeordnete Produkte und prüft deren eigene Metadaten. Attribute funktionieren bei Variationen, weil das übergeordnete Produkt alle Begriffe seiner Variationen trägt; Meta-Werte tun das nicht. Legen Sie den Wert am übergeordneten Produkt ab.
- Der Turbo-Modus filtert im Browser aus einer eigenen Datendatei, die nur die im Tab Metadaten hinzugefügten Schlüssel enthält. Über die ACF-Erweiterung angezeigte Felder und PHP-Hooks wie die obigen Snippets werden dort nicht verwendet. Siehe Fehlerbehebung beim Turbo-Modus.
- Die URL ändert sich, aber es werden weiterhin alle Produkte angezeigt. Dann liegt das Problem nicht am Feld: Das Raster des Page Builders oder ein benutzerdefiniertes Template führt eine eigene Abfrage aus und ignoriert jeden Filter. Die Lösung steht unter Filter-URL ändert sich, aber die Produkte werden nicht gefiltert.
Wenn der ACF-Filter weiterhin keine Produkte findet
- Prüfen Sie, was wirklich gespeichert ist. Führen Sie in phpMyAdmin oder einem ähnlichen Werkzeug
SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = 123mit einer Produkt-ID (und Ihrem Tabellenpräfix) aus. Ein Wert, der mita:beginnt, ist ein serialisiertes Array; ein anderer Schlüssel als erwartet bedeutet, dass ACF unter einem anderen Namen speichert. - Tab Metadaten: der Schlüssel ohne führenden Unterstrich und in derselben Schreibweise; Typ string für Text; der gespeicherte Optionswert nach
^. - Für die ACF-Erweiterung: Die Position der Gruppe ist Beitragstyp ist gleich Produkt (Post Type is equal to Product), die Optionswerte entsprechen ihren Bezeichnungen, die Mehrfachauswahl (Select Multiple) ist aus, und die Produkte wurden nach der Änderung erneut gespeichert.
- Der Wert liegt am übergeordneten Produkt, nicht an Variationen.
- Ein Taxonomie-Filter funktioniert auf derselben Seite. Falls nicht, beheben Sie zuerst das Produktraster.
Wenn alle Punkte stimmen und der Filter trotzdem nichts findet, eröffnen Sie im HUSKY-Support-Forum ein Thema mit Typ und Einstellungen des Feldes, dem Meta-Schlüssel und einem Beispiel für den gespeicherten Wert, und wir sehen es uns an.