PS PrestaShop Anfänger

DataFirefly Address Lookup — Dokumentation

Installation, Einstellungen und Fehlerbehebung der Adressvorschläge: kostenloser Dienst der Géoplateforme (IGN, BAN-Daten) für Frankreich und Übersee, optional Google Places API (New) für andere Länder.

Aktualisiert Modulversion 2.0.0

Überblick

DataFirefly Address Lookup schlägt Adressen vor, während Kunden in den Adressformularen von PrestaShop tippen: im Bestellvorgang (Kunden und Gäste, Liefer- und Rechnungsadresse) und unter Mein Konto > Meine Adressen. Der Kunde tippt den Anfang seiner Adresse, wählt einen Vorschlag, und das Modul füllt Straße, Postleitzahl, Ort und – in Ländern mit Bundesländern oder Provinzen – auch diese aus.

Zwei Anbieter stehen zur Verfügung und werden pro Land gewählt:

  • Géoplateforme: Geokodierungsdienst des französischen Instituts für Geoinformation (IGN) auf Basis der nationalen Adressdatenbank (BAN), data.geopf.fr/geocodage. Kostenlos, ohne Schlüssel. Er ersetzt api-adresse.data.gouv.fr, die Ende Januar 2026 abgeschaltet wurde.
  • Google Places API (New): optional, mit Ihrem eigenen Google-Maps-Platform-Schlüssel, für die Länder, die die Géoplateforme nicht abdeckt.

Neu in 2.0.0: Anbieter je Land, Überseegebiete über die Géoplateforme, Google nur bei Bedarf geladen, Bundesland/Provinz ausgefüllt, Vorschlagsliste vollständig per Tastatur und Screenreader bedienbar, Schaltfläche „Adresse manuell eingeben“, Vorschau und Tests im Backoffice, Datenschutzhinweis, Statistik ohne personenbezogene Daten, 8 Sprachen, Kompatibilität ab PrestaShop 1.7.8.

Voraussetzungen und Kompatibilität

  • PrestaShop 1.7.8 bis 9.x, PHP 7.1 oder höher.
  • Themes Classic und Hummingbird sowie Themes, die die Standard-Feldnamen behalten (address1, postcode, city, id_country, id_state). Kein jQuery nötig.
  • Checkout-Module, die das Standard-Adressformular anzeigen, zum Beispiel DataFirefly Simple Checkout.
  • Nur für Google Places: ein Google-Cloud-Schlüssel mit aktivierter Places API (New) und Maps JavaScript API sowie aktiver Abrechnung.

Installation und Update

  1. Klicken Sie unter Module > Modul-Manager auf Modul hochladen und legen Sie dfaddresslookup-2.0.0.zip ab.
  2. Klicken Sie auf Konfigurieren. Ohne weitere Einstellung erhalten Frankreich und die Überseegebiete Vorschläge der Géoplateforme.

Update von 1.0.x oder 1.1.0: Laden Sie das neue Zip über das alte hoch. Alle Einstellungen bleiben erhalten; die Liste „Erlaubte Länder (Google)“ der 1.x wird zur Anbietertabelle je Land, sodass dieselben Länder dieselben Vorschläge behalten. Das Update-Skript leert außerdem den kombinierten CSS-Cache von PrestaShop, der sonst weiter das alte Stylesheet ausliefern würde.

Übersicht

Der erste Tab fasst zusammen, was die Kunden sehen: Anzahl der Länder je Anbieter, Seiten, Datenschutzhinweis, erkannte Checkout-Module und Zähler der letzten 30 Tage.

Modulübersicht: Länder über die Géoplateforme und über Google Places, Status der Seiten und Zähler der letzten 30 Tage
Modulübersicht

Länder und Anbieter

Jedes im Shop aktivierte Land hat eine eigene Auswahl: Automatisch, Géoplateforme, Google Places oder Keine Vorschläge. Im Automatikmodus bedient die Géoplateforme die Länder, für die sie Adressen hat; für die übrigen wählt die Einstellung „Länder ohne Abdeckung durch die Géoplateforme“ Google Places (wenn ein Schlüssel hinterlegt ist) oder keine Vorschläge. Die Spalte Ergebnis aktualisiert sich live.

Die Géoplateforme deckt das französische Mutterland, Guadeloupe, Martinique, Französisch-Guayana, Réunion, Mayotte, Saint-Pierre und Miquelon, Saint-Barthélemy und Saint-Martin ab, Neukaledonien und Französisch-Polynesien teilweise. Für Wallis und Futuna sowie Monaco hat sie keine Daten. Eine Überseeadresse, die mit dem Land „Frankreich“ eingegeben wird, wird ebenfalls gefunden.

Anbieter je Land: Géoplateforme für Frankreich, Guadeloupe und Réunion, Google Places für die Länder, die sie nicht abdeckt
Anbieter je Land

Sucheinstellungen

  • Mindestanzahl Zeichen (2 bis 10, Standard 3; die Géoplateforme braucht mindestens 3).
  • Wartezeit vor der Suche (80 bis 2000 ms, Standard 250): Pause nach der letzten Taste.
  • Anzahl der Vorschläge (1 bis 10, Standard 6) und Zeitlimit (1000 bis 15000 ms), nach dem die Suche abgebrochen wird.
  • Eingegebenen Text hervorheben, Ort anhand der Postleitzahl, Schaltfläche Adresse manuell eingeben.
  • Seiten: Bestellvorgang und/oder Meine Adressen. Das Skript wird nur auf diesen Seiten geladen und gar nicht, wenn kein Land einen Anbieter hat. Ein erweitertes Feld nimmt die Controller eines Checkout-Moduls mit eigener Seite auf.
  • Akzentfarbe: leer, dann wird die Hauptfarbe des Themes verwendet.
Sucheinstellungen: Mindestzeichen, Wartezeit vor der Suche, Anzahl der Vorschläge, Zeitlimit, Seiten und Farbe
Sucheinstellungen

Google-Places-Schlüssel

Das Modul nutzt nur Places API (New): Das alte Widget Places Autocomplete wird neuen Google-Cloud-Projekten nicht mehr angeboten. Das Google-Skript wird erst geladen, wenn ein Kunde eine Adresse in einem Land eingibt, das über Google läuft.

  1. Erstellen oder wählen Sie in der Google Cloud Console ein Projekt mit aktivierter Abrechnung.
  2. Aktivieren Sie unter APIs und Dienste die Places API (New) und die Maps JavaScript API.
  3. Erstellen Sie unter Anmeldedaten einen API-Schlüssel.
  4. Anwendungseinschränkungen: Websites. Fügen Sie die vom Modul angezeigten Verweis-URLs hinzu (Shop- und Backoffice-Domain, Schaltfläche Kopieren).
  5. API-Einschränkungen: Beschränken Sie den Schlüssel auf Places API (New) und Maps JavaScript API.
  6. Fügen Sie den Schlüssel ein, aktivieren Sie Google Places, speichern Sie und klicken Sie auf Schlüssel testen.

Abrechnung: Das Modul fasst die Suchen nach einer Adresse in einem Sitzungstoken zusammen, das mit einer einzigen Place-Details-Anfrage nur für die Adressfelder (Kategorie Essentials) abgeschlossen wird. Google stellt diese Nutzung Ihrem Konto nach der jeweils gültigen Preisliste in Rechnung; die Anzahl der Sitzungen erscheint im Tab Statistik. Standardmäßig werden nur Adressen vorgeschlagen (Hausnummern, Gebäude, Straßen), keine Geschäfte.

Ein Maps-JavaScript-Schlüssel ist in den Seiten des Shops sichtbar: Setzen Sie ihn nie ohne Einschränkung auf HTTP-Verweis-URLs ein.

Google-Places-API-(New)-Schlüssel: Aktivierung, nur Adressen, Abrechnung pro Sitzung und Schritte zur Einschränkung
Google-Places-API-(New)-Schlüssel

Vorschau und Test

Der Tab Vorschau und Test bildet ein Adressformular mit den aktuellen Einstellungen nach, auch vor dem Speichern. Die Test-Buttons fragen die Géoplateforme und Google Places aus Ihrem Browser ab, wie es ein Kunde tun würde, und zeigen die Antwortzeit oder die Ursache eines Fehlers (Schlüssel abgelehnt, Netzwerk, CSP-Direktive).

Live-Vorschau und Verbindungstest: Vorschläge der Géoplateforme und Antwort von Google Places im Backoffice
Live-Vorschau und Verbindungstest

Auf Kundenseite

Vorschläge und Tastatur

Die Vorschläge erscheinen unter dem Feld Adresse über der Seite: Das Formular verschiebt sich nicht. Jede Zeile zeigt die Straße, dann Postleitzahl, Ort und Region. Die Pfeiltasten nach oben und unten gehen die Liste durch, die Eingabetaste wählt, Escape schließt, ohne den Text zu löschen; die Anzahl der Vorschläge wird Screenreadern angesagt.

Adressvorschläge im Bestellvorgang: Plätze des Hôtel de Ville mit Postleitzahl, Ort und Region
Adressvorschläge im Bestellvorgang
Tastaturnavigation: Pfeiltasten zum Durchgehen der Vorschläge, Eingabetaste zum Auswählen, Escape zum Schließen
Tastaturnavigation

Ausfüllen des Formulars

Felder werden nur ausgefüllt, wenn der Kunde einen Vorschlag auswählt, und kurz hervorgehoben. Der Adresszusatz wird nie ersetzt, und der Ort anhand der Postleitzahl füllt nur ein leeres Feld. Liefer- und Rechnungsformular arbeiten unabhängig voneinander, und der Anbieter folgt dem gewählten Land, auch wenn PrestaShop das Formular neu lädt.

Formular nach der Auswahl ausgefüllt: Adresse, Postleitzahl und Ort hervorgehoben, Adresszusatz unverändert
Formular nach der Auswahl ausgefüllt

Ort anhand der Postleitzahl

In Ländern über die Géoplateforme füllt eine 5-stellige Postleitzahl den Ort, wenn nur eine Gemeinde passt, oder zeigt die Liste der Gemeinden, wenn es mehrere gibt.

Postleitzahl mehrerer Gemeinden: Liste der Orte unter dem Feld Postleitzahl
Postleitzahl mehrerer Gemeinden

Kein Ergebnis, Fehler, manuelle Eingabe

Wenn keine Adresse passt oder der Dienst langsam, überlastet (Antwort 429) oder nicht erreichbar ist, zeigt die Liste dies an und erinnert daran, dass die manuelle Eingabe möglich bleibt. Die Schaltfläche Adresse manuell eingeben (oder die Escape-Taste) schließt die Liste; die Bestellung wird nie blockiert.

Keine Adresse gefunden: klare Meldung und Schaltfläche zur manuellen Eingabe, die Bestellung wird nie blockiert
Keine Adresse gefunden

Google Places für andere Länder

Für ein Land über Google stammen die Vorschläge von Google Places und tragen den Hinweis „Google Maps“. Bei der Auswahl wird auch das Bundesland oder die Provinz in der PrestaShop-Liste gewählt, wenn das Land eine hat.

Adresse in den USA: Vorschläge von Google Places (New) mit der Google-Maps-Attribution
Adresse in den USA

Smartphone und Meine Adressen

Auf dem Smartphone sind die Zeilen mindestens 48 px hoch und die Liste bleibt im Bildschirm. Dieselben Vorschläge stehen zur Verfügung, wenn ein Kunde in seinem Konto eine Adresse hinzufügt oder bearbeitet.

Auf dem Smartphone: Vorschläge unter dem Feld, große Tippflächen und Schaltfläche zur manuellen Eingabe
Auf dem Smartphone
Mein Konto, Meine Adressen: dieselben Vorschläge zum Hinzufügen oder Bearbeiten einer Adresse
Mein Konto, Meine Adressen

Datenschutz

Der in das Feld Adresse eingegebene Text geht vom Browser des Kunden an den Anbieter des Landes: die Géoplateforme (data.geopf.fr, ohne Cookie) oder Google (maps.googleapis.com, nur für Länder über Google und erst, wenn der Kunde tippt). Nichts läuft über DataFirefly. Unter dem Feld wird in jeder Sprache ein Hinweis mit dem Namen des Anbieters ({provider}) und einem optionalen Link zu einer CMS-Seite angezeigt. Dieser Hinweis informiert den Kunden; er ersetzt nicht Ihre eigene Prüfung Ihrer Pflichten.

Hinweis unter dem Feld Adresse: Text je Sprache, Link zu einer Seite und Ziel der eingegebenen Daten
Hinweis unter dem Feld Adresse

Statistik

Das Modul zählt pro Tag und Anbieter die Suchen, ausgewählten Adressen, Suchen ohne Ergebnis, Fehler und Google-Sitzungen. Es werden keine Adresse, keine IP-Adresse und keine Kundenkennung gespeichert. Die Zählung kann deaktiviert und zurückgesetzt werden.

Nutzungsstatistik: Suchen, ausgewählte Adressen, kein Ergebnis, Fehler und Google-Sitzungen, ohne personenbezogene Daten
Nutzungsstatistik

Sicherheit und Content Security Policy

  • Vorschläge werden als Text aufgebaut: Keine Daten des Anbieters werden als HTML eingefügt.
  • Das Modul verwendet weder Inline-Skripte noch eval und hat keinen Server-Proxy.
  • Wenn Ihr Shop einen CSP-Header sendet: connect-src https://data.geopf.fr für die Géoplateforme; für Google die Direktiven aus dem Tab Hilfe (die Nonce der Seite wird an das Google-Skript übergeben, wenn es eine gibt).

Fehlerbehebung

Es erscheint kein Vorschlag

  • Prüfen Sie, ob das Modul aktiviert ist und die Seite zu den gewählten Seiten gehört.
  • Prüfen Sie unter Länder und Anbieter die Spalte Ergebnis für das im Formular gewählte Land.
  • Starten Sie den Géoplateforme-Test unter Vorschau und Test: Ein Fehler deutet meist auf eine Netzwerksperre oder eine connect-src-Direktive hin.
  • Leeren Sie nach einem manuellen Datei-Update den Cache unter Erweiterte Einstellungen > Leistung.

Google Places antwortet nicht

  • Die Schaltfläche Schlüssel testen zeigt, ob Google den Schlüssel ablehnt: API nicht aktiviert, Abrechnung inaktiv oder Domain fehlt in den Verweis-URLs.
  • Die Backoffice-Domain muss für Test und Vorschau in den Verweis-URLs stehen.

Ein Checkout-Modul eines Drittanbieters

Checkouts, die die Standard-Feldnamen behalten, funktionieren ohne Einstellung. Haben sie eine eigene Seite, fügen Sie ihren Controller unter Weitere Controller hinzu. Benennen sie die Felder um, bleibt die Eingabe manuell, ohne Fehler.

FAQ

Braucht man für Frankreich einen Schlüssel?

Nein. Die Géoplateforme ist kostenlos und ohne Schlüssel. Google Places ist optional.

Wird das Skript auf jeder Seite geladen?

Nein: nur im Bestellvorgang und auf der Adressseite (je nach Einstellung), und das Google-Skript erst, wenn ein Kunde in einem Land über Google tippt.

Was passiert bei der Deinstallation?

Die Einstellungen und die Statistiktabelle werden gelöscht.

Änderungsprotokoll

2.0.0 — 8. November 2026

  • Anbieter je Land (automatisch, Géoplateforme, Google Places, keiner); Überseegebiete, die als eigene Länder angelegt sind, über die Géoplateforme
  • Google: Skript bei Bedarf geladen, nur Adressen, Sitzungstoken mit einer Essentials-Anfrage abgeschlossen, Bundesland/Provinz ausgefüllt, Google-Maps-Attribution, Erkennung eines abgelehnten Schlüssels
  • Neue Vorschlagsliste: Zustände Laden, kein Ergebnis, Fehler und Pause, Schaltfläche zur manuellen Eingabe, vollständiges ARIA-Combobox-Muster, mobile Größen
  • Veraltete Anfragen abgebrochen, Zeitlimit, Cache, Pause bei Antworten 429
  • Backoffice neu: Vorschau, Verbindungstests, Hilfe zum Schlüssel, Datenschutzhinweis, Statistik; 8 Sprachen
  • Kompatibel mit PrestaShop 1.7.8 bis 9; Update von 1.0.x und 1.1.0 ohne Verlust von Einstellungen

1.1.0 — 23. August 2026

  • Google-Engine auf Places API (New) umgestellt

1.0.3 und 1.0.2 — 23. August 2026

  • Straße bleibt nach der Auswahl erhalten; Liste öffnet sich nach der Auswahl nicht mehr

1.0.1 — 1. Juli 2026

  • Umstieg auf die Géoplateforme (data.geopf.fr/geocodage)

1.0.0 — 15. Mai 2026

  • Erste öffentliche Version
War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren