Rotozoom Product Filter — Manuale
Filtraggio prodotti AJAX ultrarapido per WooCommerce. Product Filter permette ai tuoi clienti di restringere il catalogo per categoria, prezzo, attributi, disponibilità e valutazione — i risultati si aggiornano all'istante, senza ricaricare la pagina. È un sostituto diretto e senza dipendenze di WBW Product Filter.
- Versione gratuita: filtraggio AJAX completo, cursore del prezzo, filtri disponibilità/valutazione, contesto di categoria, fino a 4 attributi attivi.
- Versione Pro: attributi illimitati e piena compatibilità con il tema XStore.
- Prezzo Pro: 47 € / anno per sito.
Per i principianti: cosa fa questo plugin
Quando un negozio ha più di una manciata di prodotti, i clienti hanno bisogno di un modo per trovare rapidamente ciò che cercano. Un filtro è il pannello — di solito a sinistra della pagina del negozio — con caselle di controllo e cursori come Prezzo, Colore o Marca. Man mano che il cliente spunta le caselle, la griglia dei prodotti si restringe.
Product Filter aggiunge questo pannello al tuo negozio e lo rende istantaneo: la griglia si aggiorna nel momento in cui una casella viene spuntata, senza ricaricare la pagina. Inoltre mantiene i filtri scelti nell'indirizzo web (l'URL), così un cliente può salvare nei preferiti o condividere una vista filtrata.
Configurazione
1. Prepara i tuoi dati
I filtri valgono quanto i tuoi dati prodotto, quindi assicurati prima che i tuoi prodotti abbiano:
- Categorie assegnate (sotto ogni prodotto o in Prodotti → Categorie).
- Attributi come Colore, Taglia, Potenza, Attacco (impostati in Prodotti → Attributi, poi assegnati ai prodotti).
Suggerimento: mantieni gli slug degli attributi in semplici lettere ASCII (per esempio
socket,wattage). Gli slug non latini possono essere codificati male nell'URL.
2. Posiziona il filtro
Aggiungi il filtro al tuo negozio con lo shortcode [avs_filter]. Mettilo in un'area widget (come una barra laterale del negozio) o direttamente in una pagina o un template di categoria, a seconda del tema. Il filtro rispetta automaticamente la pagina in cui si trova — su una pagina di categoria filtra all'interno di quella categoria.
3. Scegli quali filtri mostrare
Nelle impostazioni del plugin scegli quali controlli appaiono — categorie, fascia di prezzo, singoli attributi, stato di disponibilità e valutazione — e in quale ordine appaiono.
Riferimento delle funzionalità
Filtraggio AJAX con sincronizzazione dell'URL
Ogni modifica a un filtro attiva una richiesta AJAX — una chiamata in background al server che restituisce solo i prodotti corrispondenti e li inserisce nella griglia, senza ricaricare completamente la pagina. I filtri attivi vengono scritti nell'URL, così che:
- Il pulsante Indietro del browser funziona come previsto.
- Una vista filtrata può essere salvata nei preferiti o condivisa.
- Arrivare direttamente su un URL filtrato mostra i risultati corretti, già filtrati.
Cursore della fascia di prezzo
Un cursore trascinabile a due maniglie permette ai clienti di impostare un prezzo minimo e massimo. La fascia si adatta ai prodotti attualmente visibili.
Filtri degli attributi
Ogni attributo WooCommerce può diventare un gruppo di filtri (caselle di controllo). I clienti possono combinarne diversi — per esempio Attacco: E27 e Temperatura di colore: Bianco caldo — per restringere i risultati con precisione.
- Free: fino a 4 filtri di attributi attivi alla volta.
- Pro: filtri di attributi illimitati — ideale per cataloghi tecnici con molte proprietà.
Filtri di disponibilità, valutazione e speciali
Filtri integrati oltre agli attributi:
- Disponibile — nascondi gli articoli esauriti.
- Valutazione — mostra solo i prodotti pari o superiori a una valutazione a stelle.
- In offerta / in evidenza — metti in risalto le promozioni.
Contesto della pagina di categoria
Quando il filtro si trova su un archivio di categoria, limita automaticamente i risultati a quella categoria, così i clienti affinano all'interno della sezione che stanno sfogliando anziché su tutto il negozio.
Free vs Pro in breve
| Funzionalità | Free | Pro |
|---|---|---|
| Filtraggio AJAX con sincronizzazione dell'URL | ✓ | ✓ |
| Cursore della fascia di prezzo | ✓ | ✓ |
| Filtri di disponibilità, valutazione e speciali | ✓ | ✓ |
| Contesto della pagina di categoria | ✓ | ✓ |
| Filtri di attributi attivi | fino a 4 | illimitati |
| Compatibilità tema XStore | — | ✓ |
Note avanzate
- Compatibilità XStore (Pro): XStore genera le pagine del negozio con il proprio markup; Pro include un'integrazione specifica affinché il filtro si agganci correttamente alla griglia dei prodotti e all'AJAX di XStore. Sui temi standard/generici il filtro funziona senza questa.
- Query pilotate dall'URL: i filtri modificano la query principale dei prodotti, così i risultati sono vere query WooCommerce (impaginazione, ordinamento e conteggi corretti) anziché un trucco di mostra/nascondi lato client.
- Prestazioni: il filtraggio usa il contesto di categoria per mantenere le query mirate e veloci anche su cataloghi di grandi dimensioni.
Risoluzione dei problemi
- Un attributo non viene proposto come filtro — verifica che sia un attributo globale (in Prodotti → Attributi) e che sia assegnato ai prodotti; in Free, ricorda il limite di 4 attributi.
- Gli URL filtrati sembrano rotti o codificati due volte — controlla che gli slug degli attributi siano in ASCII semplice.
- Il filtro appare senza stile su XStore — XStore richiede l'integrazione Pro; collega la tua licenza Pro.
Per collegare una licenza Pro, vedi Installare e aggiornare i plugin.