English Version

Zurück zur Übersicht

Fehlerbehebung und FAQ

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Keine Vorschläge beim Tippen

Das Plugin gibt bei internen Fehlern bewusst nichts aus, damit es die Storefront nie stört. Prüfe deshalb der Reihe nach:

1. Ist Autocomplete aktivieren im betroffenen Sales Channel eingeschaltet?
2. Ist ein API-Schlüssel hinterlegt, der mindestens 10 Zeichen lang ist und nur die erlaubten Zeichen enthält (siehe Konfiguration)? Die Prüfung findet pro Sales Channel statt.
3. Ist die Seite eine der Seiten, auf denen das Plugin arbeitet? Auf der Registrierungsseite des Checkouts wird nichts geladen.
4. Steht im Quelltext der Seite ein Skript-Tag von cdn.smartmaps.cloud mit dem Attribut data-smartmaps-apikey? Wenn nicht, ist die Konfiguration nicht gültig oder eine zwischengespeicherte Seite ist veraltet. Leere dann den Cache mit bin/console cache:clear.
5. Wird cdn.smartmaps.cloud im Browser geladen? Werbeblocker, Firewall oder eine Content Security Policy können es blockieren.
6. Meldet die Browser-Konsole Fehler mit dem Präfix [SmartMaps]? Beispiele sind Failed to initialize und Error.

Meldungen wegen des Domain-Schutzes

Erscheinen in der Konsole Fehler zu Access-Control-Allow-Origin oder lehnt SmartMaps Anfragen ab, ist die Shop-Domain vermutlich nicht für den Schlüssel freigegeben. Trage sie im SmartMaps-Portal bei den Domain-Einschränkungen des Schlüssels ein.

Land wird nicht übernommen

Das Plugin findet die Länder-Option über das Attribut data-iso oder über einen Optionstext, der dem ISO-Code entspricht. Verwendet dein Theme beides nicht, bleibt die Auswahl unverändert. Länder, die dem Sales Channel nicht zugeordnet sind, stehen in der Auswahl nicht zur Verfügung und können nicht gesetzt werden.

Bundesland wird nicht gesetzt

• Ist das Bundesland-Feld im Formular sichtbar, und sind für das Land Bundesländer angelegt (Einstellungen > Shop > Länder)?
• Der Name des Bundeslandes aus SmartMaps muss dem Optionstext genau entsprechen (ohne Beachtung der Groß- und Kleinschreibung). Weicht die Schreibweise ab, bleibt die Auswahl unverändert.

Länder-Filter greift nicht

Der Länder-Filter lässt nur zweistellige Ländercodes zu. Einträge wie DEU werden ignoriert, und ohne gültigen Eintrag gilt kein Filter. Prüfe die Schreibweise, zum Beispiel DE, AT, CH.

Häufige Fragen

Kann ich pro Sales Channel einen eigenen API-Schlüssel nutzen?

Ja, alle Einstellungen lassen sich pro Sales Channel überschreiben.

Schreibt das Plugin Adressen in eine Datenbank?

Nein, es legt keine eigenen Tabellen an und speichert nichts.

Ist die Nutzung von SmartMaps kostenlos?

Die Konditionen legt SmartMaps fest, bitte prüfe sie dort.

Gibt es eine Verbindung zur YellowMap AG?

Das Plugin wird von Markus Michalski entwickelt und vertrieben. Es besteht keine geschäftliche Verbindung zur YellowMap AG als Betreiberin von SmartMaps, und die YellowMap AG leistet keinen Support für das Plugin.