Estonian Address Autocomplete

Estonian Address Autocomplete ist ein kostenloses PrestaShop-Modul für Adressen in Estland. Ein gewählter Treffer füllt Straße mit gelieferten Haus-, Wohnungs- oder Gebäudenummern, fünfstellige PLZ und Ort. Maa- ja Ruumiamet liefert nationale ADS-Adressdaten über In-AKS ohne Konto, Schlüssel oder Kosten pro Abfrage.

Schnellstart

1. Installieren Sie das Modul-ZIP. Kein In-AKS-Konto, Schlüssel oder Zahlungsschritt nötig.
2. Öffnen Sie Konfigurieren oder den Eintrag Estonian Address im Backoffice-Menü und wählen Sie im Multishop einen Shop, den Sie verwalten dürfen.
3. Prüfen Sie, dass Estland 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 bei Bedarf die CSP um In-AKS und erwähnen Sie die Browserverbindung im Datenschutzhinweis.
7. Wählen Sie Estland und tippen Sie narva mnt 5 tallinn. Prüfen Sie nach der Auswahl Narva mnt 5, 10117 und Tallinn, wenn geliefert. Testen Sie auch Narva mnt 5-10, einen Hofnamen, reine Straßen, manuelle Eingabe, Gäste, Rechnungen, Mitarbeiter/neue Bestellungen, Frankreich mit French Address Autocomplete und Smartphone-Breite.

Funktionen

• Estnische Adressvorschläge. Amtliche In-AKS ADS-Daten in nativen Konto- und Checkout-Formularen, auch für Gäste.
• Gemeinsam ausgefüllt. Straße oder Hofname, Haus-/Wohnungsnummern, PLZ NNNNN und Ort.
• Feste Abdeckung: Estland. Nationale ADS-Daten, Wohnungen und Hofnamen; reine Straßen müssen Sie ergänzen.
• 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 nationalen 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 Estonian Address im Backoffice-Menü. Die eine Einstellungsseite enthält Konfiguration, Integrität, Lizenz, Update und Support. 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 weiteren Adressdiensten. Einstellungstexte sind auf Englisch, Deutsch, Französisch, Polnisch, Italienisch, Spanisch und Estnisch vorhanden; dies bedeutet nicht, dass Adressdaten in sieben Sprachen vorliegen.

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

Anpassungsbeispiele

In-AKS in einer Content Security Policy erlauben

Aus dem Code abgeleitet: https://aks.geoportaal.ee in connect-src. Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand. Es wird kein externes In-AKS-SDK oder Stylesheet geladen. Ergänzen Sie Ihre vorhandene Richtlinie und behalten Sie Theme-, Inline-/Nonce- und andere Modulregeln. Für French Address Autocomplete zusätzlich https://data.geopf.fr in connect-src erlauben.

script-src 'self';
style-src 'self';
connect-src 'self' https://aks.geoportaal.ee;

Wohnungs- und Lieferdetails behalten

Land, zweite Adresszeile, Name, Firma und Telefon bleiben erhalten. Eine gelieferte Wohnungsnummer bleibt in Zeile eins; zusätzliche Stockwerk- oder Eingangsangaben können Sie in Zeile zwei lassen. Prüfen Sie Straße oder Hofname, alle Nummern, PLZ und Ort vor dem Speichern. Ihre Kunden können das Ergebnis bearbeiten oder von Hand eingeben. Eine reine Straßenauswahl leert die PLZ; Hausnummer 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. Estland muss verfügbar sein; aktivieren Sie es, wenn Sie dorthin liefern.
• Prüfen Sie, dass Estland 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. Estonian 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 beginnen nach drei Zeichen und 300 ms Pause. Der Browser sendet einen direkten GET-Aufruf an Maa- ja Ruumiamet In-AKS mit results=10 und dem an den Rändern gekürzten Suchtext in address. Bis zu fünf eindeutige gültige Vorschläge erscheinen. Angefangene Ortsnamen gehen ohne lokale Erweiterung oder Parallelsuche an den Dienst; Ergebnisse und Reihenfolge hängen von ihm ab.

Bei einem langsamen Dienst erscheint nach 600 ms die einfache Zeile „Adressen werden gesucht…“ (englischer Quelltext: „Searching addresses…“). Nach zehn Sekunden endet die Anfrage; Sie können die Adresse weiter von Hand eingeben.

Felder der gewählten Adresse

Der Adapter übernimmt address1 aus aadresstekst und die fünfstellige postcode ohne Leerzeichen aus sihtnumber. city nutzt asustusyksus und omavalitsus: Bezirke mit linnaosa verwenden ihre Gemeinde, Städte verlieren linn, andere Siedlungen behalten beide Teile. Fehlt ein Teil, gilt der vorhandene; ohne Ort entfällt der Treffer. Wohnungs- und Gebäudezusätze in der Adresszeile bleiben erhalten; kort_nr wird nicht extra angehängt. Benannte Höfe benötigen keine Nummer. Adressen benötigen eine PLZ; Straßen mit liik 2 keine. Adressen haben Vorrang; Straßen erscheinen nur ohne getippte Ziffer und leeren bei Auswahl die PLZ. Getippte Zahlen müssen zugeordnet werden; eine verbundene Wohnungsnummer muss den Anfang des Hausnummernblocks bilden. Diese Filter prüfen keine Adresse. Zwei Zeilen zeigen Straße/Hof und Nummern, dann PLZ + Ort. Kein Bundesland wird geliefert. Die Auswahl braucht keinen weiteren Abruf.

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

Unter Kunden > Adressen können Mitarbeiter estnische 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. Die gemeinsame Adress-Engine unterstützt entsprechend gekennzeichnete Formulare, etwa von Checkout Revolution. Beide Module verwenden dieselben Diensteinstellungen pro 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 © Maa- ja Ruumiamet. 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 gekürzten Suchtext in address mit results=10 direkt an In-AKS unter https://aks.geoportaal.ee. Kein Schlüssel, Land, Sprache, Name, E-Mail, Telefon, Firma oder zweite Adresszeile wird als Parameter ergänzt. Alles im Suchfeld wird übertragen. Die direkte Verbindung legt die Besucher-IP offen und kann je nach Browserregeln Browser-, Herkunfts- oder Referrerinformationen übertragen. Zugangsdaten sind deaktiviert. Nach zehn Sekunden endet der Abruf; manuelle Eingabe bleibt. Kein Suchverlauf und kein Shop-Proxy; Diagnosen enthalten keine Suchtexte oder Antwortadressen. PrestaShop speichert die normale Adresse. Erwähnen Sie die Übertragung im Datenschutzhinweis. Sichtbare Quelle: © Maa- ja Ruumiamet.

Grenzen des Moduls

• Daten und Erreichbarkeit hängen von In-AKS ab. Keine vollständige Adressliste, dauernde Verfügbarkeit oder unbegrenzte Nutzung zugesagt.
• Adresszeilen benötigen Adresstext, Ort und fünfstellige PLZ; ein benannter Hof braucht keine Hausnummer. Fehlerhafte Zeilen entfallen. Reine Straßen erscheinen nur ohne gültige Adresse und ohne getippte Ziffer. Die Auswahl leert die PLZ; ergänzen Sie Hausnummer und PLZ von Hand. Zahlenfilter grenzen Ergebnisse ein, prüfen aber keine Adresse. Kontrollieren Sie jedes Feld vor dem Speichern.
• Bei 429 pausiert der Dienst nach Retry-After oder zehn Sekunden. Manuelle Eingabe bleibt möglich; kein automatischer Ersatzdienst.
• Eigene Formulare/Themes und abweichende Bestellfenster brauchen Tests. Eigene Checkout-Formulare benötigen eine Integration mit der gemeinsamen Adress-Engine.
• Keine Karte, Standortabfrage, Koordinatenspeicherung, Prüfung beim Absenden, automatische Länderauswahl oder Liefergarantie. Lebenslange Updates, keine enthaltene Supportzusage.

Fehler eingrenzen

• Keine estnischen Treffer: Estland, 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 In-AKS prüfen, bei Rate-Limit warten und manuell fortfahren.
• Eigenes Formular oder Layout: natives Formular, Tastatur/Smartphone und Bestellroute testen; gemeinsame Diensteinstellungen pro Shop prüfen.