Warenkorb-Add-ons - kostenpflichtige Zusatzoptionen

Installation

1. Plugin im Shopware-Account über den Marketplace beziehen oder die ZIP-Datei unter „Erweiterungen → Meine Erweiterungen“ manuell hochladen.
2. Unter „Erweiterungen → Meine Erweiterungen“ das Plugin installieren und anschließend aktivieren.
3. Cache leeren lässt Shopware automatisch. Sollte die Storefront die Add-ons nicht sofort zeigen, einmal manuell über „Einstellungen → System → Caches“ nachhelfen.

Wo finde ich das Plugin im Admin?

Nach der Aktivierung erscheint in der linken Seitenleiste unter Einstellungen der neue Eintrag „Priority-Optionen“. Dort werden alle Add-ons angelegt und gepflegt.

Eine Priority-Option anlegen

1. Auf „Priority-Option anlegen“ oben rechts klicken.
2. Card „Allgemein“: Name, Beschreibung, Aktiv, Steuerklasse, Sichtbarkeitsregel und Position (Sortier-Reihenfolge in der Toggle-Liste) setzen. Mehrsprachig pflegbar über den Sprach-Umschalter oben links.
3. In „Darstellung“ den Anzeige-Modus wählen (siehe unten). Je nach Modus erscheinen weitere Cards.
4. Card „Preis“: Endkunden-Preis brutto/netto eintragen. Pro Option ist zusätzlich ein Staffel-Preis-Block via Shopware-Rule-System möglich.
5. Card „Bild (Toggle-Cover)“: optionales kleines Thumbnail (~64×64 px) für die Auswahl-Liste im Warenkorb. Wird im Inline-Modus nicht genutzt, dort übernimmt das Badge-Icon.
6. Card „Verfügbarkeit pro Kontext“: sechs Toggles für die Storefront-Kontexte (siehe Abschnitt „Sichtbarkeit“).
7. Speichern – die Option ist sofort im Warenkorb verfügbar.

Anzeige-Modi (Card „Allgemein“ → Feld „Darstellung“)

Vier Modi pro Option wählbar – das bestimmt, wie der Kunde die Option im Warenkorb sieht und zubucht.

• Line Item (Standard): klassische Position im Warenkorb wie ein Produkt. Wird in der Bestellung als regulärer Posten geführt. Gut für Add-ons mit eigenem „Lieferumfang“-Charakter wie Geschenkverpackung.
• Badge: eigenes Banner im Warenkorb-Summary, frei positionierbar und farblich gestaltbar. Preis wird in der Gesamtsumme verrechnet, erscheint nicht als separate Cart-Zeile. Ideal für prominente Marketing-Add-ons (Priorisieren, Express).
• Summary-Zeile (wie Versandkosten): schlichte dt/dd-Zeile in der Zusammenfassung neben Versand und Gesamtsumme. Visuell un­auf­dring­lich. Gut für kleine Aufschläge wie Trinkgeld oder Klimaspende.
• Inline (im Toggle): eigene Card mit Icon-Tile, Untertitel und großem Toggle direkt in der Auswahl-Liste – die aktive Option bleibt dort sichtbar (kein zusätzliches Badge). Im Bestell-Kontext (Bestellabschluss/Konto) wird automatisch auf den Summary-Zeile-Modus zurückgegriffen.

Position im Warenkorb (Card „Anzeige“ → Feld „Position im Summary“)

Pro Add-on lässt sich wählen, wo es im Warenkorb-Layout erscheint. Acht Slots stehen zur Verfügung:

• Vor Versandkosten
• Nach Versandkosten
• Direkt vor Gesamtsumme
• Über dem Kasse-Button
• Unter dem Kasse-Button
• Über dem Gutschein-Feld
• Unter dem Gutschein-Feld
• Zwischen Artikel-Liste und Zwischensumme

Die Slots gelten für die Modi Badge und Inline. Für Summary-Zeile sind nur die ersten drei wirksam (alle anderen werden ignoriert, da sie außerhalb der Summary-Liste liegen) – im Admin steht dort der entsprechende Hinweis. Der Modus Line Item erscheint immer in der Cart-Position-Tabelle.

Sichtbarkeit (Card „Verfügbarkeit pro Kontext“)

Pro Add-on ist einzeln einstellbar, in welchen Storefront-Kontexten es angeboten wird:

• Im Warenkorb verfügbar
• Im Offcanvas-Warenkorb verfügbar
• Beim Checkout-Login/Registrieren verfügbar
• Auf der Checkout-Bestätigungsseite verfügbar
• Auf der Checkout-Abschlussseite verfügbar
• In der Bestellübersicht (Kundenkonto) verfügbar

Wichtig: einmal von einem Kunden aktivierte Optionen bleiben im Warenkorb erhalten, auch wenn sie in einem nachfolgenden Kontext nicht mehr angeboten werden. Die Sichtbarkeits-Steuerung blendet nur die Auswahl aus, nicht den bereits ausgewählten Posten. Das verhindert versehentliche Storno durch reine Navigation. Wer eine Option komplett verbergen will, setzt sie auf inaktiv im Tab „Allgemein“.

Badge-Einstellungen (nur bei Modus „Badge“ sichtbar)

Die Card „Badge-Einstellungen“ erscheint nur wenn als Modus Badge gewählt ist:

• Badge-Stil: Pill gefüllt (Default), Pill Outlined, Eckig Outlined oder Feature Card (mit Icon-Tile + Untertitel).
• Hintergrundfarbe + Textfarbe – freie Hex-Werte über den Color-Picker.
• Verhalten des Schließen-X am Badge – sechs Optionen, wie der „X“-Knopf am aktiven Badge erscheint und sich verhält:
  • Hover-Blur (Desktop) + Inline-X (Mobile, Standard) – empfohlener Default
  • Inline-X rechts (immer sichtbar)
  • Slide-Reveal (X slidet von rechts ein)
  • Top-Right-Overlay (kleiner Kreis außerhalb)
  • 2-Click-Bestätigung („Entfernen?“)
  • Kein X (Deaktivierung nur via Toggle)
• Badge-Icon (Media-Upload) + Icon-Füllfarbe + Icon-Hintergrundfarbe: dekorativer Icon-Kreis im Badge. Achtung: Icon-Füll-/-Hintergrundfarbe wirken via CSS-Mask nur mit einfarbigen SVG-Icons – bei PNG/JPG oder mehrfarbigen Logos beide Felder leer lassen.
• Untertitel + Untertitel im Badge anzeigen: kurzer Werbe-Subtext unter dem Namen (max. 255 Zeichen), z.B. „Lieferung morgen“ oder „Recyceltes Papier“. Optimal in Kombination mit Badge-Stil Feature Card.
• Toggle ausblenden, wenn aktiv (Card „Erweitert“): sobald das Badge aktiv ist, verschwindet der Toggle aus der Auswahl-Liste – der Kunde deaktiviert nur noch über das X am Badge. Reduziert Visual-Noise im Warenkorb.

Hinweis: Untertitel und Farbe wirken auch im Inline (im Toggle)-Modus – die Card heißt dort „Inline-Stil (Farbe & Icon)“ statt „Badge-Einstellungen“.

Anzeige (Card „Anzeige“)

• Größe: Kompakt, Normal oder Groß – steuert die Padding/Font-Skala des Badges.
• Position im Summary – siehe Slot-Tabelle oben.
• Anzeige in Bestellbestätigung & Bestellübersicht: In der Zusammenfassung (Standard) oder Oben prominent. Bestimmt wo die Option auf der Finish-Page und im Konto-Bereich angezeigt wird.

Toggle-Stil und 0 €-Anzeige

• Darstellung des Toggle-Schalters (Card „Erweitert“): Schalter (moderner On/Off-Switch) oder Checkbox.
• Preis-Anzeige bei 0 € (eigene Card): vier Varianten, wenn der berechnete Preis exakt 0 € ist:
  • „Kostenlos“ anzeigen
  • „0,00 €“ anzeigen
  • Nichts anzeigen
  • Eigener Text (z.B. „Inklusive“, übersetzbar pro Sprache)

Erweitert

• Eigene CSS-Klasse: wird zusätzlich an das Badge-Element gehängt – freier Stil-Hook im Theme.
• Abstands-Klasse (Container): Bootstrap-Spacing-Utilities (z.B. mt-2 mb-3 oder my-1) für den vertikalen Abstand zur Nachbar-Option.

Mehrsprachigkeit

Name, Beschreibung, Untertitel und der eigene 0 €-Text sind pro Sprache pflegbar – über den Sprach-Umschalter oben links auf der Detail-Seite. Storefront-Snippets (z.B. Schalter-Labels) lassen sich über das Shopware-Snippet-System für weitere Sprachen erweitern.

Drei konkrete Beispiele

Beispiel 1: „Express-Bearbeitung“ als auffälliges Badge

1. Neue Priority-Option anlegen, Name: „Express-Bearbeitung“, Beschreibung: „Ihre Bestellung wird heute vor 14 Uhr versandfertig gemacht.“
2. Card „Allgemein“: Darstellung = Badge.
3. Card „Preis“: 4,90 € brutto.
4. Card „Anzeige“: Größe = Normal, Position im Summary = Nach Versandkosten.
5. Card „Badge-Einstellungen“: Hintergrundfarbe = #F47B27 (Orange), Textfarbe = #FFFFFF, Badge-Stil = Pill gefüllt, Verhalten des Schließen-X = Hover-Blur.
6. Card „Erweitert“ (optional): Toggle ausblenden, wenn aktiv = an – Kunde deaktiviert nur über das X am Badge.
7. Speichern – im Warenkorb erscheint nun ein oranges Pill-Badge unterhalb der Versandkosten, sobald der Kunde den Toggle aktiviert.

Beispiel 2: „Geschenkverpackung“ als reguläre Cart-Position (Line Item)

1. Neue Priority-Option anlegen, Name: „Geschenkverpackung“, Beschreibung: „Wir verpacken Ihre Bestellung in geschenkfertiger Präsentation mit Schleife.“
2. Card „Allgemein“: Darstellung = Line Item (Standard).
3. Card „Preis“: 2,90 € brutto.
4. Card „Bild (Toggle-Cover)“: kleines Geschenk-Icon als Cover hochladen.
5. Card „Verfügbarkeit pro Kontext“: nur Im Warenkorb verfügbar + Im Offcanvas-Warenkorb verfügbar aktiv lassen (Checkout-Schritte aus – Kunde soll die Wahl nur einmal im Cart treffen).
6. Speichern – die Option erscheint als reguläre Cart-Zeile zwischen den Produkten, mit dem Cover-Icon links und dem Preis rechts.

Beispiel 3: „Klimaspende“ als dezente Summary-Zeile

1. Neue Priority-Option anlegen, Name: „Klimaspende“, Beschreibung: „1 € gehen an Aufforstungs-Projekte. Steuerlich begleitet durch unsere Partner-Organisation.“
2. Card „Allgemein“: Darstellung = Summary-Zeile (wie Versandkosten).
3. Card „Preis“: 1,00 € brutto.
4. Card „Anzeige“: Position im Summary = Direkt vor Gesamtsumme.
5. Card „Erweitert“: Darstellung des Toggle-Schalters = Checkbox (passt zum Charakter einer freiwilligen Zustimmung).
6. Speichern – im Warenkorb erscheint die Option in der Zusammenfassung wie eine zusätzliche Versandkosten-Zeile direkt über der Gesamtsumme.

Tipps

• Visual-Noise gering halten: nicht zu viele Add-ons im selben Slot. Drei Optionen wirken kuratiert – ab fünf wird’s gefühlt zur Pflicht-Auswahl.
• Badge für Premium, Summary-Zeile für Mikro-Aufschläge: teure Add-ons (Express, Wunschtermin) profitieren vom prominenten Badge-Modus. Niedrigpreisige (Klimaspende, Trinkgeld) wirken als Summary-Zeile glaubwürdiger.
• Mobile testen: der Offcanvas-Cart hat weniger Platz als die Desktop-Warenkorb-Seite – vor dem Live-Schalten kurz durchspielen.
• Sichtbarkeit testen: beim Anlegen einer neuen Option alle sechs Kontext-Checkboxen bewusst durchgehen – ungewollt versteckte Kontexte sind eine häufige Quelle für „Add-on erscheint nicht“-Tickets.
• 0 € mit Bedacht: bei Preis 0 € ist „Kostenlos“ meist die freundlichste Anzeige – „0,00 €“ wirkt bürokratisch.

Deinstallation

Unter „Erweiterungen → Meine Erweiterungen“ das Plugin deaktivieren und deinstallieren. Beim Deinstallieren lässt sich wählen, ob die Plugin-Daten (alle angelegten Optionen) erhalten bleiben oder mitgelöscht werden.