Dutch Address Autocomplete

Dutch Address Autocomplete ergänzt PDOK Locatieserver Vorschläge in nativen PrestaShop Adressformularen für die europäischen Niederlande. Ein vollständiger gewählter Treffer füllt address1, postcode und city, erhält Hausbuchstabe oder Zusatz und formatiert die Postleitzahl als 1012 LG. Das Modul ist kostenlos mit lebenslangen Updates, ohne enthaltene Supportzusage. PDOK benötigt weder Konto noch Schlüssel oder Bezahlung je Abfrage.

Schnellstart

1. Laden Sie das ZIP in den Modul-Manager und installieren Sie es. Ein PDOK Konto oder Schlüssel ist nicht nötig.
2. Aktivieren Sie Niederlande als Ziel, wenn Sie dorthin liefern. Öffnen Sie Konfigurieren oder den Eintrag Dutch Address im Backoffice-Menü; wählen Sie bei Multishop einen Shop, den Sie verwalten dürfen.
3. Wählen Sie bei Multishop einen einzelnen berechtigten Shop. Öffnen Sie Konfiguration auf der gemeinsamen Einstellungsseite.
4. Wählen Sie Haupt-, Konto-, Checkout- und Backofficeschalter in dieser Reihenfolge und speichern Sie. Hier gibt es keine Dienstzugangsdaten oder Länderauswahl.
5. Ergänzen Sie gegebenenfalls https://api.pdok.nl in connect-src der bestehenden CSP und erläutern Sie die Übertragung im Datenschutzhinweis.
6. Wählen Sie Niederlande im nativen Formular. Geben Sie 1012 LG mit Hausnummer im Straßenfeld ein und wählen Sie einen tatsächlich zurückgegebenen vollständigen Treffer. Prüfen Sie Zusatz, Leerzeichen in der Postleitzahl und Ort.
7. Prüfen Sie manuelle Eingabe, Gäste, getrennte Rechnung, Kunden > Adressen, natives Bestelladressfenster, anderes Land, Telefon und Tastatur. Prüfen Sie die Browserkonsole. Eine Suche beweist keine Adressgültigkeit.

Funktionen

• Niederländische Adresssuche. Straße oder Postleitzahl mit Hausnummer im vorhandenen Straßenfeld eingeben.
• Gemeinsam ausgefüllt. Straße, Hausnummer mit Buchstabe oder Zusatz, Postleitzahl und Ort nach der Auswahl.
• Amtliche Quelle. PDOK Locatieserver von Kadaster mit niederländischen BAG Adressdaten.
• Native Formulare. Kundenkonto, Gastbestellung, getrennte Rechnung und Kundenadressen im Backoffice.
• Alltägliche Eingabe. Antippen, Tastaturauswahl und Ergebnisansagen für Screenreader; manuelle Eingabe bleibt.
• Kostenloser Dienstzugang. Kein Konto, kein Schlüssel und keine Kosten je Abfrage; getrennte Formularschalter.

Konfigurationsoptionen

Die vier sichtbaren Schalter heißen in dieser Reihenfolge: Adressen vorschlagen, während der Kunde tippt; Im Adressformular des Kundenkontos; In den Adressformularen des Bestellvorgangs (auch für Gäste und separate Rechnungsadressen); Im Adressformular des Back-Office (Kundenadressen, neue Bestellungen). Sie sind standardmäßig an. Danach folgen Speichern sowie Hinweise zu Abdeckung, manueller Eingabe, Datenschutz und CSP. Ein ausgeschalteter Hauptschalter beendet Vorschläge in allen Formularen.

Öffnen Sie Konfigurieren im Modul-Manager oder den Eintrag Dutch Address im Backoffice-Menü. Diese Version hat eine Einstellungsseite mit Konfiguration, Integrität, Lizenz, Update und Support. Einstellungen gelten für einen Shop. Wählen Sie im Multishop einen einzelnen berechtigten Shop vor der Bearbeitung.

Es gibt weder einen Dienstschlüssel noch Für diese Länder verwenden. Diese Auswahl erscheint nur bei weltweiten Adaptern. Feste NL Abdeckung steht vor einem uneingeschränkten weltweiten Adapter. Eine gewählte überschneidende Liste kann vor PDOK stehen; vermeiden Sie dort NL, wenn PDOK antworten soll. Leere weltweite Listen bedeuten alle im Formular angebotenen Länder und ändern nicht Ihre Verkaufsziele.

Englischer Quelltext und niederländische, deutsche, französische, polnische, italienische und spanische Übersetzungen der Einstellungen sind vorhanden. Für aktuelle PDOK Hinweise fällt Englisch auf den Quelltext zurück.

Anpassungsbeispiele

PDOK in einer Content Security Policy erlauben

Die im Adapter ermittelte externe Verbindungsquelle ist https://api.pdok.nl. PDOK lädt kein externes SDK, Stylesheet oder Schriftart. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand. Führen Sie das Beispiel mit der vorhandenen Richtlinie zusammen und behalten Sie Regeln für eingebettete Konfiguration, Theme und andere Module. French Address Autocomplete benötigt zusätzlich https://data.geopf.fr in connect-src.

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

Wohnungs- und Lieferdetails erhalten

Tragen Sie Wohnung, Etage oder Lieferhinweis vor der Auswahl in Zeile zwei ein. Diese Zeile bleibt erhalten, ebenso Land, Kundenname, Firma und Telefon. Ergänzen Sie bei einer reinen Straße Nummer und Postleitzahl vor dem Speichern. Der Adapter liefert keine Provinz. Kunden können alle gewöhnlichen Felder weiterhin bearbeiten.

Installation

Voraussetzungen

• Allgemeiner PrestaShop Bereich: PS 1.6 – 9.x. Genaues erklärtes Minimum: PrestaShop 1.6.1.0; PHP 7.1 oder neuer.
• Native Adressfelder und Listenpräsentation mit Bootstrap 3, 4 oder 5. Eigene Themes und Formulare gesondert prüfen.
• Niederlande im Formular und aktive relevante Schalter. Kein PDOK Konto, Schlüssel oder Abfragekauf.

Ist ein älteres Adressmodul installiert, können niederländische Vorschläge ausgeschaltet bleiben; die Einstellungsseite des Moduls nennt das zu aktualisierende Modul. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand.

Funktionsweise

Vorschläge beginnen nach drei Zeichen und 300 ms Pause. Der Adapter sendet einen GET an PDOK suggest mit Suchtext, festen Adress- und Straßenfiltern und gewünschten Feldnamen. Er fordert zehn Datensätze an, entfernt fehlerhafte Einträge und Duplikate, bevorzugt vollständige Adressen und zeigt höchstens fünf. Reine Straßen erscheinen nur ohne vollständigen Treffer und ohne Ziffer in der Anfrage. Die Liste ist nicht vollständig.

Die Auswahl füllt direkt aus dem Vorschlag und sendet keine zweite Abfrage. Ein gültiger vollständiger Datensatz hat eine positive ganzzahlige Hausnummer, optional einen Buchstaben und einen alphanumerischen Zusatz von 1 bis 4 Zeichen, niederländische Postleitzahl und Ort. Nicht unterstützte Formate werden verworfen. Die Postleitzahl erhält Leerzeichen und Großbuchstaben; der Buchstabe folgt der Nummer, der Zusatz einem Bindestrich.

Welche Felder füllt ein gewählter Vorschlag aus

Ein vollständiger Treffer liefert Straße, Hausnummer samt zurückgegebenem Buchstaben oder Zusatz, Postleitzahl und Ort. Ein Buchstabe steht direkt an der Nummer, etwa 12A. Ein Zusatz folgt einem Bindestrich, etwa Damrak 12-H. Die Postleitzahl wird im PrestaShop Format mit Leerzeichen und Großbuchstaben ausgefüllt, etwa 1012 LG. Die Beispiele beschreiben das Format und sichern keinen Treffer zu.

Gewähltes Land, Name, Firma, Telefonnummer und vorhandene zweite Adresszeile bleiben unverändert. Kunden können dort Wohnung, Etage oder Lieferhinweise behalten und den Treffer bearbeiten. Ein reiner Straßenvorschlag enthält keine Hausnummer und Postleitzahl; diese Angaben müssen von Hand ergänzt werden. Dieser Adapter füllt keine Provinz aus.

Für welche Ziele erscheinen niederländische Vorschläge

PDOK Vorschläge gelten für die europäischen Niederlande bei im Formular gewähltem Land Niederlande. Das Modul bietet keine Abdeckung der niederländischen Karibik oder weltweite Adressdaten. Bei einem anderen Land enden die niederländischen Vorschläge. Ein anderer installierter Dienst kann nach seiner eigenen Abdeckung und Konfiguration antworten.

French Address Autocomplete kann seine französischen Ziele bedienen, während PDOK für die Niederlande antwortet. Google Address Autocomplete und Fetchify Address Autocomplete behalten ihre Ländereinstellungen. Feste Länderabdeckung steht vor einem uneingeschränkten weltweiten Dienst. Vermeiden Sie überschneidende gewählte Länderlisten. Nach einem Fehler erfolgt keine automatische Anfrage bei einem anderen Dienst.

Wo erhält Ihr Team Hilfe im Backoffice

Unter Kunden > Adressen erhält Ihr Team Vorschläge im nativen Straßenfeld. Mitarbeiter können Postleitzahl und Hausnummer aus einer telefonischen Anfrage eingeben, eine zurückgegebene Adresse wählen und Straße, Postleitzahl und Ort vor dem Speichern prüfen. Zurückgegebene Hausbuchstaben und Zusätze bleiben bei der Nummer erhalten.

Die Integration zielt außerdem auf das native Adressfenster einer neuen Bestellung, wenn AdminAddresses es bereitstellt. Andere Bestellfenster und eigene Konto- oder Checkoutformulare brauchen eine gesonderte Prüfung. Der Backofficeschalter ist unabhängig von Konto und nativem Checkout. Wenn Checkout Revolution diese gemeinsame Adressengine verwendet, nutzt es dieselben Einstellungen pro Shop für diesen Dienst.

Wie funktioniert die Liste auf dem Telefon und mit der Tastatur

Auf dem Telefon tippen Kunden einen Vorschlag unter dem Straßenfeld an. Pfeiltasten bewegen die Auswahl, Eingabe übernimmt sie und Escape oder Tab schließt die Liste. Screenreader erhalten eine Ansage zur Ergebniszahl. Die gemeinsame Liste unterstützt Bootstrap 3, 4 und 5 und bleibt neben den Feldern, die Ihre Kunden gerade ausfüllen.

Die Liste nennt PDOK Locatieserver (Kadaster, BAG) als Quelle. Ohne nutzbaren Treffer bleibt sie geschlossen, die manuelle Eingabe bleibt verfügbar. Wenn der Dienst langsam antwortet, erscheint unter dem Straßenfeld kurz „Adressen werden gesucht…“ und verschwindet dann wieder; nach 10 Sekunden ohne Antwort geben Sie die Adresse einfach von Hand ein. Ein Netzwerk- oder Dienstfehler kann einen kurzen Hinweis anzeigen, ohne eine Auswahl zu erzwingen. Kunden prüfen weiterhin das Lieferziel; die Hilfe validiert keine Adresse beim Absenden und garantiert keine Zustellung.

Anfragen, gespeicherte Adressen und Datenschutz

Der direkte Browser-GET sendet q (Suchtext), rows=10, fq=type:(adres OR weg) und fl (feste Feldliste). Er sendet weder Schlüssel noch gewählten Länderparameter, Seitensprache oder Sitzungskennung. Kundenname, E-Mail, Telefon, Firma und zweite Adresszeile werden nicht ausdrücklich eingefügt. Alles im Suchfeld wird Bestandteil der Anfrage. Herkunftsübergreifende Zugangsdaten sind ausgeschaltet.

PDOK erhält die Besucher-IP über die Verbindung und eventuell Browserinformationen (HTTP-Kopfzeilen Origin und Referer) nach Browserrichtlinie. Erläutern Sie die Übertragung im Datenschutzhinweis. Das Modul entscheidet weder über Einwilligung noch rechtliche Konformität oder Speicherdauer des Anbieters. Es implementiert keinen Suchproxy oder Adresssuchverlauf im Shop. Das normale Speichern bleibt PrestaShop überlassen.

Die Liste zeigt PDOK Locatieserver (Kadaster, BAG). Es wird kein zusätzlicher CC BY Hinweis angezeigt. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand.

Grenzen des Moduls

• Abdeckung. Nur europäische Niederlande. Keine niederländische Karibik oder Garantie vollständiger, aktueller Daten oder eines Treffers für jede Kombination.
• Dienstverfügbarkeit. Netzwerk, Browserrichtlinie, CSP oder PDOK Fehler können Vorschläge stoppen. Bei 429 gilt Retry-After oder zehn Sekunden Pause; Zeitlimit zehn Sekunden. Kein automatischer Dienstwechsel.
• Unvollständige Auswahl. Eine reine Straße leert die Postleitzahl und enthält keine Nummer. Ergänzen Sie Details manuell. Ungültige Formate werden verworfen.
• Native Formulare. Eigene Konto-, Checkout- und Bestellfenster oder Themes gesondert prüfen. Bestelladresshilfe zielt auf AdminAddresses.
• Erhaltene Werte. Land, zweite Zeile, Name, Firma und Telefon bleiben bestehen. PDOK liefert keine Provinz.
• Ausfüllschutz. Geänderte Länder oder Feldwerte, fehlende Felder und überlange Werte können eine spätere Übernahme verhindern.
• Zuordnung und Pakete. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand. Ist ein älteres Adressmodul installiert, können niederländische Vorschläge ausgeschaltet bleiben; die Einstellungsseite des Moduls nennt das zu aktualisierende Modul.
• Manuelle Eingabe. Keine Pflichtauswahl, Absendevalidierung, Geolokalisierung, Karte oder Zustellgarantie. Lebenslange kostenlose Updates enthalten keine Supportzusage.

Fehler eingrenzen

• Keine Vorschläge: prüfen Sie Niederlande, Haupt- und Formularschalter, aktive Shopziele und Integrität. Ist ein älteres Adressmodul installiert, können niederländische Vorschläge ausgeschaltet bleiben; die Einstellungsseite des Moduls nennt das zu aktualisierende Modul.
• CSP blockiert: erlauben Sie https://api.pdok.nl in connect-src und erhalten Sie die Skript- und Stilregeln des Shops. Prüfen Sie die Konsole; das Beispiel ist keine vollständige Richtlinie.
• Postleitzahl oder Zusatz fehlt: wählen Sie einen vollständigen Treffer. Reine Straßen benötigen manuelle Angaben; ungültige Formate werden verworfen. Erfinden Sie keinen Treffer durch Bildbearbeitung.
• Anderer Dienst oder anderes Land: PDOK ist fest NL zugeordnet. Andere Dienste behalten ihre Einstellungen. Vermeiden Sie Überschneidungen gewählter Listen; kein Wechsel nach Fehlern.
• Dienstfehler oder verweigerte Übernahme: warten Sie nach einem Limit, prüfen Sie Netzwerk und Felder und tippen Sie weiter. Vorschläge verhindern kein normales Absenden und bestätigen keine Zustellung.