Plugin-Dokumentation · JTL-Shop 5
Bonuspunkte – Kundenbindungsprogramm — Installation
Setup-Guide für die Installation des Plugins in JTL-Shop 5. Dauer: ca. 10 Minuten.
Voraussetzungen
- JTL-Shop: Version 5.2.0 oder neuer
- Kundenkonten: Punkte sammeln nur registrierte Kunden; Gastbestellungen sammeln keine Punkte
- Wawi-Abgleich muss laufen: Bestellstatuswechsel (z. B. „Versendet") kommen aus dem regulären Wawi-Sync des Shops. Das Plugin gleicht darauf basierend alle 6 Stunden ab (traffic-getriggert)
- Standardwährung: das Plugin ist nicht für Multi-Currency-Shops ausgelegt
- Datenbank: das Plugin legt eigene Tabellen an (
wplp_ledger,wplp_state)
Installation über den JTL-Extension Store
- Erwerben Sie die Erweiterung im JTL-Extension Store. Sie wird dadurch mit Ihrer Shop-Lizenz verknüpft.
- Öffnen Sie im JTL-Shop-Backend Plugins → Meine Erweiterungen. Die Erweiterung erscheint dort nach kurzer Zeit automatisch.
- Klicken Sie auf Installieren. Der Shop legt dabei die Plugin-Tabellen automatisch an.
- Aktivieren Sie das Plugin anschließend im Plugin-Manager unter Installiert, falls es nicht bereits aktiv ist.
Alternative: manuelle Installation (ZIP)
- Öffnen Sie im JTL-Shop-Backend Plugins → Plugin-Manager und wählen Sie den Tab Upload.
- Laden Sie das Plugin-Paket (ZIP) hoch. Der Ordnername im Archiv (
webpowers_loyalty_points) darf nicht verändert werden. - Wechseln Sie zum Tab Vorhanden, wählen Sie Bonuspunkte – Kundenbindungsprogramm aus und klicken Sie auf Installieren.
- Aktivieren Sie das Plugin unter Installiert.
Aktivierung
Öffnen Sie Plugins → Bonuspunkte → Einstellungen und prüfen Sie, dass „Plugin aktivieren" auf Aktiviert steht. Wichtig: Bestellungen und Registrierungen vor der Installation werden bewusst nicht rückwirkend bepunktet — der erste Gutschrift-Durchlauf berücksichtigt nur Bestellungen seit der Installation. Bestandskunden können über manuelle Buchungen im Dashboard nachträglich Punkte erhalten. Details zu allen Einstellungen, zur Gutschrift-Logik (6-Stunden-Abgleich) und zur Einlösung finden Sie in der Konfigurationsanleitung unter webpowers.org/docs/jtl-loyalty-points/konfiguration.
Punktekonto im Kundenkonto
Das Plugin registriert eine eigene Frontend-Seite /punktekonto und blendet auf der „Mein Konto"-Seite automatisch eine Punktestand-Kachel mit Link ein. Es ist keine manuelle Verlinkung nötig.
Deinstallation
Das Plugin kann jederzeit über den Plugin-Manager deinstalliert werden. Bereits erzeugte Gutscheine bleiben gültig, da sie in den Kern-Kupontabellen liegen und vom Kunden mit Punkten bezahlt wurden. Bei Deinstallation mit „Daten löschen" werden Punktestände und Historie (wplp_ledger, wplp_state) entfernt.
Support
webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org
