Dutch Address Autocomplete

Dutch Address Autocomplete aggiunge suggerimenti PDOK Locatieserver ai moduli indirizzo nativi PrestaShop per i Paesi Bassi europei. Un risultato completo scelto compila address1, postcode e city, conserva lettera o aggiunta al numero e formatta il CAP come 1012 LG. Il modulo è gratuito con aggiornamenti a vita, senza impegno di assistenza incluso. PDOK non richiede account, chiave o pagamento per ricerca.

Avvio rapido

1. Carica e installa lo ZIP nel gestore moduli. Non servono account o chiave PDOK.
2. Attiva Paesi Bassi come destinazione se consegni lì. Apri Configura oppure la voce Dutch Address nel menu del back office; nel multinegozio scegli un negozio che puoi gestire.
3. Nel multinegozio scegli un singolo negozio autorizzato. Apri Configurazione nella pagina unica Impostazioni.
4. Scegli gli interruttori generale, account, checkout e back office in quest’ordine e salva. Qui non ci sono credenziali del servizio o selettori dei paesi.
5. Se necessario, aggiungi https://api.pdok.nl a connect-src nella CSP esistente e descrivi il trasferimento nell’informativa privacy.
6. Seleziona Paesi Bassi nel modulo nativo. Scrivi 1012 LG e un numero nel campo via, scegli un risultato completo realmente restituito e verifica aggiunta, spazio nel CAP e città.
7. Prova inserimento manuale, ospiti, fattura separata, Clienti > Indirizzi, finestra nativa nuovo ordine, altro paese, telefono e tastiera. Controlla la console. Una ricerca non dimostra la validità dell’indirizzo.

Funzionalità

• Ricerca olandese. Una via oppure CAP e numero nel campo via esistente.
• Compilazione congiunta. Via, numero con lettera o aggiunta, CAP e città da un risultato scelto.
• Fonte ufficiale. PDOK Locatieserver di Kadaster con i dati del registro BAG.
• Moduli indirizzo nativi. Account, checkout ospiti, fatturazione separata e indirizzi nel back office.
• Uso quotidiano. Tocco, tastiera e annunci per lettori di schermo, con inserimento manuale mantenuto.
• Accesso gratuito. Senza account, chiave o costo per ricerca, con interruttori separati per le diverse pagine.

Opzioni di configurazione

I quattro controlli visibili sono, nell’ordine: Suggerisci indirizzi mentre il cliente scrive; Nel modulo indirizzo dell'account cliente; Nei moduli indirizzo del checkout (inclusi ospiti e indirizzi di fatturazione separati); Nel modulo indirizzo del back office (indirizzi dei clienti, nuovi ordini). Sono attivi per impostazione predefinita. Seguono Salva e le note su copertura, inserimento manuale, privacy e CSP. Spegnere il controllo generale ferma i suggerimenti in tutte le pagine.

Apri Configura in Gestione moduli o la voce Dutch Address nel menu del back office. Questa versione ha una sola pagina Impostazioni con Configurazione, Integrità, Licenza, Aggiornamento e Supporto. Le impostazioni valgono per un negozio. Nel multinegozio scegli un singolo negozio autorizzato prima di modificare.

Non c’è campo chiave del servizio né Usa per questi paesi. Il selettore riguarda solo gli adattatori mondiali. La copertura fissa NL precede un adattatore mondiale senza restrizioni. Una lista scelta sovrapposta può precedere PDOK; evita NL lì se deve rispondere PDOK. Una lista mondiale vuota significa tutti i paesi offerti dal modulo indirizzo e non modifica le destinazioni di vendita.

Sono forniti i testi sorgente inglesi e traduzioni delle impostazioni in olandese, tedesco, francese, polacco, italiano e spagnolo. L’inglese usa il testo sorgente per le attuali note PDOK.

Esempi di personalizzazione

Consentire PDOK in una Content Security Policy

L’origine esterna rilevata nell’adattatore è https://api.pdok.nl. PDOK non carica SDK, fogli di stile o font remoti. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione. Unisci l’esempio alla tua policy conservando le regole per configurazione incorporata, tema e altri moduli. French Address Autocomplete richiede anche https://data.geopf.fr in connect-src.

script-src 'self';
style-src 'self';
connect-src 'self' https://api.pdok.nl;

Conservare dettagli di appartamento e consegna

Scrivi appartamento, piano o indicazioni di consegna nella seconda riga prima di scegliere. Quella riga resta intatta, come paese, nome, azienda e telefono. Completa una sola via con numero e CAP prima di salvare. L’adattatore non fornisce una provincia. Il cliente può sempre correggere i normali campi.

Installazione

Requisiti

• Compatibilità generale PrestaShop: PS 1.6 – 9.x. Minimo esatto dichiarato: PrestaShop 1.6.1.0; PHP 7.1 o successivo.
• Campi indirizzo nativi e lista Bootstrap 3, 4 o 5. Verifica temi e moduli personalizzati separatamente.
• Paesi Bassi nel modulo indirizzo e interruttori rilevanti attivi. Nessun account, chiave o acquisto di ricerche PDOK.

Se hai installato un vecchio modulo indirizzi, i suggerimenti olandesi possono restare spenti e la pagina delle impostazioni del modulo ti indica quale modulo aggiornare. 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. L’adattatore esegue una GET verso PDOK suggest con testo, filtri fissi per indirizzi e vie e nomi dei campi richiesti. Richiede dieci record, elimina quelli malformati e i duplicati, preferisce indirizzi completi e ne mostra al massimo cinque. Una sola via appare soltanto senza indirizzi completi e senza cifre nella ricerca. La lista non è esaustiva.

La scelta compila direttamente dal suggerimento senza una seconda ricerca. Un record completo valido ha numero intero positivo, una lettera facoltativa, un’aggiunta alfanumerica facoltativa di 1-4 caratteri, CAP olandese e città. I formati non supportati sono scartati. Il CAP riceve spazio e maiuscole; la lettera si unisce al numero e l’aggiunta segue un trattino.

Quali campi vengono compilati dopo la scelta

Un risultato completo fornisce via, numero con lettera o aggiunta restituita, CAP e città. La lettera si unisce al numero, per esempio 12A; l’aggiunta segue un trattino, come Damrak 12-H. Il CAP usa spazio e maiuscole nel formato PrestaShop, ad esempio 1012 LG. Gli esempi descrivono il formato e non garantiscono un indirizzo restituito.

Paese scelto, nome, azienda, telefono e seconda riga già scritta rimangono invariati. Il cliente può conservare appartamento, piano o indicazioni di consegna e correggere il risultato. Un suggerimento di sola via non contiene numero e CAP, che vanno completati a mano. Questo adattatore non compila la provincia.

Quali destinazioni ricevono suggerimenti olandesi

I suggerimenti PDOK riguardano i Paesi Bassi europei quando Paesi Bassi è selezionato nel modulo indirizzo. Non viene offerta copertura dei Caraibi olandesi o mondiale. Il cambio di paese ferma i suggerimenti olandesi; un altro servizio installato può rispondere secondo la propria copertura e configurazione.

French Address Autocomplete può servire le proprie destinazioni francesi accanto a PDOK per i Paesi Bassi. Google Address Autocomplete e Fetchify Address Autocomplete mantengono le proprie impostazioni dei paesi. La copertura fissa precede un servizio mondiale senza restrizioni; evita liste scelte sovrapposte. Una ricerca fallita non passa automaticamente a un altro servizio.

Dove riceve aiuto il personale nel back office

In Clienti > Indirizzi il personale trova i suggerimenti nel campo via nativo. Può digitare CAP e numero ricevuti al telefono, scegliere un indirizzo restituito e controllare via, CAP e città prima del salvataggio. La formattazione conserva la lettera o aggiunta al numero restituita dal servizio.

L’integrazione si rivolge anche alla finestra nativa dell’indirizzo di un nuovo ordine se servita da AdminAddresses. Altre finestre e moduli indirizzo personalizzati richiedono una verifica separata. L’interruttore back office è indipendente da account e checkout nativo. Quando Checkout Revolution usa questo motore condiviso degli indirizzi, usa le stesse impostazioni per negozio di questo servizio.

Come funziona la lista su telefono e con la tastiera

Su telefono il cliente tocca un suggerimento sotto il campo via. Le frecce spostano la selezione, Invio sceglie ed Escape o Tab chiude la lista. Il numero dei risultati viene annunciato ai lettori di schermo. La lista condivisa supporta la presentazione Bootstrap 3, 4 e 5 e resta vicina ai campi già in uso.

La lista cita PDOK Locatieserver (Kadaster, BAG). Se non ci sono risultati utilizzabili resta chiusa e si può continuare a scrivere a mano. Se il servizio tarda a rispondere, sotto il campo della via appare per poco «Ricerca degli indirizzi…» e poi scompare; dopo 10 secondi senza risposta, scrivi semplicemente l’indirizzo a mano. Un errore di rete o del servizio può mostrare un breve messaggio senza obbligare a scegliere. Il cliente controlla comunque la destinazione: i suggerimenti non validano l’indirizzo all’invio e non garantiscono la consegna.

Richieste, indirizzi salvati e privacy

La GET diretta del browser invia q (testo), rows=10, fq=type:(adres OR weg) e fl (lista fissa dei campi). Non invia chiave, parametro del paese selezionato, lingua della pagina o identificatore di sessione. Non aggiunge esplicitamente nome, email, telefono, azienda o seconda riga; qualunque testo nella ricerca diventa parte della richiesta. Le credenziali tra origini sono disattivate.

PDOK riceve l’IP tramite la connessione e può ricevere informazioni sul browser (intestazioni Origin e Referer) secondo le regole del browser. Descrivi il trasferimento nell’informativa privacy. Il modulo non stabilisce consenso, conformità legale o conservazione del fornitore. Non implementa un proxy di ricerca o una cronologia degli indirizzi nel negozio. Il salvataggio ordinario rimane quello di PrestaShop.

La lista mostra PDOK Locatieserver (Kadaster, BAG). Non viene mostrata un’ulteriore attribuzione CC BY. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.

Limiti da conoscere

• Copertura. Solo Paesi Bassi europei. Niente Caraibi olandesi o garanzia di dati completi, aggiornati e risultati per ogni CAP e numero.
• Disponibilità. Rete, browser, CSP o PDOK possono fermare i suggerimenti. Un 429 impone Retry-After o dieci secondi di pausa; tempo di attesa di dieci secondi. Nessun cambio servizio automatico.
• Scelta incompleta. Una sola via svuota il CAP e non ha numero. Completa a mano. I formati non validi vengono scartati.
• Moduli nativi. Finestre personalizzate di account, ordine e checkout e temi particolari richiedono verifica. Il nuovo ordine si rivolge ad AdminAddresses.
• Campi conservati. Paese, seconda riga, nome, azienda e telefono restano invariati. PDOK non fornisce provincia.
• Protezioni. Paese o campi cambiati, campi mancanti e valori troppo lunghi possono impedire una compilazione tardiva.
• Assegnazione e pacchetti. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione. Se hai installato un vecchio modulo indirizzi, i suggerimenti olandesi possono restare spenti e la pagina delle impostazioni del modulo ti indica quale modulo aggiornare.
• Inserimento manuale. Nessuna selezione obbligatoria, validazione all’invio, geolocalizzazione, mappa o garanzia di consegna. Gli aggiornamenti a vita non includono un impegno di assistenza.

Se non compaiono suggerimenti

• Nessun suggerimento: verifica Paesi Bassi, interruttori generale e della pagina, destinazioni attive e Integrità. Se hai installato un vecchio modulo indirizzi, i suggerimenti olandesi possono restare spenti e la pagina delle impostazioni del modulo ti indica quale modulo aggiornare.
• Blocco CSP: consenti https://api.pdok.nl in connect-src mantenendo le regole per script e stili del negozio. Controlla la console; l’esempio non è una policy completa.
• CAP o aggiunta mancanti: scegli un risultato completo. Una sola via richiede dati manuali; i formati errati sono scartati. Non modificare una schermata per inventare risultati.
• Altro paese o servizio: PDOK è fisso su NL. Gli altri servizi conservano la configurazione. Evita liste scelte sovrapposte; nessun passaggio dopo errore.
• Servizio assente o compilazione rifiutata: attendi dopo un limite, controlla rete e campi e continua a mano. I suggerimenti non bloccano l’invio e non confermano la consegna.