Promotion Badge für Shopware 6

1. Was macht das Plugin?

Das Plugin zeigt automatisch ein Rabatt-Badge an Produkten an, wenn Shopware für dieses Produkt eine passende Promotion berechnet.

Die Ausgabe ist möglich in:

• Kategorie-Listings
• Produktboxen
• Produktslidern
• CMS-Produktslidern
• Cross-Selling-Bereichen
• Produktdetailseiten

Das Badge wird nur angezeigt, wenn Shopware im Hintergrund erkennt, dass für das Produkt eine unterstützte Promotion gültig ist.

Dadurch bleibt die Logik zuverlässig: Nicht das Plugin entscheidet frei über Rabatte, sondern Shopware selbst berechnet die Promotion. Das Plugin macht diese Information sichtbar.

2. Für welche Aktionen ist das Plugin geeignet?

Das Plugin ist ideal für automatische Rabattaktionen ohne Gutscheincode.

Typische Beispiele:

• 8% EXTRA im Warenkorb
• 10% auf ausgewählte Produkte
• 5€ Rabatt auf bestimmte Artikel
• Kategorie-Aktionen
• Hersteller-Aktionen
• Aktionen auf dynamische Produktgruppen
• Weekend Sale
• Black Week Aktionen
• Saisonale Rabattaktionen

Besonders geeignet ist das Plugin für Aktionen, bei denen der Kunde keinen Code eingeben muss und der Rabatt automatisch im Warenkorb angewendet wird.

3. Empfohlene Shopware-Promotion-Einstellung

Damit das Badge zuverlässig angezeigt wird, sollte die Shopware-Promotion wie folgt angelegt werden.

Im Bereich Allgemein:

• Aktiv: Ja
• Aktionscode: Kein Aktionscode erforderlich
• Verkaufskanal: gewünschter Verkaufskanal
• Gültig ab / bis: optional

Im Bereich Bedingungen können Warenkorb-Regeln oder Kunden-Regeln verwendet werden, wenn die Aktion nur unter bestimmten Voraussetzungen gelten soll.

Beispiel:

Warenkorb-Regel: Produkt befindet sich im Warenkorb

Die wichtigste Einstellung befindet sich im Bereich Rabatte.

Empfohlene Konfiguration:

• Anwenden auf: Warenkorb
• Nur auf ausgewählte Produkte anwenden: Ja
• Produktregeln: gewünschte Produktregel auswählen
• Art: Prozentual oder Absolut
• Wert: z. B. 8 oder 5

Wichtig: Die Produktregel im Rabattbereich ist entscheidend. Darüber erkennt Shopware, welche Produkte tatsächlich rabattiert werden.

4. Plugin-Konfiguration

Das Plugin kann im Shopware Admin über die Plugin-Einstellungen konfiguriert werden.

• Plugin aktiv: Aktiviert oder deaktiviert das gesamte Plugin.
• Badge im Listing anzeigen: Steuert die Anzeige in Produktboxen, Kategorie-Listings und Suchergebnissen.
• Badge in Produktslidern anzeigen: Steuert die Anzeige in Produktslidern, CMS-Slidern und ähnlichen Produktboxen.
• Badge auf Detailseite anzeigen: Steuert die Anzeige auf der Produktdetailseite.
• Globale Warenkorb-Aktionen ohne Produktregel anzeigen: Ermöglicht optional die Anzeige globaler Aktionen ohne konkrete Produktregel.
• Debug-Modus aktiv: Dient nur zur technischen Prüfung in Entwicklungsumgebungen.

Der Debug-Modus sollte im Livebetrieb deaktiviert bleiben.

5. Badge-Texte und HTML

Die Badge-Texte können frei angepasst werden. HTML ist in den Badge-Texten erlaubt.

Standardtext für Listing / Produktbox:

%discount% EXTRA<br>im Warenkorb

Standardtext für die Detailseite:

%discount% EXTRA im Warenkorb

Folgende Platzhalter stehen zur Verfügung:

• %discount% = formatierter Rabattwert, z. B. 8% oder 5€
• %value% = reiner Zahlenwert, z. B. 8 oder 5
• %type% = Rabattart, z. B. percentage oder absolute

Beispiel mit HTML:

<span style="color: #fd0;">%discount%</span> EXTRA<br>im Warenkorb

In der config.xml muss HTML escaped werden.

<defaultValue>&lt;span style="color: #fd0;"&gt;%discount%&lt;/span&gt; EXTRA&lt;br&gt;im Warenkorb</defaultValue>

6. Design-Einstellungen

Das Badge kann optisch angepasst werden.

• Hintergrundfarbe
• Textfarbe
• Border-Radius
• Schriftgröße
• eigene CSS-Klasse

Beispiel:

Hintergrundfarbe: #000000
Textfarbe: #ffffff
Border-Radius: 4px
Schriftgröße: 12px

So lässt sich das Badge an das eigene Shop-Design anpassen.

7. Globale Warenkorb-Aktionen

Das Plugin unterstützt optional globale automatische Warenkorb-Aktionen.

Beispiel:

8% auf den gesamten Warenkorb
Kein Aktionscode erforderlich
Keine konkrete Produktregel

Da eine solche Aktion nicht an einzelne Produkte gebunden ist, kann der Badge bei aktivierter Option produktübergreifend erscheinen.

Deshalb ist diese Funktion standardmäßig deaktiviert.

Empfehlung:

• Für produktbezogene Aktionen: deaktiviert lassen
• Für globale Aktionen wie 8% auf alles: bewusst aktivieren

8. Was wird nicht unterstützt?

Version 1 des Plugins konzentriert sich bewusst auf automatische Produkt- und Warenkorb-Promotions ohne Aktionscode.

Nicht unterstützt werden aktuell:

• Gutscheincode-Aktionen
• feste Aktionscodes
• individuelle Aktionscodes
• Coupon-Badges
• 3-für-2-Aktionen
• Set-Gruppen
• Bundle-Logik
• Festpreis-Aktionen
• Versandkostenrabatte
• komplexe Mengen- oder Kombinationslogiken

Diese Aktionen können im Warenkorb korrekt funktionieren, lassen sich aber nicht immer zuverlässig vor dem Hinzufügen zum Warenkorb einem einzelnen Produkt zuordnen.

9. Häufige Fragen

Wird der Produktpreis durch das Plugin verändert?

Nein. Das Plugin verändert keine Produktpreise. Der Rabatt wird weiterhin durch die normale Shopware-Promotion im Warenkorb berechnet. Das Plugin zeigt nur den passenden Hinweis am Produkt an.

Warum erscheint kein Badge?

Prüfen Sie folgende Punkte:

• Ist das Plugin aktiv?
• Ist die Anzeige für Listing, Slider oder Detailseite aktiviert?
• Ist die Promotion aktiv?
• Ist die Promotion im richtigen Verkaufskanal gültig?
• Ist kein Aktionscode erforderlich?
• Wird der Rabatt auf den Warenkorb angewendet?
• Ist die Rabattart prozentual oder absolut?
• Greift die Promotion im Warenkorb tatsächlich?

Wenn die Promotion im Warenkorb nicht greift, erscheint auch kein Badge.

Muss die Promotion eine Produktregel haben?

Für produktbezogene Aktionen ist das empfohlen. Die beste Grundlage ist:

Nur auf ausgewählte Produkte anwenden: Ja
Produktregel im Rabattbereich gesetzt

So ist klar, welche Produkte rabattiert werden.

Funktioniert das Plugin mit Varianten?

Ja. Das Plugin prüft die Produktlogik über Shopware und berücksichtigt dabei auch Varianten bzw. Parent-/Child-Produkte, sofern die Promotion im Warenkorb für diese Produkte greift.

Funktioniert das Plugin in Produktslidern?

Ja. Das Plugin unterstützt Produktslider und CMS-Produktslider, sofern die Produkte von Shopware geladen und im Storefront-Template ausgegeben werden.

Funktioniert das Plugin auf der Produktdetailseite?

Ja. Das Badge kann auf der Produktdetailseite separat aktiviert oder deaktiviert werden.

Werden Gutscheincode-Aktionen angezeigt?

Nein. Gutscheincode-Aktionen werden in Version 1 bewusst nicht als Badge angezeigt.

Grund: Bei Gutscheincode-Aktionen muss der Kunde aktiv einen Code eingeben. Ein automatischer Badge am Produkt könnte sonst suggerieren, dass der Rabatt automatisch gilt.

10. Einrichtung kurz erklärt

Schritt 1: Shopware-Promotion anlegen.

Im Shopware Admin unter:

Marketing > Rabatte & Aktionen

eine neue Aktion erstellen.

Schritt 2: Aktionscode deaktivieren.

Kein Aktionscode erforderlich

Schritt 3: Rabatt konfigurieren.

Anwenden auf: Warenkorb
Nur auf ausgewählte Produkte anwenden: Ja
Produktregel auswählen
Art: Prozentual oder Absolut
Wert eintragen

Schritt 4: Plugin aktivieren.

Plugin aktiv: Ja
Badge im Listing anzeigen: Ja
Badge in Produktslidern anzeigen: Ja
Badge auf Detailseite anzeigen: Ja

Schritt 5: Frontend prüfen.

Öffnen Sie das betroffene Produkt im Shop. Wenn Shopware für dieses Produkt im Warenkorb einen Rabatt berechnet, erscheint das Badge automatisch im Listing, im Slider und auf der Produktdetailseite.