Polish Address Autocomplete: configurazione e aiuto

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.

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.

Polish Address: quattro interruttori e note su copertura, inserimento manuale, riservatezza e CSP

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.

Ricerca a Varsavia Marszałkowska 100 Warszawa con suggerimenti GUGiK PRG in PrestaShop

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.

Indirizzo polacco scelto: Marszałkowska 100/102, 00-026 Warszawa; seconda riga invariata

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.

Francia scelta nello stesso modulo, French Address Autocomplete risponde tramite BAN

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.

Suggerimenti polacchi GUGiK nel back office nativo Clienti › Indirizzi

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à.

Suggerimenti polacchi PRG su telefono con fonte GUGiK (PRG)

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.
Caricamento...
Torna su