Polish Address Autocomplete

Polish Address Autocomplete è un modulo PrestaShop gratuito per inserire indirizzi in Polonia. Il punto PRG scelto compila via con numero civico restituito, CAP NN-NNN e località. GUGiK fornisce i dati del registro nazionale tramite CAPAP senza account, chiave o costo per ricerca. Il cliente aggiunge il numero dell’appartamento.

Avvio rapido

1. Installa lo ZIP del modulo in PrestaShop. Nessun account GUGiK, chiave o pagamento da preparare.
2. Apri Configura, oppure la voce Polish Address nel menu del back office; in multinegozio scegli un negozio che puoi gestire.
3. Verifica che la Polonia sia attiva e disponibile nei moduli indirizzo nativi che usi.
4. Scegli nell’ordine gli interruttori generale, account, ordine 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 GUGiK in una CSP esistente e descrivi la connessione del navigatore nell’informativa sulla riservatezza.
7. Seleziona la Polonia e digita Marszałkowska 100 Warszawa. Dopo la scelta verifica Marszałkowska 100/102, 00-026 e Warszawa se restituiti. Aggiungi tu l’appartamento. Prova anche villaggio senza vie, sola via, inserimento manuale, ospiti, fatture, operatori/nuovo ordine, Francia con French Address Autocomplete e telefono.

Funzionalità

• Suggerimenti polacchi. Dati ufficiali GUGiK PRG nei moduli nativi di account e ordine, ospiti inclusi.
• Campi compilati insieme. Via e civico restituito, CAP NN-NNN e località.
• Polonia fissa. Anche villaggi senza vie; sole vie e appartamenti si completano a mano.
• Back office. Lo stesso aiuto per gli operatori in Clienti > Indirizzi.
• Inserimento quotidiano. Tocco, tastiera e annunci per lettori di schermo; resta l’inserimento manuale.
• Senza account del servizio. Modulo e dati nazionali 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, oppure la voce Polish Address nel menu del back office. La pagina contiene Configurazione, Integrità, Licenza, Aggiornamento e Assistenza in questo ordine. I quattro interruttori sopra sono seguiti da Salva e sono tutti attivi per impostazione predefinita. Nessun campo chiave, account o paese. In multinegozio scegli un negozio che puoi gestire; i valori sono salvati per negozio. Seguono note su copertura/servizio gratuito, inserimento manuale, riservatezza, CSP e servizi fratelli. I testi sono forniti in inglese, tedesco, francese, polacco, italiano e spagnolo. Sono lingue dell’interfaccia, non una promessa di dati indirizzo tradotti.

Usa per questi paesi è disponibile solo sui moduli mondiali. Vuoto significa tutti i paesi del modulo, una lista limita quel servizio. GUGiK rimane fisso su PL. 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 e attivare Polish Address per la Polonia. Nessun errore passa automaticamente a un altro servizio.

Esempi di personalizzazione

Consenti GUGiK nella politica di sicurezza dei contenuti

Consenti https://capap.gugik.gov.pl in connect-src, indirizzo GUGiK usato dal modulo e dalle prove del servizio fornite. Script e stili provengono dal negozio. Integra l’esempio nella politica esistente, mantenendo regole del tema, stili incorporati/codici monouso di sicurezza e altri moduli. Con French Address Autocomplete consenti anche https://data.geopf.fr in connect-src. Verifica le richieste del navigatore nel negozio. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.

script-src 'self';
style-src 'self';
connect-src 'self' https://capap.gugik.gov.pl;

Conserva appartamento e dettagli di consegna

Paese, seconda riga, nome, azienda e telefono restano invariati. PRG non contiene numeri di appartamento: aggiungili dopo la selezione o conservali in seconda riga con piano o ingresso. La scelta sostituisce la riga della via con l’indirizzo restituito; un appartamento digitato lì non viene mantenuto. Controlla civico, CAP e località prima di salvare. Scegliere una sola via svuota il CAP; numero e CAP vanno completati a mano.

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. La Polonia deve essere disponibile; attivala se consegni lì.
• Verifica che la Polonia sia attiva 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. Polish Address funziona da solo.

Prova i moduli e il tema effettivamente usati nel negozio. Conserva le richieste del navigatore con i controlli di distribuzione. 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 300 ms di pausa. Il navigatore invia una richiesta GET diretta a GUGiK CAPAP ref/qn: testo normalizzato in q, f=json, offs=0, cnt=10, area polacca fissa, bboxm=soft, top=and e useExtSvc=true. Con una cifra si usa idx=pkt per i punti indirizzo, altrimenti idx=ulc per le vie. Quando possibile, ref/ac invia l’ultima parola in b, a vuoto, cnt=5 e idx=pkt,ulc; possono seguire fino a due ricerche completate. Il primo risultato valido non vuoto interrompe le altre richieste. Appaiono fino a cinque suggerimenti distinti su due righe: via/località e numero, poi CAP e località.

Durante l’attesa, dopo 600 ms appare la semplice riga “Ricerca degli indirizzi…”. Ogni singola richiesta scade dopo dieci secondi; una sequenza di ricerche completate può durare di più. Nelle ore di punta il servizio può rallentare; la nota sulla copertura menziona anche una breve pausa notturna. Il cliente può sempre digitare o modificare l’indirizzo a mano.

Campi dell’indirizzo scelto

Un punto scelto compila via e civico come restituiti, ad esempio Marszałkowska 100/102, CAP 00-026 e località Warszawa. Qui la barra fa parte del civico e non indica una ricerca dell’appartamento. I tipi di strada particolari restano, come pl. Zamkowy, senza raddoppiare Aleje in Aleje Jerozolimskie. Senza via si usano località e numero. La località PRG può differire da quella postale. I punti richiedono località, civico non vuoto, CAP NN-NNN e, se presente, stato esistente. Le righe non valide vengono scartate. Le sole vie si cercano senza cifre; la scelta compila via e località e svuota il CAP. Si usano i dati già ricevuti senza un nuovo recupero. Nessuna ricerca separata di località postale, distretto o provincia.

Usa per questi paesi è disponibile solo sui moduli mondiali. Vuoto significa tutti i paesi del modulo, una lista limita quel servizio. GUGiK rimane fisso su PL. 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 e attivare Polish Address per la Polonia. Nessun errore passa automaticamente a un altro servizio.

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

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. Il motore incluso supporta i moduli indirizzo del checkout con i marcatori previsti e condivide le impostazioni dei servizi per negozio con Checkout Revolution.

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 è GUGiK (PRG). 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 navigatore invia il testo cercato, le opzioni fisse ed eventuali completamenti dell’ultima parola direttamente a GUGiK su https://capap.gugik.gov.pl. Non aggiunge parametri di chiave, paese scelto, lingua, nome, posta elettronica, telefono, azienda o seconda riga. Tutto ciò che viene scritto nella ricerca è trasmesso. Le richieste non inviano credenziali. La connessione espone IP e informazioni del navigatore; origine e pagina di provenienza seguono le sue regole. Nessuna cronologia delle ricerche o inoltro tramite il negozio; la diagnostica omette ricerche e indirizzi ricevuti. PrestaShop salva normalmente gli indirizzi scelti. Descrivi il trasferimento nell’informativa sulla riservatezza. Fonte visibile: GUGiK (PRG).

Limiti da conoscere

• Copertura e disponibilità dipendono da GUGiK. Non sono garantiti ogni indirizzo né un servizio continuo. Nessun elenco esaustivo di CAP o uso illimitato promesso.
• PRG non contiene appartamenti. Aggiungili dopo la scelta o in seconda riga. La località può differire da quella postale. I punti richiedono un CAP NN-NNN valido; le sole vie richiedono numero e CAP manuali.
• Le risposte 429 sospendono secondo Retry-After o per dieci secondi. Ogni richiesta scade dopo dieci secondi; una sequenza può durare di più. Inserimento manuale disponibile, senza passaggio automatico ad altri servizi.
• Verifica moduli e temi personalizzati e finestre di nuovo ordine su percorsi diversi. I moduli di checkout personalizzati richiedono l’integrazione con il motore condiviso.
• Nessuna mappa, geolocalizzazione, memorizzazione di coordinate, convalida all’invio, scelta automatica del paese o garanzia di consegna. Gratuito con aggiornamenti a vita, senza impegno di assistenza incluso.

Se non compaiono suggerimenti

• Nessun risultato polacco: controlla che la Polonia sia attiva 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 GUGiK, attendi dopo un limite e continua manualmente.
• Modulo o impaginazione personalizzata: prova modulo nativo, tastiera/telefono e percorso ordine; controlla le impostazioni dei servizi condivise per il negozio selezionato.