Filtri a Faccette AJAX per PrestaShop — Documentazione

Questa guida copre l’installazione, la configurazione e l’esercizio del modulo Filtri a Faccette AJAX per PrestaShop 8 e 9. Il modulo sostituisce la ricerca a faccette nativa con una navigazione AJAX più rapida, uno slider prezzo con istogramma e un controllo fine dell’indicizzazione SEO delle pagine filtrate.

Installazione

Nel tuo back-office, apri Moduli > Gestore moduli, clicca su Carica un modulo e trascina il file dffacetedfilter.zip. All’installazione il modulo esegue automaticamente:

• la creazione delle sue tabelle e della sua scheda di amministrazione;
• una prima sincronizzazione delle faccette dal tuo catalogo;
• il preriscaldamento dell’indice prezzi (entro pochi secondi).

Prima configurazione

Vai su Catalogo > Filtri a faccette. Vi troverai l’elenco delle faccette, una dashboard di sintesi e le impostazioni generali e SEO.

Sincronizzare le faccette

Il pulsante Sincronizza dal catalogo crea automaticamente le faccette mancanti a partire dai tuoi gruppi di attributi, dalle tue caratteristiche e dalle faccette integrate (prezzo, marca, saldi, disponibilità, condizione). Le faccette esistenti non vengono mai modificate: puoi rilanciare la sincronizzazione in tutta sicurezza dopo aver aggiunto un attributo o una caratteristica.

Ricostruire l’indice prezzi

Il pulsante Ricostruisci l’indice prezzi ricalcola i limiti di prezzo di tutti i prodotti, a lotti, con una barra di avanzamento. Avvialo dopo l’installazione e dopo ogni importazione massiva di prodotti.

Gestire le faccette

Ogni riga può essere riordinata tramite trascinamento (l’ordine definisce sia l’ordine di visualizzazione nel front sia l’ordine normalizzato degli URL), attivata o disattivata e modificata.

Opzioni di una faccetta

• Etichetta: il nome visualizzato, traducibile per lingua.
• Visualizzazione: caselle, campioni di colore / texture, o link semplici. I gruppi di colore ereditano automaticamente la visualizzazione a campioni.
• Selezione multipla: consente di selezionare più valori di una stessa faccetta contemporaneamente, combinati con OR.
• Mostra i contatori: mostra il numero di prodotti accanto a ogni valore.
• Nascondi i valori vuoti: nasconde i valori a zero prodotti invece di mostrarli in grigio.
• Ripiegata per impostazione predefinita: la faccetta si mostra chiusa e il visitatore la espande al clic.
• Valori prima di «Mostra altro»: numero di valori visibili prima del pulsante di espansione (0 = mostra tutti).

Lo slider prezzo e il suo indice

La faccetta Prezzo si mostra come un doppio cursore. Sopra, un istogramma di distribuzione dei prodotti su dodici fasce aiuta il visitatore a collocare i prezzi. Questi dati provengono da un indice prezzi dedicato, separato dalle tabelle di PrestaShop, per restare rapido anche su un catalogo di grandi dimensioni.

Manutenzione dell’indice

L’indice è aggiornato in tempo reale dagli hook quando cambia un prodotto, un prezzo specifico o una combinazione. Per una ricostruzione completa pianificata, usa l’endpoint cron mostrato nel back-office:

/module/dffacetedfilter/cron?token=IL_TUO_TOKEN

La chiamata elabora l’indice a blocchi con un limite di tempo di circa 20 secondi; se restano prodotti, la risposta fornisce l’URL di continuazione da richiamare. Una chiamata notturna giornaliera è sufficiente nella maggior parte dei casi.

La faccetta Saldi

La faccetta In saldo filtra i prodotti attualmente scontati: prodotti contrassegnati come «in offerta» o coperti da un prezzo specifico attivo (una riduzione in corso, entro il suo intervallo di date, per la valuta, il paese e il gruppo correnti). Viene creata attivata per impostazione predefinita durante la sincronizzazione.

Disponibilità e condizione

Vengono create due faccette integrate complementari, disattivate, da attivare secondo le esigenze:

• Disponibilità: un valore «Disponibile» che rispetta la tua impostazione di ordine in esaurimento scorte.
• Condizione: nuovo, usato, ricondizionato.

Limitare una faccetta a categorie

Per impostazione predefinita, una faccetta appare su tutte le pagine di listing. Nel modulo di modifica, la sezione Limita a categorie ti consente di spuntare una o più categorie: la faccetta apparirà allora solo su quelle categorie e le loro sottocategorie.

La SEO delle faccette

È uno dei punti di forza del modulo: decidi con precisione quali pagine filtrate possono essere indicizzate. Gli URL dei filtri sono leggibili e seguono questo formato:

/categoria?dff=colore:rosso,blu-scuro/prezzo:10,50/marca:nike

Le faccette sono separate da una barra, lo slug della faccetta e i suoi valori dai due punti, e i valori tra loro da una virgola. L’ordine delle faccette e l’ordinamento dei valori sono normalizzati affinché una stessa combinazione produca sempre un unico URL canonico.

Impostazioni SEO

• Indicizzabile (per faccetta): una faccetta non indicizzabile forza la pagina filtrata a noindex, follow e aggiunge rel="nofollow" sui suoi link.
• N. max di valori indicizzabili: oltre questo numero di valori selezionati, la pagina passa a noindex, follow. Il valore 1 è il più sicuro contro l’esplosione del budget di scansione.
• Canonical proprio sulle pagine indicizzabili: le pagine indicizzabili ricevono un tag canonical che punta al proprio URL di filtro normalizzato. Il canonical del tema viene rimosso lato front per evitare duplicati.
• Tutto a noindex: forza noindex, follow su tutte le pagine filtrate, quali che siano le impostazioni per faccetta.

Modalità AJAX

L’impostazione Modalità AJAX determina come la pagina si aggiorna al clic su un filtro:

• Tema (eventi nativi) — consigliata: il modulo emette l’evento nativo di PrestaShop e lascia che il core e il tema aggiornino la lista, le faccette e la cronologia del browser. È la modalità più compatibile con i temi basati su classic.
• Autogestita: per i temi non standard, il modulo recupera la pagina via AJAX da solo e sostituisce i blocchi interessati. Usala solo se la modalità Tema non aggiorna correttamente la pagina.

Cache dei contatori

Il calcolo dei contatori disgiuntivi può essere costoso su un catalogo di grandi dimensioni. Il modulo memorizza il loro risultato in cache per un breve tempo configurabile (300 secondi per impostazione predefinita). Questa cache viene invalidata automaticamente a ogni modifica del catalogo e a ogni modifica di una faccetta. Nel back-office è disponibile un pulsante Svuota la cache dei contatori.

Statistiche d’uso

La dashboard, in cima alla pagina di amministrazione, riassume gli ultimi 30 giorni: prodotti indicizzati, numero di visualizzazioni di pagine filtrate, quota di budget di scansione tenuta fuori dall’indice (pagine filtrate servite come noindex) e una classifica delle faccette più usate. Puoi disattivare la registrazione delle statistiche nelle impostazioni di prestazioni.

Pagine supportate

Le faccette si applicano alle pagine di categoria, marca, fornitore, novità, più venduti, offerte e risultati di ricerca (rispettando il ranking nativo di PrestaShop). La faccetta Marca viene nascosta automaticamente su una pagina di marca, e le faccette limitate per categoria su una pagina di ricerca.

Disattivare la ricerca a faccette nativa

Il modulo ha la priorità su ps_facetedsearch, ma consigliamo di disattivare quest’ultimo per evitare un doppio lavoro di indicizzazione. Un avviso nel back-office te lo ricorda se resta attivo.

Risoluzione dei problemi

• Le faccette non appaiono: avvia una sincronizzazione, verifica che almeno una faccetta sia attiva e che tu sia su una pagina di listing supportata.
• Manca lo slider prezzo: ricostruisci l’indice prezzi; la faccetta Prezzo si nasconde finché l’indice è vuoto per la categoria visualizzata.
• La pagina non si aggiorna via AJAX: imposta la modalità AJAX su «Autogestita» se il tuo tema non segue lo standard di PrestaShop.
• Troppe pagine indicizzate: abbassa il n. max di valori indicizzabili, rendi non indicizzabili le faccette ad alta cardinalità (colore, taglia), oppure attiva «Tutto a noindex» mentre riprendi il controllo.

Il codice sorgente è fornito non cifrato. Hai 12 mesi di aggiornamenti di compatibilità e supporto entro 24 ore.