Polish Address Autocomplete: configurazione e aiuto
Avvio rapido
- Installa lo ZIP del modulo in PrestaShop. Nessun account GUGiK, chiave o pagamento da preparare.
- Apri Configura, oppure la voce Polish Address nel menu del back office; in multinegozio scegli un negozio che puoi gestire.
- Verifica che la Polonia sia attiva e disponibile nei moduli indirizzo nativi che usi.
- Scegli nell’ordine gli interruttori generale, account, ordine e back office, poi salva. Qui non c’è selezione paesi.
- Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.
- Integra GUGiK in una CSP esistente e descrivi la connessione del navigatore nell’informativa sulla riservatezza.
- 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.
Manuale di configurazione
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.
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.
Domande
7
Polish Address Autocomplete è gratuito?
Sì. Il modulo è gratuito con aggiornamenti a vita, senza impegno di assistenza incluso. Le ricerche non richiedono account o chiave e non prevedono costi per ricerca.
Ti serve una chiave o un account?
No. Non ti servono né un account del servizio né una chiave API.
Quali paesi e campi sono coperti?
Per la Polonia compila via e civico, CAP NN-NNN e località. Se scegli solo una via, aggiungi numero e CAP a mano. Aggiungi l’appartamento dopo la scelta o in seconda riga; il paese scelto e gli altri campi restano invariati.
Funziona per ospiti, indirizzi di fatturazione e operatori?
Sì, nei moduli nativi di account e checkout, inclusi ospiti e indirizzi di fatturazione separati, e in Clienti > Indirizzi. Le finestre indirizzo dei nuovi ordini sono incluse quando passano da quella pagina; prova i moduli personalizzati.
Puoi usare più moduli indirizzo insieme?
Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione. PL e destinazioni BAN sono separate. Nessun passaggio automatico dopo un errore.
Cosa invia il browser a GUGiK?
Testo cercato, completamenti delle parole e opzioni fisse vanno direttamente a GUGiK, che vede anche IP e informazioni del browser del visitatore. Gli altri campi del modulo non vengono aggiunti.
Il cliente deve scegliere un suggerimento per salvare?
No. I clienti possono inserire, modificare e salvare gli indirizzi a mano, anche quando i suggerimenti non sono disponibili.
Problemi noti
Nessun problema noto
Al momento non ci sono problemi aperti o risolti registrati per questo modulo.
Richieste funzionalità
Ancora nessuna richiesta di funzionalità per questo modulo
Manca qualcosa? Proponilo e segui qui i progressi.
Registro modifiche
v1.0.02026-11-10
- Initialrelease.
- InitialPolish national address suggestions from PRG through GUGiK CAPAP, without account, key or lookup fee.
- InitialNative account, checkout, guest, separate invoice and back office address forms.
- InitialFill street and returned building number, NN-NNN postcode and locality; support villages without streets.
- InitialPreserve returned building-number ranges, street types and Roman numerals; customers add flats.
- InitialFull-text search with optional last-word completion; two-line suggestions and source credit GUGiK (PRG).
- InitialFour per-shop switches, fixed PL coverage and routing alongside other address services.
- InitialSearching status after 600 ms, ten-second timeout per request, rate-limit pauses and manual entry.
- InitialKeyboard and touch controls; English, German, French, Polish, Italian and Spanish settings.