Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Dieses Plugin arbeitet nicht selbst-gehostet. Auf den betroffenen Seiten lädt der Browser des Besuchers Dateien von
cdn.smartmaps.cloud, und die SmartMaps-Bibliothek schickt die getippten Adressdaten zur Vervollständigung an SmartMaps.
| Wann | Wohin | Was |
|---|---|---|
| Beim Aufruf einer betroffenen Seite, sobald das Plugin aktiv und konfiguriert ist | cdn.smartmaps.cloud |
Das Stylesheet autocomplete.css und das Skript autocomplete.min.js werden geladen. Dabei erhält der Server die IP-Adresse und die üblichen Browser-Angaben des Besuchers. |
| Beim Tippen in das Straßenfeld | SmartMaps-Dienst | Die SmartMaps-Bibliothek sendet den eingegebenen Text zusammen mit deinem API-Schlüssel, um Vorschläge zu holen. |
Das Laden erfolgt auf jeder betroffenen Seite, auch wenn der Besucher das Adressfeld nie benutzt. Auf anderen Seiten und bei ausgeschaltetem Plugin finden keine Anfragen statt.
Prüfe vor dem Einsatz, ob du für die Nutzung von SmartMaps eine Rechtsgrundlage und einen Auftragsverarbeitungsvertrag brauchst, und nimm SmartMaps in deine Datenschutzerklärung auf.
Der API-Schlüssel steht im HTML der betroffenen Seiten, im Attribut data-smartmaps-apikey des Skript-Tags. Die SmartMaps-Bibliothek arbeitet im Browser und braucht ihn dort, deshalb ist er für jeden Besucher einsehbar. Schränke den Schlüssel im SmartMaps-Portal auf deine Shop-Domains ein.
Der Schlüssel erscheint nicht in der Konfiguration, die an die Storefront-JavaScript-Klasse übergeben wird (dort stehen nur der Schalter und der Länder-Filter). Er wird pro Sales Channel gelesen, es lassen sich also verschiedene Schlüssel für verschiedene Shops hinterlegen.
Setzt du eine Content Security Policy ein, musst du cdn.smartmaps.cloud für Skripte und Stylesheets erlauben. Die Initialisierung läuft in einem Inline-Skript, das den Shopware-CSP-Nonce (cspNonce) verwendet. Welche weiteren Hosts die SmartMaps-Bibliothek anspricht, legt SmartMaps fest; sie müssen bei einer strengen Richtlinie zusätzlich freigegeben werden.
Das Plugin speichert keine Adressen und keine SmartMaps-Antworten. Die ausgewählte Adresse landet über das normale Shopware-Formular im Shop, wie bei einer manuellen Eingabe.