> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreizack-medien.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Einführung

> Kupons für deinen JTL Shop 5 mit Ausschlüssen: der Rabatt steckt direkt im Artikelpreis

## Was ist DZM Promo Plus?

DZM Promo Plus übernimmt die komplette Kupon-Funktion deines JTL Shop 5. Du legst Kupons wie gewohnt an, mit denselben Kupon-Arten wie in JTL: Standard, Versandkostenfrei und Neukunden. Dazu kommt, was der JTL-Kupon nicht kann: **Ausschlüsse**. Ein Kupon „10 % auf alles außer Gutscheine und Marke X“ ist eine Einstellung, keine endlose Freigabeliste.

Der Rabatt erscheint nicht als negative Rabattposition, sondern **senkt den Preis der Artikel im Warenkorb**. Deine Kunden sehen den reduzierten Preis direkt am Artikel, und in Rechnung und Warenwirtschaft steht der tatsächlich erzielte Artikelpreis.

> [accordion] Gilt für, Ausgenommen, Nur wenn Warenkorb enthält
>
> Lege fest, worauf rabattiert wird (Kategorien, Hersteller, Artikel), was nie rabattiert wird und welche Artikel im Warenkorb liegen müssen, damit der Kupon überhaupt gilt. Neue Artikel und Kategorien brauchen keine Pflege.

> [accordion] Geschützte Artikel
>
> Artikel mit dem Funktionsattribut `dzm_promo_excluded`, zum Beispiel Geschenkgutscheine, werden von keinem Kupon rabattiert.

> [accordion] Exakte Beträge
>
> Festbeträge und Höchstbeträge werden auf den Cent genau getroffen, ohne Zusatz- oder Rabattposition. Jeder Artikel bleibt eine Zeile, und der Zeilenbetrag stimmt in Warenkorb, Rechnung und Warenwirtschaft.

> [accordion] Einlösen per Feld, Link, Klick oder automatisch
>
> Neben dem normalen Kupon-Feld lösen deine Kunden Codes über Links (`?coupon=…`), über Buttons auf deinen Seiten oder ganz ohne Eingabe ein.

> [accordion] Kaufe N, erhalte M
>
> Mengenaktionen wie „3 für 2“ oder „das zweite Stück zum halben Preis“, gezählt über alle passenden Artikel oder je Artikel, auf Wunsch mit Höchstzahl je Warenkorb.

> [accordion] Gratisartikel
>
> Ein oder mehrere Artikel mit Menge kostenlos zum Kupon, automatisch oder zur Auswahl für den Kunden.

> [accordion] Im Shop bewerben
>
> Rabattbox auf der Artikelseite, Ribbon „Rabatt verfügbar“ in Listen, Top-Banner und Fortschrittsbalken bis zum Mindestbestellwert.

> [accordion] Viele Codes je Kupon
>
> Ein Kupon kann beliebig viele Codes haben, von Hand angelegt, per CSV importiert oder per Massengenerierung erzeugt, auch tausende individuelle Einmalcodes. Limits gelten je Kupon, je Code und je Kunde.

> [accordion] Import deiner JTL-Kupons
>
> Deine bestehenden JTL-Kupons übernimmst du mit Vorschau in einem Schritt, inklusive bisheriger Verwendungen. Ein Klick führt zurück zu den JTL-Kupons.

> [accordion] Statistik und Protokoll
>
> Je Einlösung Bestellung, Kunde, Bestellwert und Rabatt, dazu ein Protokoll je Bestellung mit dem Abzug jeder Position.

## Voraussetzungen

* JTL Shop 5.7.0 bis 5.8.x
* PHP 8.2 bis 8.5
* [DZM Resources & Health](https://docs.dreizack-medien.de/Resources-and-Health/einfuehrung.md) ab Version 1.17.1
* Templates: NOVA und NIU Plus. Für den Sidebar-Warenkorb von NIU Plus brauchst du zusätzlich den NIU Plus Companion ab 6.18.0 (Shop 5.7) bzw. 7.18.0 (Shop 5.8).

> [!NOTE]
>
> DZM Promo Plus ist kostenpflichtig. Ohne Lizenz ist die Engine im Shop abgeschaltet: Der Shop verhält sich, als wäre das Plugin nicht installiert. Mehr dazu unter [Lizenz](#lizenz).

> [!WARNING]
>
> Die Shop-Einstellung **Standardkuponabfrage bereits im Warenkorb** (Einstellungen → Warenkorb/Kaufabwicklung) muss aktiv sein. Sonst zeigt der Warenkorb kein Kupon-Feld an.

## Bereiche im Plugin

> [card] [Kupons](https://docs.dreizack-medien.de/DZM-Promo-Plus/kupons.md)
>
> Kupons anlegen, Codes verwalten und erzeugen

> [card] [Einlösen im Shop](https://docs.dreizack-medien.de/DZM-Promo-Plus/einloesen.md)
>
> Kupon-Feld, Links, Buttons und die Anzeige im Warenkorb

> [card] [So wird gerechnet](https://docs.dreizack-medien.de/DZM-Promo-Plus/berechnung.md)
>
> Verteilung, Kombination, Versandkostenfrei und Neukunden

> [card] [Im Shop bewerben](https://docs.dreizack-medien.de/DZM-Promo-Plus/bewerben.md)
>
> Rabattbox, Ribbon, Top-Banner und Fortschrittsbalken

> [card] [JTL-Import](https://docs.dreizack-medien.de/DZM-Promo-Plus/jtl-import.md)
>
> JTL-Kupons übernehmen und bei Bedarf zurückgeben

> [card] [Statistik](https://docs.dreizack-medien.de/DZM-Promo-Plus/statistik.md)
>
> Einlösungen, Rabatt und Protokoll je Bestellung

> [card] [Einstellungen](https://docs.dreizack-medien.de/DZM-Promo-Plus/einstellungen.md)
>
> Versand, Mindestbestellwert, Storno, Warenwirtschaft und Links

> [card] [Hinweise und Grenzen](https://docs.dreizack-medien.de/DZM-Promo-Plus/hinweise.md)
>
> Warenwirtschaft, Zahlungsarten, Datenschutz und Deaktivieren

> [card] Lizenz
>
> Trage hier deinen Lizenzschlüssel ein, wie bei allen anderen DZM Plugins.

## Schnellstart

**1. Plugin installieren**

Installiere bzw. aktualisiere zuerst [DZM Resources & Health](https://docs.dreizack-medien.de/Resources-and-Health/installation.md) auf mindestens Version 1.17.1. Danach installierst du DZM Promo Plus über den JTL Extension Store (**Meine Käufe**) oder lädst die ZIP-Datei im **Plugin-Manager** hoch und installierst sie unter **Vorhanden**.

**2. Setup-Assistent**

Öffne das Plugin im Backend. Der Setup-Assistent prüft, ob DZM Resources & Health in der nötigen Version installiert und aktiv ist, und zeigt dir, was noch fehlt. Den NIU Plus Companion führt er als optionale Abhängigkeit für den Sidebar-Warenkorb.

**3. Lizenz eintragen**

Trage deinen Lizenzschlüssel im Plugin unter **Lizenz** ein, wie bei allen anderen DZM Plugins.

**4. Bestehende JTL-Kupons übernehmen**

Hast du schon JTL-Kupons, öffne im Plugin **JTL-Import**, prüfe die Vorschau und importiere. Die übernommenen JTL-Kupons werden dabei deaktiviert, damit nicht beide Systeme denselben Code einlösen.

**5. Geschützte Artikel markieren**

Gib Geschenkgutscheinen und allen Artikeln, die nie rabattiert werden dürfen, in der Warenwirtschaft das Funktionsattribut `dzm_promo_excluded` mit dem Wert `1`.

**6. Ersten Kupon anlegen**

Öffne **Kupons → Neuer Kupon**, trage Name, Rabatt und Code ein und speichere. Der Kupon wirkt sofort im Shop.

> [!TIP]
>
> **Geschafft!** Lege einen passenden Artikel in den Warenkorb und löse den Code ein. Am Artikel siehst du den durchgestrichenen Originalpreis und den Kupon mit seinem Abzug.

## Lizenz

DZM Promo Plus ist kostenpflichtig. Wird keine Lizenz erkannt, erscheint im Backend der Hinweis „Lizenz nicht erkannt, Kupons und Aktionen sind im Shop abgeschaltet“. Dann gilt:

* Im Shop gelten weder die Codes noch die automatischen Aktionen des Plugins, und alle Anzeigen sind aus. Der Shop verhält sich, als wäre das Plugin nicht installiert.
* Gratisartikel, die schon in einem Warenkorb liegen, werden entfernt. Sie würden sonst den vollen Preis kosten.
* Stornos aus der Warenwirtschaft geben Verwendungen weiter frei, damit die Zähler stimmen.
* Die Plugin-Oberfläche im Backend bleibt bedienbar. Die Einstellungen lassen sich aber erst mit Lizenz speichern.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.