Fetchify Address Autocomplete

Fetchify Address Autocomplete ergänzt native PrestaShop-Adressformulare um Fetchify-Vorschläge. Eine einzelne ausgewählte Adresse füllt address1, postcode, city und bei passender Option die native Bundesland- oder Provinzauswahl. Das Modul ist kostenlos; Fetchify rechnet Abfragen über Ihr eigenes Konto ab. Sie richten Ihr eigenes öffentliches Browser-Zugriffstoken ein.

Schnellstart

1. Erstellen oder öffnen Sie Ihr eigenes Fetchify-Konto für den Shop. Abfragen werden über dieses Konto abgerechnet.
2. Öffnen Sie Access Tokens & Statistics und kopieren Sie das für Ihren Shop vorgesehene Zugriffstoken.
3. Tragen Sie bei Fetchify unter Allowed Domains die tatsächliche Shop-Domain ein. Ergänzen Sie eine andere Backoffice-Domain, falls dort Vorschläge nötig sind. Das Token ist später im Browser öffentlich.
4. Laden Sie die Modul-ZIP in PrestaShop hoch und installieren Sie sie. Öffnen Sie Konfigurieren oder den Eintrag Fetchify Address im Backoffice-Menü; wählen Sie bei Multishop einen einzelnen Shop, den Sie verwalten dürfen.
5. Fügen Sie das Token unter Fetchify-Zugriffstoken ein. Wählen Sie unter Für diese Länder verwenden zum Beispiel Vereinigtes Königreich oder lassen Sie die Liste für alle Länder leer. Wählen Sie die Formularschalter und speichern Sie.
6. Ergänzen Sie bei Bedarf die Fetchify-Quelle in Ihrer CSP und erläutern Sie die Browserverbindung im Datenschutzhinweis.
7. Wählen Sie Vereinigtes Königreich in einem nativen Adressformular und geben Sie eine britische Postleitzahl ins Straßenfeld ein. Öffnen Sie gegebenenfalls eine Gruppe, wählen Sie eine einzelne Adresse und prüfen Sie die Felder. Testen Sie auch manuelle Eingabe, Gastbestellung, getrennte Rechnung, Kunden > Adressen, das native Adressfenster einer neuen Bestellung, ein anderes Land und Handybreite. Prüfen Sie Browserkonsole und Fetchify-Nutzung.

Funktionen

• Straßenvorschläge. Fetchify im nativen Kundenkonto und Bestellprozess, auch für Gäste.
• Gemeinsam ausgefüllt. Straße, Postleitzahl, Ort und bei passender nativer Option Bundesland oder Provinz aus dem gewählten Vorschlag.
• Gewähltes Land. Die Suche folgt dem Zielland im Adressformular.
• Backoffice. Eingabehilfe auf der nativen Seite für Kundenadressen.
• Im Alltag. Bedienung per Handy, Tastatur und Screenreader; manuelle Eingabe bleibt erhalten.
• Ihr Fetchify-Konto. Kostenloses Modul mit Formularschaltern; Fetchify berechnet Ihnen die Nutzung.

Konfigurationsoptionen

Öffnen Sie Konfigurieren im Modul-Manager oder den Eintrag Fetchify Address im Backoffice-Menü. Die Abschnitte heißen Konfiguration, Integrität, Lizenz, Update und Support, in dieser Reihenfolge. Konfiguration öffnet sich zuerst; das Fetchify-Zugriffstoken steht über den Schaltern und der Länderliste.

• Fetchify-Zugriffstoken: Ihr eigenes öffentliches Browser-Token von Fetchify. Beschränken Sie Allowed Domains in Ihrem Fetchify-Konto.
• Adressen vorschlagen, während der Kunde tippt: Hauptschalter.
• Im Adressformular des Kundenkontos: native Adresseingabe im Konto.
• In den Adressformularen des Bestellvorgangs (auch für Gäste und separate Rechnungsadressen): nativer Bestellprozess einschließlich Gästen und getrennter Rechnungsadresse.
• Im Adressformular des Back-Office (Kundenadressen, neue Bestellungen): Kunden > Adressen, auch ein darüber geöffnetes Adressfenster für neue Bestellungen.
• Für diese Länder verwenden: Leer bedeutet alle angebotenen Formularländer. Alternativ wählen Sie Fetchifys Länder. Ein Modul mit Länderliste antwortet vor einem weltweiten Modul. French Address Autocomplete behält seine feste Abdeckung, wenn es im Formular aktiv ist. Eine Warnung weist auf weltweit überlappende Einstellungen hin.

Die Schalter sind zunächst an, Fetchify benötigt aber ein gespeichertes Token. Leeren Sie es, stoppt dieser Adapter; die normale Adresseingabe bleibt nutzbar. Speichern prüft druckbare Tokenzeichen, keine Anmeldung bei Fetchify oder Domainfreigabe. Es gibt keine Schaltfläche für einen Live-Tokentest. Geben Sie Shop und gegebenenfalls abweichende Backoffice-Domain bei Fetchify frei.

Wählen Sie bei Multishop einen einzelnen Shop, für den Sie berechtigt sind. Die Werte werden für diesen Shop gespeichert. Hauptschalter und jeweiliger Formularschalter müssen aktiv sein. Ein ausgeschalteter Bestellschalter lässt die aktivierten Konto- und Backoffice-Funktionen bestehen.

Die Seite enthält Hinweise zu Abdeckung, Abrechnung, Datenschutz und CSP. Englisch ist die Quellsprache; deutsche, französische, polnische, italienische und spanische Einstellungstexte werden mitgeliefert. Diese Sprachliste beschreibt die Einstellungen des Moduls und verspricht keine Adressdaten in jeder Sprache.

Lädt ein anderes Modul eine ältere Adressengine und bleiben Fetchify-Vorschläge dadurch aus, meldet das Installationsprüfbanner ein Problem. Der Abschnitt Konfiguration nennt das zu aktualisierende Modul. Ein gespeichertes Token allein bestätigt keine betriebsbereite Engine.

Anpassungsbeispiele

Fetchify in einer Content Security Policy zulassen

Aus dem Quelltext ergibt sich https://api.craftyclicks.co.uk als externe Quelle für connect-src. Fetchify-Adapter, Adressengine, gemeinsame Felder und Vorschlagsliste werden vom Shop geladen; auch ihre Styles stammen vom Shop. Es gibt keinen externen Fetchify-Script- oder Stylesheet-Loader. Ergänzen Sie die bestehende Richtlinie und behalten Sie Regeln für Theme, Inline-Konfiguration und andere Module. 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://api.craftyclicks.co.uk;

Wohnungs- und Lieferdetails erhalten

Tragen Sie eine Wohnung oder Etage in die zweite Adresszeile ein und wählen Sie einen Vorschlag. Die zweite Zeile bleibt bestehen. Ergänzen Sie eine fehlende Hausnummer vor dem Speichern. Keine Einstellung erzwingt eine Auswahl; das Modul fügt keine Prüfung der abgesendeten Adresse hinzu.

Installation

Voraussetzungen

• Allgemeiner PrestaShop-Bereich: PS 1.6 – 9.x. Deklariertes genaues Minimum: PrestaShop 1.6.1.0; PHP ab 7.1.
• Native Adressfelder und ein Bootstrap-3-, -4- oder -5-Theme für die unterstützte Dropdown-Darstellung.
• Eigenes Fetchify-Konto und Zugriffstoken, mit Shop-Domain in Allowed Domains. Fetchify berechnet Abfragen über Ihr Konto.

Wenn ein anderes Adressmodul eine ältere Engine lädt und dadurch Vorschläge ausbleiben, aktualisieren Sie das auf der Einstellungsseite dieses Moduls genannte Modul.

Ein gespeichertes Token bestätigt nur die angenommene Syntax. Prüfen Sie Anmeldung, Allowed Domains und Kontoeinstellungen im Browser auf den tatsächlich genutzten Domains. Das Modul erstellt oder verwaltet kein Fetchify-Konto. Veröffentlichen Sie keinen Screenshot mit dem echten Token.

Funktionsweise

Vorschläge beginnen nach drei Zeichen und einer Pause von 300 ms. Das sind feste Werte. Eine britische Postleitzahl wird im gewöhnlichen Straßenfeld gesucht. Die Liste zeigt Fetchifys zurückgegebene Treffer; der Adapter begrenzt sie nicht auf fünf und bestätigt keine vollständige Postleitzahlliste.

Liefert Fetchify beide Teile, zeigt jeder Vorschlag zuerst die Adresse und darunter die Postleitzahl. Ein Ergebnis mit nur einer Bezeichnung bleibt einzeilig.

Bei einem langsamen Dienst erscheint „Adressen werden gesucht…“; nach zehn Sekunden endet die Anfrage und manuelle Eingabe bleibt möglich. Die Suchzeile verschwindet, sobald die Ergebnisse eintreffen.

Während der Eingabe sendet der Browser find. Die Auswahl einer Gruppe sendet erneut find mit Kennung und bisheriger Suche. Eine einzelne Adresse löst retrieve aus; line_1, line_2, postal_code, locality oder dependent_locality sowie Provinzfelder werden dem nativen Formular zugeordnet. Gruppen füllen noch keine Adresse. Für die USA fordert usa_exclude_zip_plus4: true fünfstellige ZIP-Codes an. Daraus folgt keine Zusage zu Tarifen oder Abfragekontingenten.

Welche Angaben werden bei einer Auswahl ausgefüllt

Das gewählte Land bleibt erhalten, ebenso eine bereits eingetragene Wohnung, Etage oder Zufahrt in der zweiten Adresszeile. Name, Unternehmen und Telefonnummer bleiben unangetastet. Kunden prüfen und bearbeiten das Ergebnis vor dem Speichern. Die Hilfe verkürzt die Eingabe und überlässt ihnen weiterhin die Kontrolle über ihre Adresse.

Für welche Länder erscheinen Fetchify-Vorschläge

Die Suche folgt dem gewählten Formularland und Ihrer Länderauswahl im Modul. Das Modul bietet Fetchify-Vorschläge für über 240 Länder. Tatsächliche Vorschläge hängen von Fetchifys Adressdaten, Ihrem Konto und der Verfügbarkeit ab. Ein angebotenes Land garantiert keine vollständige Straßen- oder Hausnummernliste.

Mit Für diese Länder verwenden legen Sie bei mehreren Adressmodulen den Dienst pro Land fest. Wählen Sie beispielsweise Fetchify für das Vereinigte Königreich und Google Address Autocomplete für den Rest. Ein Modul mit Länderliste antwortet dort vor einem weltweit belassenen Modul. French Address Autocomplete behält seine französischen Zielgebiete, wenn es im selben Formular aktiv ist. Leer bedeutet jedes im Formular verfügbare Land; die Verkaufsländer ändern sich dadurch nicht.

Wo hilft das Modul Ihrem Team im Backoffice

Unter Kunden > Adressen erscheinen Vorschläge auch im nativen Straßenfeld. Mitarbeiter wählen eine Adresse und übernehmen Straße, Postleitzahl, Ort und bei passender nativer Option Bundesland oder Provinz, etwa nach einer telefonischen Anfrage oder beim Vorbereiten einer Bestellung. Der Backoffice-Schalter ist unabhängig von Kundenkonto und Bestellprozess. Sie aktivieren die Unterstützung gezielt dort, wo Ihr Team sie benötigt.

Wie funktioniert die Auswahl auf dem Handy und per Tastatur

Auf dem Handy tippen Kunden auf einen Vorschlag unter dem Straßenfeld. Mit den Pfeiltasten bewegen sie sich durch die Liste, mit Enter wählen sie den markierten Eintrag. Escape oder Tab schließt die Liste ohne Auswahl. Liefert Fetchify beide Teile, zeigt jeder Vorschlag zuerst die Adresse und darunter die Postleitzahl. Ein Ergebnis mit nur einer Bezeichnung bleibt einzeilig. Die Darstellung folgt dem Dropdown-Stil des Themes und bleibt unmittelbar bei den Adressfeldern, statt eine Karte oder Suchseite zu öffnen.

Anfragen, gespeicherte Adressen und Datenschutz

Der Browser sendet öffentliches Zugriffstoken, Suchtext und gewählten Alpha-3-Ländercode an Fetchify. Bei einer Gruppe kommen Kennung und vorherige Suche hinzu; die Adressabfrage sendet Kennung, Token und Land. US-Anfragen enthalten die ZIP-Formatoption. Dieser Adapter sendet weder Seitensprache noch Suchsitzungstoken. Fetchify sieht die Besucher-IP über die Verbindung und je nach Browserrichtlinie Browserinformationen (Kopfzeilen Origin und Referer). Anfragen nutzen keine Zugangsdaten für fremde Ursprünge.

Name, E-Mail, Telefon, Unternehmen und zweite Adresszeile fügt das Modul diesen Abfragen nicht hinzu. Es leitet die Suche nicht über den Shopserver und speichert Suchtexte und Ergebnisse nicht in eigenen Tabellen. Das bedeutet nicht, dass Fetchify nichts speichert. Das spätere Speichern der Adresse bleibt der normale PrestaShop-Vorgang. Erläutern Sie die Übertragung im Datenschutztext; die Installation regelt Einwilligungsfragen und andere Datenschutzpflichten nicht automatisch.

Die Liste nennt Fetchify als Quelle. Optionale Engine-Diagnosen erfassen technischen Status, Anbieter, Land, Dauer und Ergebniszahl, keine getippten Adressen. Ein Suchverlauf wird dadurch nicht angelegt.

Grenzen des Moduls

• Öffentliches Token. Das pro Shop gespeicherte Zugriffstoken steht in der Browserkonfiguration. Beschränken Sie Allowed Domains bei Fetchify, prüfen Sie den Kontozugang und verbergen Sie das echte Token auf öffentlichen Screenshots.
• Abdeckung ohne Vollständigkeit. Die Suche folgt dem Land. Ergebnisse können fehlen, ohne Hausnummer oder Postleitzahl sein oder keine nutzbaren Straßen- und Ortsangaben enthalten.
• Native Formulare. Eigene Checkouts, fremde Fenster und Themes ohne Bootstrap brauchen eigene Tests. Das Bestellfenster wird über AdminAddresses angesprochen.
• Manuelle Eingabe. Vorschläge validieren die abgesendete Adresse nicht und garantieren keine Zustellung. Kunden prüfen das Ziel.
• Erhaltene Felder. Zweite Adresszeile, Name, Unternehmen, Telefon und gewähltes Land bleiben unverändert.
• Späte Antworten. Länderwechsel, geänderte Werte, fehlende Pflichtfelder oder zu lange Angaben können das Ausfüllen stoppen. Das Formular lässt sich von Hand ergänzen.
• Externer Dienst. Netzwerk, Browserrichtlinie und Kontoeinrichtung beeinflussen die Verfügbarkeit. Ein fehlgeschlagener BAN-Aufruf wechselt nicht automatisch zu Fetchify.
• Gemeinsame Einstellungen. Wenn Checkout Revolution diese gemeinsame Adressengine verwendet, nutzt es dieselben Einstellungen pro Shop für diesen Dienst.
• US-ZIP-Format. Der Adapter fordert fünfstellige ZIP-Codes ohne +4 an. Prüfen Sie reale Ergebnisse und die native Bundeslandauswahl. Die Anforderungsoption garantiert keine Zustellung.

Fehler eingrenzen

• Keine Vorschläge: Prüfen Sie Haupt- und Formularschalter, gespeichertes Fetchify-Token und Für diese Länder verwenden. Prüfen Sie Konto und Allowed Domains für tatsächliche Shop- und Backoffice-Domains bei Fetchify.
• CSP blockiert Anfragen: Ergänzen Sie https://api.craftyclicks.co.uk in connect-src. Modulscripte und Styles stammen vom Shop. Behalten Sie die bestehende Richtlinie und prüfen Sie blockierte Anfragen in der Konsole. Das Beispiel ist aus dem Code abgeleitet, nicht vollständig gemessen.
• Postleitzahl öffnet eine weitere Liste: Es handelt sich um eine Gruppe. Wählen Sie eine einzelne zurückgegebene Adresse zum Abrufen der Felder. Fetchifys Daten bestimmen die Treffer; keine Liste garantiert jede Adresse der Postleitzahl.
• Land oder Adresse fehlt: Prüfen Sie Formularland, Modulländerliste, Konto und erlaubte Domains. Bei Fehlern oder fehlenden Treffern bleibt die manuelle Eingabe möglich. Es gibt keinen automatischen Wechsel zu einem anderen Dienst.
• ZIP oder Bundesland prüfen: US-Anfragen schließen ZIP+4 aus. Bundesland oder Provinz wird nur bei passender nativer Option ausgewählt. Fehlende, zu lange oder während der Abfrage geänderte Felder ergänzen Sie von Hand.