Modulo di ricerca visiva (non SaaS): il motore di ricerca intelligente self-hosted con opzione Meilisearch

21/10/2026
v1.4.48

Trova ciò che è scritto a orecchio

Una parola scritta in modo errato e non presente nell'indice viene cercata anche in base alla sua pronuncia spagnola: "kolageno" trova "collagen", "proteyna" trova "protein", "kafeina" trova "caffeine" e "bitamine" trova "vitamin". In precedenza, si cadeva nella trappola della ricerca approssimativa, che accettava parole da descrizioni che si somigliavano solo per le lettere ("oxigeno" per "kolageno") e riempiva i risultati con prodotti non correlati.

Regole: la h è muta; la w e la hu hanno lo stesso suono; anche la k, la c e la qu hanno lo stesso suono; ce, ci e z; ge, gi e j; b e v; y e i; le lettere doppie contano come una sola e la vocale finale non ha importanza. Una parola scritta correttamente viene cercata così com'è, quindi ciò che ha già funzionato non cambia. Anche i sinonimi della parola trovata sono validi ("kolageno" → "colageno" → "collagen").

Una ricerca senza risultati non viene riempita con qualsiasi cosa.

Il metodo di ricerca di ultima istanza confrontava frammenti di tre lettere con i nomi: "biscotto" avrebbe mostrato prodotti con "bis" nel nome, seguiti da altri otto nella stessa categoria. Ora utilizza solo varianti quasi complete della parola; se non viene trovata alcuna corrispondenza, non vengono visualizzati risultati e vengono mostrate le ricerche più popolari.

L'aggiornamento crea la tabella delle chiavi fonetiche e la popola con le parole già presenti nell'indice, senza reindicizzarle, e svuota la cache di ricerca.

21/10/2026
v1.4.47

Prima viene fornito un riferimento completo al modello

Quando si cerca un riferimento di modello utilizzando lettere e numeri ("et-14100", "ET 14100", "et14100"), i prodotti che lo contengono nel loro nome potrebbero classificarsi centinaia di posizioni più in basso, per due motivi:

• La parte più corta conteneva centinaia di prodotti. Proprio come il numero corto nel 1.4.46, Una parte di una o due lettere ("et") abbinata come prefisso alle etichette e a qualsiasi altro modello "ET-...". Ora, se la ricerca ha una parte più lunga, un prodotto deve corrispondere almeno a quella parte.
• Gli articoli esauriti sono stati messi in fondo alla lista., ...anche dietro a "Potrebbe interessarti anche". Ora sono alla fine del loro blocco: una corrispondenza esatta non disponibile si posiziona comunque prima delle corrispondenze correlate. Inoltre, un riferimento al modello che è presente per intero nel nome conta come corrispondenza esatta, con o senza il trattino: "et14100" corrisponde a "ET-14100", ma non a "ET-141000". L'aggiornamento cancella la cache di ricerca.

20/10/2026
v1.4.46

Un numero basso non è più sufficiente per entrare nei risultati

IL 1.4.45 Ha smesso di contare i numeri brevi isolati durante l'ordinamento, ma la query includeva ancora qualsiasi prodotto con quel numero nella descrizione o nelle caratteristiche nei risultati: "whey 80" avrebbe mostrato prodotti con "80 capsule" o "800 mg" e, poiché i nomi non corrispondevano, sarebbero apparsi in "Potrebbe interessarti anche". Ora, se la ricerca include parole e un numero di una o due cifre, un prodotto deve corrispondere ad almeno una delle parole. Con pochi risultati, il blocco viene riempito con prodotti della stessa categoria, come nel 1.4.45.

L'aggiornamento cancella la cache di ricerca.

20/10/2026
v1.4.45

Anche i sinonimi contano quando si ordina

La ricerca ha già cercato sinonimi ("proteina" → "proteina"), ma la fase di separazione tra corrispondenze esatte, corrispondenze correlate e "Potrebbe interessarti anche" confrontava solo la parola digitata con il nome del prodotto. Tutto ciò che veniva trovato come sinonimo rientrava nella categoria "Potrebbe interessarti anche" ed era ordinato in base alle vendite, quindi il prodotto più venduto appariva per primo anche se non era correlato, e una ricerca con un errore di ortografia mostrava quell'etichetta in cima. Ora, una parola corrisponde al prodotto se corrisponde a se stessa o a uno dei suoi sinonimi attivi, e "proteina" viene ordinato allo stesso modo di "proteina". Attivare e disattivare l'opzione "Promuovi corrispondenze esatte" è sufficiente.

Un singolo numero breve non è più correlato a un prodotto

Con diverse parole, bastava abbinare anche solo una o due cifre per accedere a prodotti correlati e guadagnare punti: con "omega 3" si otteneva una "Confezione da 3" di qualcos'altro o un formato "30g" prima di quelli omega. Ora il numero conta solo se corrisponde anche a una parola.

"Potrebbe interessarti anche" con pochi risultati, senza Meilisearch

Una ricerca con meno di 8 risultati viene integrata con un massimo di 8 prodotti che condividono la stessa categoria: prima la categoria più specifica (una sottocategoria precedente alla categoria principale; le categorie radice e home non vengono conteggiate) e poi i prodotti più venduti. Il sistema rispetta le categorie e i produttori esclusi e l'opzione "Nascondi i prodotti esauriti". Viene utilizzato solo l'ordinamento per rilevanza, senza filtri. In precedenza, solo Meilisearch offriva questa funzionalità, e solo in assenza di risultati.

L'aggiornamento cancella la cache di ricerca, che memorizza l'ordine finale.

15/10/2026
v1.4.42

Le immagini danneggiate provenienti da altri moduli non scompaiono più

Il motore di ricerca era in ascolto per eventuali errori di caricamento. Tutto Le immagini della pagina erano nascoste e quelle che non venivano caricate correttamente, anche se non erano proprie della pagina stessa, venivano contrassegnate con un'icona "immagine non presente". Un'immagine creata vuota da un altro modulo e poi riempita, come ad esempio il codice QR per la finestra modale di condivisione del carrello, rimaneva nascosta per sempre.

Ora vengono elaborate solo le immagini presenti nel motore di ricerca, nella pagina dei risultati o nei banner. Non cambia nulla all'interno del modulo stesso: l'immagine di un prodotto che non si carica viene comunque sostituita dall'icona.

15/10/2026
v1.4.41

Ora anche altri moduli possono salvare il carrello dopo aver salvato un prodotto.

Quando salvi un prodotto, il motore di ricerca lo indicizza e ha bisogno di un carrello della spesa nel contesto per calcolare il prezzo (senza di esso, Prodotto::getPriceStatic() fa morire() in PrestaShop 1.7.8, 8.2 e 9.0). Se il carrello di contesto non aveva ancora un ID, veniva modificato in un nuovo Cart() Vuoto, senza valuta. Nella vetrina, il carrello senza ID è quello che PrestaShop prepara per il visitatore, quindi qualsiasi modulo che ha salvato un prodotto dal negozio e poi il carrello ha generato l'errore "La proprietà Cart->id_currency è vuota". Si è verificato con un personalizzatore di abbigliamento: il primo modello di ogni prodotto non entrava nel carrello.

Ora il carrello viene creato solo se non ne esiste già uno (console, servizio web) e viene popolato come avviene nel sistema principale: lingua, valuta e negozio.

Il pulsante "aggiungi al carrello" sul pannello salva anche il carrello che il negozio aveva già preparato invece di crearne un altro, quindi mantiene il visitatore (id_guest) come il normale carrello della spesa di PrestaShop.

v1.4.382026/10/08

Durante la digitazione, i risultati appaiono sopra, non sotto, il messaggio di benvenuto.

Osservato su iogenixdise (PS 8.2) durante la ricerca di "Isolate": con la query digitata, il pannello continuava a mostrare "Ricerche popolari" e "Più venduti", e i risultati, con la corrispondenza esatta in alto, erano a circa 1.580 px dall'alto.

Prima era una gara. All'apertura del pannello, il server richiedeva un messaggio di benvenuto e, se il client digitava qualcosa prima che arrivasse, la risposta sovrapponeva il messaggio di benvenuto ai risultati. Ora, quella richiesta viene annullata non appena viene ricevuta una query e, se era già in corso, non viene sovrapposta. Con il messaggio di benvenuto intenzionalmente ritardato di 4 secondi, i risultati ora hanno una larghezza di 192 pixel e la prima scheda è larga 236 pixel, senza il CSS del tema.

Il blocco contenente il tuo messaggio, i link e le "Categorie più trovate", che appare solo in caso di ricerca, si sposta da sopra i risultati (169 px) a dietro di essi.

Una ricerca, una richiesta

• Ogni richiesta è stata inviata al server due volte. rkrfreevisualsearch-nav.js avvolto eseguireSearch con _origExecute(query).then ? _origExecute(query)…Il controllo ha già avviato la ricerca e il ramo l'ha avviata di nuovo.
• Quando ho aperto il pannello, sono apparse 2 o 4 ricerche vuote. Uno ha chiesto "prodotti in evidenza" con solo in primo piano, un parametro che il server non ha mai letto e la risposta era irrilevante: è stato rimosso. Inoltre, l'argomento richiede aprire() con la messa a fuoco e con il clic della sua casella, e la seconda chiamata ha ripetuto il benvenuto e cancellato ciò che era stato scritto: ora non fa nulla se il pannello è già aperto.
• I filtri, l'ordinamento e il limite non hanno annullato la ricerca precedente. E due risposte potrebbero arrivare in qualsiasi ordine. Ora ogni ricerca annulla quella in corso e una vecchia risposta viene scartata anche se arriva (incluse le risposte "carica altro" e di completamento automatico).

La funzione di completamento automatico ha impiegato un'intera pagina

autocomplete.php Stavo chiamando parent::initContent(), che in PrestaShop assegna variabili di pagina ed esegue displayHeader con gli hook di tutti i moduli dello store. In iogenixdise erano 3,6 s per ogni richiesta, anche con l'autocompletamento disattivato, perché il controllo avveniva in un secondo momento. Ora sono 0,1–0,2 s (0,9 s la prima volta). search.php Non lo fece mai. addcart.php Prima faceva la stessa cosa e poi ha smesso di farla: aggiunta al carrello dal pannello, 0,17 s.

La striscia di completamento automatico, con miniatura e senza coprire nulla

Fluttuava sopra il pannello (posizione: AssolutoIn precedenza, copriva le ricerche più popolari e visualizzava solo il testo. Ora è nel flusso, sopra la colonna dei risultati, in una singola riga che scorre orizzontalmente (~70px) e ogni prodotto ha la sua miniatura: il server stava già inviando URL dell'immagine. L'input su un suggerimento contrassegnato dalle frecce non ha avuto alcun effetto (l'elenco letto era sempre vuoto) e ora lo apre.

Il motore di ricerca ha impiegato pochi secondi per trovare i negozi con cronologia degli ordini.

Misurato in maesalv9 (PS 9.1.4, (1.083 prodotti, 535.838 righe d'ordine):

• Schede prodotto ProductDataProvider::getProducts): le unità vendute ammontavano in totale dettagli_ordine + ordini Ogni richiesta richiede circa 1 secondo per prodotto venduto. All'apertura del motore di ricerca (query vuota), i 12 "più venduti" hanno richiesto 9,8 secondi. Ora appaiono in rkrfreevisualsearch_index.total_sold, L'indicizzatore calcola già la stessa somma (gli stessi numeri); solo i dati non indicizzati vengono calcolati come prima. Query vuota: 10,1 s → 0,22 s; "ceramico": 2,4 s → 0,4 s. Le risposte sono identiche byte per byte.
• Completamento automaticoIn precedenza, i file venivano compilati per un massimo di 80 candidati per mostrarne 8, e quelli non corrispondenti venivano scartati (1,7 secondi). Ora, il sistema filtra preventivamente utilizzando nome, riferimento ed EAN da una query, e vengono compilati solo i seguenti: limite * 2 carte. 2,2 s → 0,15–0,4 s, stessi suggerimenti. In iogenixdise (PS 8.2, 346 prodotti, 578.153 righe d'ordine), "Isolate" passa da 12 s a 0,3 s senza caching e la query vuota da 5 s a 0,24 s. Ricerca fuzzy (FUZZY, soglia 60) e MAX_PRODUCTS_QUERY=100 Non erano loro il collo di bottiglia: una query senza risultati, che attraversa il percorso diffuso, impiega 0,49 secondi.

Aggiornamento

upgrade-1.4.38.php basta chiamare Media::clearCache()Con la funzionalità "Smart cache" di JS/CSS abilitata, il negozio continuerebbe a servire il vecchio pacchetto precompilato.

v1.4.372026/10/05

Un singolo banner immagine o video ha mandato in crash l'intero negozio in PrestaShop 9.2

Con un banner immagine o video attivo, la homepage e le pagine prodotto di PrestaShop 9.2 genererebbero un errore irreversibile, non solo la funzione di ricerca: SmartyException: Il template './_banner-overlay.tpl' non può essere relativo al template di tipo risorsa 'module'.. . _banner-media.tpl incluso il testo del banner con un percorso relativo (./_banner-overlay.tpl), e Smarty 9.2 non supporta più i percorsi relativi all'interno di un modello caricato come modulo:.

Ora incluso nel tuo percorso completo (modulo:rkfreevisualsearch/views/templates/hook/_banner-overlay.tpl), come il resto dei modelli front-end. Non è necessario alcun aggiornamento: è solo il modello. Riproducibile in 9.2.0 con la versione precedente e testato con la nuova in 9.2.0, , 9.1.5, , 9.0.0, , 8.2.8 E 1.7.8.11 (Pagina iniziale con un banner immagine in alto e un banner video a lato, e la pagina dei risultati). Il affermare Le relazioni di back-office non cambiano: quei modelli vengono caricati tramite percorso file e funzionano anche in 9.2.

30/09/2026
v1.4.36

La chiave Meilisearch "non è stata salvata"

Un cliente ha segnalato questo problema. La password era stata salvata, ma sullo schermo veniva visualizzato un messaggio diverso e Meilisearch si è chiuso improvvisamente. 1.4.33 La chiave salvata non viaggia più al browser: il campo appare sempre vuoto e il JavaScript della schermata continua a dedurre "nessuna chiave" da un campo vuoto: al caricamento, disabilita e blocca l'interruttore e visualizza "È richiesta la chiave API". Poiché una casella di controllo disabilitata non viene inviata, la successiva casella di controllo salvata invia il 0 dal campo nascosto e Meilisearch disattivato. E se fosse forzato, PHP rifiuterebbe il salvataggio per lo stesso motivo, perché anche in quel caso si limitava a considerare solo il campo.

Ora il modello dice se c'è una chiave salvata (set di chiavi datiJavaScript tiene conto di questo aspetto, mentre PHP richiede la chiave solo se il campo è vuoto. E Nessuno salvato. Giocato su 9.2.0 Con la versione precedente e testato con la nuova: salvando con una password, ricaricando e salvando di nuovo senza inserirla, Meilisearch rimane attivo e la password intatta.

28/09/2026
v1.4.33

Pulizia. Per il commerciante non cambia nulla in termini di funzionalità; ciò che cambia è il funzionamento interno del modulo e il contenuto della confezione.

Ogni azione "aggiungi al carrello" invia una richiesta HTTP dal server a se stesso

Quando si aggiunge un prodotto dal motore di ricerca, il controller richiede l'HTML del mini-carrello tramite cURL. al negozio stesso, con un ritardo di due secondi, all'interno del percorso di acquisto. Era inutile: puntava al modulo. blocco, Quello Non esiste più dalla versione 1.7 di PrestaShop. —il blocco del carrello nativo è ps_shoppingcart—, quindi la richiesta ha restituito un errore 404 e l'HTML è sempre arrivato vuoto. Misurato in 8.2.8: HTTP 404 e 47 byte.

Ciò che costava caro era il tempo. In un negozio che non può raggiungere se stesso a causa del suo dominio pubblico – Cloudflare di mezzo, DNS split-horizon, un bilanciatore di carico o un certificato che cURL non convalida – si trattava di ben due secondi per ogni clic, proprio sulla schermata in cui il cliente prende la decisione.

Il browser, che gestisce la sessione dell'acquirente, ha già gestito l'aggiornamento: i due file JavaScript sono stati inseriti nella propria andare a prendere Quando il codice HTML è vuoto, come sempre accade, non si perde nulla rimuovendolo.

Inoltre, è stato misurato ciò che NO Per evitare di entrare troppo nei dettagli: quella richiesta non ha creato visitatori falsi nelle statistiche. Prima e dopo cinque chiamate, ps_guest E ps_connections Rimangono fermi a 416 e 446.

Codice che nessuno stava eseguendo.

• 176 righe di codice JavaScript per l'indicizzatore (da 530 a 354). Due schermate intere, reindicizzate con barra di avanzamento e aggiornamento delle statistiche, sono state incollate a undici identificatori che nessun modello di modulo definisce, controllate una per una. Con loro vanno le sue tre assistenti, che nessun altro ha chiamato, e le undici regole CSS di quella barra di avanzamento.
• 49 linee del Controllore GeneraleCopie di due hook dal modulo e una seconda implementazione della coda di reindicizzazione. Questi sono metodi hookXxx() all'interno di un controller e PrestaShop invia gli hook a moduli, quindi non furono mai giustiziati. La prova che erano morti da un po' è che questa copia stava ancora cercando _PS_MODE_IMPORT_, la costante che il 1.4.32 Il problema è già stato risolto nell'hook corrente. Le implementazioni in esecuzione nel file principale non sono state modificate, così come non lo sono la coda utilizzata da cron e dal modulo.
• configurazione/services.yaml, che nessuno ha letto: PrestaShop cerca letteralmente services.yml, verificato in 1.7.8.11 E 8.2.8. E non poteva essere semplicemente rinominato, perché attivandolo si sarebbe tentato di iniettare automaticamente classi con dipendenze che non era in grado di risolvere. Con esso è scomparsa anche l'estensione Twig che esisteva solo per registrare quel file: il modulo non ha nemmeno un template Twig.

Presentazione in sei lingue

Ciò che l'acquirente vede (le 141 etichette nel motore di ricerca) ora appare anche in francese, tedesco, italiano e polacco, Oltre all'inglese e allo spagnolo. In precedenza, in un negozio in quelle lingue, la sovrapposizione veniva visualizzata in inglese. Il back office del modulo rimane in inglese e spagnolo.

E tre testi che non sono stati tradotti in nessuna lingua: «Vai a…» era scritto in spagnolo nel codice JavaScript, mentre il contatore «N risultati» e la relativa etichetta di accessibilità erano in inglese.

Multistore: categorie ripetute con il nome di un altro negozio

Sei consultazioni unite categoria_lingua Senza filtrare per negozio. In un'azienda con più punti vendita, ogni categoria appariva una sola volta. per negozio nei collegamenti rapidi dei risultati e con il nome di quello selezionato: nel negozio di prova polacco, apparivano sia "Tonery" che "Tóner". Ciò ha influenzato i collegamenti rapidi, le "categorie più trovate", i filtri e il nome della categoria di ogni inserzione.

Le ricerche più popolari impostate manualmente non sono mai comparse.

Le voci aggiunte dal commerciante a Import/Export vengono conteggiate come zero ricerche e l'elenco è stato ordinato in base al volume di ricerca prima di essere troncato al raggiungimento del limite: non appena le statistiche hanno mostrato un dato significativo, le voci inserite manualmente sono state eliminate senza preavviso. Vengono visualizzate per prime, in ordine.

Il validatore dei componenti aggiuntivi interpretava in modo errato il nome del modulo.

L'ho registrato come «Rekire Ricerca visiva gratuita - Intelligente SearchModules.Rkfreevisualsearch.Admin»: estrae il nome combinando tutte le lettere nell'assegnazione di $this->displayName, La chiamata di traduzione utilizzava il nome di dominio letteralmente. Il nome di dominio è ora una costante. Conferma tramite il caricamento del file ZIP: l'invio 3767735 ora utilizza il nome corretto, con 0 errori e 0 avvisi.

Le schermate nella guida mostravano il nostro laboratorio

Tre delle diciotto immagini presenti nella guida contenevano nomi provenienti dal nostro ambiente di test: un host Meilisearch e un nome di indice in una, e un dominio locale nell'URL di esempio nelle altre due. Non si tratta di credenziali o dati personali, bensì di nomi di macchine locali, ma sono inclusi nel pacchetto acquistato dal cliente e sono del tutto irrilevanti. Sono stati sostituiti con valori neutri.

v1.4.142026/09/08

• Nuovo Guida utente all'interno del back-office, in spagnolo e inglese, con screenshot e assistenza per ogni schermata.
• Corretto Attivando Meilisearch, il tuo negozio non rimarrà più senza servizio se il tuo server non risponde o è obsoleto.
• Corretto Sono stati corretti i link dei banner, il messaggio di benvenuto, i design scuri e i pesi multi-negozio.
• Sicurezza Correzione di sicurezza, chiavi API salvate e crittografate e tutte le librerie all'interno del modulo, senza CDN esterno.

v1.4.132026/09/01

• Corretto Il filtro prezzo consente ancora una volta di filtrare in base al prezzo più basso.

26/08/2026
v1.4.12

• Corretto I colori configurati vengono applicati al pulsante del carrello e alla finestra delle combinazioni.

23/07/2026
v1.4.8

• Nuovo I banner possono contenere immagini, video o prodotti e possono essere generati utilizzando l'intelligenza artificiale.
• Nuovo Campagne di email indirizzate a coloro che hanno cercato un determinato termine, previo consenso registrato al momento della prima ricerca.
• Corretto Sono stati corretti i permessi e le impostazioni della finestra per l'intera pagina, oltre a un bug nell'editor di testo.

11/07/2026
v1.3.7

• Migliorato Ricerca più precisa, anche quando il nome del prodotto contiene numeri.
• Nuovo Opzione per passare al motore di ricerca PrestaShop premendo Invio o la lente d'ingrandimento.
• Nuovo Nuova modalità di presentazione Classica, senza sovrapposizione a schermo intero, e una modalità a pagina intera completamente funzionale.
• Migliorato La scelta migliore tra scorrimento infinito e impaginazione.

13/06/2026
v1.2.33

• Corretto Risolto il problema di aggiornamento dell'indice durante il salvataggio di un prodotto.

11/04/2026
v1.2.8

• Corretto Filtri corretti e migliorati.

10/04/2026
v1.2.7

• Migliorato Modulo interamente tradotto in inglese, con tutti i testi traducibili.
• Migliorato Ritocchi estetici negli uffici amministrativi e nel punto vendita.
• Sicurezza Miglioramenti alla sicurezza.

v1.2.52026/04/09

• Nuovo Colore di sfondo configurabile per le etichette della ricerca predittiva.
• Migliorato Regolazione del colore e delle dimensioni.

v1.2.42026/04/07

• Nuovo Sezione "Potrebbe interessarti" con prodotti suggeriti quando i risultati sono pochi.
• Migliorato Ricerca approssimativa migliorata grazie al motore MySQL e miglioramenti grafici.

v1.1.02026/04/05

• Nuovo Banner programmabili da posizionare nella parte superiore o laterale del motore di ricerca.
• Nuovo Opzione per escludere i marchi dalla ricerca.
• Migliorato Avviso relativo ai prodotti esauriti che sono comunque acquistabili.
• Migliorato Miglioramenti grafici e piccole correzioni.

30/03/2026
v1.0.27

• Nuovo I prodotti nuovi o modificati vengono reindicizzati automaticamente.
• Nuovo Prezzo comprensivo o meno di tasse, a vostra scelta.

29/03/2026
v1.0.25

• Nuovo Esclusione di categorie e caratteristiche dalla ricerca.
• Nuovo Indicizzazione automatica tramite attività pianificata, che rileva i prodotti non indicizzati e sincronizza Meilisearch.
• Migliorato Precaricamento automatico dei termini più cercati e statistiche migliorate.
• Migliorato Miglioramento della ricerca approssimativa, che ignora i termini eccessivamente brevi, e migliore visualizzazione su schermi 2K e 4K.

26/03/2026
v1.0.24

• Migliorato Miglioramenti grafici e correzione di bug.

19/03/2026
v1.0.23

• Nuovo Avvio del modulo.