HUSKY - WooCommerce Product Filter Professional

Filtrare i prodotti WooCommerce per campo ACF: tipi, configurazione e soluzioni

Con HUSKY puoi filtrare i prodotti WooCommerce in base ai valori dei campi ACF, ma solo quando il campo memorizza il suo valore in una forma che una query del database è in grado di confrontare. I campi a valore singolo (Select, Radio Button, True / False, Number, Text, Date Picker) si filtrano senza problemi. I campi Checkbox e i campi Select con Selezione multipla (Select Multiple) attivata o non compaiono mai nel filtro oppure mostrano opzioni che trovano sempre 0 prodotti. Qui trovi come HUSKY legge i dati ACF, quali tipi di campo funzionano, come configurare ciascuno e cosa fare con i campi a più valori.

I due modi in cui HUSKY legge i campi ACF

ACF salva ogni campo come normale meta dato del prodotto: una riga nella tabella wp_postmeta, sotto il Nome del campo (Field Name), che contiene il valore salvato. HUSKY ha due estensioni integrate che filtrano in base a queste righe. Entrambe sono estensioni di sistema, sempre attive, quindi non c'è nulla da abilitare.

  • L'estensione ACF (Campi ACF (ACF fields)) trova automaticamente i tuoi gruppi di campi ACF ed elenca i loro campi Select, Radio Button e True / False nella scheda Struttura (Structure) come Etichetta campo (Titolo gruppo) (Field label (Group title)). Imposta il menu a discesa accanto a un campo su Sì, salva, e il campo è nel filtro. Gli altri tipi di campo non vengono elencati affatto. I dettagli sono nella pagina dell'estensione ACF.
  • La scheda Metadati (estensione Filtro meta (Meta filter)) funziona con qualsiasi chiave meta, ACF o meno. La chiave la aggiungi tu e scegli come viene mostrata: Slider, Ricerca per testo (Search by text), Checkbox, Menu a discesa (Drop-down), Menu a discesa multiplo (Multi Drop-down) o Selettore di date (Datepicker), e quale tipo di dati contiene: numero (number), stringa (string) o data (date). Vedi filtrare per campi meta.

L'estensione ACF è più rapida da configurare, ma ha tre regole che spiegano la maggior parte delle segnalazioni "il campo non compare" e "0 prodotti":

  1. Il gruppo di campi deve essere assegnato per tipo di contenuto. HUSKY riconosce solo i gruppi le cui regole di Posizione (Location) contengono Tipo di contenuto è uguale a Prodotto (Post Type is equal to Product). Un gruppo mostrato solo da una regola come la categoria di prodotto viene saltato, quindi i suoi campi non arrivano mai nella scheda Struttura (Structure).
  2. Il valore di ogni scelta deve coincidere con la sua etichetta. In ACF una scelta scritta come xl : Extra large salva xl nel prodotto, ma l'estensione ACF cerca l'etichetta, Extra large, e non trova nulla. Funzionano le scelte scritte come una sola parola per riga (valore ed etichetta coincidono) o che differiscono solo per maiuscole e minuscole, come red : Red. Le etichette che contengono virgolette non corrispondono mai.
  3. Selezione multipla deve essere disattivata. Un campo Select con Selezione multipla (Select Multiple) attivata viene comunque elencato, ma non trova prodotti, per il motivo spiegato più avanti.

Se un campo non rispetta una di queste regole, filtralo invece tramite la scheda Metadati, dove controlli la chiave e i valori esatti.

Quali tipi di campo ACF si possono filtrare

Tipo di campo ACFCosa viene salvato nel prodottoCome filtrarlo in HUSKY
Select (singolo), Radio ButtonIl valore di una sceltaEstensione ACF, oppure Metadati Menu a discesa (Drop-down) / Menu a discesa multiplo (Multi Drop-down)
Button GroupIl valore di una sceltaMetadati Menu a discesa (Drop-down) / Menu a discesa multiplo (Multi Drop-down)
True / False1 oppure 0Estensione ACF, oppure Metadati Checkbox
Number, RangeUn numeroMetadati Slider, tipo numero (number)
Text, Email, URLUna stringaMetadati Ricerca per testo (Search by text), oppure Menu a discesa (Drop-down) con i valori elencati
Date PickerUna data come 20250131 (Ymd)Metadati Selettore di date (Datepicker) più un hook (vedi sotto)
Checkbox, Select con Selezione multipla (Select Multiple), Relationship / Post Object / Taxonomy a più valoriUn array serializzatoNon con un confronto normale; vedi le due soluzioni più avanti
Repeater, Flexible ContentRighe numerate come specs_0_widthNon filtrabile come campo unico

I campi all'interno di un campo Group vengono salvati come groupname_fieldname e si filtrano come il loro tipo specifico. Un Date Time Picker salva un testo come 2025-01-31 14:00:00, che il filtro Datepicker non è in grado di confrontare.

Perché i campi checkbox e a selezione multipla non trovano nulla

Quando un campo può contenere più valori, ACF li impacchetta in un'unica stringa nel formato serializzato di PHP. Un'auto con aria condizionata e sedili riscaldati ottiene una riga meta come questa:

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

L'estensione ACF e le visualizzazioni Drop-down, Multi Drop-down e Checkbox chiedono al database le righe in cui il valore è uguale (equals) all'opzione selezionata. ac non è uguale a quell'intera stringa, quindi il risultato è 0. Disattivare Selezione multipla (Select Multiple) in ACF non ripara i prodotti esistenti: i loro valori restano serializzati finché ogni prodotto non viene salvato di nuovo con un solo valore.

Configurare un campo ACF nella scheda Metadati

  1. Trova la vera chiave meta. È il Nome del campo (Field Name) in ACF (ad esempio body_type), non la sua etichetta. Nella scheda Metadati (Meta Data), Ottieni le chiavi da qualsiasi prodotto tramite il suo ID (Get keys from any product by its ID) elenca tutte le chiavi di un prodotto. Ogni campo ACF compare due volte: body_type contiene il valore, _body_type contiene il riferimento interno al campo di ACF. Usa la chiave senza il trattino basso. Le chiavi distinguono maiuscole e minuscole e non contengono mai spazi o parentesi.
  2. Aggiungi la chiave con Aggiungi chiave personalizzata a mano (Add Custom key by hands) oppure dall'elenco, inserisci un titolo e scegli la visualizzazione e il tipo. Per i valori di testo scegli stringa (string). Con numero (number), MySQL converte in 0 un testo come Coupe prima del confronto e il filtro restituisce ogni prodotto che ha la chiave, il che fa sembrare che "il filtro non faccia nulla".
  3. Elenca le opzioni per Menu a discesa (Drop-down) e Menu a discesa multiplo (Multi Drop-down). Un campo meta è testo libero, quindi HUSKY non può costruire da solo l'elenco dei valori; lo scrivi tu, separato da virgole. Usa title^value quando il titolo visibile differisce dal valore salvato. Per le scelte ACF coupe : Coupe e suv : SUV / Crossover diventa:
    Coupe^coupe,SUV / Crossover^suv
    La parte dopo ^ deve essere esattamente ciò che ACF ha salvato, il valore della scelta, non la sua etichetta.
  4. Salva, apri la scheda Struttura (Structure), imposta il nuovo elemento su Sì, trascinalo al suo posto e salva di nuovo. L'icona a forma di ingranaggio accanto contiene le opzioni proprie della visualizzazione, ad esempio Opzione di ricerca (Search option) e Valore di ricerca (Search value) per un Checkbox, oppure Condizione di ricerca testuale (Text search conditional) (LIKE o EXACT) per Ricerca per testo (Search by text).

Un Checkbox è una singola casella per una chiave. Trova i prodotti il cui valore è 1 (campi True / False), un altro Valore di ricerca (Search value) come yes oppure, con Opzione di ricerca (Search option) impostata su Il valore esiste (Value exists), ogni prodotto che ha il campo compilato.

Se un valore salvato contiene a sua volta una virgola, cambia il separatore per tutti gli elenchi Drop-down e Multi Drop-down, quindi riscrivi gli elenchi con |:

/*
 * 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 '|';
} );

I campi Number e Range vanno in uno Slider; intervalli, passi e decimali sono trattati in filtri slider di intervallo per attributi e campi meta.

Filtrare per un campo data ACF

Il filtro Datepicker confronta per impostazione predefinita i timestamp Unix, mentre il Date Picker di ACF salva le date come 20250131. L'hook woof_meta_use_acf_dateformat fa sì che il filtro converta le date scelte nello stesso formato prima di cercare:

/*
 * 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' );

Aggiungi la chiave ACF nella scheda Metadati con la visualizzazione Selettore di date (Datepicker) e lascia il tipo su numero (number): le date convertite vengono confrontate come numeri, e il tipo data (date) qui non produce date utilizzabili. L'hook si applica a ogni filtro Datepicker del sito, quindi tutti devono poi puntare a campi ACF Date Picker. Per un periodo di validità (da / a), aggiungi i campi di inizio e di fine come due filtri separati.

Campi checkbox e a selezione multipla: due soluzioni

Consigliata: spostare i valori in una tassonomia

I dati con più valori per prodotto sono ciò per cui sono nate le tassonomie. Con una tassonomia ottieni una checkbox per ogni valore, i conteggi, la logica AND o OR tra i valori selezionati e il supporto della modalità Turbo, cose che un campo meta non può offrire. Non devi rinunciare ad ACF per la modifica:

  1. Crea una tassonomia di prodotto, ad esempio Dotazioni, come tassonomia personalizzata oppure come attributo globale in Prodotti → Attributi (Products → Attributes).
  2. In ACF, sostituisci il campo Checkbox con un campo Tassonomia (Taxonomy) che punti a essa, con Salva termini (Save Terms) e Carica termini (Load Terms) attivati. ACF assegna allora al prodotto i termini scelti invece di memorizzare un array.
  3. I prodotti ricevono i loro termini quando vengono salvati di nuovo; per un catalogo grande fallo in blocco. La tassonomia compare poi nella scheda Struttura (Structure) di HUSKY come qualsiasi altra.

Mantenere il campo: cercare all'interno dell'array memorizzato

Se il campo deve restare com'è, si può cambiare il confronto. Lo snippet qui sotto trasforma la condizione "uguale" di HUSKY per le chiavi elencate in una ricerca LIKE del valore tra virgolette, quindi ac diventa LIKE '%"ac"%' e corrisponde all'elemento all'interno della stringa serializzata, ma non a ac_rear. Corregge anche i conteggi delle opzioni.

/*
 * 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 );

Poi aggiungi equipment nella scheda Metadati come Menu a discesa (Drop-down) o Menu a discesa multiplo (Multi Drop-down), tipo stringa (string), con i valori delle scelte ACF dopo ^, ad esempio Air conditioning^ac,Heated seats^heated_seats. Tieni presenti i limiti: un Multi Drop-down trova i prodotti che hanno almeno uno dei valori selezionati, non tutti; una ricerca LIKE '%…%' non può usare un indice del database e rallenta nei cataloghi grandi; e lo snippet non si applica nella modalità Turbo. Altre informazioni sull'hook nella pagina woof_get_meta_query.

Varianti, modalità Turbo e griglie di prodotti personalizzate

  • I valori nelle varianti non vengono cercati. La query del negozio restituisce i prodotti padre e controlla i meta del padre stesso. Gli attributi funzionano per le varianti perché il padre porta tutti i termini delle sue varianti; i valori meta no. Inserisci il valore nel prodotto padre.
  • La modalità Turbo filtra nel browser dal proprio file di dati, che include solo le chiavi aggiunte nella scheda Metadati. I campi mostrati tramite l'estensione ACF e gli hook PHP come gli snippet qui sopra non vengono usati lì. Vedi risoluzione dei problemi della modalità Turbo.
  • L'URL cambia ma tutti i prodotti vengono ancora mostrati. Allora il problema non è il campo: la griglia del page builder o il template personalizzato esegue una propria query e ignora ogni filtro. La soluzione è in l'URL del filtro cambia ma i prodotti non vengono filtrati.

Se il filtro ACF continua a non trovare prodotti

  • Controlla cosa è davvero salvato. In phpMyAdmin o in uno strumento simile esegui SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = 123 con l'ID di un prodotto (e il prefisso delle tue tabelle). Un valore che inizia con a: è un array serializzato; una chiave diversa da quella attesa significa che ACF salva con un altro nome.
  • Scheda Metadati: la chiave senza il trattino basso iniziale, con le stesse maiuscole e minuscole; tipo stringa (string) per il testo; il valore della scelta salvato dopo ^.
  • Per l'estensione ACF: la posizione del gruppo è Tipo di contenuto è uguale a Prodotto (Post Type is equal to Product), i valori delle scelte coincidono con le etichette, Selezione multipla (Select Multiple) è disattivata e i prodotti sono stati salvati di nuovo dopo la modifica.
  • Il valore si trova nel prodotto padre, non nelle varianti.
  • Un filtro per tassonomia funziona nella stessa pagina. Se non funziona, correggi prima la griglia dei prodotti.

Se ogni punto risulta a posto e il filtro non trova ancora nulla, apri una discussione sul forum di supporto di HUSKY indicando il tipo e le impostazioni del campo, la chiave meta e un esempio del valore salvato, e daremo un'occhiata.