Slovak Address Autocomplete

Slovak Address Autocomplete ist ein kostenloses PrestaShop-Modul für Adressen in der Slowakei. Eine gewählte Adresse füllt Straße und zurückgegebene Hausnummern, eine verfügbare PLZ im Format NNN NN und den Ort. Es nutzt offene Daten des Register adries des slowakischen Innenministeriums, ohne Konto, Schlüssel oder Kosten je Suche.

Schnellstart

1. Installieren Sie das Modul-ZIP. Kein MV SR-Konto, Schlüssel oder Zahlungsschritt nötig.
2. Öffnen Sie Konfigurieren oder den Eintrag Slovak Address im Backoffice-Menü; wählen Sie im Multishop einen Shop, den Sie verwalten können.
3. Prüfen Sie, dass die Slowakei 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 MV SR und erwähnen Sie die Browserverbindung im Datenschutzhinweis.
7. Wählen Sie die Slowakei und geben Sie Obchod 12 Bratis ein. Falls geliefert, wählen Sie Obchodná 512/12 und prüfen Sie 811 06 sowie Bratislava. Testen Sie auch ein Dorf ohne Straßen, eine fehlende PLZ, manuelle Eingabe, Gäste, Rechnungsadressen, Mitarbeiter/neue Bestellungen, Frankreich mit French Address Autocomplete und die Telefonansicht.

Funktionen

• Adressvorschläge für die Slowakei. Amtliche Register-adries-Daten in nativen Konto- und Bestellformularen, auch für Gäste.
• Gemeinsam ausgefüllt. Straße und zurückgegebene Hausnummern, verfügbare PLZ im Format NNN NN und Ort.
• Festes Gebiet Slowakei. Nationale Registeradressen, auch Dörfer ohne Straßen; fehlende PLZ müssen ergänzt werden.
• 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 Slovak 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 Geschwisterdiensten. Einstellungstexte sind auf Englisch, Deutsch, Französisch, Polnisch, Italienisch, Spanisch und Slowakisch vorhanden; dies bedeutet nicht, dass Adressdaten in sieben Sprachen vorliegen.

Für diese Länder verwenden gibt es nur bei weltweiten Geschwistermodulen. Leer bedeutet alle Länder des Formulars; eine Auswahl begrenzt dieses Geschwistermodul. MV SR bleibt fest auf SK. 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 Slovak Address für die Slowakei. Es gibt keinen automatischen Wechsel nach einem Suchfehler.

Anpassungsbeispiele

MV SR in einer Inhaltssicherheitsrichtlinie erlauben

Erlauben Sie https://rageo.minv.sk in connect-src, wie vom Adapter und den aufgezeichneten Dienstaufrufen verwendet. Skripte und Stile kommen aus Ihrem Shop. Ergänzen Sie die bestehende Richtlinie unter Beibehaltung der Theme-Regeln, eingebetteten Stile/Nonces und anderer Module. Für French Address Autocomplete erlauben Sie zusätzlich https://data.geopf.fr in connect-src. Prüfen Sie Anfragen und Richtlinie im Shop. Die Quellkennung data.gov.sk wird nicht als eigene Adresse aufgerufen. Für diese Länder verwenden gibt es nur bei weltweiten Geschwistermodulen. Leer bedeutet alle Länder des Formulars; eine Auswahl begrenzt dieses Geschwistermodul. MV SR bleibt fest auf SK. 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 Slovak Address für die Slowakei. Es gibt keinen automatischen Wechsel nach einem Suchfehler.

script-src 'self';
style-src 'self';
connect-src 'self' https://rageo.minv.sk;

Wohnungs- und Lieferdetails behalten

Land, zweite Adresszeile, Name, Firma und Telefon bleiben unverändert. Wohnung, Etage oder Eingang gehören in Zeile zwei. Die Auswahl ersetzt die Straßenzeile durch die zurückgegebene Adresse; ergänzen Sie zusätzliche Angaben danach. Prüfen Sie Hausnummern, PLZ und Ort vor dem Speichern. Wohnungsnummern oder Hausnamen werden nicht nachgeschlagen. Kunden können die Adresse jederzeit bearbeiten oder manuell eingeben.

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. Die Slowakei muss verfügbar sein; aktivieren Sie sie, wenn Sie dorthin liefern.
• Prüfen Sie, dass die Slowakei 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. Slovak 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 einer Pause von 300 ms. Der Browser sendet einen direkten JSON-POST an https://rageo.minv.sk/geocoder/api/v1/search mit normalisiertem text, categories:["adresa"] und size:50. Optionale Straßenpräfixe entfallen, námestie wird vereinheitlicht. Ein kurzer Anfang eines von 25 größeren Orten kann eine parallele Suche mit ausgeschriebenem Ort auslösen. Eine erkannte PLZ samt Hausnummer ergänzt einen WFS-GET an /geoserver/ows, gefiltert nach PLZ, Nummer und Straßen-/Ortswörtern. Zusammengeführte Ergebnisse werden nach Nummer, eingegebenem Ort und Großstadtfolge sortiert; höchstens fünf Vorschläge erscheinen.

Während Suche oder Auswahl ausstehen, erscheint nach 600 ms die schlichte Zeile „Adressen werden gesucht…“. Jede HTTP-Anfrage bricht nach zehn Sekunden ab. Suche und Auswahl sind getrennte Vorgänge, daher ist dies keine Gesamtfrist. Bei einer Anfragengrenze wird nach Retry-After oder zehn Sekunden pausiert. Kunden können immer manuell weiter eingeben oder bearbeiten.

Felder der gewählten Adresse

Die Auswahl füllt Straße und Hausnummern in der Schreibweise des Registers: súpisné/orientačné, etwa Obchodná 512/12. Einzelne verfügbare Nummern und Buchstaben bleiben erhalten. Die PLZ wird zu 811 06, der Ort zu Bratislava. Stadtbezirke von Bratislava und Košice werden auf den Stadtnamen gekürzt, ohne eine Postamtsnummer zu erfinden. Ohne Straße wird der Ortsteil oder das Dorf verwendet, etwa Horša 12 mit Levice oder Čičmany 123. Eine fehlende PLZ bleibt leer und muss manuell ergänzt werden. Normale Geocoder-Vorschläge zeigen zwei Zeilen: Straße/Ortsteil und Nummer, danach den zurückgegebenen Ort. Eine PLZ ist darin nicht enthalten. Eine normale Auswahl lädt einen strukturierten WFS-Datensatz anhand seiner Quellkennung. Ergebnisse einer PLZ-Suche enthalten bereits die Felder, zeigen PLZ und Ort in Zeile zwei und brauchen keinen weiteren Abruf. Gültige Details benötigen einen Ort und mindestens eine Hausnummer; fehlerhafte Datensätze werden abgelehnt. Reine Straßen werden nicht ausgefüllt. Fehlende PLZ leeren das Feld; eine Provinz wird nicht geliefert.

Für diese Länder verwenden gibt es nur bei weltweiten Geschwistermodulen. Leer bedeutet alle Länder des Formulars; eine Auswahl begrenzt dieses Geschwistermodul. MV SR bleibt fest auf SK. 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 Slovak Address für die Slowakei. Es gibt keinen automatischen Wechsel nach einem Suchfehler.

Unter Kunden > Adressen können Mitarbeiter slowakische 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 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 © Ministerstvo vnútra SR. 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 normalisierten Suchtext und feste Suchoptionen direkt an den Dienst des Innenministeriums unter https://rageo.minv.sk. Eine Ortsergänzung kann eine weitere Suche auslösen; PLZ-Suchen senden PLZ, Hausnummer und Straßen-/Ortswörter in WFS-Filtern. Eine normale Auswahl sendet die Quellkennung zum Adressabruf. Es kommen keine Parameter für Schlüssel, gewähltes Land, Seitensprache, Name, E-Mail, Telefon, Firma oder Zeile zwei hinzu. Eingaben im Suchfeld können nach Normalisierung übertragen werden. Anfragen senden keine Anmeldedaten. Die Verbindung übermittelt IP-Adresse und Browserinformationen; Herkunfts- und Verweisseitenangaben richten sich nach der Browserrichtlinie. Es gibt weder einen Shop-Proxy noch einen Suchverlauf; Diagnosen lassen Suchtexte und Ergebnisadressen aus. Nennen Sie die Übertragung in Ihren Datenschutzhinweisen. Sichtbarer Quellenhinweis: © Ministerstvo vnútra SR.

Grenzen des Moduls

• Abdeckung und Verfügbarkeit hängen vom Register adries ab. Weder jede Adresse noch ein durchgehend erreichbarer Dienst sind zugesichert. Kein vollständiges PLZ-Verzeichnis oder unbegrenztes Nutzungsversprechen.
• Die normale Vorschlagsliste enthält keine PLZ. Suchseiten und Ortsergänzungen sind begrenzt; ein Detailabruf kann unabhängig von der Suche scheitern. Fehlende PLZ müssen ergänzt werden.
• Hausnummern bleiben wie zurückgegeben. Keine Wohnungs- oder Hausnamensuche, kein Ausfüllen reiner Straßen und keine erfundene Postamtsnummer. Prüfen Sie die gewählte Adresse.
• Jede Anfrage endet nach zehn Sekunden; Suche und Auswahl sind getrennt. Anfragengrenzen lösen Pausen aus. Manuelle Eingabe bleibt, ohne automatischen Dienstwechsel.
• Eigene Formulare/Themes und anders geroutete Bestellfenster müssen geprüft werden. Eigene Checkout-Formulare benötigen eine Integration mit der gemeinsamen Engine. Keine Karte, Standortabfrage, Prüfung beim Absenden, automatische Länderwahl oder Liefergarantie. Kostenloses Modul mit lebenslangen Updates, ohne enthaltene Supportzusage.

Fehler eingrenzen

• Keine slowakischen Ergebnisse: Slowakei, aktiven Länderstatus und Haupt-/Formularschalter prüfen, dann volle Straße + Nummer + Ort versuchen.
• Versuchen Sie eine andere Schreibweise oder den ganzen Ort bei zu breiter Suche. Halten Sie alle Adressmodule aktuell.
• Keine Details oder fehlende PLZ: Straße, Nummer, PLZ und Ort manuell eingeben oder ergänzen und vor dem Speichern prüfen.
• Vorschläge nicht verfügbar: Browseranfragen und CSP für rageo.minv.sk prüfen, nach Anfragengrenzen warten und manuell fortfahren.
• Eigenes Layout: natives Formular, Telefon, Tastatur und neuen Bestellweg prüfen. Prüfen Sie die gemeinsamen Diensteinstellungen des gewählten Shops.