> ## 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.

# Im Shop bewerben

> Rabattbox auf der Artikelseite, Ribbon in Artikellisten, Top-Banner und Fortschrittsbalken im Warenkorb, angepasst per CSS oder eigener Vorlage

## Überblick

Außerhalb des Warenkorbs machst du Kupons an drei Stellen sichtbar. Dazu kommt ein Fortschrittsbalken im Warenkorb.

> [card] Rabattbox
>
> Auf der Artikelseite: Rabatt, Bedingungen, Code zum Kopieren und „Aktivieren“, in drei Darstellungen.

> [card] Ribbon
>
> In Artikellisten: „Rabatt verfügbar“ am Artikelbild jedes Artikels, für den ein Kupon gilt.

> [card] Top-Banner
>
> Leiste oben auf jeder Seite mit Code und „Aktivieren“.

> [card] Fortschrittsbalken
>
> Im Warenkorb: „Noch 12,50 € bis Herbstaktion“ für Kupons mit Mindestbestellwert.

> [!WARNING]
>
> Es erscheinen **nur Kupons, bei denen du es am Kupon einschaltest**. Persönliche Codes oder Newsletter-Codes werden so nie versehentlich öffentlich.

## Am Kupon einschalten

Im Kupon unter **Im Shop bewerben**:

**Ribbon in der Artikelliste** `boolean`

Zeigt das Ribbon an jedem Artikel, für den der Kupon gilt.

**Rabattbox auf der Artikelseite** `boolean`

Zeigt den Kupon in der Rabattbox der Artikelseite, wenn er für den Artikel gilt.

**Darstellung der Rabattbox** `select`

Nur mit Rabattbox. **Wie in den Einstellungen** (Vorbelegung), **Abriss-Coupon (Standard)**, **Kompakter Kasten** oder **Clip-Zeile ohne Kasten**. So zeigst du zum Beispiel eine Aktion auffälliger als die übrigen. Eine kleine Vorschau neben dem Feld zeigt die Form (siehe [Darstellungen](#darstellungen)).

**Top-Banner** `boolean`

Zeigt den Kupon in der Leiste oben auf jeder Seite.

**Gezeigter Code** `string`

Welcher Code erscheint. Leer = der einzige Code des Kupons. Hat der Kupon mehrere Codes, zum Beispiel persönliche Codes aus der Massengenerierung, erscheint er ohne gezeigten Code nicht in Rabattbox, Top-Banner und Fortschrittsbalken. So wird kein persönlicher Code öffentlich. Bei automatischen Kupons gibt es keinen Code: Dort steht „Wird automatisch im Warenkorb abgezogen“.

**Texte je Sprache** `string`

Ribbon-Text, Box-Titel, Box-Text und Banner-Text. Leer = Standardtext: „Rabatt verfügbar“, der Anzeigename des Kupons bzw. „Name – mit dem Code CODE“. Die Standardtexte änderst du in den Sprachvariablen.

## Für wen ein Kupon erscheint

Box und Ribbon erscheinen nur, wenn der Kupon für den Artikel **und** den Kunden gilt:

* aktiv und im Gültigkeitszeitraum,
* passende Kundengruppe und, falls gesetzt, der richtige Kunde,
* Neukunden-Kupons, solange nicht feststeht, dass der Kunde kein Neukunde ist,
* der Artikel passt zu „Gilt für“, ist nicht ausgenommen, nicht geschützt und – falls eingestellt – nicht reduziert.

Bedingungen, die vom Warenkorb abhängen (Mindestbestellwert, „Nur wenn der Warenkorb enthält“), stehen als Text in der Rabattbox. Das Top-Banner prüft nur Gültigkeit und Kunde, nicht den Artikel.

Gelten mehrere Kupons, stehen sie in der Rabattbox untereinander, der stärkste zuerst: Prozent-Kupons und Mengenaktionen vor Festbeträgen vor Versandkostenfrei, innerhalb jeweils der höhere Rabatt zuerst. Das Ribbon zeigt den Text des stärksten Kupons.

## Rabattbox

> [accordion] Inhalt
>
> Titel, Angebot („10 % Rabatt auf diesen Artikel“, „Kaufe 2, erhalte 1 gratis“), Gratisartikel, dein Box-Text, Bedingungen (zum Beispiel „ab 50,00 € Bestellwert“, „gültig bis 30.11.2026“), der Code mit **Kopieren** und die Schaltfläche **Aktivieren**.

> [accordion] Aktivieren
>
> Ein Klick merkt den Code vor, ohne die Seite neu zu laden. Er wirkt, sobald passende Artikel im Warenkorb liegen. Die Schaltfläche wird zu „Kupon ist aktiv“.

> [accordion] Position
>
> Standard: unter dem Warenkorb-Bereich (`#add-to-cart`), in NOVA und NIU Plus. Unter [Einstellungen](https://docs.dreizack-medien.de/DZM-Promo-Plus/einstellungen.md) setzt du einen eigenen Platz.

### Darstellungen

Die Darstellung der Rabattbox wählst du global unter [Einstellungen](https://docs.dreizack-medien.de/DZM-Promo-Plus/einstellungen.md#im-shop-bewerben). Einzelne Kupons können am Kupon eine eigene Darstellung haben. Zeigt die Box Kupons mit verschiedenen Darstellungen, bekommt jede Darstellung einen eigenen Block, die Reihenfolge bleibt. Farbe und Schrift übernimmt die Box vom Template.

> [accordion] Abriss-Coupon (Standard)
>
> Karte im Stil eines Gutscheins mit abgesetztem Wertfeld und Code mit Button.

> [accordion] Kompakter Kasten
>
> Derselbe Inhalt als schlichter Kasten.

> [accordion] Clip-Zeile ohne Kasten
>
> Eine einzelne Zeile mit Wert, Name, Code und „Aktivieren“, ohne Rahmen.

## Ribbon in Artikellisten

Das Ribbon erscheint an den Artikelkarten in Kategorie- und Suchergebnissen, in Boxen auf der Startseite und bei „Passende Artikel“, nicht in Warenkorb und Checkout. Standardplatz ist unten links im Artikelbild. Es zeigt keinen Code. Ohne eigenen Ribbon-Text zeigt eine Aktion „Kaufe N, erhalte M“ die Kurzform, zum Beispiel „3 für 2“.

> [!NOTE]
>
> Kleine Listen in der Seitenleiste (zum Beispiel „Zuletzt angesehen“) und einzelne Slider bekommen kein Ribbon.

## Top-Banner

Die Leiste steht oben auf jeder Seite außer im Checkout, je Kupon eine Zeile mit dem Banner-Text, dem Code und **Aktivieren**. Über das × blendet der Kunde sie für seinen Besuch aus. Kommt ein anderer Kupon dazu, erscheint sie wieder. Farben stellst du unter [Einstellungen](https://docs.dreizack-medien.de/DZM-Promo-Plus/einstellungen.md) ein.

## Fortschrittsbalken

Im Warenkorb und im seitlichen Warenkorb von NIU Plus erscheint ein Balken, wenn ein Kupon nur noch am Mindestbestellwert scheitert. Infrage kommen Kupons, die der Kunde schon per Link oder Klick vorgemerkt hat, automatische Kupons und Kupons, die du im Shop bewirbst. Es erscheinen höchstens zwei, der kleinste Restbetrag zuerst.

> [!NOTE]
>
> Gezählt wird der Warenwert vor Rabatt, genauso wie bei der Prüfung des Mindestbestellwerts. Gratisartikel zählen nicht mit.

Einen eigenen Schalter hat der Balken nicht: Er erscheint, sobald ein solcher Kupon den Mindestbestellwert noch nicht erreicht. Ein beworbener Kupon mit mehreren Codes erscheint ohne **Gezeigten Code** nicht im Balken.

## Optik anpassen

Alle Elemente des Plugins übernehmen Schrift, Farben und Eckenradien deines Templates. In NIU Plus mit [Theme v2](https://docs.dreizack-medien.de/NIU-Plus/theme-2-0.md) folgen sie den Einstellungen des Companion, auch im Dunkelmodus. In NOVA und älteren Templates fallen sie auf feste, zurückhaltende Werte zurück. Das gilt für Rabattbox, Ribbon, Top-Banner und Fortschrittsbalken ebenso wie für die [Anzeige im Warenkorb](https://docs.dreizack-medien.de/DZM-Promo-Plus/einloesen.md#anzeige-im-warenkorb).

> [!TIP]
>
> **Erst CSS, dann Vorlage.** Für Farben, Abstände und Radien reichen fast immer die CSS-Variablen. Eine kopierte Vorlage friert das Markup ein und bekommt Verbesserungen und Fehlerbehebungen aus späteren Updates nicht mehr mit.

### Per CSS-Variablen

Jeder Wert lässt sich einzeln übersteuern, im CSS deines Child-Templates oder Themes:

```css theme={null}
.dzm-promo {
  --dzm-promo-accent: #c0392b;
  --dzm-promo-radius-card: 0;
}
```

| Variable | Wirkung | Standard |
| - | - | - |
| `--dzm-promo-accent` | Akzentfarbe | Akzent bzw. Primärfarbe des Templates, sonst ein festes Grün |
| `--dzm-promo-on-accent` | Schriftfarbe auf der Akzentfarbe | automatisch hell oder dunkel |
| `--dzm-promo-ink` | Akzent für Text und Symbole | Akzent, zur Textfarbe hin abgedunkelt |
| `--dzm-promo-surface` | Fläche von Karten und Kästen | Kartenfläche des Templates bzw. durchsichtig |
| `--dzm-promo-text` | Textfarbe auf Karten | Kartentext des Templates bzw. geerbt |
| `--dzm-promo-border` | Rahmenfarbe | Rahmenfarbe des Templates |
| `--dzm-promo-radius` | Eckenradius von Knöpfen und Feldern | Radius der Bedienelemente im Template |
| `--dzm-promo-radius-card` | Eckenradius von Karten und Kästen | Kartenradius des Templates |
| `--dzm-promo-ticket-shadow` | Schatten des Abriss-Coupons, z. B. `drop-shadow(0 3px 8px rgba(0, 0, 0, .1))` | keiner |

Für gezielte Änderungen tragen alle Elemente eigene Klassen mit dem Präfix `dzm-promo-`. Die Farben des Top-Banners stellst du ohne CSS in den [Einstellungen](https://docs.dreizack-medien.de/DZM-Promo-Plus/einstellungen.md) ein.

> [!NOTE]
>
> NOVA gibt den Eckenradius nicht als CSS-Variable aus. Hat dein NOVA-Shop einen anderen Radius als den Standard, setze `--dzm-promo-radius` selbst.

### Per eigener Vorlage

Reicht CSS nicht, ersetzt du eine Vorlage des Plugins durch eine eigene. Lege dazu neben der Originaldatei im Plugin-Ordner unter `frontend/injections/` eine Kopie mit der Endung `_custom.tpl` an, zum Beispiel `promo_box_custom.tpl` neben `promo_box.tpl`. Liegt eine solche Datei vor, nimmt das Plugin sie statt des Originals. Eigene Vorlagen überstehen Plugin-Updates.

| Vorlage | Wo |
| - | - |
| `promo_box`, `promo_box_clip` | Rabattbox auf der Artikelseite (`promo_box` für Abriss-Coupon und Kompakter Kasten, `promo_box_clip` für die Clip-Zeile) |
| `promo_banner` | Top-Banner |
| `promo_ribbon` | Ribbon an Artikelkarten |
| `promo_progress` | Fortschrittsbalken (Warenkorbseite und Sidebar-Warenkorb) |
| `active_codes`, `sidebar_codes` | Liste der eingelösten Kupons (Warenkorb und Checkout bzw. Sidebar-Warenkorb) |
| `position_badge`, `position_hints` | Originalpreis und Abzüge je Warenkorbzeile, `position_hints` auch in der Bestellübersicht von NOVA |
| `sidebar_position` | Abzüge je Artikel im Sidebar-Warenkorb und in der Bestellübersicht von NIU Plus |
| `position_gift` | Hinweis „Gratisgeschenk“ (Warenkorb, Bestellübersicht, Sidebar-Warenkorb) |
| `position_gift_form` | Formular „Anderes Geschenk wählen“ |
| `styles`, `apply_assets` | Einbindung von Stylesheet und Skript |

> [!WARNING]
>
> Vergleiche deine eigene Vorlage nach einem Plugin-Update mit dem neuen Original. Neue Funktionen und Fehlerbehebungen in der Vorlage kommen sonst nicht in deinem Shop an. Die Vorlagen `styles` und `apply_assets` binden Stylesheet und Klick-Einlösung ein. Ersetze sie nur, wenn du genau weißt, was du tust.


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