Store Locator in Drupal einbinden

Was Sie bekommen

Eine Standortkarte mit Liste, Suche und Filtern auf Ihrer Drupal-Website. Die Standorte pflegen Sie in My Store Locator, Drupal zeigt nur die Karte.

Voraussetzungen

• Ein Konto bei My Store Locator (kostenlos registrieren)
• Eine veröffentlichte Karte (Status „Live“)
• Für unser Modul Zugriff auf die Dateien der Drupal-Installation (oder Ihre Agentur)
• Für den Weg ohne unser Modul der Einbettungscode aus dem Embed Studio der App und in Drupal die Berechtigung für das Textformat Full HTML (oder ein anderes Format, das <iframe> erlaubt)

Modul installieren

1. Laden Sie oben die Zip-Datei herunter und entpacken Sie sie.
2. Kopieren Sie den Ordner my_store_locator nach modules/contrib/ Ihrer Drupal-Installation (bei Composer-Projekten meist web/modules/contrib/).
3. Öffnen Sie Erweitern, setzen Sie den Haken bei My Store Locator und klicken Sie auf Installieren. Mit Drush: drush en my_store_locator.

Mit My Store Locator verbinden

1. Öffnen Sie Konfiguration → Web-Dienste → My Store Locator (/admin/config/services/my-store-locator).
2. Fügen Sie 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 (nur auf Websites mit HTTPS). Klicken Sie auf Konfiguration speichern.
3. Öffnen Sie Struktur → Blocklayout, klicken Sie in einem Bereich (zum Beispiel „Inhalt“) auf Block platzieren und dann bei My-Store-Locator-Karte auf Block platzieren. Nehmen Sie den Haken bei Titel anzeigen heraus, legen Sie bei Bedarf unter Sichtbarkeit → Seiten den Pfad fest (zum Beispiel /filialen) und klicken Sie auf Block speichern.

Die Zwei-Klick-Lösung (Einwilligungsmodus (Laden per Klick)) ist voreingestellt. Lassen Sie im Block das Feld Karten-Token leer, nutzt er den Standard-Token. Jeder Block kann eine eigene Karte und eigene Einstellungen haben.

Updates

Ein Modul aus einer Zip-Datei aktualisiert Drupal nicht von selbst. Für eine neue Version ersetzen Sie den Ordner my_store_locator durch den aus der neuen Zip und rufen danach /update.php auf (oder drush updb). Haben Sie das Modul mit Composer installiert, holen Sie neue Versionen mit composer update drupal/my_store_locator und rufen danach drush updb auf. Projektseite: drupal.org/project/my_store_locator (externer Link).

Ohne unser Modul: als Inhaltsblock

1. Kopieren Sie im Embed Studio den Code im Reiter iframe.
2. Öffnen Sie Struktur → Blocklayout und klicken Sie in der gewünschten Region auf Block platzieren.
3. Wählen Sie Inhaltsblock hinzufügen und stellen Sie unter dem Textfeld das Textformat Full HTML ein.
4. Wechseln Sie im Editor mit Quelle (Source) in die Code-Ansicht und fügen Sie den Code ein.
5. Speichern Sie, legen Sie unter Sichtbarkeit → Seiten fest, auf welcher Seite der Block erscheint, und speichern Sie den Block.

<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>

Alternative: im Inhalt

Für eine einzelne Seite wie „Standorte“ können Sie den Code direkt in das Textfeld des Inhalts einfügen: Textformat Full HTML wählen, mit Quelle in die Code-Ansicht wechseln, Code einfügen, speichern.

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 entfernt: Das gewählte Textformat erlaubt keine iframes. Nutzen Sie „Full HTML“ oder ergänzen Sie <iframe src title style loading allow> in den erlaubten Tags des Formats.
• Block nicht sichtbar: Prüfen Sie Region, Sichtbarkeitsregeln und ob der Block aktiviert ist.
• „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