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.

• Versione gratuita: filtraggio AJAX completo su ogni attributo prodotto (senza limiti), cursore del prezzo, filtri disponibilità/in offerta/novità/valutazione, contesto di categoria e compatibilità con temi classici, a blocchi e XStore.
• Versione Pro: corrispondenza di tutti i valori selezionati di un attributo (logica AND), tue scelte personali di prodotti per pagina, un colore esatto per ciascun valore di swatch e una cache dei risultati per un filtraggio ripetuto più veloce. Pro richiede l'edizione scaricata da rotozoom.com, che installa automaticamente Rotozoom Connect — lì effettui l'accesso con il tuo account Rotozoom.
• Prezzo Pro: 47 € / anno per sito, IVA incl.

---

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

Il filtro compare automaticamente nelle pagine del tuo negozio, di categoria, di tag e di ricerca. Per posizionarlo altrove — su qualsiasi pagina o articolo — usa lo shortcode [rotozoom_filter] (opzioni: category, per_page, columns, orderby, sidebar="0", bar="0"); [rotozoom_filter_bar] genera autonomamente la barra degli strumenti di ordinamento/prodotti per pagina. 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 (Rotozoom → Product Filter) 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. L'intervallo copre i prezzi dell'intera categoria corrente (incluse le sue sottocategorie), o dell'intero negozio nelle pagine di negozio e di ricerca; non si restringe man mano che vengono selezionati altri filtri.

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: ogni attributo può essere un filtro — non c'è alcun limite. I prodotti corrispondono se hanno almeno uno dei valori selezionati di un attributo (OR).
• Pro: per ciascun attributo puoi scegliere Tutti (AND) in Sezioni, quindi i prodotti devono avere ogni valore selezionato — 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 (disattivata per impostazione predefinita; attivala in Sezioni → Visibilità delle sezioni).
• In offerta — metti in risalto le promozioni.
• Novità — mostra i prodotti aggiunti di recente.

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.

Extra Pro

• Corrispondenza AND — richiede tutti i valori selezionati di un attributo.
• Prodotti per pagina — offri ai clienti le tue scelte personalizzate per pagina.
• Colori swatch esatti — imposta il colore preciso mostrato per ciascun valore di colore.
• Cache dei risultati — i risultati dei filtri ripetuti per i visitatori disconnessi vengono serviti da una cache sul tuo sito, aggiornata quando cambiano i prodotti o la disponibilità.

Free vs Pro in breve

Funzionalità	Free	Pro
Filtraggio AJAX con sincronizzazione dell'URL	✓	✓
Cursore della fascia di prezzo	✓	✓
Filtri di disponibilità, in offerta, novità e valutazione	✓	✓
Contesto della pagina di categoria	✓	✓
Filtri per tutti gli attributi dei prodotti (senza limiti)	✓	✓
Temi classici, a blocchi e XStore	✓	✓
Corrispondenza AND per attributo	—	✓
Scelte personalizzate di prodotti per pagina	—	✓
Colore esatto per valore di swatch	—	✓
Cache dei risultati	—	✓

Note avanzate

• Compatibilità XStore (Free e Pro): XStore genera le pagine del negozio con il proprio markup; il plugin 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.
• 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 — assicurati che il filtro si trovi su una pagina di negozio o di categoria WooCommerce e svuota la cache di pagina.

Per attivare Pro (scarica da rotozoom.com e accedi tramite Rotozoom Connect), vedi Installare e aggiornare i plugin.