Konfigurationsreferenz

Technische Referenz für Ultimate Upsell Engine: Plugin-Einstellungen, Platzierungs-Slots, CMS-Elemente, Entitäten und Rechte. Schritt-für-Schritt-Anleitungen finden Sie im Tutorial und in den Anleitungen.

Plugin-Einstellungen

Zu finden unter Erweiterungen > Meine Erweiterungen > Ultimate Upsell Engine > Konfiguration. Diese Tabelle wird aus der config.xml des Plugins generiert.

Allgemein

Setting	Type	Default	Description
trackingEnabled — Storefront-Tracking aktivieren	bool	true	Wenn deaktiviert, werden keine Impression/Klick/Accept-Ereignisse gespeichert und die "Statistik anzeigen"-Aktionen im Admin werden ausgeblendet.

Platzierungs-Slots

Jedes Offer rendert in genau einem Slot. Die Slot-Namen erscheinen im Wo-Tab des Editors und in der Seitenleiste der Offer-Liste.

Slot	Position im Admin	Erscheint
pdp_content	Unter der Produktbeschreibung	Unter der Produktbeschreibung auf jeder Produktseite
pdp_sticky	Neben dem „Kaufen“-Button	Neben dem Kaufen-Button auf jeder Produktseite
cart_above_summary	Über der Warenkorb-Zusammenfassung	Über der Warenkorb-Zusammenfassung auf der Warenkorbseite
cart_drawer	Im Warenkorb-Drawer	Unten im Off-Canvas-Warenkorb
checkout_sidebar	Checkout-Sidebar	Unter der Warenkorb-Zusammenfassung in der Checkout-Seitenleiste — verändert den Warenkorb nicht
thank_you	Nach den Bestelldetails	Unter den Bestelldetails auf der Bestellbestätigungsseite
free_shipping_bar	Versandkosten-Fortschrittsbalken	Oben im Warenkorb-Drawer und auf der Warenkorbseite

CMS-Elemente

Das Plugin registriert eine CMS-Block-Kategorie, Ultimate Upsell, mit diesen Elementen für Offer-Layouts (und jede andere CMS-Seite):

Element	Zweck	Konfiguration
Upsell-Produktslider	Große Produktkarten im Slider; erweitert Shopwares nativen Produktslider und erbt dessen Styling	Produkte, Überschrift, Slider-Verhalten (wie der native Slider)
Upsell-Produktzeile	Kompakte horizontale Produktzeilen für schmale Kontexte (Drawer, Checkout-Sidebar, Kaufbox)	Produkte, Überschrift, „In den Warenkorb“-Button pro Zeile an/aus
Upsell-CTA	Annehmen/Verwerfen-Buttons für ein Offer	Beschriftung Annehmen-Button, Verwerfen-Button an/aus + Beschriftung, Button-Stil (Primär/Sekundär/Erfolg)
Countdown	Fristen-Timer	Endet am, Beschriftung, Beschriftung nach Ablauf
Versandkosten-Fortschrittsbalken	Fortschritt zur Versandkostenfrei-Schwelle	Schwellenwert, Fortschrittsnachricht (Platzhalter {remaining}), Abschlussnachricht

Offer-Felder

Feld	Tab	Bedeutung
Name	Allgemein	Interne Bezeichnung; Kunden sehen sie nie
Interne Beschreibung	Allgemein	Notizen fürs Team; nicht im Storefront sichtbar
Priorität	Allgemein	Höhere Zahlen werden zuerst gerendert, wenn mehrere Offers denselben Slot beanspruchen; Standard 0
Aktiv	obere Leiste	Veröffentlichen/Zurückziehen; ein Offer im Entwurf rendert nie
Regeln	Wann	Rule-Builder-Regeln; alle gewählten Regeln müssen zutreffen; leer = alle
Seite / Position	Wo	Der Platzierungs-Slot (siehe oben); genau einer pro Offer
Verkaufskanäle	Wo	Auf bestimmte Kanäle beschränken; leer = jeder Kanal
Layout	Inhalt	Die CMS-Seite, die das Offer rendert
Was dieses Angebot zeigt	Inhalt	Slot-Überschreibungen des Layouts (Produkte, Texte) ohne Änderung am geteilten Layout
Aktion	Aktion	Optionaler Bundle-Rabatt als verwaltete Shopware-Promotion

Bundle-Rabatt (Aktion-Tab)

Feld	Bedeutung
Rabatt-Vorlage	Bundle (% oder € Rabatt, wenn alle Produkte im Warenkorb sind) — der Rabatt greift nur, wenn alle Layout-Produkte im Warenkorb liegen
Gilt für (aus dem Layout)	Nur-Lese-Liste der Layout-Produkte des Offers; zum Ändern das Layout bearbeiten
Rabatt-Typ	Prozent oder Fester Betrag
Rabatt-Wert	Prozent oder Betrag auf die Bundle-Produkte
Angebot endet am	Optionales Enddatum, nach dem der Rabatt nicht mehr angewendet wird

Das Plugin erstellt pro Bundle-Offer eine verwaltete Shopware-Promotion (samt Regeln) und hält sie bei jedem Speichern synchron. Verwaltete Promotions, die bereits in Bestellungen verwendet wurden, werden beim Löschen des Offers deaktiviert statt gelöscht — die Bestellhistorie bleibt intakt.

Entitäten

Das Plugin ergänzt diese Datenbank-Entitäten (alle mit Präfix ssd_upsell_):

Entität	Zweck
ssd_upsell_offer	Das Offer: Slot, Priorität, Aktiv-Status, Layout-Referenz, Slot-Konfiguration; Name/Beschreibung übersetzbar
ssd_upsell_offer_rule	Zuordnung Offer ↔ Rule-Builder-Regeln
ssd_upsell_offer_sales_channel	Zuordnung Offer ↔ Verkaufskanäle
ssd_upsell_auto_promotion	Der Bundle-Rabatt und die Referenz auf die verwaltete Promotion
ssd_upsell_offer_stat	Tagesaggregierte Statistik je Offer (Impressions, Klicks, Accepts, zugeordneter Umsatz)
ssd_upsell_event_log	Rohe Tracking-Ereignisse; einmal täglich aggregiert und nach 30 Tagen gelöscht

Eine vollständige Deinstallation (ohne Beibehalten der Nutzerdaten) entfernt diese Tabellen.

Rechte (ACL)

Unter Einstellungen > System > Benutzer & Rechte registriert das Plugin die Rechtegruppe Ultimate Upsell:

Rolle	Erlaubt
Betrachter	Offers und Statistiken ansehen
Bearbeiter	Bestehende Offers bearbeiten (enthält Betrachter)
Ersteller	Neue Offers anlegen (enthält Betrachter, Bearbeiter)
Löscher	Offers löschen (enthält Betrachter)

Tracking und Datenschutz

• Impression/Klick/Accept-Ereignisse erfordern die Zustimmung zum Cookie Seiten-Nutzungsanalyse, das das Plugin der Gruppe „Statistik" des Cookie-Banners hinzufügt.
• Die Umsatz-Zuordnung markiert Warenkorb-Positionen mit der Offer-Id — First-Party-Bestelldaten, unabhängig vom Cookie.
• Rohe Ereignisse werden einmal täglich zu Tagesstatistiken aggregiert und nach 30 Tagen gelöscht. Die Tagesaggregate enthalten keine personenbezogenen Daten.
• Die Einstellung trackingEnabled schaltet das Ereignis-Tracking global ab.