Store Locator in Joomla einbinden

Was Sie bekommen

Eine Standortkarte mit Liste, Suche und Filtern auf Ihrer Joomla-Website. Die Standorte pflegen Sie in My Store Locator.

Voraussetzungen

• Ein Konto bei My Store Locator (kostenlos registrieren)
• Eine veröffentlichte Karte (Status „Live“)
• Für den Weg ohne unser Modul der Einbettungscode aus dem Embed Studio der App
• Ein Joomla-Administrator-Zugang (Joomla 4 oder 5, für unser Modul Joomla 4.4 oder 5)

Modul installieren

1. Laden Sie oben die Zip-Datei herunter.
2. Öffnen Sie im Backend System → Installieren → Erweiterungen. Im Reiter Paketdatei hochladen ziehen Sie die Datei in das Feld oder klicken auf Oder eine Datei auswählen. Joomla meldet „Die Modul-Installation wurde abgeschlossen.“

Mit My Store Locator verbinden

1. Öffnen Sie Inhalt → Site Module, klicken Sie auf Neu und wählen Sie den Modultyp My Store Locator.
2. Fügen Sie den Token in das Feld Karten-Token ein (das Modul meldet „Karten-Token erkannt“). Einbettungscode oder Kartenlink funktionieren ebenfalls. Oder klicken Sie auf Mit My Store Locator verbinden, melden Sie sich an und wählen Sie Ihre Karte. Der Button braucht eine Website mit HTTPS.
3. Geben Sie einen Titel ein, wählen Sie eine Position (bei Cassiopeia zum Beispiel main-top) und lassen Sie den Status auf Veröffentlicht. Wählen Sie im Reiter Menüzuweisung Nur auf den gewählten Seiten, haken Sie die Seite an und klicken Sie auf Speichern & Schließen.

Die Zwei-Klick-Lösung ist voreingestellt.

Updates

Das Joomla-Modul meldet neue Versionen selbst: Joomla zeigt sie unter System → Aktualisieren → Erweiterungen an, und Sie installieren sie dort mit einem Klick. Der Eintrag im Joomla Extensions Directory ist eingereicht und wird geprüft.

Ohne unser Modul: als „Eigenes Modul“

1. Kopieren Sie im Embed Studio den Code im Reiter iframe.
2. Öffnen Sie im Joomla-Backend Inhalt → Site Module und klicken Sie auf Neu.
3. Wählen Sie den Modultyp Eigenes Modul (englisch „Custom“).
4. Schalten Sie den Editor mit Editor an/aus (Toggle Editor) in die Code-Ansicht und fügen Sie den Code ein.
5. Wählen Sie eine Position Ihres Templates und unter Menüzuweisung die Seite, auf der die Karte erscheinen soll.
6. Speichern Sie und prüfen Sie die Seite im Frontend.

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

Sie können den Code auch in einen Beitrag einfügen. Schalten Sie dafür den Editor in die Code-Ansicht. Joomla filtert HTML je nach Benutzergruppe: Unter System → Globale Konfiguration → Textfilter legen Sie fest, ob eine Gruppe iframes speichern darf. Für Super User ist standardmäßig kein Filter aktiv.

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 verschwindet nach dem Speichern: Der Textfilter Ihrer Benutzergruppe entfernt iframes. Passen Sie den Filter an oder lassen Sie einen Super User den Code einfügen.
• Modul nicht sichtbar: Prüfen Sie Position, Menüzuweisung und Status („Veröffentlicht“).
• „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