Belgian Address Autocomplete

Belgian Address Autocomplete è un modulo PrestaShop gratuito per inserire indirizzi belgi. Un suggerimento numerato compila via e civico, CAP di quattro cifre e città. Usa i registri ufficiali di Fiandre, Bruxelles e Vallonia senza account, chiave o costo per ricerca.

Avvio rapido

1. Installa lo ZIP del modulo in PrestaShop. Nessun account del servizio, chiave o pagamento da preparare.
2. Apri Configura o la voce Belgian Address nel menu del back office; in multinegozio scegli un negozio autorizzato.
3. Verifica che il Belgio sia attivo e disponibile nei moduli indirizzo nativi che usi.
4. Scegli nell’ordine gli interruttori generale, account, checkout e back office, poi salva. Qui non c’è selezione paesi.
5. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.
6. Integra le tre origini regionali nella CSP esistente e descrivi le connessioni del browser nell’informativa privacy.
7. Seleziona il Belgio e digita rue royale 10 bru. Controlla Rue Royale 10, 1000, Bruxelles se restituiti. Aggiungi l’interno nella seconda riga. Prova sola via, inserimento manuale, ospiti, fattura, operatori/nuovo ordine, Francia con French Address Autocomplete e telefono.

Funzionalità

• Suggerimenti belgi. Registri regionali ufficiali nei moduli nativi di account e checkout, ospiti inclusi.
• Campi compilati insieme. Via e civico, CAP di quattro cifre e città dalla scelta numerata.
• Copertura belga fissa. Fiandre, Bruxelles e Vallonia insieme; interni e sole vie da completare a mano.
• Back office. Aiuto agli operatori in Clienti > Indirizzi.
• Uso quotidiano. Tocco, tastiera e annunci per lettori di schermo; inserimento manuale conservato.
• Senza account del servizio. Modulo e dati regionali gratuiti, quattro interruttori e nessuna chiave.

Opzioni di configurazione

• Suggerisci indirizzi mentre il cliente scrive: interruttore generale, primo campo.
• Nel modulo indirizzo dell’account cliente: indirizzi nativi dell’account.
• Nei moduli indirizzo del checkout (inclusi ospiti e indirizzi di fatturazione separati): ospiti e fatturazione separata inclusi.
• Nel modulo indirizzo del back office (indirizzi dei clienti, nuovi ordini): indirizzi clienti e nuovi ordini nativi.

Apri Configura in Gestione moduli o la voce Belgian Address nel menu del back office. La pagina unica contiene le sezioni Configuration, Integrity, License, Update e Support (nomi inglesi). I quattro interruttori appaiono in questo ordine, poi Salva. Sono tutti attivi per impostazione predefinita. Nessun campo chiave, account o paese. In multinegozio scegli un negozio che puoi gestire; le impostazioni vengono salvate per quel negozio. Dopo il modulo trovi note su copertura/servizio gratuito, inserimento manuale, privacy, CSP e servizi correlati. Testi forniti in inglese, tedesco, francese, polacco, italiano, spagnolo e olandese; non è una promessa di dati indirizzo in sette lingue.

Usa per questi paesi è disponibile solo sui moduli mondiali. Vuoto significa tutti i paesi del modulo, una lista limita quel servizio. Belgian Address rimane fisso su BE. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione. Puoi lasciare un servizio mondiale per le altre destinazioni. Nessun errore passa automaticamente a un altro servizio.

Esempi di personalizzazione

Consenti le tre regioni belghe nella tua Content Security Policy

Origini connect-src dedotte dal codice: https://geo.api.vlaanderen.be, https://geoservices.irisnet.be e https://geoservices.wallonie.be. Nessun SDK o stile esterno viene caricato. Integra l’esempio nella tua politica esistente, mantenendo regole del tema, inline/nonces e 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://geo.api.vlaanderen.be https://geoservices.irisnet.be https://geoservices.wallonie.be;

Conserva appartamento e dettagli di consegna

Paese, seconda riga, nome, azienda e telefono restano invariati. Aggiungi o conserva interno, cassetta, piano, ingresso ed edificio nella seconda riga. Controlla via, civico, CAP e città prima di salvare. La sola via richiede ancora un civico. Una scelta di sola via dalle Fiandre svuota il CAP; Bruxelles e Vallonia conservano quello restituito. Completa a mano i dettagli mancanti.

Installazione

Requisiti

• Intervallo PrestaShop generale: PS 1.6 – 9.x. Minimo esatto dichiarato: PrestaShop 1.6.1.0 e PHP da 7.1.
• Campi nativi e presentazione Bootstrap 3, 4 o 5. Il Belgio deve essere disponibile; attivalo se consegni lì.
• Verifica che il Belgio sia attivo e disponibile nei moduli indirizzo nativi che usi.

Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione. Belgian Address funziona da solo.

L’installazione non certifica disponibilità del servizio o tutte le combinazioni piattaforma/tema. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.

Come funziona

I suggerimenti iniziano dopo tre caratteri e una pausa di 300 ms. Quattro GET diretti interrogano in parallelo Fiandre, Bruxelles in francese e olandese, e Vallonia. Le Fiandre usano c=10&q=..., Bruxelles spatialReference=4326, language=fr o nl fisso e address, la Vallonia address. Filtri per prefissi di parole e numeri riducono corrispondenze vaghe, normalizzando maiuscole e accenti. Fino a cinque risultati distinti vengono uniti a turno, eliminando duplicati per via, CAP e città. Se la Vallonia non dà righe valide e la ricerca ha almeno tre parole, riprova una volta senza l’ultima parola, sempre filtrando con il testo completo. Solo per la Vallonia apostrofi e operatori diventano spazi. Un risultato utile lascia ai servizi più lenti un altro secondo prima dell’annullamento. Altre regioni possono rispondere anche se una non funziona.

Durante la ricerca, dopo 600 ms appare la semplice riga “Ricerca degli indirizzi…” (fonte: “Searching addresses…”). Ogni richiesta HTTP termina dopo dieci secondi. Il nuovo tentativo vallone può prolungare la ricerca totale; non esiste un unico limite complessivo di dieci secondi. Il cliente può continuare a inserire l’indirizzo manualmente.

Campi dell’indirizzo scelto

La scelta compila address1, postcode e city senza altra ricerca. Le Fiandre separano via/numero, CAP di quattro cifre e città; Bruxelles fornisce via, numero, CAP e comune separati; la Vallonia analizza indirizzi di livello 4, sposta il civico iniziale alla fine e rimuove trattini bassi finali dalla città. Il CAP resta di quattro cifre senza spazi. Lettere o suffissi con barra restituiti possono restare, ma gli interni si aggiungono a mano dopo la scelta. L’interno digitato deve corrispondere alla riga restituita e può dare zero risultati. Le sole vie appaiono senza indirizzi numerati validi e senza cifre digitate. Una scelta dalle Fiandre svuota il CAP, Bruxelles/Vallonia conservano quello restituito. Completa civico e CAP mancanti. Nessuna provincia o modalità speciale per località senza vie. Due righe mostrano via/numero, poi CAP + città.

Usa per questi paesi è disponibile solo sui moduli mondiali. Vuoto significa tutti i paesi del modulo, una lista limita quel servizio. Belgian Address rimane fisso su BE. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione. Puoi lasciare un servizio mondiale per le altre destinazioni. Nessun errore passa automaticamente a un altro servizio.

In Clienti > Indirizzi gli operatori possono scegliere un indirizzo belga dopo una richiesta telefonica per compilare via, CAP e città. L’interruttore del back office è indipendente da account e checkout.

Il codice comprende le finestre native dell’indirizzo di un nuovo ordine servite dalla pagina degli indirizzi clienti. Percorsi e moduli personalizzati richiedono una prova. Checkout Revolution può caricare lo stesso motore per i propri formulari indirizzo e riutilizzare queste impostazioni del servizio per il singolo negozio.

Sul telefono tocca un risultato sotto la via. Con la tastiera usa frecce e Invio; Escape o Tab chiude l’elenco. I lettori di schermo ricevono annunci dei risultati. Il componente comune segue la presentazione Bootstrap del tema.

Il credito visibile è © Digitaal Vlaanderen, paradigm.brussels, SPW. Senza corrispondenze l’elenco resta chiuso; l’indisponibilità viene annunciata. Inserimento e modifica manuali rimangono possibili. Il salvataggio non richiede una scelta e non verifica la consegnabilità.

Privacy e credito dei dati

Il browser invia il testo della via alle tre regioni, con q per le Fiandre e address per Bruxelles/Vallonia. Opzioni fisse includono limite risultati, riferimento spaziale e lingue francese/olandese di Bruxelles. La Vallonia riceve testo ripulito ed eventualmente un tentativo abbreviato, sempre filtrato con il testo completo. Non vengono aggiunti parametri di chiave, paese scelto, lingua della pagina, nome, email, telefono, azienda o seconda riga. Tutto il testo cercato viene inviato. Le connessioni espongono IP e possibili dati browser/origin/referrer secondo le sue regole. Le credenziali sono disattivate. Ogni richiesta HTTP scade dopo dieci secondi; un tentativo ulteriore può prolungare la ricerca. La scelta è locale. Nessuna cronologia o proxy del negozio; la diagnostica omette ricerche e indirizzi restituiti. PrestaShop salva l’indirizzo normalmente. Descrivi le connessioni nell’informativa privacy. Credito visibile: © Digitaal Vlaanderen, paradigm.brussels, SPW.

Limiti da conoscere

• I registri regionali non garantiscono ogni indirizzo, aggiornamento, disponibilità continua o uso illimitato. Le risposte registrate non certificano risultati attuali o località senza vie.
• Le righe malformate sono scartate; i prefissi possono corrispondere a nomi o numeri più lunghi. Interno, cassetta ed edificio si aggiungono dopo la scelta. Le sole vie richiedono civico e talvolta CAP; le Fiandre svuotano il CAP. Controlla l’indirizzo prima di salvare.
• HTTP 429 sospende solo il server coinvolto secondo Retry-After o dieci secondi; le due lingue di Bruxelles condividono la pausa. Altre regioni possono dare risultati. Ogni richiesta scade dopo dieci secondi con possibile nuovo tentativo vallone. Inserimento manuale disponibile; nessun passaggio a un altro servizio installato.
• Moduli/temi personalizzati e percorsi diversi del nuovo ordine richiedono test. Checkout Revolution può usare il motore condiviso.
• Niente mappe, geolocalizzazione, coordinate salvate, validazione all’invio, selezione automatica del paese o garanzia di consegna. Aggiornamenti a vita senza promessa di supporto incluso.

Se non compaiono suggerimenti

• Nessun risultato belga: controlla che il Belgio sia attivo e verifica gli interruttori, poi via completa, numero e città.
• Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.
• Sola via o nessun risultato: completa civico, CAP e località postale a mano e controlla l’indirizzo prima di salvare.
• Servizio indisponibile: verifica rete/CSP dei servizi regionali, attendi dopo un limite e continua manualmente.
• Modulo o layout personalizzato: prova modulo nativo, tastiera/telefono e percorso ordine; controlla le impostazioni del servizio per questo negozio.