Skip to main content

Überblick

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

Rabattbox

Auf der Artikelseite: Rabatt, Bedingungen, Code zum Kopieren und „Aktivieren“, in drei Darstellungen.

Ribbon

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

Top-Banner

Leiste oben auf jeder Seite mit Code und „Aktivieren“.

Fortschrittsbalken

Im Warenkorb: „Noch 12,50 € bis Herbstaktion“ für Kupons mit Mindestbestellwert.
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:
boolean
Zeigt das Ribbon an jedem Artikel, für den der Kupon gilt.
boolean
Zeigt den Kupon in der Rabattbox der Artikelseite, wenn er für den Artikel gilt.
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).
boolean
Zeigt den Kupon in der Leiste oben auf jeder Seite.
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“.
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

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.
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“.
Standard: unter dem Warenkorb-Bereich (#add-to-cart), in NOVA und NIU Plus. Unter Einstellungen setzt du einen eigenen Platz.

Darstellungen

Die Darstellung der Rabattbox wählst du global unter Einstellungen. 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.
Karte im Stil eines Gutscheins mit abgesetztem Wertfeld und Code mit Button.
Derselbe Inhalt als schlichter 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“.
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 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.
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 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.
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:
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 ein.
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.
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.