Belgian Address Autocomplete

Belgian Address Autocomplete ist ein kostenloses PrestaShop-Modul für belgische Adressen. Ein nummerierter Vorschlag füllt Straße und Hausnummer, vierstellige PLZ und Ort. Grundlage sind die amtlichen Adressregister von Flandern, Brüssel und Wallonien, ohne Konto, Schlüssel oder Kosten pro Abfrage.

Schnellstart

1. Installieren Sie das Modul-ZIP. Kein Dienstkonto, Schlüssel oder Zahlungsschritt nötig.
2. Öffnen Sie Konfigurieren oder den Eintrag Belgian Address im Backoffice-Menü und wählen Sie im Multishop einen berechtigten Shop.
3. Prüfen Sie, dass Belgien aktiv und in Ihren nativen Adressformularen verfügbar ist.
4. Wählen Sie Haupt-, Konto-, Checkout- 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 die drei regionalen Ursprünge in einer bestehenden CSP und nennen Sie die Browserverbindungen im Datenschutzhinweis.
7. Wählen Sie Belgien und tippen Sie rue royale 10 bru. Prüfen Sie Rue Royale 10, 1000, Bruxelles, wenn zurückgegeben. Ergänzen Sie die Box in Zeile zwei. Testen Sie reine Straßen, manuelle Eingabe, Gäste, Rechnungsadressen, Mitarbeiter/neue Bestellung, Frankreich mit French Address Autocomplete und Smartphonebreite.

Funktionen

• Belgische Adressvorschläge. Amtliche Regionalregister in nativen Konto- und Checkout-Formularen, auch für Gäste.
• Gemeinsam ausgefüllt. Straße und Hausnummer, vierstellige PLZ und Ort nach einer nummerierten Auswahl.
• Festes Gebiet Belgien. Flandern, Brüssel und Wallonien gemeinsam; Boxdetails und reine Straßen ergänzen Sie von Hand.
• Backoffice. Adresshilfe für Mitarbeiter unter Kunden > Adressen.
• Alltagstaugliche Eingabe. Touch, Tastatur und Ansagen für Screenreader; manuelle Eingabe bleibt möglich.
• Ohne Dienstkonto. Kostenloses Modul mit kostenlosen regionalen Daten, vier Schaltern und ohne 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 Belgian Address im Backoffice-Menü. Die eine Einstellungsseite enthält die Abschnitte Configuration, Integrity, License, Update und Support (englische Bezeichnungen). Die vier Schalter erscheinen in dieser Reihenfolge, danach Speichern. Alle sind standardmäßig an. Es gibt kein Dienstschlüssel-, Konto- oder Länderfeld. Wählen Sie im Multishop einen Shop, den Sie verwalten dürfen; die Einstellungen werden für diesen Shop gespeichert. Nach dem Formular folgen Hinweise zu Abdeckung/kostenlosem Dienst, manueller Eingabe, Datenschutz, CSP und verwandten Adressdiensten. Einstellungstexte sind auf Englisch, Deutsch, Französisch, Polnisch, Italienisch, Spanisch und Niederländisch vorhanden; dies bedeutet nicht, dass Adressdaten in sieben Sprachen vorliegen.

Für diese Länder verwenden gibt es nur bei weltweiten Adressmodulen. Leer bedeutet alle Länder des Formulars; eine Auswahl begrenzt dieses Modul. Belgian Address bleibt fest auf BE. 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. Es gibt keinen automatischen Wechsel nach einem Suchfehler.

Anpassungsbeispiele

Die drei belgischen Regionen in Ihrer Content Security Policy erlauben

Aus dem Code abgeleitete connect-src-Ursprünge: https://geo.api.vlaanderen.be, https://geoservices.irisnet.be und https://geoservices.wallonie.be. Es wird kein fremdes SDK oder Stylesheet geladen. Ergänzen Sie Ihre bestehende Richtlinie und behalten Sie Theme-Regeln, inline/nonces und andere Module bei. Mit French Address Autocomplete erlauben Sie zusätzlich https://data.geopf.fr in connect-src.

script-src 'self';
style-src 'self';
connect-src 'self' https://geo.api.vlaanderen.be https://geoservices.irisnet.be https://geoservices.wallonie.be;

Wohnungs- und Lieferdetails behalten

Land, zweite Adresszeile, Name, Firma und Telefon bleiben erhalten. Ergänzen oder behalten Sie Box, Wohnung, Stockwerk, Eingang und Gebäudedetails in Zeile zwei. Prüfen Sie Straße, Hausnummer, PLZ und Ort vor dem Speichern. Reine Straßenvorschläge brauchen noch eine Hausnummer. Bei Flandern wird dabei die PLZ geleert; Brüssel und Wallonien behalten eine zurückgegebene PLZ. Ergänzen Sie fehlende Angaben von Hand.

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. Belgien muss verfügbar sein; aktivieren Sie es, wenn Sie dorthin liefern.
• Prüfen Sie, dass Belgien 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. Belgian Address funktioniert allein.

Die Installation bestätigt keine Dienstverfügbarkeit oder sämtliche Plattform-/Theme-Kombinationen. 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. Vier direkte GET-Anfragen laufen parallel: Flandern, Brüssel auf Französisch und Niederländisch sowie Wallonien. Flandern nutzt c=10&q=..., Brüssel spatialReference=4326, festes language=fr oder nl und address, Wallonien address. Wortpräfix- und Zahlenfilter begrenzen unscharfe Treffer; Großschreibung und Akzente werden abgeglichen. Bis zu fünf unterschiedliche Ergebnisse werden abwechselnd aus den Diensten zusammengeführt, nach Straße, PLZ und Ort dedupliziert. Liefert Wallonien keinen passenden Treffer bei mindestens drei Suchwörtern, folgt einmal eine Anfrage ohne das letzte Wort; gefiltert wird weiter nach dem ganzen Text. Nur für Wallonien werden Apostrophe und Suchoperatoren zu Leerzeichen. Nach dem ersten brauchbaren Ergebnis bleiben langsameren Diensten höchstens eine Sekunde; andere Regionen können trotz eines Ausfalls Treffer liefern.

Nach 600 ms erscheint bei einer laufenden Suche die einfache Zeile „Adressen werden gesucht…“ (Quelltext: „Searching addresses…“). Jede HTTP-Anfrage endet nach zehn Sekunden. Die wallonische Wiederholung kann die Gesamtsuche verlängern; es gibt keine gemeinsame Zehn-Sekunden-Grenze. Ihre Kunden können währenddessen weiter von Hand eingeben.

Felder der gewählten Adresse

Die Auswahl füllt address1, postcode und city ohne weitere Abfrage. Flandern trennt Straße/Nummer von vierstelliger PLZ und Ort; Brüssel liefert Straße, Nummer, PLZ und Gemeinde getrennt; Wallonien verarbeitet Adressen der Stufe 4, stellt vorangestellte Nummern ans Ende und entfernt Unterstriche am Ortsende. Die PLZ bleibt vierstellig ohne Leerzeichen. Zurückgegebene Buchstaben oder Schrägstrichzusätze können erhalten bleiben; Boxnummern ergänzen Sie nach der Auswahl selbst. Eingegebene Boxdetails müssen zur zurückgegebenen Adresszeile passen und können zu keinem Treffer führen. Reine Straßen erscheinen nur ohne gültige nummerierte Adresse und ohne eingegebene Ziffer. Flandern leert bei Straßenauswahl die PLZ, Brüssel/Wallonien behalten sie, wenn vorhanden. Ergänzen Sie Hausnummer und fehlende PLZ. Keine Provinz und kein besonderer Modus für Orte ohne Straßen. Zwei Zeilen zeigen Straße/Nummer und danach PLZ/Ort.

Für diese Länder verwenden gibt es nur bei weltweiten Adressmodulen. Leer bedeutet alle Länder des Formulars; eine Auswahl begrenzt dieses Modul. Belgian Address bleibt fest auf BE. 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. Es gibt keinen automatischen Wechsel nach einem Suchfehler.

Unter Kunden > Adressen können Mitarbeiter belgische 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 Checkout.

Der Code berücksichtigt auch native Adressfenster neuer Bestellungen, wenn sie über die Kundenadressseite laufen. Eigene Routen und Fremdformulare benötigen eine Prüfung. Checkout Revolution kann dieselbe Engine für seine Adressformulare laden und diese Diensteinstellungen für den jeweiligen Shop mitverwenden.

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 © Digitaal Vlaanderen, paradigm.brussels, SPW. 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 sendet den Straßensuchtext an alle drei Regionen, mit q für Flandern und address für Brüssel/Wallonien. Feste Optionen sind Ergebniszahl, Raumbezug und die französische/niederländische Brüsseler Suche. Wallonien erhält bereinigten Text und eventuell eine verkürzte Wiederholung, weiterhin mit vollständigem Wortfilter. Kein Schlüssel, gewähltes Land, Seitensprache, Name, E-Mail, Telefon, Firma oder zweite Zeile wird als Parameter ergänzt. Alles im Suchfeld wird übertragen. Direkte Verbindungen zeigen Besucher-IP und gegebenenfalls Browser-/Origin-/Referrer-Daten nach Browserregeln. Credentials sind aus. Jede HTTP-Anfrage endet nach zehn Sekunden; eine Wiederholung kann die Suche verlängern. Auswahl erfolgt lokal. Keine Suchhistorie und kein Shop-Proxy; Diagnoseprotokolle enthalten keine Suchtexte oder Ergebnisadressen. PrestaShop speichert die Adresse regulär. Nennen Sie die Verbindungen im Datenschutzhinweis. Sichtbarer Hinweis: © Digitaal Vlaanderen, paradigm.brussels, SPW.

Grenzen des Moduls

• Regionalregister garantieren weder jede Adresse, Aktualität, ständige Erreichbarkeit noch unbegrenzte Nutzung. Aufzeichnungen bestätigen keine heutigen Ergebnisse oder Orte ohne Straßennamen.
• Unbekannte oder fehlerhafte Zeilen werden verworfen. Präfixe können längere Namen oder Nummern treffen. Box, Wohnung und Gebäudedetails ergänzen Sie nach der Auswahl selbst. Reine Straßen benötigen Hausnummer und eventuell PLZ; Flandern leert dabei die PLZ. Prüfen Sie die Adresse vor dem Speichern.
• HTTP 429 pausiert nur den betroffenen Host nach Retry-After oder zehn Sekunden; beide Brüsseler Sprachen teilen die Pause. Andere Regionen können Treffer liefern. Jede Anfrage endet nach zehn Sekunden, eventuell mit einer wallonischen Wiederholung. Manuelle Eingabe bleibt; kein Wechsel zu einem anderen installierten Dienst.
• Eigene Formulare/Themes und abweichende Bestellfenster brauchen Tests. Checkout Revolution kann die gemeinsame Engine verwenden.
• Keine Karte, Standortabfrage, Koordinatenspeicherung, Prüfung beim Absenden, automatische Länderauswahl oder Liefergarantie. Lebenslange Updates, keine enthaltene Supportzusage.

Fehler eingrenzen

• Keine belgischen Treffer: Belgien, 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 die Regionaldienste prüfen, bei Rate-Limit warten und manuell fortfahren.
• Eigenes Formular oder Layout: natives Formular, Tastatur/Smartphone und Bestellroute testen; Diensteinstellungen für diesen Shop prüfen.