PS PrestaShop PrestaShop Principiante

Live Search Intelligente — Guida completa

Installare, configurare e gestire DFLiveSearch: ricerca live, suggerimenti, sinonimi, tolleranza agli errori di battitura, pertinenza, statistiche e avvisi email per PrestaShop 8 e 9.

Aggiornato Versione del modulo 1.4.0

Presentazione e prerequisiti

DFLiveSearch sostituisce la ricerca nativa di PrestaShop con un motore live in AJAX: un pannello di risultati si apre fin dai primi caratteri, con l’immagine, il nome, il prezzo e i badge promozionali di ogni prodotto. Il modulo aggiunge inoltre un motore di ricerca intelligente (sinonimi, tolleranza agli errori di battitura, pertinenza ponderata), caroselli di suggerimenti (ricerche popolari e prodotti consigliati), una dashboard analitica completa e avvisi email sulle ricerche senza risultato.

  • Compatibile con PrestaShop 8.0 fino 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 sei tabelle: dflivesearch_stats, dflivesearch_log, dflivesearch_alerts, dflivesearch_popular, dflivesearch_synonyms e dflivesearch_lexicon.

Installazione

Installa il modulo come qualsiasi altro modulo PrestaShop:

  1. Scarica l’archivio dflivesearch.zip dal tuo account cliente.
  2. Nel back-office, vai su Moduli > Gestore dei moduli.
  3. Clicca su Carica un modulo e rilascia l’archivio.
  4. Una volta installato, clicca su Configura.

All’installazione, il modulo registra i suoi hook, crea le sue tabelle e pre-compila un testo segnaposto (placeholder) tradotto nelle cinque lingue. Vengono inoltre pre-compilati alcuni gruppi di sinonimi comuni e il dizionario di correzione degli errori viene costruito a partire dal tuo catalogo. Il campo di ricerca live è immediatamente attivo sul tuo negozio.

Aggiornamento

L’aggiornamento avviene normalmente dal Gestore dei moduli. Lo script di upgrade integrato crea le nuove tabelle, applica i valori predefiniti delle nuove opzioni (sinonimi, pertinenza, tolleranza agli errori, aspetto della barra) senza toccare la tua configurazione esistente, poi ricostruisce il dizionario di correzione. Non è richiesta alcuna azione manuale. Dopo l’aggiornamento, svuota la cache di PrestaShop e rigenera gli asset per eliminare il vecchio JavaScript.

Dopo un import catalogo importante, ricostruisci il dizionario di correzione (vedi la sezione «Ricerca intelligente») affinché la correzione degli errori rifletta il tuo catalogo aggiornato.

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 per impostazione predefinita).
  • Numero massimo di prodotti: limite di risultati mostrati nel pannello.
  • Ricerche popolari e ricerche recenti: visualizzazione dei caroselli di suggerimenti prima della digitazione.
  • Autocompletamento: suggerimenti di termini (prodotti, categorie, ricerche popolari) durante la digitazione, con navigazione da tastiera (frecce su/giù, Invio, Esc) ed evidenziazione del termine inserito. Il numero massimo di suggerimenti è 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 le raccomandazioni automatiche.

Aspetto

La sezione Aspetto permette di adattare la ricerca alla tua identità grafica:

  • Colore principale: colore dei pulsanti e degli accenti (predefinito #2196F3).
  • Colore principale (hover): colore al passaggio del mouse sui pulsanti (predefinito #1976D2).
  • Larghezza max della finestra: larghezza massima del pannello di ricerca. Accetta un valore CSS come 900px, 1200px o 100%.
  • Dimensione della barra di ricerca (dalla versione 1.4.0): Small, Medium o Large. Regola l’altezza, la dimensione del testo e quella dell’icona della barra mostrata nell’intestazione.
  • Larghezza della barra di ricerca: larghezza massima della barra stessa (400px, 50%, 30rem…). Lascia il campo vuoto per occupare tutta la larghezza del contenitore del tema.
  • Raggio degli angoli della barra: da 0 (angoli retti) a 50 px (forma a pillola).
  • Scorciatoia da tastiera: apre la ricerca con Ctrl+K (Cmd+K su Mac) o il tasto / da qualsiasi punto della pagina. Su desktop viene mostrato un badge indicativo («Ctrl K» o «⌘K») nella barra. L’opzione è disattivabile.

Questi valori vengono iniettati come CSS sul front. Per una barra in stile «pillola» alla Algolia, scegli un raggio di 50 e una dimensione Large. Per una finestra dei risultati a tutta larghezza sia su mobile che su desktop, inserisci 100% nella larghezza della finestra.

Dalla versione 1.4.0, la finestra di ricerca è completamente accessibile da tastiera: la barra è focalizzabile e si apre con Invio o Spazio, il focus resta all’interno della finestra durante la navigazione con Tab, Esc la chiude e il focus torna sulla barra. Un pulsante di cancellazione appare nel campo non appena viene digitato del testo, e le animazioni rispettano la preferenza di sistema prefers-reduced-motion.

Prodotti consigliati

I prodotti consigliati appaiono in carosello 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 con precisione i prodotti 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 nella visualizzazione lato negozio.

Nel selettore vengono proposti solo i prodotti attivi e visibili. L’ordine delle miniature determina l’ordine di apparizione nel carosello.

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 semplice padiglione» trova quindi il prodotto anche se queste parole non sono consecutive nel nome. Dalla versione 1.2.0, ogni parola viene anche estesa ai suoi sinonimi e la ricerca copre i riferimenti delle varianti (vedi la sezione «Ricerca intelligente»).

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. Quando il cliente ha cercato il riferimento esatto di una combinazione, questo pulsante conduce direttamente alla variante interessata.

Disponibilità e stock

I prodotti esauriti restano visibili nei risultati e riportano un badge «Esaurito». Questo badge non appare per i prodotti il cui ordine fuori 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 fuori stock, il modulo non aggiunge il prodotto e mostra un messaggio che indica la quantità rimanente.

Ricerca intelligente: sinonimi, errori di battitura e pertinenza

Dalla versione 1.2.0, DFLiveSearch integra un motore di ricerca intelligente. Tutte queste impostazioni si trovano nella sezione Ricerca intelligente della pagina di configurazione.

Sinonimi

Il dizionario di sinonimi collega termini equivalenti: un cliente che cerca «tv» trova anche i prodotti chiamati «televisione» o «tele». L’editor è multilingua (una scheda per lingua). Inserisci un gruppo per riga, con i termini separati da virgole:

tv, tele, televisione, televisore
computer, pc, portatile
cuffie, auricolari, headphones

Tutti i termini di una stessa riga sono considerati equivalenti: cercarne uno estende automaticamente la query agli altri. Attiva o disattiva la funzionalità tramite l’opzione Attivare i sinonimi. Alcuni gruppi comuni sono pre-compilati all’installazione; adattali al tuo catalogo.

I sinonimi sono memorizzati per negozio e per lingua. Ricordati di compilare ogni scheda lingua per coprire l’intera clientela.

Tolleranza agli errori di battitura

Quando una ricerca non restituisce risultati, il modulo tenta automaticamente di correggere l’errore a partire da un dizionario costruito dal tuo catalogo (nomi di prodotti, riferimenti, categorie). Se la correzione dà risultati, vengono mostrati direttamente con la dicitura «Risultati per…» e un link per tornare all’ortografia originale.

  • Tolleranza agli errori di battitura: attiva o disattiva la correzione automatica.
  • Distanza di correzione max: numero massimo di caratteri differenti tollerato (da 1 a 3; 2 consigliato). Un valore più alto corregge più errori ma aumenta il rischio di falsi positivi.
  • Mostrare «Forse cercavi?»: mostra il banner di correzione. Disattivata, la correzione si applica silenziosamente.

La correzione si basa su una preselezione fonetica (SOUNDEX) seguita da un calcolo della distanza di Levenshtein: ritrova ad esempio «televisione» a partire da «televisone». Le parole di meno di tre caratteri non vengono corrette; le equivalenze brevi (come «tv») sono gestite dai sinonimi.

Dizionario di correzione

Il dizionario di correzione (tabella dflivesearch_lexicon) viene costruito all’installazione e può essere ricostruito in qualsiasi momento tramite il pulsante Ricostruire il dizionario della pagina di configurazione. L’area informativa mostra il numero di parole indicizzate e la data dell’ultima ricostruzione.

Ricostruisci il dizionario dopo un import catalogo importante o un cambiamento massivo dei nomi dei prodotti, affinché la correzione degli errori rifletta il tuo catalogo aggiornato. Puoi anche automatizzare questa ricostruzione tramite un’attività pianificata.

Pertinenza dei risultati

I risultati sono ordinati secondo un punteggio di pertinenza ponderato: corrispondenza esatta del nome (punteggio più alto), nome che inizia con la query, query contenuta nel nome, poi riferimento ed EAN. Due boost completano questa classifica:

  • Boost prodotti disponibili: a pertinenza comparabile, i prodotti disponibili salgono in cima alla lista.
  • Boost più venduti: favorisce i prodotti più venduti, a partire dalle statistiche di vendita di PrestaShop.

Entrambe le opzioni sono attivabili in modo indipendente nella sezione Ricerca intelligente.

Ricerca per riferimento di variante

La ricerca copre ora gli identificatori propri delle combinazioni: riferimento, EAN, UPC e riferimento fornitore di ogni variante. Digitare il riferimento o il codice a barre di una combinazione fa quindi emergere il prodotto padre. Quando la query somiglia a un codice, il risultato punta direttamente alla combinazione corretta (link alla variante esatta) e la scheda mostra il riferimento e il prezzo di quella variante.

I riferimenti puramente alfabetici (senza cifre) restano trovabili ma aprono la scheda sulla combinazione predefinita. I riferimenti contenenti cifre (EAN, la maggior parte degli SKU) attivano il link diretto alla variante esatta.

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 export CSV dell’insieme dei dati.

Il tracciamento delle conversioni avviene tramite l’hook actionOrderStatusPostUpdate: un ordine effettuato dopo un clic nei risultati di ricerca viene conteggiato come convertito. Dalla versione 1.3.0, ogni ordine viene conteggiato una sola volta, indipendentemente dai successivi cambi di stato.

Avvisi email

Il sistema di avvisi sorveglia i termini che non restituiscono alcun risultato. Non appena un termine supera la soglia configurabile (5 per impostazione predefinita), un avviso email viene inviato all’indirizzo di tua scelta e una notifica appare nell’header del back-office. Ogni avviso può essere marcato come letto o eliminato. I template email sono forniti nelle cinque lingue (IT/EN/FR/ES/DE) e l’oggetto viene inviato nella lingua predefinita del negozio. Queste ricerche senza risultato sono una fonte preziosa per rilevare le lacune del catalogo, gli errori di battitura frequenti o i sinonimi mancanti da aggiungere.

Conservazione dei dati

I log di ricerca sono conservati 90 giorni per impostazione predefinita (durata configurabile). Un pulsante di pulizia manuale è disponibile nel back-office e, dalla versione 1.3.0, una pulizia automatica viene applicata in continuo secondo il periodo di conservazione configurato.

FAQ e risoluzione dei problemi

Come configurare i sinonimi?

Nella sezione «Ricerca intelligente» della configurazione, inserisci un gruppo di sinonimi per riga (termini separati da virgole) nella scheda di ogni lingua, poi salva. Verifica che l’opzione «Attivare i sinonimi» sia attiva.

Come cambiare la dimensione o la forma della barra di ricerca?

Nella sezione «Aspetto», scegli la dimensione della barra (Small / Medium / Large), la larghezza massima e il raggio degli angoli. Un raggio di 50 dà una barra a forma di pillola. Queste impostazioni riguardano solo la barra mostrata nell’intestazione; la finestra dei risultati si regola con «Larghezza max della finestra».

Come disattivare la scorciatoia Ctrl+K?

Nella sezione «Aspetto», imposta l’opzione «Scorciatoia da tastiera» su No. Il badge scompare dalla barra e i tasti Ctrl+K, Cmd+K e / non aprono più la ricerca.

Una ricerca con un errore restituisce una pagina vuota

Verifica che l’opzione «Tolleranza agli errori di battitura» sia attivata e che il dizionario di correzione contenga parole (area informativa della configurazione). Dopo un import importante, clicca su «Ricostruire il dizionario». Puoi anche aumentare la «Distanza di correzione max».

La ricerca non trova un riferimento di variante

La ricerca per riferimento di variante (rif, EAN, UPC, rif fornitore) è disponibile dalla versione 1.2.0. Aggiorna, svuota la cache e rigenera gli asset. Per ottenere il link diretto alla variante esatta, la query deve somigliare a un codice (contenere almeno una cifra).

La ricerca non restituisce nulla per più parole

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 nasconde i risultati

L’autocompletamento si chiude automaticamente quando il campo perde il focus o con il tasto Esc. Assicurati di usare l’ultima versione e svuota la cache se il vecchio comportamento persiste.

Un badge «esaurito» appare su un prodotto ordinabile

Il modulo legge l’impostazione «Accetta ordini» nella scheda Quantità della scheda prodotto (memorizzata in StockAvailable su PrestaShop 8). Verifica questa impostazione: se autorizza l’ordine, nessun badge verrà mostrato.

Cosa succede alla disinstallazione?

La disinstallazione rimuove in modo pulito gli hook, le variabili di configurazione e le sei tabelle del modulo. Nessun dato residuo viene lasciato nel database.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza