Biwem Search Autocomplete

1. Introduzione

Biwem Search Autocomplete è un motore di ricerca potente e intelligente che aggiunge suggerimenti di autocompletamento in tempo reale al tuo negozio WooCommerce o al tuo sito WordPress. I visitatori trovano quello che cercano in pochi secondi — anche se sbagliano a scrivere, abbreviano o conoscono solo il codice prodotto.

Il plugin è costruito attorno a quattro principi fondamentali:

• Velocità. I suggerimenti appaiono mentre il visitatore digita, grazie a un sistema di caching multilivello che mantiene tempi di risposta bassi anche su hosting condiviso.
• Tolleranza agli errori. Il fuzzy matching integrato gestisce automaticamente refusi e lettere mancanti. Cercando "trapno" si trova comunque "trapano".
• Ricerca intelligente. Oltre ai titoli, il plugin riconosce anche SKU prodotto e codici EAN/GTIN, così il personale di magazzino e gli utenti B2B trovano i prodotti per codice in un istante.
• Compatibilità. Funziona con qualsiasi tema, qualsiasi configurazione WooCommerce, qualsiasi plugin di cache. Nessuna ipotesi sul tuo stack.

Cosa è incluso nella versione gratuita

• Autocompletamento in tempo reale con numero di suggerimenti configurabile a piacere (nessun limite massimo)
• Fuzzy matching integrato (tolleranza ai refusi)
• Corrispondenza esatta SKU ed EAN/GTIN
• Ricerca multi-contenuto (prodotti, articoli del blog, pagine — ognuno attivabile in modo indipendente)
• Anteprime prodotto (dimensione fissa di 32 pixel nella versione gratuita)
• Visualizzazione del prezzo
• Termini più ricercati — le ricerche più popolari del tuo sito mostrate come pulsanti cliccabili in cima al menu a tendina, personalizzabili nei colori, nella forma e nella dimensione (novità 1.0.6)
• Indicatore di caricamento
• Shortcode della barra di ricerca personalizzata con 3 stili
• Selettore del colore principale
• Modalità focus mobile (apertura a schermo intero al tap)
• Sistema di caching multilivello
• 6 lingue amministrative integrate
• Pronto per le traduzioni (WPML / Polylang / Loco Translate)
• Privacy-first: zero chiamate esterne
• Link rapidi "Impostazioni" e "Documentazione" direttamente nella pagina Plugin di WordPress

Cosa è disponibile nella versione Pro

La versione Pro aggiunge funzioni avanzate per negozi che vogliono il massimo controllo e la massima conversione. Consulta la panoramica funzioni Pro più sotto per l'elenco completo. La versione Pro è un plugin separato distribuito da biwem.it: dopo l'acquisto della licenza riceverai il file ZIP da installare, e da quel momento gli aggiornamenti arrivano automaticamente dal nostro server.

2. Requisiti

Compatibilità browser

L'interfaccia di ricerca frontend funziona su tutti i browser moderni:

• Chrome / Edge (ultime 2 versioni principali)
• Firefox (ultime 2 versioni principali)
• Safari 14 o superiore
• iOS Safari 14+ / Chrome Android (ultime 2 versioni principali) — layout chat AI ottimizzato per iOS (nessun auto-zoom indesiderato al tap sul campo)

3. Installazione

Metodo 1 — Dalla directory plugin di WordPress.org (consigliato)

1. Nel pannello WordPress, vai su Plugin → Aggiungi nuovo.
2. Nella casella di ricerca digita "Biwem Search Autocomplete".
3. Clicca Installa ora sulla scheda del nostro plugin.
4. Una volta installato, clicca Attiva.
5. Fatto! Una nuova voce di menu "Autocomplete" appare nella barra laterale dell'admin.

Metodo 2 — Caricamento manuale (file ZIP)

1. Scarica l'ultimo ZIP del plugin da WordPress.org.
2. Nel pannello WordPress, vai su Plugin → Aggiungi nuovo → Carica plugin.
3. Clicca Scegli file, seleziona lo ZIP e poi Installa ora.
4. Clicca Attiva plugin.

Metodo 3 — Installazione via FTP

1. Estrai il file ZIP del plugin sul tuo computer. Otterrai una cartella chiamata biwem-search-autocomplete-for-woocommerce.
2. Connettiti al tuo server via FTP/SFTP e carica la cartella in /wp-content/plugins/.
3. Nel pannello WordPress, vai su Plugin → Plugin installati.
4. Trova Biwem Search Autocomplete nell'elenco e clicca Attiva.

4. Avvio rapido

Appena attivato, il plugin funziona con configurazione zero. Nel momento in cui lo attivi, i suggerimenti di autocompletamento sono abilitati su ogni campo di ricerca standard nel tuo tema.

Per ottenere il massimo dal plugin, segui questi passi iniziali:

1. Apri le impostazioni. Vai su Autocomplete → Impostazioni generali.
2. Scegli cosa cercare. Nella scheda "Tipi di ricerca", decidi se cercare prodotti, articoli, pagine o qualsiasi combinazione.
3. Configura le opzioni di visualizzazione. Attiva o disattiva anteprime prodotto, prezzi e indicatore di caricamento, e scegli quanti risultati mostrare (il numero che preferisci).
4. (Facoltativo) Passa alla barra personalizzata. Attiva lo shortcode nella scheda "Stile barra di ricerca" per pieno controllo visuale. Posiziona [wcsa_search_autocomplete] dove vuoi.
5. Salva le modifiche. Clicca il pulsante verde Salva modifiche in fondo alla pagina.

5. Impostazioni generali

La pagina Impostazioni generali è il centro di controllo principale del plugin. La trovi su Autocomplete → Impostazioni generali nella barra laterale dell'admin.

Attivazione e disattivazione

Ogni sezione della pagina impostazioni ha un toggle principale che attiva o disattiva quel gruppo di funzioni per intero. Quando un toggle è OFF, tutte le sotto-opzioni dentro la scheda vengono nascoste, mantenendo l'interfaccia pulita.

Come persistono le impostazioni

Tutte le impostazioni vengono salvate in una singola opzione WordPress chiamata wcsa_options. Vengono caricate ad ogni richiesta tramite caching efficiente.

6. Tipi di ricerca

Il plugin può cercare in tre tipi di contenuto in modo indipendente:

Prodotti (WooCommerce)

Disponibile quando WooCommerce è attivo. Restituisce i prodotti corrispondenti con anteprima, prezzo e link. Cerca contemporaneamente in titolo, descrizione, SKU e codici EAN/GTIN.

Articoli del blog

Cerca negli articoli WordPress. Il dropdown mostra il titolo dell'articolo e un link.

Pagine

Cerca nelle pagine WordPress. Utile quando hai molte pagine informative (FAQ, chi siamo, termini) e vuoi renderle trovabili dalla barra di ricerca.

Fuzzy matching

Il plugin usa un fuzzy matching basato sulla distanza di Levenshtein per gestire i refusi automaticamente. Esempi:

• "trapno" trova "trapano" (lettera mancante)
• "avitatore" trova "avvitatore" (doppia consonante mancante)
• "drll" trova "drill" (vocale saltata)

Per i dettagli sul comportamento del fuzzy matching nelle varie lingue, vedi la sezione Ricerca fuzzy multilingua.

Corrispondenza SKU ed EAN/GTIN

Quando un visitatore digita un testo che corrisponde esattamente allo SKU di un prodotto o al suo _global_unique_id (EAN/GTIN), il plugin restituisce quel prodotto immediatamente — anche prima della ricerca testuale regolare. Anche il badge "esaurito" (se attivato) appare correttamente sui prodotti trovati per SKU o EAN.

7. Ricerca fuzzy multilingua

Il motore di tolleranza ai refusi è progettato per funzionare su più lingue senza configurazione. Combina quattro strategie complementari, applicate in sequenza fino a trovare risultati:

• Deduplicazione parziale: gestisce le doppie consonanti scritte male, tipiche dell'italiano ("machina" → "macchina", "avitatore" → "avvitatore").
• Inserimento vocali: recupera le vocali saltate digitando velocemente ("trpano" → "trapano", "cffie" → "cuffie").
• Varianti fuzzy: lettere rimosse o scambiate ("tarpano" → "trapano").
• Varianti vocaliche: vocali sbagliate, frequenti tra tastiere di lingue diverse ("telefano" → "telefono").

La copertura è stata testata su un set di refusi reali in cinque lingue con risultati eccellenti in italiano, francese e inglese, e molto buoni in spagnolo e tedesco.

8. Opzioni di visualizzazione

Questa scheda controlla cosa appare nel menu a tendina dei suggerimenti e come appare.

9. I termini più ricercati Free + Pro

Da 1.0.6 il plugin può mostrare le ricerche più popolari del tuo sito come pulsanti cliccabili in cima al menu a tendina, sotto il titolo "I Termini più ricercati". Un visitatore che apre la barra di ricerca vede subito cosa cercano gli altri e può avviare una di quelle ricerche con un solo clic. Da 1.0.8 la funzione si concentra sui cinque termini di punta del sito.

Come funziona la registrazione

• Un termine viene registrato solo quando la ricerca viene davvero inviata (Invio, clic sulla lente, o clic su un suggerimento) — mai lettera per lettera. Contano le ricerche reali, non i tentativi di digitazione.
• I termini vengono salvati nel database del tuo sito, senza chiamate esterne e senza dati personali. Il plugin conserva i più cercati con pulizia automatica dei meno rilevanti.
• La classifica si aggiorna da sola: un termine che guadagna ricerche prende il posto di uno più debole.
• Alla disinstallazione del plugin, i termini vengono rimossi insieme a tutte le altre opzioni.

Il pannello dei termini registrati (Dashboard)

Da 1.0.7 i termini registrati si gestiscono da un pannello dedicato nella Dashboard del plugin: nella versione Pro è una card affiancata a "Visibilità AI", nella versione gratuita si trova nella scheda "Ultime ricerche". Il pannello mostra tutti i termini con il numero di ricerche, dal più cercato, ed evidenzia quelli attualmente visibili ai visitatori. Da qui puoi:

• Cancellare un singolo termine (per esempio un residuo lasciato dai bot o una parola che non vuoi pubblicare);
• Azzerare l'intero elenco, con richiesta di conferma;
• Aprire le impostazioni della funzione con un clic.

I filtri di visualizzazione

Quattro filtri decidono cosa può comparire come pulsante (da 1.0.7):

Personalizzazione dei pulsanti

• Quattro selettori colore: colore primario, colore hover, colore del bordo, colore del bordo in hover — con anteprima dal vivo (passa il mouse sull'anteprima per vedere lo stato hover).
• Tre stili di pulsante: Tondo, Appena rotondo, Quadrato — ognuno con la sua anteprima.
• Grandezza del testo regolabile: il pulsante si adatta da solo al testo.
• Numero massimo di termini mostrati, da 1 a 5.

10. Barra di ricerca personalizzata

Oltre ad agganciarsi alle barre di ricerca native del tuo tema, il plugin offre una barra di ricerca personalizzata tramite shortcode, con tre stili grafici pronti (Minimal, Rounded, Bold) e — nella versione Pro — pieno controllo sui colori.

Attributi facoltativi:

• style — uno tra minimal, rounded, bold
• placeholder — il testo guida mostrato quando il campo è vuoto

A prova di tema (da 1.0.4)

La barra personalizzata viene generata in modo isolato dagli stili del tema e degli altri plugin: mantiene sempre l'aspetto che hai configurato, su qualsiasi tema, presente o futuro. Dove l'isolamento non è disponibile (browser molto datati), ripiega automaticamente sul formato standard.

Segnaposto predefinito modificabile

Nelle impostazioni puoi definire il testo guida predefinito del campo di ricerca, mostrato anche quando il segnaposto animato è disattivato.

11. Preset di colori Pro

La versione Pro include la pagina Personalizza grafica con selettori colore per ogni elemento della barra e del menu a tendina: sfondo, bordo, divisore, icona della lente, colori della chat AI, badge "esaurito" e altro. Sei preset di colori integrati permettono di partire da combinazioni già armoniose, e puoi salvare preset personali illimitati con un nome a tua scelta.

• Anteprima dal vivo di ogni modifica, senza salvare
• Ripristino con un clic dei colori predefiniti
• I preset personali sopravvivono agli aggiornamenti del plugin

12. Modalità focus mobile

Al tap sulla barra di ricerca da smartphone, il campo si apre a schermo intero con la tastiera già attiva: il visitatore digita comodamente senza distrazioni, vede i suggerimenti a tutta larghezza e chiude con la X o con un tap fuori. La modalità focus mobile è inclusa anche nella versione gratuita.

Da 1.0.4 la modalità focus conserva l'aspetto esatto della barra del tuo tema (colori, bordi, ombra), sia su desktop sia su mobile, e — con lo stile della barra personalizzata disattivato — l'apertura su mobile usa per default una morbida dissolvenza. La versione Pro aggiunge cinque effetti di transizione a scelta per l'apertura a schermo intero.

La modalità focus desktop (con un pannello fluttuante sopra la pagina) è invece esclusiva Pro. Da 1.0.9 il pannello fluttuante si ri-ancora continuamente alla posizione originale della barra: se il layout della pagina si sposta dopo l'apertura — un banner pubblicitario che si carica o si chiude, un avviso che compare — la barra lo segue in una frazione di secondo, restando sempre al suo posto.

13. Riferimento shortcode

14. Gestione sinonimi Pro

La pagina Sinonimi permette di insegnare al motore di ricerca il vocabolario dei tuoi clienti. Ogni riga definisce un termine canonico (la parola chiave principale) e i suoi sinonimi, separati da virgola.

Aggiungere una coppia di sinonimi

1. Vai su Autocomplete → Sinonimi.
2. Clicca + Aggiungi riga.
3. Scrivi il termine canonico a sinistra e i sinonimi (separati da virgola) a destra.
4. Clicca Salva sinonimi.

Come funzionano le corrispondenze (da 1.0.9)

I sinonimi funzionano in entrambe le direzioni e vengono riconosciuti come frasi intere sulla ricerca digitata:

• Bidirezionale: cercando il termine canonico si trovano anche i prodotti intitolati col sinonimo, e cercando il sinonimo si trovano i prodotti intitolati col termine canonico. Non serve inserire la coppia due volte.
• A frase intera: il riconoscimento avviene sull'intera ricerca digitata, quindi funzionano anche i gruppi con termini di più parole o di parole corte — per esempio "5 in 1" abbinato a "ripetitore".
• Ovunque: vale sia per i suggerimenti del menu a tendina sia per la pagina dei risultati di ricerca, senza dover ricostruire l'indice.

Nella pagina dei risultati, i prodotti che contengono nel titolo la frase esatta digitata vengono mostrati per primi, seguiti da quelli che contengono un termine del gruppo di sinonimi riconosciuto.

15. Privacy e GDPR

Il plugin è progettato secondo il principio privacy-first:

• Zero chiamate esterne nella versione gratuita. Nessun dato lascia il tuo sito. Le ricerche dei visitatori restano nel tuo database.
• Nessun cookie di tracciamento. Il plugin non imposta cookie di profilazione.
• I termini più ricercati vengono salvati localmente, senza indirizzi IP né altri dati personali associati alla singola ricerca visualizzata.
• Nella versione Pro, le funzioni che comunicano con l'esterno (suggerimenti esterni, verifica licenza, GeoIP della cronologia ricerche) sono documentate nella pagina prodotto e attivabili in modo consapevole.
• Alla disinstallazione, tutte le opzioni e i dati del plugin vengono rimossi dal database.

16. Panoramica funzioni Pro

La versione Pro si acquista su biwem.it/autocomplete.

17. Attivazione licenza Pro

1. Dopo l'acquisto ricevi via email la chiave di licenza e il file ZIP del plugin Pro.
2. Installa e attiva il plugin Pro (la versione gratuita, se presente, si disattiva da sola conservando tutte le impostazioni).
3. Vai su Autocomplete → Impostazioni generali e apri la scheda Licenza.
4. Incolla la chiave e clicca Attiva licenza.
5. La Dashboard mostra lo stato "Attiva Pro" con la data di scadenza. Da questo momento gli aggiornamenti Pro arrivano automaticamente.

18. Risoluzione problemi

I suggerimenti non compaiono

• Svuota la cache del sito (LiteSpeed, WP Rocket, ecc.) e del browser: dopo un aggiornamento, i file JavaScript vecchi possono restare in cache.
• Verifica che il campo di ricerca del tema sia un campo standard WordPress (name="s"). Con la barra personalizzata via shortcode il problema non si pone.
• Controlla nella console del browser (F12) eventuali conflitti JavaScript con altri plugin.

Non vedo nessun pulsante dei termini più cercati

• L'opzione "Mostra i termini più cercati" deve essere attiva nelle Opzioni di visualizzazione.
• Serve almeno una ricerca realmente inviata (i termini non si registrano lettera per lettera).
• Controlla i filtri (da 1.0.7): il minimo di ricerche richiesto, il filtro sui termini solo numerici, l'elenco dei termini esclusi e l'opzione "registra solo ricerche con risultati" possono nascondere legittimamente dei termini. Il pannello nella Dashboard mostra per ogni termine se è visibile o filtrato.
• Se usi una cache pagina aggressiva, i pulsanti possono comparire con qualche minuto di ritardo dopo le prime ricerche: la pagina in cache va rigenerata.

La ricerca è lenta

• Nella versione Pro, attiva l'indice interno (Impostazioni generali → Backend di ricerca) e ricostruiscilo dalla Dashboard.
• Verifica che il limite di memoria PHP sia almeno 64 MB (consigliati 128 MB).
• Su cataloghi molto grandi, riduci il numero di risultati mostrati.

Ho aggiornato ma non vedo le novità

• Svuota tutte le cache (pagina, oggetti, browser). Il plugin usa il cache-busting automatico sugli asset, ma le pagine HTML già in cache vanno rigenerate.
• Entra almeno una volta nella bacheca admin dopo l'aggiornamento: alcune migrazioni e riallineamenti si eseguono al primo accesso.

Conflitto con un altro plugin di ricerca

Disattiva gli altri plugin di ricerca/autocomplete: due motori che intercettano lo stesso campo si disturbano a vicenda. Biwem Search Autocomplete sostituisce completamente la ricerca nativa.

19. Domande frequenti

Il plugin funziona senza WooCommerce?

Sì. Senza WooCommerce cerca articoli e pagine; con WooCommerce si aggiunge la ricerca prodotti con anteprime, prezzi e codici.

Posso usare Free e Pro insieme?

No, e non serve: attivando la Pro, la Free si disattiva da sola conservando tutte le impostazioni (sono condivise). Se riattivi la Free con la Pro attiva, un avviso ti informa senza errori.

I miei clienti vedranno pubblicità o dati inviati a terzi?

No. La versione gratuita non effettua alcuna chiamata esterna. Nella Pro, le sole funzioni che parlano con l'esterno sono quelle che lo richiedono per natura (suggerimenti esterni, verifica licenza) e sono documentate.

Il plugin è compatibile con WPML / Polylang?

Sì, il plugin è translation-ready e convive con i principali plugin multilingua. I suggerimenti rispettano la lingua corrente del sito.

Posso tradurre i testi del frontend?

Sì, tramite Loco Translate o gli strumenti di traduzione standard di WordPress. Il plugin include già 6 lingue amministrative.

Cosa succede ai miei dati se disinstallo il plugin?

Tutte le opzioni, i termini registrati e le tabelle del plugin vengono rimossi dal database.

20. Supporto e contatti

21. Changelog

Versione attuale: 1.0.9 (Agosto 2026). L'elenco completo delle modifiche, versione per versione e con il dettaglio Free / Pro, è pubblicato nella pagina dedicata:

biwem.it/autocomplete/changelog →