Store Locator in TYPO3 einbinden

Extension zum DownloadFür TYPO3 12.4 und 13.4 mit eigenem Inhaltselement „My Store Locator Karte“. Der Einbettungscode funktioniert weiterhin.

Bei Packagist veröffentlichtMit Composer installieren: composer require shss/my-store-locator, danach vendor/bin/typo3 extension:setup. Der Eintrag im TER steht noch aus.

My Store Locator für TYPO3

Extension · Version 1.0.0 · 52 KB

Passt zu: TYPO3 12.4 LTS und 13.4 LTS, PHP 8.1 bis 8.4

Zip herunterladen

Datei my_store_locator_1.0.0.zip · SHA-256 deac516698cbdb81dbdfc7334e7aedae6b5d9fcbb50397939cd2bdb970d25e67

Was Sie bekommen

Ihre Standortkarte mit Liste, Suche und Filtern auf einer TYPO3-Seite, zum Beispiel „Standorte“ oder „Händler finden“. Die Daten pflegen Sie in My Store Locator, nicht in TYPO3.

Voraussetzungen

Ein Konto bei My Store Locator (kostenlos registrieren)
Eine veröffentlichte Karte (Status „Live“)
Für die Extension ein Administrator-Zugang im TYPO3-Backend
Für den Weg ohne Extension der Einbettungscode aus dem Embed Studio der App und ein TYPO3-Backend-Zugang, der das Inhaltselement „Reines HTML“ verwenden darf (bei eingeschränkten Redakteursrechten muss ein Administrator es freigeben)

Extension installieren

Laden Sie oben die Zip-Datei herunter. Entpacken Sie sie nicht und behalten Sie den Dateinamen bei - TYPO3 liest daraus den Extension-Schlüssel my_store_locator.
Öffnen Sie im Backend Verwaltungswerkzeuge → Erweiterungen, wählen Sie oben Erweiterung hochladen und laden Sie die Datei hoch. Aktivieren Sie die Extension, falls TYPO3 das nicht schon getan hat.
Binden Sie die Einstellungen ein. In TYPO3 13: Seitenverwaltung → Seiten, bei Ihrer Site auf das Stift-Symbol klicken, unter Sets für diese Webseite das Set My Store Locator auswählen und Speichern. In TYPO3 12: im Root-Template unter Seitenverwaltung → TypoScript das statische Template My Store Locator (my_store_locator) nach Fluid Content Elements einbinden.

Der Upload im Backend klappt nur bei Installationen ohne Composer. Läuft Ihr TYPO3 mit Composer, installieren Sie die Extension direkt von Packagist und richten sie danach ein:

composer require shss/my-store-locator
vendor/bin/typo3 extension:setup

Lassen Sie den zweiten Befehl nicht weg. Erst extension:setup legt die Datenbankfelder der Extension an. Ohne ihn meldet TYPO3 beim Anlegen oder Anzeigen des Inhaltselements einen SQL-Fehler zur Spalte icon_type. Danach binden Sie die Einstellungen wie in Schritt 3 ein.

Mit My Store Locator verbinden

Öffnen Sie das Modul Seite, wählen Sie im Seitenbaum die Seite, klicken Sie auf Neuen Inhalt erstellen und wählen Sie im Reiter Plugins das Element My Store Locator Karte.
Fügen Sie im Reiter Karte den Token in das Feld Karten-Token ein. Einbettungscode oder Kartenlink funktionieren ebenfalls. Oder klicken Sie auf das Symbol rechts neben dem Feld, melden Sie sich bei My Store Locator an und wählen Sie Ihre Karte. Der Token wird eingetragen.
Klicken Sie auf Speichern und öffnen Sie die Seite mit Web-Seite anzeigen im Frontend.

Die Zwei-Klick-Lösung ist voreingestellt. Höhe, Sprache und Layout stellen Sie pro Element ein.

Updates

Eine Extension aus einer Zip-Datei aktualisiert TYPO3 nicht von selbst. Für eine neue Version laden Sie die neue Datei von dieser Seite wieder über Erweiterung hochladen hoch und lassen die vorhandene Version überschreiben. Mit Composer holen Sie neue Versionen per composer update shss/my-store-locator und führen danach wieder vendor/bin/typo3 extension:setup aus. Sobald die Extension im TER ist, steht es hier.

Ohne Extension: Inhaltselement „Reines HTML“

Kopieren Sie im Embed Studio den Code im Reiter iframe.
Öffnen Sie im TYPO3-Backend das Modul Seite und wählen Sie die gewünschte Seite im Seitenbaum.
Klicken Sie in der gewünschten Spalte auf Neuen Inhalt erstellen.
Wählen Sie im Reiter Sonderelemente das Element Reines HTML (englisch „Plain HTML“).
Fügen Sie den Code in das Feld HTML-Code ein, 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>

Das Inhaltselement gibt den Code unverändert aus. Prüfen Sie die Seite nach dem Speichern im Frontend, denn die Vorschau im Backend zeigt nur den Quelltext.

Mehrere Sprachen

Pflegen Sie in TYPO3 eine deutsche und eine englische Seite, setzen Sie in der Übersetzung denselben Code ein und ändern Sie die Sprache im Embed Studio (Parameter lang=en in der Adresse bzw. data-lang="en" beim Widget).

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

Element fehlt in der Auswahl: Ihr Benutzer darf „Reines HTML“ nicht verwenden. Ein Administrator kann es in den Rechten der Backend-Gruppe freigeben.
Content Security Policy: TYPO3 ab Version 12 kann eine CSP für das Frontend setzen. Ergänzen Sie dort app.my-store-locator.com für frame-src.
„Karte nicht verfügbar“: Die Karte ist noch ein Entwurf. Veröffentlichen Sie sie in der App.

Alle Optionen erklärt die Hilfe zum Einbetten.

FAQ

Brauche ich eine Extension?

Nein. Das Inhaltselement „Reines HTML“ gehört zum TYPO3-Kern und reicht. Unsere Extension macht es Redakteuren leichter: eigenes Inhaltselement, Verbinden statt Code kopieren, Zwei-Klick-Lösung eingebaut.

Kann ich die Karte in ein Seitentemplate fest einbauen?

Ja. Ihre Agentur kann den Code auch in ein Fluid-Template oder per TypoScript ausgeben. Für Redakteure ist das Inhaltselement meist einfacher.

Funktioniert das mit TYPO3 11, 12 und 13?

Das Inhaltselement „Reines HTML“ gibt es in allen diesen Versionen. Die Bezeichnungen im Backend können sich leicht unterscheiden. Unsere Extension unterstützt TYPO3 12.4 und 13.4.