Zum Inhalt springen

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

  1. Erwerben Sie die Erweiterung im JTL-Extension Store. Sie wird dadurch mit Ihrer Shop-Lizenz verknüpft.
  2. Öffnen Sie im JTL-Shop-Backend Plugins → Meine Erweiterungen. Die Erweiterung erscheint dort nach kurzer Zeit automatisch.
  3. Klicken Sie auf Installieren. Der Shop legt dabei die Plugin-Tabellen automatisch an.
  4. Aktivieren Sie das Plugin anschließend im Plugin-Manager unter Installiert, falls es nicht bereits aktiv ist.

Alternative: manuelle Installation (ZIP)

  1. Öffnen Sie im JTL-Shop-Backend Plugins → Plugin-Manager und wählen Sie den Tab Upload.
  2. Laden Sie das Plugin-Paket (ZIP) hoch. Der Ordnername im Archiv (webpowers_loyalty_points) darf nicht verändert werden.
  3. Wechseln Sie zum Tab Vorhanden, wählen Sie Bonuspunkte – Kundenbindungsprogramm aus und klicken Sie auf Installieren.
  4. 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