Zum Inhalt springen

Plugin-Dokumentation · JTL-Shop 5

Kauf-Sperrregeln für Artikel — Installation

Setup-Guide für die Installation des Plugins in JTL-Shop 5. Dauer: ca. 10 Minuten (zzgl. Wawi-Attributpflege je Artikel).

Voraussetzungen

  • JTL-Shop: Version 5.2.0 oder neuer
  • PHP: 8.1 oder neuer
  • Wawi-Funktionsattribute: Sperrregeln werden je Artikel als FunktionsAttribute in der Wawi gepflegt
  • Keine eigenen Datenbanktabellen — Kern-Tabellen (tartikelattribut, tartikel) werden ausschließlich gelesen

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.
  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-Admin Plugins → Plugin-Manager → Upload.
  2. Laden Sie das Plugin-Paket (ZIP) hoch. Der Ordnername im Archiv (webpowers_purchase_rules) darf nicht verändert werden.
  3. Wechseln Sie zum Tab Vorhanden, wählen Sie Kauf-Sperrregeln für Artikel (Kundengruppen, Gast, Länder) aus und klicken Sie auf Installieren.
  4. Aktivieren Sie das Plugin unter Installiert.

Sperrregeln in der Wawi anlegen

Am gewünschten Artikel die FunktionsAttribute anlegen (Namen sind im Plugin konfigurierbar, hier die Defaults):

  • kauf_nur_kundengruppen → CSV von Kundengruppen-IDs, z. B. 1,3 — NUR diese Gruppen dürfen kaufen
  • kauf_kein_gast → Wert 1 = nicht eingeloggte Besucher dürfen nicht kaufen
  • kauf_laender_verboten → CSV ISO-3166-1-alpha-2-Codes, z. B. CH,US — Kauf gesperrt, wenn das Session-Lieferland auf der Liste steht

Anschließend Wawi-Abgleich ausführen. Kundengruppen-IDs finden Sie unter Shop-Admin → Kunden → Kundengruppen (Spalte ID bzw. kKundengruppe).

Aktivierung

Öffnen Sie Plugins → Kauf-Sperrregeln → Einstellungen und prüfen Sie, dass „Plugin aktivieren“ auf Aktiviert steht. Prüfen Sie nach dem Wawi-Abgleich einmal im Frontend, dass die Sperre wie erwartet greift — das Parsing ist bewusst fail-open (ein Tippfehler in der Wawi macht den Artikel nicht versehentlich unverkäuflich). Details zu allen Einstellungen finden Sie in der Konfigurationsanleitung unter webpowers.org/docs/jtl-purchase-rules/konfiguration.

Deinstallation

Das Plugin kann jederzeit über den Plugin-Manager deinstalliert werden. Es legt keine eigenen Datenbanktabellen an — die Deinstallation ist rückstandsfrei.

Support

webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org