Store-Locator – Überblick & Installation

Der Store-Locator zeigt Ihre Filialen, Geschäfte, Abholstationen oder Servicepartner auf einer interaktiven Google-Maps-Karte im Shop-Frontend. Kunden können nach Adresse, PLZ oder Ort suchen; passende Standorte werden im gewählten Umkreis angezeigt und nach Entfernung sortiert.

Funktionen im Überblick

• Interaktive Google-Maps-Karte mit eigenen Markern
• Umkreissuche mit Google-Places-Adressvorschlägen (Autocomplete)
• Entfernungsanzeige zu jedem Fundort (Luftlinie)
• Automatische Geocodierung der eingegebenen Adressen
• Öffnungszeiten je Filiale (optional, mehrzeilig)
• Zeitraumbegrenzung für temporäre Standorte (z. B. Pop-up-Stores)
• CSV-Import und -Export der Filialliste
• Anpassbares Karten-Icon und Icon-Größe
• Wählbarer Bootstrap-Stil für den Suchen-Button

Voraussetzungen

• JTL-Shop ab Version 5.1.0.
• Ein Google-Cloud-Projekt mit aktiviertem, gültigem API-Schlüssel. Dafür müssen folgende Google-APIs aktiviert sein: Maps JavaScript API, Places API, Distance Matrix API und Geocoding API.

Ohne aktivierten API-Schlüssel wird weder die Karte angezeigt, noch können Adressen automatisch in Koordinaten umgerechnet werden.

Installation

1. Laden Sie die Plugin-ZIP im JTL-Shop-Backend unter „Plugins → Plugin-Manager" hoch (Reiter „Hochladen").
2. Installieren Sie das Plugin anschließend unter „Verfügbar".
3. Richten Sie es danach unter „Plugins → SALEPIX Store-Locator" ein.

Das Plugin ist auch über den JTL-Extension-Store erhältlich.

Nach der Installation wird für Ihre Domain automatisch ein zeitlich begrenzter Demo-Zeitraum aktiviert. Für die weitere Nutzung nach Ablauf der Demo ist eine Lizenz erforderlich; einen entsprechenden Hinweis mit Erwerbs-Link zeigt das Backend an, sobald keine gültige Lizenz mehr vorliegt.

Schnellstart

1. Öffnen Sie „Plugins → SALEPIX Store-Locator → Einstellungen" und tragen Sie Ihren Google-Maps-API-Schlüssel ein.
2. Legen Sie Mittelpunkt (Latitude/Longitude) und Zoomstufe der Karte fest – diese Ansicht sehen Kunden, solange sie noch keine eigene Suche gestartet haben.
3. Legen Sie unter „Plugins → SALEPIX Store-Locator → Adressen" Ihre erste Filiale an.
4. Rufen Sie die Store-Locator-Seite unter der SEO-URL /store-locator im Frontend auf, um das Ergebnis zu prüfen.

Weitere Artikel dieser Dokumentation: Filialen verwalten, Einstellungen, Frontend & Häufige Fragen.