Polish Address Autocomplete

Polish Address Autocomplete ist ein kostenloses PrestaShop-Modul für Adressen in Polen. Ein gewählter PRG-Adresspunkt füllt Straße mit gelieferter Hausnummer, PLZ im Format NN-NNN und Ort. GUGiK liefert nationale Registerdaten über CAPAP ohne Konto, Schlüssel oder Kosten pro Abfrage. Wohnungsnummern ergänzen Kunden selbst.

Schnellstart

1. Installieren Sie das Modul-ZIP. Kein GUGiK-Konto, Schlüssel oder Zahlungsschritt nötig.
2. Öffnen Sie Konfigurieren oder den Eintrag Polish Address im Backoffice-Menü; wählen Sie im Multishop einen Shop, den Sie verwalten dürfen.
3. Prüfen Sie, dass Polen aktiv und in Ihren nativen Adressformularen verfügbar ist.
4. Wählen Sie Haupt-, Konto-, Bestellvorgang- und Backoffice-Schalter in dieser Reihenfolge und speichern Sie. Keine Länderauswahl hier.
5. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand.
6. Ergänzen Sie bei Bedarf die CSP um GUGiK und erwähnen Sie die Browserverbindung im Datenschutzhinweis.
7. Wählen Sie Polen und tippen Sie Marszałkowska 100 Warszawa. Prüfen Sie nach der Auswahl Marszałkowska 100/102, 00-026 und Warszawa, sofern geliefert. Ergänzen Sie Wohnungen selbst. Testen Sie auch Dorf ohne Straßen, reine Straße, manuelle Eingabe, Gäste, Rechnung, Mitarbeiter/neue Bestellung, Frankreich mit French Address Autocomplete und Smartphone.

Funktionen

• Polnische Adressvorschläge. Amtliche GUGiK-PRG-Daten in nativen Konto- und Bestellformularen, auch für Gäste.
• Zusammen ausgefüllt. Straße und gelieferte Hausnummer, NN-NNN-PLZ und Ort.
• Fest auf Polen. Auch Dörfer ohne Straßen; reine Straßen und Wohnungsnummern ergänzen Sie selbst.
• Backoffice. Dieselbe Adresshilfe für Mitarbeiter unter Kunden > Adressen.
• Alltagseingabe. Berührung, Tastatur und Ansagen für Bildschirmleseprogramme; manuelle Eingabe bleibt möglich.
• Kein Dienstkonto. Kostenloses Modul und nationale Daten, vier Schalter und kein Schlüssel.

Konfigurationsoptionen

• Adressen vorschlagen, während der Kunde tippt: Hauptschalter, zuerst im Formular.
• Im Adressformular des Kundenkontos: native Kundenadressen.
• In den Adressformularen des Bestellvorgangs (auch für Gäste und separate Rechnungsadressen): einschließlich Gästen und separaten Rechnungsadressen.
• Im Adressformular des Back-Office (Kundenadressen, neue Bestellungen): Kundenadressen und native neue Bestellungen.

Öffnen Sie Konfigurieren im Modul-Manager oder den Eintrag Polish Address im Backoffice-Menü. Die Einstellungsseite enthält Konfiguration, Integrität, Lizenz, Aktualisierung und Unterstützung in dieser Reihenfolge. Es folgen die vier Schalter in obiger Reihenfolge und Speichern. Alle sind standardmäßig an. Kein Dienstschlüssel-, Konto- oder Länderfeld. Wählen Sie im Multishop einen Shop, den Sie verwalten dürfen. Einstellungen gelten je Shop. Nach dem Formular folgen Hinweise zu Abdeckung/kostenlosem Dienst, manueller Eingabe, Datenschutz, CSP und Geschwisterdiensten. Einstellungstexte sind auf Englisch, Deutsch, Französisch, Polnisch, Italienisch und Spanisch vorhanden. Das sind Oberflächensprachen, keine Zusage übersetzter Adressdaten.

Für diese Länder verwenden gibt es nur bei weltweiten Geschwistermodulen. Leer bedeutet alle Länder des Formulars; eine Auswahl begrenzt dieses Geschwistermodul. GUGiK bleibt fest auf PL. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand. Lassen Sie etwa einen weltweiten Dienst für andere Länder aktiv und aktivieren Sie Polish Address für Polen. Es gibt keinen automatischen Wechsel nach einem Suchfehler.

Anpassungsbeispiele

GUGiK in einer Inhaltssicherheitsrichtlinie erlauben

Erlauben Sie https://capap.gugik.gov.pl in connect-src. Dies ist die GUGiK-Adresse des Moduls und der bereitgestellten Dienstabfragen. Skripte und Stile kommen vom Shop. Ergänzen Sie Ihre bestehende Richtlinie und behalten Sie Regeln des Themes, eingebettete Stile/Sicherheitskennungen und andere Module bei. Für French Address Autocomplete erlauben Sie zusätzlich https://data.geopf.fr in connect-src. Prüfen Sie die tatsächlichen Browseranfragen im Shop. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand.

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

Wohnungs- und Lieferdetails behalten

Land, zweite Adresszeile, Name, Firma und Telefon bleiben erhalten. PRG enthält keine Wohnungsnummern: ergänzen Sie diese nach der Auswahl oder lassen Sie Wohnung, Stockwerk und Eingang in Zeile zwei. Die Auswahl ersetzt die Straßenzeile durch den gelieferten Eintrag; eine dort eingetippte Wohnungsnummer wird nicht übernommen. Prüfen Sie Hausnummer, PLZ und Ort vor dem Speichern. Eine reine Straßenauswahl leert die PLZ; Nummer und PLZ müssen ergänzt werden.

Installation

Voraussetzungen

• Allgemeiner PrestaShop-Bereich: PS 1.6 – 9.x. Deklariertes Minimum: PrestaShop 1.6.1.0 und PHP ab 7.1.
• Native Adressfelder mit Bootstrap 3, 4 oder 5. Polen muss verfügbar sein; aktivieren Sie es, wenn Sie dorthin liefern.
• Prüfen Sie, dass Polen aktiv und in Ihren nativen Adressformularen verfügbar ist.

Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand. Polish Address funktioniert allein.

Testen Sie die tatsächlich verwendeten Formulare und das Shop-Theme. Bewahren Sie die Browseranfragen bei Ihren Bereitstellungsprüfungen auf. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand.

Funktionsweise

Vorschläge starten nach drei Zeichen und 300 ms Pause. Der Browser sendet eine direkte GET-Anfrage an GUGiK CAPAP ref/qn: normalisierter Suchtext in q, f=json, offs=0, cnt=10, festes polnisches Suchgebiet, bboxm=soft, top=and und useExtSvc=true. Mit einer Ziffer wird idx=pkt für Adresspunkte verwendet, sonst idx=ulc für Straßen. Gegebenenfalls übermittelt ref/ac das letzte Wort in b, leeres a, cnt=5 und idx=pkt,ulc; bis zu zwei ergänzte Suchen folgen. Das erste gültige, nichtleere Ergebnis beendet die anderen Anfragen. Bis zu fünf eindeutige Vorschläge erscheinen zweizeilig: Straße/Ort und Nummer, dann PLZ und Ort.

Bei ausstehender Suche erscheint nach 600 ms die einfache Zeile „Adressen werden gesucht…“. Jede einzelne Anfrage bricht nach zehn Sekunden ab; eine Kette ergänzender Anfragen kann insgesamt länger dauern. Zu Stoßzeiten kann der Dienst langsamer sein; der Abdeckungshinweis nennt auch eine kurze nächtliche Pause. Kunden können jederzeit von Hand eingeben und bearbeiten.

Felder der gewählten Adresse

Ein Adresspunkt füllt Straße und Hausnummer wie geliefert, etwa Marszałkowska 100/102, PLZ 00-026 und Ort Warszawa. Der Schrägstrich gehört hier zur gelieferten Hausnummer und ist keine Wohnungssuche. Besondere Straßentypen bleiben erhalten, etwa pl. Zamkowy; Aleje in Aleje Jerozolimskie wird nicht verdoppelt. Ohne Straße werden Ortsname und Nummer verwendet. Der PRG-Ort kann vom Postort abweichen. Adresspunkte benötigen Ort, eine nichtleere Hausnummer, PLZ im Format NN-NNN und, falls angegeben, den Status eines bestehenden Punkts. Ungültige Einträge entfallen. Reine Straßenvorschläge werden bei Suchtext ohne Ziffer genutzt; sie füllen Straße und Ort und leeren die PLZ. Die Auswahl verwendet bereits gelieferte Daten ohne weiteren Abruf. Kein gesonderter Postort-, Bezirks- oder Provinzabruf.

Für diese Länder verwenden gibt es nur bei weltweiten Geschwistermodulen. Leer bedeutet alle Länder des Formulars; eine Auswahl begrenzt dieses Geschwistermodul. GUGiK bleibt fest auf PL. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand. Lassen Sie etwa einen weltweiten Dienst für andere Länder aktiv und aktivieren Sie Polish Address für Polen. Es gibt keinen automatischen Wechsel nach einem Suchfehler.

Unter Kunden > Adressen können Mitarbeiter polnische Adressen nach einer telefonischen Anfrage schneller erfassen. Ein Vorschlag füllt Straße, PLZ und Ort. Der Backoffice-Schalter arbeitet unabhängig von Kundenkonto und Bestellvorgang.

Der Code berücksichtigt auch native Adressfenster neuer Bestellungen, wenn sie über die Kundenadressseite laufen. Eigene Routen und Fremdformulare benötigen eine Prüfung. Die mitgelieferte Engine unterstützt markierte Checkout-Adressformulare und nutzt mit Checkout Revolution gemeinsame Diensteinstellungen je Shop.

Auf dem Smartphone tippen Ihre Kunden auf einen Vorschlag. Mit den Pfeiltasten wird navigiert, Enter wählt aus, Escape oder Tab schließt die Liste. Screenreader erhalten Ergebnisansagen. Die gemeinsame Liste verwendet die Bootstrap-Darstellung des Themes.

Unter den Treffern steht GUGiK (PRG). Ohne Treffer bleibt die Liste geschlossen; ein Dienstausfall wird angesagt. Eingabe und Bearbeitung von Hand bleiben möglich. Speichern verlangt keinen Vorschlag und führt keine Lieferadressprüfung aus.

Datenschutz und Datenquelle

Der Browser übermittelt den Suchtext, feste Suchoptionen und gegebenenfalls Wortergänzungen direkt an GUGiK unter https://capap.gugik.gov.pl. Er fügt keine Parameter für Schlüssel, gewähltes Land, Sprache, Name, E-Mail, Telefon, Firma oder Zeile zwei hinzu. Alles im Suchfeld wird übertragen. Anmeldedaten werden nicht mitgesendet. Die direkte Verbindung übermittelt IP und Browserinformationen; Herkunft und verweisende Seite richten sich nach den Browserregeln. Keine Suchhistorie oder Shop-Weiterleitung; Diagnoseprotokolle enthalten weder Suchtexte noch gelieferte Adressen. Gewählte Adressen speichert PrestaShop normal. Ergänzen Sie Ihren Datenschutzhinweis. Sichtbarer Quellenhinweis: GUGiK (PRG).

Grenzen des Moduls

• Abdeckung und Erreichbarkeit hängen von GUGiK ab. Weder jede Adresse noch durchgehender Betrieb sind zugesagt. Kein vollständiges PLZ-Verzeichnis oder unbegrenztes Nutzungsversprechen.
• PRG enthält keine Wohnungen. Ergänzen Sie sie nach der Auswahl oder in Zeile zwei. Der Ort kann vom Postort abweichen. Adresspunkte benötigen eine gültige NN-NNN-PLZ; reine Straßen müssen Sie um Nummer und PLZ ergänzen.
• Bei 429 gilt Retry-After oder eine Pause von zehn Sekunden. Jede Anfrage hat zehn Sekunden Zeit; verkettete Suchen können länger dauern. Manuelle Eingabe bleibt möglich, ohne automatischen Dienstwechsel.
• Prüfen Sie eigene Formulare/Themes und anders geroutete Fenster für neue Bestellungen. Eigene Checkout-Formulare benötigen eine Integration mit der gemeinsamen Engine.
• Keine Karte, Standortabfrage, Koordinatenspeicherung, Prüfung beim Absenden, automatische Länderwahl oder Liefergarantie. Kostenlos mit lebenslangen Aktualisierungen, ohne enthaltene Unterstützungszusage.

Fehler eingrenzen

• Keine polnischen Treffer: Polen, Aktivierung und Haupt-/Formularschalter prüfen; vollständige Straße mit Nummer und Ort eingeben.
• Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand.
• Reine Straße oder kein Treffer: Ergänzen Sie Hausnummer, PLZ und Postort von Hand und prüfen Sie die Adresse vor dem Speichern.
• Dienst nicht verfügbar: Netzwerk/CSP für GUGiK prüfen, bei Anfragelimit warten und manuell fortfahren.
• Eigenes Formular oder Layout: natives Formular, Tastatur/Smartphone und Bestellroute testen; gemeinsame Diensteinstellungen des gewählten Shops prüfen.