Live Search Intelligente — Guida completa
Installare, configurare e gestire DFLiveSearch: ricerca live, suggerimenti, prodotti consigliati, statistiche, avvisi email e personalizzazione per PrestaShop 8 e 9.
Presentazione e prerequisiti
DFLiveSearch sostituisce la ricerca nativa di PrestaShop con un motore live in AJAX: un pannello dei risultati si apre dai primi caratteri, con l’immagine, il nome, il prezzo e i badge promozionali di ogni prodotto. Il modulo aggiunge inoltre carousel di suggerimenti (ricerche popolari e prodotti consigliati), una dashboard analitica completa e avvisi email sulle ricerche senza risultato.
- Compatibile con PrestaShop da 8.0 a 9.x, tema Classic e temi derivati.
- PHP 8.1 e superiore.
- Multinegozio e multilingua (FR/EN/ES/DE/IT).
- Nessuna sovrascrittura di file: solo hook nativi.
Il modulo si basa sugli hook displayHeader, displayTop, displaySearch, displayBackOfficeHeader e actionOrderStatusPostUpdate. Crea quattro tabelle: dflivesearch_stats, dflivesearch_log, dflivesearch_alerts e dflivesearch_popular.
Installazione
Installa il modulo come qualsiasi altro modulo PrestaShop:
- Scarica l’archivio
dflivesearch.zipdal tuo account cliente. - Nel back-office, vai su Moduli > Gestore dei moduli.
- Clicca su Carica un modulo e trascina l’archivio.
- Una volta installato, clicca su Configura.
All’installazione, il modulo registra i suoi hook, crea le sue tabelle e precompila un testo segnaposto (placeholder) tradotto nelle cinque lingue. Il campo di ricerca live è immediatamente attivo sul tuo negozio.
Aggiornamento
L’aggiornamento si effettua normalmente dal Gestore dei moduli. Lo script di upgrade integrato applica automaticamente i valori predefiniti delle nuove opzioni (colori, larghezza della finestra, modalità dei prodotti consigliati) senza toccare la tua configurazione esistente. Non è necessaria alcuna azione manuale. Dopo l’aggiornamento, svuota la cache di PrestaShop e rigenera gli asset per eliminare il vecchio JavaScript.
Configurazione generale
La pagina di configurazione raccoglie le impostazioni del comportamento della ricerca:
- Attivare il modulo: attiva o disattiva il campo di ricerca live sul negozio.
- Testo segnaposto (placeholder): testo mostrato nel campo, traducibile per lingua.
- Numero minimo di caratteri: soglia di attivazione della ricerca (2 di default).
- Numero massimo di prodotti: limite di risultati mostrati nel pannello.
- Ricerche popolari e ricerche recenti: visualizzazione dei carousel di suggerimenti prima della digitazione.
- Autocompletamento: suggerimenti di termini (prodotti, categorie, ricerche popolari) durante la digitazione, con un massimo configurabile.
- Aggiunta rapida al carrello e selettore di quantità: opzioni per aggiungere un prodotto direttamente dai risultati.
- Prodotti personalizzati: tiene conto dello storico del cliente connesso per i consigli automatici.
Aspetto
La sezione Aspetto permette di adattare la finestra di ricerca alla tua identità grafica:
- Colore principale: colore dei pulsanti e degli accenti (di default
#2196F3). - Colore principale (hover): colore al passaggio del mouse sui pulsanti (di default
#1976D2). - Larghezza max della finestra: larghezza massima del pannello di ricerca. Accetta un valore CSS come
900px,1200pxo100%.
Questi valori vengono iniettati come CSS sul front. Per una finestra a larghezza piena sia su mobile che su desktop, inserisci 100% nel campo della larghezza.
Prodotti consigliati
I prodotti consigliati appaiono in carousel non appena si apre il campo di ricerca. Sono disponibili due modalità tramite l’impostazione Origine dei prodotti consigliati:
- Automatica: il modulo seleziona i più venduti (e tiene conto dello storico cliente se l’opzione «Prodotti personalizzati» è attivata).
- Manuale: scegli esattamente quali prodotti mettere in evidenza.
In modalità manuale appare un selettore dedicato: cerca un prodotto per nome o riferimento, clicca per aggiungerlo, poi riordina le miniature trascinandole. L’ordine definito viene rispettato sul negozio.
Nel selettore vengono proposti solo prodotti attivi e visibili. L’ordine delle miniature determina l’ordine di comparsa nel carousel.
Comportamento della ricerca
Ricerca per parole
La ricerca funziona per parole: ogni parola inserita deve essere trovata (nel nome, nel riferimento, nel codice EAN o nella descrizione breve), in qualsiasi ordine. Una query come «stetoscopio padiglione semplice» trova quindi il prodotto anche se quelle parole non sono consecutive nel nome. I risultati sono classificati per pertinenza (nome esatto, poi nome che inizia con la query, poi corrispondenze parziali).
Prodotti con combinazioni
Per un prodotto con combinazioni, il pulsante di aggiunta al carrello è sostituito da un pulsante «Vedi opzioni» che rimanda alla scheda prodotto, affinché il cliente scelga la sua combinazione prima dell’aggiunta.
Disponibilità e stock
I prodotti esauriti restano visibili nei risultati con un badge «Esaurito». Questo badge non appare per i prodotti il cui ordine senza stock è autorizzato (impostazione «Accetta ordini» di PrestaShop): questi restano aggiungibili al carrello.
Se inserisci una quantità superiore allo stock disponibile di un prodotto non ordinabile senza stock, il modulo non aggiunge il prodotto e mostra un messaggio con la quantità rimanente.
Dashboard e statistiche
Il modulo registra ogni ricerca (termine inserito, numero di risultati, eventuale clic su un prodotto, conversione in ordine). La dashboard del back-office mostra:
- il totale delle ricerche e il numero di ricerche uniche;
- i tassi di successo, di clic e di conversione;
- un grafico di evoluzione delle ricerche per giorno;
- la top 20 delle ricerche con clic e conversioni;
- la top 20 delle ricerche senza risultato;
- un’esportazione CSV di tutti i dati.
Il tracciamento delle conversioni avviene tramite l’hook actionOrderStatusPostUpdate: un ordine effettuato dopo un clic nei risultati di ricerca viene conteggiato come convertito.
Avvisi email
Il sistema di avvisi sorveglia i termini che non restituiscono alcun risultato. Non appena un termine supera la soglia configurabile (5 di default), un avviso email viene inviato all’indirizzo scelto e una notifica appare nell’header del back-office. Ogni avviso può essere marcato come letto o eliminato. Queste ricerche senza risultato sono una fonte preziosa per rilevare le lacune del catalogo o gli errori di battitura frequenti.
Conservazione dei dati
I log di ricerca vengono conservati 90 giorni di default (durata configurabile). Nel back-office è disponibile un pulsante di pulizia manuale per eliminare immediatamente le voci vecchie.
FAQ e risoluzione dei problemi
La ricerca non restituisce nulla con più parole
Dalla versione 1.1.9, la ricerca funziona per parole indipendenti dall’ordine. Se hai appena aggiornato, svuota la cache di PrestaShop e rigenera gli asset per caricare il nuovo JavaScript.
Il pannello di autocompletamento copre i risultati
L’autocompletamento si chiude automaticamente quando il campo perde il focus. Assicurati di usare l’ultima versione e svuota la cache se il vecchio comportamento persiste.
L’aggiunta al carrello non funziona con un carrello vuoto
Questo caso è risolto: il modulo ora persiste il carrello appena creato. Aggiorna all’ultima versione e poi svuota la cache.
Appare un badge «esaurito» su un prodotto ordinabile
Il modulo legge l’impostazione «Accetta ordini» nella scheda Quantità della scheda prodotto (memorizzata lato StockAvailable su PrestaShop 8). Verifica questa impostazione: se l’ordine è autorizzato, non verrà mostrato alcun badge.
Cosa succede alla disinstallazione?
La disinstallazione rimuove in modo pulito gli hook, le variabili di configurazione e le tabelle del modulo. Nessun dato residuo viene lasciato nel database.