Store Locator in Shopware 6 einbinden

Was Sie bekommen

Eine Standortkarte mit Suche, Filtern und Route in Ihrem Shopware-Shop - zum Beispiel auf einer Seite „Filialen“ oder „Händler finden“. Die Standorte pflegen Sie in My Store Locator, unabhängig von Produkten und Bestellungen.

Voraussetzungen

• Ein Konto bei My Store Locator (kostenlos registrieren)
• Eine veröffentlichte Karte (Status „Live“)
• Für den Weg ohne Plugin der Einbettungscode aus dem Embed Studio der App
• Zugang zur Shopware-Administration, bei Weg 2 zusätzlich Zugriff auf Server oder Theme

Plugin installieren

1. Laden Sie oben die Zip-Datei herunter. Entpacken Sie sie nicht.
2. Öffnen Sie in der Administration Erweiterungen → Meine Erweiterungen und klicken Sie auf Erweiterung hochladen. Wählen Sie die Datei.
3. Klicken Sie in der Liste bei My Store Locator – Filialfinder & Händlerkarte auf Installieren und aktivieren Sie die Erweiterung mit dem Schalter.

Das Plugin läuft in selbst gehosteten Shops mit Shopware 6.7. In der Shopware Cloud lassen sich keine eigenen Plugins hochladen, und für ältere Versionen nutzen Sie die Wege ohne Plugin weiter unten.

Mit My Store Locator verbinden

1. Öffnen Sie Erweiterungen → Meine Erweiterungen, klicken Sie bei My Store Locator auf das Menü … und wählen Sie Konfigurieren.
2. Fügen Sie im Bereich Karte den Token in das Feld Standard-Karten-Token ein. Einbettungscode oder Kartenlink funktionieren ebenfalls. Oder klicken Sie auf Mit My Store Locator verbinden, melden Sie sich an und wählen Sie Ihre Karte. Klicken Sie auf Speichern.
3. Öffnen Sie Inhalte → Erlebniswelten und ein Layout. Ziehen Sie aus der Block-Kategorie Commerce den Block Store Locator (My Store Locator) auf die Seite und weisen Sie das Layout einer Kategorie oder Landingpage zu.

Die Zwei-Klick-Lösung (Zwei-Klick-Modus im Bereich Datenschutz) ist voreingestellt. Pro Element können Sie eine andere Karte, Höhe oder Sprache wählen.

Updates

Ein Plugin aus einer Zip-Datei aktualisiert Shopware nicht von selbst. Für eine neue Version laden Sie die neue Datei von dieser Seite wieder über Erweiterung hochladen hoch und klicken dann bei der Erweiterung auf Aktualisieren. Sobald das Plugin im Shopware Store ist, steht es hier.

Ohne Plugin, Weg 1: Erlebniswelt mit Text-Element

1. Kopieren Sie im Embed Studio den Code im Reiter iframe.
2. Öffnen Sie in der Administration Inhalte → Erlebniswelten und legen Sie eine Landingpage oder Shopseite an, z. B. „Filialen“.
3. Fügen Sie einen Block mit einem Text-Element ein.
4. Schalten Sie im Text-Editor mit dem Symbol </> in die Quellcode-Ansicht und fügen Sie den Code ein.
5. Speichern Sie, ordnen Sie die Erlebniswelt einer Kategorie oder Landingpage zu und prüfen Sie die Seite im Shop.

<iframe src="https://app.my-store-locator.com/#/m/IHR-TOKEN" title="Standortkarte" style="width:100%;height:640px;border:0;max-width:100%" loading="lazy" allow="geolocation"></iframe>

Wichtig ab Shopware 6.5: Der eingebaute HTML-Sanitizer entfernt iframes aus Text-Elementen, solange sie nicht erlaubt sind. Wird der Code nach dem Speichern abgeschnitten, muss in einem selbst gehosteten Shop die Sanitizer-Konfiguration (config/packages/z-shopware.yaml, Abschnitt html_sanitizer) um iframe und seine Attribute ergänzt werden. Das erledigt Ihre Agentur oder Ihr Hoster. In der Shopware Cloud ist diese Einstellung nicht zugänglich - nutzen Sie dort Weg 2. In selbst gehosteten Shops ist unser Plugin der einfachere Weg, denn es braucht keine Anpassung am Sanitizer. Details in der Shopware-Dokumentation zum HTML-Sanitizer (externer Link).

Ohne Plugin, Weg 2: im Theme-Template

Ihre Agentur kann den Code in ein Twig-Template Ihres Themes einbauen, zum Beispiel in eine eigene Seitenvorlage für „Filialen“. Für Entwickler eignet sich dafür das Widget, weil es seine Höhe dem Inhalt anpasst:

<div id="mystorelocator" data-token="IHR-TOKEN" data-height="auto" data-lang="de" data-consent="true"></div>
<script src="https://app.my-store-locator.com/widget.js" async defer></script>

Datenschutz: Zwei-Klick-Lösung

Schalten Sie im Embed Studio „Karte erst nach Klick laden (DSGVO)“ ein und kopieren Sie den Code danach neu. Besucher sehen dann zuerst einen Platzhalter mit Datenschutzhinweis, die Karte lädt erst nach einem Klick. Mehr unter DSGVO & Sicherheit.

Wenn die Karte nicht erscheint

• Code wird nach dem Speichern gekürzt: Der HTML-Sanitizer filtert das iframe (siehe Weg 1).
• Cache: Leeren Sie nach Änderungen an Konfiguration oder Theme den Shop-Cache.
• „Karte nicht verfügbar“: Die Karte ist noch ein Entwurf. Veröffentlichen Sie sie in der App.
• Content Security Policy: Setzt Ihre Website eine CSP, muss frame-src die Domain app.my-store-locator.com erlauben (beim Widget zusätzlich script-src).

Alle Optionen erklärt die Hilfe zum Einbetten.

FAQ