Filters

Interfaccia dei filtri #

I filtri possono essere utilizzati per ogni Contenuto per restringere i risultati in base agli attributi del prodotto.

Troverai questa opzione in ogni Contenuto che crei per Recommendations, Search o Email, sotto Content type > Product filters.

Ogni parte del filtro è composta dai seguenti elementi:

• Un attributo su cui filtrare
• Un confronto che decide come confrontare l’attributo con il valore
• Un valore che determina con cosa confrontare l’attributo

Puoi creare filtri basati su qualsiasi attributo di prodotto che invii a Clerk. Gli operatori di confronto disponibili dipendono dal tipo di attributo che vuoi filtrare.

Ad esempio, price contiene un numero, il che significa che puoi utilizzare sia maggiore di, minore di e altri confronti numerici, mentre attributi testuali come name consentono solo confronti booleani come è o non è.

Quando crei filtri, l’interfaccia mostra quanti prodotti corrispondono al filtro e la stringa filtro generata.

Filtri semplici #

Questi contengono un solo attributo e confronto. Un esempio è mostrare solo prodotti sotto i 400 €:

Set di filtri #

Questi ti permettono di restringere la selezione dei prodotti aggiungendo più filtri all’interno dello stesso set. Puoi farlo cliccando sull’icona "+" all’interno di un filtro esistente e aggiungendone uno nuovo.

All’interno di un set, puoi scegliere tra due logiche di filtraggio:

• AND mostra solo i prodotti che soddisfano tutti i filtri del set.
• OR mostra i prodotti che soddisfano almeno uno dei filtri del set.

Esempio: Vuoi mostrare solo prodotti che costano meno di 400 € e sono anche in saldo.

Combinazione di set #

Puoi combinare set di filtri per farli lavorare insieme attraverso condizioni diverse. Invece di aggiungere filtri all’interno di un set esistente, clicca su "+ Aggiungi filtro" per iniziare un nuovo set.

Ogni set di filtri funziona separatamente, e puoi scegliere come interagiscono:

• AND mostra solo i prodotti che soddisfano tutti i set.
• OR mostra i prodotti che soddisfano almeno uno dei set.

Esempio: Vuoi mostrare prodotti che sono sotto i 400 € E in saldo, ma anche provenienti da Vendor A O una categoria specifica.

• Il primo set assicura che i prodotti rispettino le condizioni di prezzo e saldo.
• Il secondo set dà flessibilità includendo prodotti da uno specifico vendor o categoria.

Stringa filtro #

L’Interfaccia dei Filtri crea automaticamente la sintassi corretta in base ai dati disponibili nei tuoi attributi. Ad esempio, se i tuoi SKU sono formattati come stringhe tipo “GT-1234”, le virgolette vengono aggiunte automaticamente alla stringa filtro.

sku = "GT-1234"

Se un attributo è un numero, viene aggiunto senza virgolette.

price < 300

Se riscontri problemi con il filtraggio, controlla la stringa filtro per assicurarti che la sintassi sia corretta e apporta le modifiche necessarie.

Se hai dubbi, puoi vedere quale tipo di dato ha un determinato attributo (stringa, numero, lista, booleano) andando su Data > Products e navigando su un qualsiasi prodotto.

Puoi sempre modificare manualmente la stringa filtro in base alle tue esigenze cliccando sull’icona matita accanto a Filter expression.

Filtraggio dinamico #

Filters possono essere aggiunti direttamente ai codici di incorporamento utilizzando l’attributo data-filter. Questo permette di rendere i filtri dinamici modificando i valori in base alla logica frontend.

Di seguito alcuni esempi comuni di come puoi utilizzare il filtraggio dinamico.

Limite per la spedizione gratuita #

Definisci una variabile, ad esempio $free_shipping_limit, che contiene l’importo rimanente necessario al cliente per raggiungere il limite di spedizione gratuita. Usa questo valore come filtro dinamico per mostrare solo i prodotti sopra questo prezzo:

<span class="clerk"
      data-template="@complementary-to-basket"
      data-filter="price > $free_shipping_limit">
</span>

Corrispondenza del genere #

Se i tuoi prodotti hanno un attributo come gender che può contenere female, male, kids, unisex e così via, puoi forzare gli elementi Clerk a mostrare prodotti per lo stesso genere.

Definisci una variabile, ad esempio $product_gender, che contiene il genere del prodotto attualmente visualizzato, e utilizzala per mostrare prodotti dello stesso genere:

<span class="clerk"
      data-template="@Bestsellers"
      data-filter="gender = $product_gender">
</span>

Categoria specifica #

In questo caso hai bisogno di una lista nel tuo store che contenga le categorie dei prodotti, che potrebbe essere definita come $available_categories = [1,2,3,4,5]. Usala per filtrare gli slider così da mostrare solo prodotti appartenenti a queste categorie:

<span class="clerk"
      data-template="@type-slider"
      data-filter="categories in $available_categories">
</span>