Tutto quello che vorresti sapere prima di installare.
Uno sguardo dettagliato su come funziona DataFirefly Address Lookup - Autocomplete di indirizzo al checkout PrestaShop 8 & 9, perché l'abbiamo progettato così, e il ragionamento dietro le funzionalità qui sopra.
Il problema invisibile che costa caro: gli indirizzi mal compilati
Un cliente su dieci inserisce il suo indirizzo con un errore di battitura, una via incompleta, un codice postale errato. Risultato: spedizioni rimandate al mittente, spese di rispedizione, supporto clienti sovraccarico, carrelli abbandonati al momento del checkout. Su PrestaShop, il modulo di indirizzo nativo non offre alcuna assistenza — il cliente digita alla cieca. DataFirefly Address Lookup risolve questo problema trasformando il modulo di indirizzo in un assistente intelligente che propone, completa e valida in tempo reale.
L'API francese BAN, gratuita e ufficiale
Il modulo utilizza per default api-adresse.data.gouv.fr, l'API ufficiale dello Stato francese. È la stessa base usata dai servizi postali e dai sistemi informativi pubblici francesi: esaustività del territorio, aggiornamento continuo, indirizzi normalizzati. Nessuna chiave API, nessun abbonamento, nessun costo di utilizzo. Le richieste partono direttamente dal browser del cliente verso l'API — il tuo server non viene mai sollecitato, la tua larghezza di banda non viene consumata.
Google Places in opzione per i tuoi clienti italiani e internazionali
Se vendi in Italia o all'estero, attiva il motore Google Places in complemento. Inserisci la tua chiave API nella configurazione, limitala per referrer HTTP nella Google Cloud Console, e il modulo passa automaticamente a Google non appena il cliente seleziona un paese diverso dalla Francia. Puoi anche limitare Google a una whitelist di paesi (IT, CH, AT, DE per esempio) per controllare il tuo budget Google Cloud.
Il workflow cliente: codice postale → città → via
Il cliente inizia a riempire il suo indirizzo. Digita le cinque cifre del suo codice postale: se solo un comune corrisponde, la città si compila da sola; altrimenti, appare un selettore di città. Inizia a digitare la sua via: il modulo interroga la BAN filtrando per il codice postale già noto e propone gli indirizzi corrispondenti. Un click, e i tre campi vengono compilati in un colpo con un indirizzo normalizzato. Tre interazioni, zero digitazioni inutili.
Integrazione zero-friction su tutti i checkout
Il modulo si aggancia all'hook standard actionFrontControllerSetMedia e inietta il suo JavaScript e CSS solo sulle pagine che contengono un modulo di indirizzo: ordine, mio indirizzo, mia identità, registrazione. Nessun override di template Smarty. Nessuna tabella in database. Nessuna dipendenza da un tema particolare — Classic, Hummingbird, e la maggior parte dei temi di terze parti funzionano senza configurazione.
Robustezza: compatibile one-page checkout e multi-moduli
Il checkout one-page di PrestaShop re-renderizza il modulo di indirizzo ad ogni cambio di step, e alcune estensioni di terze parti fanno lo stesso. Il modulo gestisce questi re-rendering grazie a un MutationObserver accoppiato agli eventi nativi PrestaShop: updatedAddressForm, updatedAddress, updatedDeliveryForm, changedCheckoutStep. Se due moduli di indirizzo sono visualizzati contemporaneamente (spedizione + fatturazione), ciascuno riceve il proprio autocomplete indipendente.
Performance e privacy: nessun server intermedio
Tutte le richieste di autocomplete partono direttamente dal browser del cliente verso l'API scelta (BAN o Google). Il tuo server PrestaShop non viene mai sollecitato dal modulo durante la digitazione: nessun carico CPU, nessuna larghezza di banda consumata, nessuna latenza aggiunta. Lato GDPR: nessun transito di dati tramite DataFirefly, nessuna raccolta lato DataFirefly, nessun cookie di terze parti depositato dal modulo.
Configurazione in due minuti
Installa il modulo, apri la sua configurazione, è già funzionale per la Francia. Per Google Places: attiva l'opzione, incolla la tua chiave, scegli l'elenco dei paesi autorizzati (IT per l'Italia). Regola il numero minimo di caratteri prima dell'attivazione, il tempo di debounce, l'attivazione o meno dell'evidenziazione dei termini corrispondenti. Nessuna riga di codice da modificare.
Ancora non ci sono recensioni.