Spanish Address Autocomplete: Einrichtung und Hilfe

• Spanische Straßenvorschläge. Amtliche CartoCiudad-Daten in nativen Konto- und Checkout-Formularen, auch für Gäste.
• Gemeinsam ausgefüllt. Straße mit Nummer, PLZ, Ort und passende spanische Provinz aus der gewählten Adresse.
• Festes Gebiet Spanien. Festland, Balearen, Kanaren, Ceuta und Melilla, abhängig von den gelieferten Daten.
• 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.

• 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 Spanish 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, Provinzen, manueller Eingabe, Datenschutz, CSP und verwandten Adressdiensten. Einstellungstexte sind auf Englisch, Deutsch, Französisch, Polnisch, Italienisch und Spanisch vorhanden; dies beschreibt keine sechs Adressdatensprachen.

Für diese Länder verwenden gibt es nur bei weltweiten Adressmodulen. Leer bedeutet alle Länder des Formulars; eine Auswahl begrenzt dieses Modul. CartoCiudad bleibt fest auf ES. 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.

CartoCiudad in einer Inhaltssicherheitsrichtlinie erlauben

Aus dem Code abgeleitet: https://www.cartociudad.es 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 CartoCiudad-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://www.cartociudad.es;

Wohnungs- und Lieferdetails behalten

Tragen Sie Wohnung oder Stockwerk vor der Auswahl in Zeile zwei ein. Diese bleibt erhalten. Prüfen Sie Hausnummer, PLZ, Ort und Provinz vor dem Speichern. Ein reiner Straßentreffer kann die PLZ leeren und ohne Nummer bleiben. Das Modul installiert keine Provinzoptionen und erzwingt keine Auswahl.

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. Spanien muss verfügbar sein; aktivieren Sie es, wenn Sie dorthin liefern.
• Für Provinzen prüfen Sie International > Länder & Regionen > Staaten und das spanische Lokalisierungspaket. Kein Dienstkonto oder Schlüssel nötig.

Läuft neben French Address Autocomplete, Google Address Autocomplete und Fetchify Address Autocomplete; halten Sie alle Module auf dem neuesten Stand. Spanish 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.

Nach drei Zeichen und 300 ms Pause sendet der Browser einen GET mit Suchtext q und limit=10 an CartoCiudad. Der Adapter filtert doppelte und unpassende Ergebnisse und zeigt bis zu fünf Vorschläge. Nummerierte Adressen haben Vorrang; reine Straßen erscheinen nur ohne Ziffern in der Suche. Die Auswahl nutzt die bereits gelieferte Adresse ohne weiteren Abruf.

Felder der gewählten Adresse

Portal-Ergebnisse füllen Straße und Nummer in address1, die fünfstellige postalCode in postcode und poblacion oder muni in city. INE-Provinzcodes 01 bis 52 werden spanischen Gebietscodes zugeordnet; Namen dienen als Ersatz für passende native Optionen. Großschreibung wird lesbar formatiert, fehlende Akzente nicht ergänzt. Buchstaben und BIS an Nummern bleiben erhalten, Zugangspunkt-Erweiterungen entfallen. Ein reiner Straßentreffer kann die PLZ leeren. Land, Zeile zwei sowie persönliche, Firmen- und Telefonfelder werden nicht gefüllt.

Für diese Länder verwenden gibt es nur bei weltweiten Adressmodulen. Leer bedeutet alle Länder des Formulars; eine Auswahl begrenzt dieses Modul. CartoCiudad bleibt fest auf ES. 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 spanische Adressen nach einer telefonischen Anfrage schneller erfassen. Ein Vorschlag füllt Straße, PLZ, Ort und eine passende Provinz. 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 CartoCiudad CC BY 4.0 scne.es. Ohne Treffer bleibt die Liste geschlossen; ein Dienstausfall wird angesagt. 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. Eingabe und Bearbeitung von Hand bleiben möglich. Speichern verlangt keinen Vorschlag und führt keine Lieferadressprüfung aus.

Datenschutz und Datenquelle

Die Abfrage enthält keine Dienstzugangsdaten oder zusätzlichen persönlichen Formularfelder. Alles im Suchfeld wird als q gesendet. Die direkte Verbindung übermittelt IP und gegebenenfalls Browserinformationen (Header Origin und Referer) gemäß Browserregeln. Zugangsdaten sind deaktiviert, Zeitlimit zehn Sekunden. Das Modul führt keinen Suchverlauf oder Shop-Proxy; Diagnoseprotokolle lassen Suchtexte und Adressen aus. Gespeicherte Adressen laufen normal über PrestaShop. Erwähnen Sie dies im Datenschutzhinweis. Sichtbare Datenquelle: CartoCiudad CC BY 4.0 scne.es.

• Daten und Erreichbarkeit hängen von CartoCiudad ab. Keine vollständige Adressliste, dauernde Verfügbarkeit oder unbegrenzte Nutzung zugesagt. Kein vollständiges Postleitzahlenverzeichnis.
• Nummerierte Ergebnisse brauchen eine brauchbare PLZ. Bei reinen Straßen ergänzen Sie Nummer und PLZ; passende Provinzen müssen vorhanden sein.
• 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. 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.

• Keine spanischen Treffer: Spanien, 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.
• Fehlende Provinz oder PLZ: Lokalisierung und native Optionen prüfen; reine Straßen manuell vervollständigen.
• Dienst nicht verfügbar: Netzwerk/CSP für CartoCiudad 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.