Fetchify Address Autocomplete

Fetchify Address Autocomplete aggiunge suggerimenti Fetchify ai moduli indirizzo nativi di PrestaShop. Scegliere un singolo indirizzo compila address1, postcode, city e la selezione nativa di stato o provincia se esiste un’opzione corrispondente. Il modulo è gratuito; Fetchify addebita le ricerche all’account del commerciante. Configuri il tuo token di accesso pubblico usato dal browser.

Avvio rapido

1. Crea o apri il tuo account Fetchify per il negozio. Le ricerche sono addebitate a questo account.
2. Apri Access Tokens & Statistics e copia il token di accesso destinato al negozio.
3. Sul lato Fetchify aggiungi il dominio effettivo del negozio in Allowed Domains. Includi un dominio diverso del back office se vuoi suggerimenti anche lì. Il token sarà pubblico nel browser.
4. Carica e installa lo ZIP del modulo in PrestaShop. Apri Configura o la voce Fetchify Address nel menu del back office; in multinegozio seleziona un solo negozio che puoi gestire.
5. Incolla il token in Token di accesso Fetchify. In Usa per questi paesi scegli, per esempio, Regno Unito oppure lascia vuoto per tutti i paesi. Imposta gli interruttori e salva.
6. Se necessario, aggiungi l’origine Fetchify alla CSP esistente e spiega la connessione del browser nell’informativa privacy.
7. Scegli Regno Unito in un modulo indirizzo nativo e digita un codice postale britannico nel campo della via. Apri un gruppo se serve, scegli un singolo indirizzo e controlla i campi. Prova anche scrittura manuale, ospiti, fattura separata, Clienti > Indirizzi, finestra nativa dell’indirizzo di un nuovo ordine, un altro paese e larghezza mobile. Controlla console e utilizzo dell’account Fetchify.

Funzionalità

• Suggerimenti della via. Fetchify nell’account e nell’ordine nativi, ospiti compresi.
• Compilazione insieme. Via, CAP, città e, se esiste un’opzione corrispondente nel modulo, stato o provincia dal suggerimento scelto.
• Paese selezionato. La ricerca segue la destinazione scelta nel modulo.
• Back office. Aiuto alla compilazione nella pagina nativa degli indirizzi clienti.
• Uso quotidiano. Telefono, tastiera e lettore di schermo, mantenendo l’inserimento manuale.
• Il tuo account Fetchify. Modulo gratuito con interruttori separati per i formulari; Fetchify ti addebita l’utilizzo.

Opzioni di configurazione

Apri Configura in Gestione moduli o la voce Fetchify Address nel menu del back office. Le sezioni sono Configurazione, Integrità, Licenza, Aggiornamento e Supporto, in quest’ordine. Si apre prima Configurazione, con il token di accesso Fetchify sopra gli interruttori e l’elenco dei paesi.

• Token di accesso Fetchify: Il tuo token pubblico per browser di Fetchify. Limita Allowed Domains nell’account Fetchify.
• Suggerisci indirizzi mentre il cliente scrive: comando generale.
• Nel modulo indirizzo dell'account cliente: inserimento nativo dell’indirizzo nell’account.
• Nei moduli indirizzo del checkout (inclusi ospiti e indirizzi di fatturazione separati): ordine nativo, ospiti e indirizzo di fatturazione separato.
• Nel modulo indirizzo del back office (indirizzi dei clienti, nuovi ordini): Clienti > Indirizzi, compresa una finestra di nuovo ordine servita da quella pagina.
• Usa per questi paesi: Lascia vuoto per tutti i paesi offerti dal modulo indirizzo, oppure scegli quelli a cui risponde Fetchify. Un modulo limitato a un elenco risponde prima di uno mondiale. French Address Autocomplete conserva la copertura fissa quando è attivo sul modulo indirizzo. Un avviso segnala le impostazioni mondiali sovrapposte.

Gli interruttori sono attivi per impostazione iniziale, ma Fetchify richiede un token salvato. Svuotarlo ferma l’adattatore e lascia disponibile la normale scrittura dell’indirizzo. Il salvataggio verifica i caratteri stampabili, non l’autenticazione Fetchify o il dominio. Non c’è un pulsante di test del token dal vivo. Autorizza sul lato Fetchify il dominio del negozio e quello del back office se diverso.

In multinegozio seleziona un solo negozio che sei autorizzato a gestire. Le impostazioni vengono salvate per quel negozio. Il comando generale deve essere attivo insieme a quello del modulo d’indirizzo. Spegnere l’ordine mantiene attivi account e back office se sono abilitati.

La pagina spiega copertura, fatturazione, privacy e CSP. Le stringhe delle impostazioni esistono in inglese, tedesco, francese, polacco, italiano e spagnolo. È l’elenco delle lingue delle impostazioni, non una garanzia sui dati degli indirizzi in ogni lingua.

Se un altro modulo carica un vecchio motore degli indirizzi che disattiva i suggerimenti Fetchify, il banner di verifica dell’installazione segnala un problema. La sezione Configurazione indica il modulo da aggiornare. Un token salvato da solo non conferma che il motore sia pronto.

Esempi di personalizzazione

Consentire Fetchify nella Content Security Policy

L’origine esterna ricavata dal codice è https://api.craftyclicks.co.uk per connect-src. Adattatore Fetchify, motore, campi condivisi ed elenco sono script serviti dal negozio; anche gli stili provengono dal negozio. Non viene caricato alcuno script o foglio di stile Fetchify esterno. Unisci l’esempio alla politica esistente, mantenendo le regole del tema, della configurazione incorporata e degli altri moduli. Con French Address Autocomplete consenti anche https://data.geopf.fr in connect-src.

script-src 'self';
style-src 'self';
connect-src 'self' https://api.craftyclicks.co.uk;

Conservare appartamento e indicazioni di consegna

Inserisci un piano o un appartamento nella seconda riga, poi scegli un risultato. La seconda riga resta invariata. Completa un numero civico mancante prima di salvare. Nessuna impostazione obbliga a scegliere una voce e il modulo non aggiunge una verifica dell’indirizzo all’invio.

Installazione

Requisiti

• Intervallo generale PrestaShop: PS 1.6 – 9.x. Minimo esatto dichiarato: PrestaShop 1.6.1.0; PHP 7.1 o successivo.
• Campi nativi e tema Bootstrap 3, 4 o 5 per l’aspetto supportato dell’elenco.
• Il tuo account Fetchify e token di accesso, con il dominio del negozio in Allowed Domains. Fetchify addebita le ricerche al tuo account.

Se un altro modulo di indirizzi carica un vecchio motore che disattiva i suggerimenti, aggiorna il modulo indicato nella pagina delle impostazioni di questo modulo.

Un token salvato dimostra solo che la sintassi è stata accettata. Prova nel browser autenticazione, Allowed Domains e configurazione dell’account sui domini effettivamente usati. Il modulo non crea né gestisce l’account Fetchify. Non pubblicare schermate con il token reale.

Come funziona

I suggerimenti iniziano dopo tre caratteri e una pausa di 300 ms. Sono valori incorporati. Il codice postale britannico si scrive nello stesso campo della via usato per cercare un indirizzo. L’elenco mostra i risultati restituiti da Fetchify; l’adattatore non impone un limite di cinque né garantisce un elenco postale completo.

Quando Fetchify restituisce entrambe le parti, ogni suggerimento mostra l’indirizzo sulla prima riga e il codice postale sotto. Un risultato con una sola etichetta rimane su una riga.

Se il servizio è lento appare “Ricerca degli indirizzi…”; dopo dieci secondi la richiesta termina e puoi continuare a inserire l’indirizzo a mano. La riga di ricerca scompare appena arrivano i risultati.

Durante la digitazione il browser invia find. La scelta di un gruppo invia un altro find con identificatore e ricerca precedente. Un singolo indirizzo avvia retrieve; line_1, line_2, postal_code, locality o dependent_locality e i campi della provincia sono associati al modulo nativo. Un gruppo non compila ancora l’indirizzo. Per gli USA usa_exclude_zip_plus4: true richiede ZIP a cinque cifre. La sequenza non stabilisce tariffe o quantità incluse di ricerche.

Quali dati vengono compilati dopo la scelta

Mantiene il paese selezionato e conserva appartamento, piano o ingresso già indicati nella seconda riga. Nome, azienda e telefono restano invariati. Il cliente rilegge e modifica il risultato prima di salvare: l’aiuto riduce la digitazione senza decidere al suo posto quale sia l’indirizzo da usare.

Per quali paesi compaiono i suggerimenti Fetchify

La ricerca segue il paese scelto nel modulo indirizzo e la tua selezione di paesi nelle impostazioni. Il modulo offre i suggerimenti Fetchify in oltre 240 paesi. I suggerimenti effettivi dipendono dai dati Fetchify, dal tuo account e dalla disponibilità del servizio. Un paese presente non garantisce ogni via o numero civico.

Con più moduli indirizzo, Usa per questi paesi decide il servizio che risponde per ogni paese. Puoi scegliere Fetchify per il Regno Unito e Google Address Autocomplete per il resto. Un modulo limitato a un elenco risponde prima di uno lasciato mondiale. French Address Autocomplete conserva le sue destinazioni francesi quando è attivo sullo stesso modulo indirizzo. L’elenco vuoto significa tutti i paesi offerti dal modulo indirizzo, senza cambiare i paesi di vendita.

Dove riceve aiuto il team nel back office

In Clienti > Indirizzi i collaboratori ricevono suggerimenti anche nel campo nativo della via. La scelta compila via, CAP, città e, se esiste un’opzione corrispondente nel modulo, stato o provincia, per esempio dopo una richiesta telefonica o mentre si prepara un ordine. L’interruttore del back office è indipendente da quelli dell’account e dell’ordine. Attivi l’aiuto nei punti in cui il team inserisce davvero gli indirizzi.

Come si sceglie un risultato da telefono o tastiera

Dal telefono il cliente tocca un suggerimento sotto il campo della via. Con la tastiera, le frecce scorrono i risultati ed Enter sceglie quello evidenziato. Escape o Tab chiude l’elenco senza scegliere. L’elenco segue l’aspetto delle liste del tema e rimane accanto ai campi in compilazione, senza aprire una mappa o una pagina di ricerca separata. Quando Fetchify restituisce entrambe le parti, ogni suggerimento mostra l’indirizzo sulla prima riga e il codice postale sotto. Un risultato con una sola etichetta rimane su una riga.

Richieste, indirizzi salvati e privacy

Il browser invia a Fetchify token pubblico, testo cercato e paese selezionato in formato alpha-3. Un gruppo aggiunge identificatore e ricerca precedente; il recupero di un indirizzo invia identificatore, token e paese. Le richieste USA includono l’opzione del formato ZIP. L’adattatore non invia lingua della pagina né token della sessione di ricerca. Fetchify riceve l’IP dalla connessione e può ricevere informazioni del navigatore (intestazioni Origin e Referer) secondo le regole del navigatore. Le richieste non usano credenziali tra origini.

Il modulo non aggiunge nome, e-mail, telefono, azienda o seconda riga a queste richieste. Non inoltra le ricerche tramite il server del negozio e non conserva testi o risultati nelle proprie tabelle. Ciò non significa che Fetchify non conservi nulla. Il successivo salvataggio dell’indirizzo resta la normale operazione PrestaShop. Indica il trasferimento nell’informativa; installare il modulo non risolve automaticamente le questioni di consenso o altri obblighi di privacy.

L’elenco riporta Fetchify. La diagnostica opzionale del motore registra stato tecnico, fornitore, paese, durata e numero di risultati, senza l’indirizzo digitato. Non crea una cronologia delle ricerche.

Limiti da conoscere

• Token pubblico. Il token viene salvato per negozio ed esposto nella configurazione del browser. Limita Allowed Domains in Fetchify, verifica l’accesso all’account e nascondi il token reale nelle schermate pubbliche.
• Copertura senza completezza. La ricerca segue il paese. Potrebbe mancare un risultato, il civico, il CAP o componenti utilizzabili per via e città.
• Moduli nativi. Ordini personalizzati, finestre di terzi e temi senza Bootstrap richiedono prove proprie. La finestra del nuovo ordine è quella servita da AdminAddresses.
• Inserimento manuale. I suggerimenti non verificano l’indirizzo inviato e non garantiscono la consegna. Il cliente controlla la destinazione.
• Campi conservati. Seconda riga, nome, azienda, telefono e paese selezionato restano invariati.
• Risposte in ritardo. Un cambio di paese o di valori, campi necessari assenti o testi troppo lunghi possono fermare la compilazione. L’inserimento manuale rimane disponibile.
• Servizio esterno. Rete, politica del browser e account influenzano i suggerimenti. Una richiesta BAN fallita non passa automaticamente a Fetchify.
• Impostazioni condivise. Quando Checkout Revolution usa questo motore condiviso degli indirizzi, usa le stesse impostazioni per negozio di questo servizio.
• Formato ZIP USA. L’adattatore chiede cinque cifre senza +4. Controlla risultati reali e scelta nativa dello stato. L’opzione non garantisce la consegna.

Se non compaiono suggerimenti

• Nessun suggerimento: controlla comando generale, interruttore del modulo indirizzo, token Fetchify e Usa per questi paesi. In Fetchify verifica account e Allowed Domains per i domini effettivi di negozio e back office.
• CSP che blocca richieste: aggiungi https://api.craftyclicks.co.uk a connect-src. Script e stili del modulo provengono dal negozio. Mantieni la politica esistente e controlla la console. L’esempio deriva dal codice, non da una misurazione completa.
• Il codice postale apre un altro elenco: è un gruppo. Scegli un singolo indirizzo restituito per recuperarne i campi. I dati Fetchify determinano i risultati; nessuna lista garantisce ogni indirizzo del codice postale.
• Paese o indirizzo assente: controlla paese del modulo indirizzo, elenco dei paesi, account e domini consentiti. Errori o nessun risultato lasciano disponibile la scrittura manuale. Non c’è un tentativo automatico tramite un altro servizio.
• ZIP o stato da controllare: le richieste USA escludono ZIP+4. Stato o provincia è scelto solo con un’opzione nativa corrispondente. Completa a mano campi mancanti, troppo lunghi o modificati durante il recupero.