SmartMaps Adress-Autocomplete: Konfiguration
Einstellungen des SmartMaps-Adress-Autocomplete-Plugins: API-Schlüssel, Aktivierung und Länder-Filter, Konfiguration pro Sales Channel und Praxis-Beispiele.
Konfiguration
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Die Einstellungen findest du im Admin unter Erweiterungen > Meine Erweiterungen > SmartMaps Adress-Autocomplete. Sie stehen in der Karte SmartMaps Autocomplete.
Einstellungen
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
API-Schlüssel (apiKey) |
Passwort, Pflichtfeld | leer | Dein SmartMaps-API-Schlüssel. Schützen kannst du ihn im SmartMaps-Portal durch Domain-Einschränkungen. |
Autocomplete aktivieren (enabled) |
Schalter | an | Schaltet die Adress-Autovervollständigung in den Adressformularen ein oder aus. |
Länder-Filter (ISO-Codes) (countryFilter) |
Text | leer | Komma-getrennte ISO-Ländercodes, die die Vorschläge einschränken, zum Beispiel DE, AT, CH. Leer lässt alle Länder zu. |
Wann das Plugin aktiv wird
Autocomplete wird nur eingebunden, wenn alle drei Bedingungen erfüllt sind.
- Autocomplete aktivieren ist eingeschaltet.
- Der API-Schlüssel ist nicht leer und mindestens 10 Zeichen lang. Führende und abschließende Leerzeichen werden entfernt.
- Der API-Schlüssel enthält nur Buchstaben, Ziffern und die Zeichen
_ - / + = % . :.
Ist eine Bedingung nicht erfüllt, bleiben die Adressformulare unverändert und es wird nichts von SmartMaps geladen.
Länder-Filter
- Jeder Eintrag muss genau zwei Zeichen lang sein. Groß- und Kleinschreibung spielt keine Rolle, Leerzeichen um die Einträge werden entfernt.
- Ungültige Einträge werden still ignoriert. Bleibt kein gültiger Eintrag übrig, gilt kein Filter.
- Der Filter schränkt nur die Vorschläge von SmartMaps ein. Die Länderliste des Formulars ändert er nicht.
Konfiguration pro Sales Channel
Alle drei Einstellungen lassen sich pro Sales Channel überschreiben. Wähle dazu in der Konfigurationsansicht oben den gewünschten Sales Channel und hinterlege eigene Werte, sonst gilt der globale Wert.
Praxis-Beispiele
DACH-Shop
| Einstellung | Wert |
|---|---|
| API-Schlüssel | dein Schlüssel |
| Autocomplete aktivieren | an |
| Länder-Filter | DE, AT, CH |
Ergebnis: Es werden nur Adressen aus Deutschland, Österreich und der Schweiz vorgeschlagen.
Internationaler Shop
| Einstellung | Wert |
|---|---|
| API-Schlüssel | dein Schlüssel |
| Autocomplete aktivieren | an |
| Länder-Filter | leer |
Ergebnis: Vorschläge aus allen Ländern, die SmartMaps liefert.
Ein Sales Channel pro Land
Global: Länder-Filter DE. Im Sales Channel "Österreich-Shop": Länder-Filter AT. Der Hauptshop schlägt dann nur deutsche Adressen vor, der Österreich-Shop nur österreichische.
Autocomplete in einem Sales Channel abschalten
Setze im betreffenden Sales Channel Autocomplete aktivieren auf aus. Die übrigen Sales Channels bleiben unverändert.