Plugin-Dokumentation · JTL-Shop 5
Gutschein-Manager Pro — Konfiguration & Bedienung
Das Plugin hat keine globalen Plugin-Einstellungen. Alle Angaben erfolgen direkt beim Anlegen bzw. Bearbeiten eines Gutscheins im Dashboard (Plugins → Gutschein-Manager).
Das Dashboard
Das Dashboard zeigt oben Statistik-Kacheln, ein Nutzungs-Diagramm der letzten 30 Tage und eine Ablauf-Warnung für Gutscheine, die innerhalb der nächsten 7 Tage ungültig werden. Darunter finden Sie die Gutschein-Liste mit Bearbeiten-, Duplizieren- und Löschen-Funktion.
Felder beim Anlegen/Bearbeiten eines Gutscheins
| Feld | Wirkung |
|---|---|
| Name / Code | Interner Name des Gutscheins sowie der einlösbare Code. Der Code muss shopweit eindeutig sein — bereits vergebene Codes werden beim Speichern abgelehnt. |
| Gutschein-Typ | Standard-Gutschein, Neukundengutschein oder Versandkostengutschein. |
| Wert-Typ / Wert | Prozentualer Nachlass (0–100, serverseitig begrenzt) oder ein fester Betrag. |
| Mindestbestellwert | Der Gutschein greift nur, wenn der Warenkorb diesen Wert erreicht. |
| Verwendungen gesamt / je Kunde | Obergrenze für die Gesamtzahl der Einlösungen sowie je Kunde. |
| Gültig ab / Gültig bis | Zeitraum, in dem der Code einlösbar ist. Ohne Enddatum bleibt der Gutschein unbegrenzt gültig. |
| Aktiv | Schaltet den Gutschein unabhängig vom Gültigkeitszeitraum ein oder aus. |
| Zuordnung: Artikel / Kategorie / Hersteller / Kunde | Tag-Picker mit Live-Suche, um den Gutschein auf bestimmte Artikel, Kategorien, Hersteller oder Kunden einzuschränken. |
| Ausschlusslisten: Artikel / Kategorie / Hersteller / Kunde | Getrennt von der Zuordnung: Artikel, Kategorien, Hersteller oder Kunden, für die der Gutschein trotz sonst passender Kriterien nicht gilt. |
| Lieferländer | Auf welche Lieferländer der Gutschein beschränkt ist (Standard: DE). |
| Zusatzgebühren einbeziehen / Gesamten Warenkorb rabattieren | Steuert, ob Zusatzgebühren in die Rabattberechnung einfließen und ob sich der Rabatt auf den gesamten Warenkorb statt nur die zugeordneten Positionen bezieht. |
| Kundengruppe / Steuerklasse | Optionale Einschränkung auf eine bestimmte Kundengruppe sowie die für die Berechnung anzusetzende Steuerklasse. |
Ausschlusslisten und ihre Prüfung im Warenkorb
Die Ausschlusslisten (Artikel/Kategorie/Hersteller/Kunde) je Gutschein werden beim Einlösen des Codes im Warenkorb tatsächlich geprüft: Enthält der Warenkorb einen ausgeschlossenen Artikel bzw. eine ausgeschlossene Kategorie oder einen ausgeschlossenen Hersteller, oder steht der Kunde auf der Ausschlussliste, wird der Code abgelehnt. Tritt dabei ein interner Fehler im Plugin auf, wird der Gutschein nicht fälschlich blockiert (fail-open) — die Einlösung läuft in diesem Fall wie ohne Ausschlussprüfung weiter.
Bulk-Generator
Erzeugt in einem Durchgang bis zu 500 Gutscheincodes mit gemeinsamen Eigenschaften:
- Präfix: wird jedem generierten Code vorangestellt
- Anzahl: bis zu 500 Codes je Durchgang
- Typ, Wert-Typ, Wert: wie beim Einzelgutschein
- Mindestbestellwert, Gültig bis, max. Verwendungen, Aktiv: für alle generierten Codes identisch
Jeder Code erhält einen zufälligen, eindeutigen Suffix (aus kryptografisch sicheren Zufallsbytes), sodass keine zwei generierten Codes kollidieren.
CSV-Import und -Export
- Export: exportiert die aktuelle Gutschein-Liste als CSV; Felder, die mit
= + - @beginnen, werden mit einem führenden Apostroph versehen (Schutz vor Formel-Injection beim Öffnen in Excel). - Import: akzeptiert ausschließlich Dateien mit der Endung
.csvbis maximal 5 MB.
Weitere Funktionen
- Duplizieren: legt eine Kopie eines bestehenden Gutscheins an, die anschließend angepasst werden kann.
- A/B-Varianten: mehrere Codes mit unterschiedlichen Werten für Tests.
- QR-Code: Anzeige eines QR-Codes zum jeweiligen Gutschein, z. B. für Print-Aktionen.
- Per E-Mail versenden: Gutschein direkt an eine E-Mail-Adresse verschicken (über den JTL-Mailer).
Häufige Fragen
Warum finde ich keine „Einstellungen"-Seite?
Das Plugin hat keine globalen Einstellungen. Alles wird direkt am jeweiligen Gutschein konfiguriert.
Was passiert, wenn die Ausschlussprüfung fehlschlägt?
Ein interner Fehler im Plugin führt nie dazu, dass ein Gutschein fälschlich blockiert wird (fail-open bei Plugin-internen Ausnahmen).
Was passiert bei der Deinstallation?
Sie können die Zusatztabelle mit den Ausschlusslisten beim Deinstallieren optional löschen. Die über den JTL-Kern verwalteten Gutscheine selbst bleiben davon unberührt.
Support
webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org