Filters

Interfaccia dei filtri #

I filtri possono essere utilizzati per ogni Contenuto per restringere i risultati in base alle caratteristiche 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 da:

• Un attributo su cui filtrare
• Un confronto che decide come l’attributo deve essere confrontato con il valore
• Un valore che determina a cosa l’attributo deve essere confrontato

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

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

Durante la creazione dei filtri, l’interfaccia ti mostrerà quanti prodotti corrispondono al filtro e la stringa di filtro generata.

Filtri semplici #

Questi contengono solo un singolo attributo e un confronto. Un esempio è mostrare solo i 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 prodotti che corrispondono a tutti i filtri del set.
• OR mostra prodotti che corrispondono ad almeno uno dei filtri del set.

Esempio: Vuoi mostrare solo i prodotti sotto i €400 e anche in saldo.

Combinazione di set #

Puoi combinare set di filtri che permettono loro di lavorare insieme tramite 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 prodotti che corrispondono a tutti i set.
• OR mostra prodotti che corrispondono ad almeno uno dei set.

Esempio: Vuoi mostrare prodotti che sono sotto i €400 E in saldo, ma anche del Fornitore A O di una categoria specifica.

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

Stringa di 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 formati come stringhe tipo “GT-1234”, le virgolette vengono aggiunte automaticamente alla stringa di filtro.

sku = "GT-1234"

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

price < 300

Se riscontri problemi con il filtraggio, controlla la stringa di filtro per assicurarti che sia usata la sintassi corretta, ed effettua le modifiche necessarie.

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

Puoi sempre modificare manualmente la stringa di filtro secondo le tue esigenze cliccando sull’icona matita accanto a Filter expression.

Filtraggio dinamico #

I filtri possono essere aggiunti direttamente ai codici di embed utilizzando l’attributo data-filter. Questo ti consente di rendere i filtri dinamici modificando i valori in base alla logica del frontend.

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

Limite per spedizione gratuita #

Definisci una variabile, ad es. $free_shipping_limit, che contiene l’importo rimanente necessario affinché il cliente raggiunga la soglia per la spedizione gratuita. Usalo come filtro dinamico per mostrare solo prodotti al di sopra di 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 tipo gender che contiene female, male, kids, unisex e così via, puoi forzare gli elementi Clerk a mostrare prodotti per lo stesso genere.

Definisci una variabile, ad es. $product_gender, che contiene il genere del prodotto visualizzato e usala per mostrare prodotti dello stesso genere:

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

Categoria specifica #

In questo caso ti serve una lista nel tuo store che contiene le categorie di prodotto, che potrebbe essere definita come $available_categories = [1,2,3,4,5]. Usala per filtrare slider e mostrare solo prodotti appartenenti a quelle categorie:

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