> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/plugins/cross-selling-warenkorb-und-checkout/storefront-integration.md). # Storefront Integration Damit Cross-Selling im Warenkorb und Checkout funktioniert, fügt das Plugin an mehreren Stellen automatisch Inhalte ein. Du steuerst über die [Konfiguration](/plugins/cross-selling-warenkorb-und-checkout/konfiguration.md), an welcher Stelle und an welcher Position der Slider erscheint. ## Wo wird der Cross-Selling-Slider angezeigt? Der Slider ist überall dort verfügbar, wo Kund:innen ihren Einkauf betrachten oder abschließen — und kann pro Stelle einzeln aktiviert werden: ### Off-Canvas-Warenkorb Das ist der ausklappbare Warenkorb, der nach dem Hinzufügen eines Produkts erscheint. Hier hast du vier Optionen: * **Nein** — der Slider wird nicht angezeigt. * **Oberhalb vom Warenkorb** — der Slider erscheint vor der Positionsliste. * **Unterhalb vom Warenkorb** — der Slider erscheint zwischen Positionen und Zwischensumme. * **Unterer Bereich des Off-Canvas** — der Slider erscheint ganz unten unterhalb der Buttons. ### Warenkorb-Seite Die eigene Warenkorb-Seite (z. B. nach Klick auf „Warenkorb anzeigen"): * **Nein** * **Oberhalb vom Warenkorb** * **Unterhalb vom Warenkorb** ### Checkout-Seite Sowohl die Bestellbestätigung als auch die Checkout-Registrierungsseite: * **Nein** * **Oberhalb vom Checkout** * **Unterhalb vom Checkout** > Tipp: Viele Shopbetreiber:innen kombinieren **Off-Canvas (unten)** mit **Warenkorb-Seite (unterhalb)**. So sehen Kund:innen den Slider sowohl im schnellen Kaufprozess als auch in der ausführlichen Warenkorb-Ansicht. ### Produktdetailseite Auf der Produktdetailseite gibt es **keinen eigenen Slider**, der das Cross-Selling anzeigt. Stattdessen wird der **rabattierte Preis** direkt am Produkt angezeigt, sobald das Produkt unter eine aktive Cross-Selling-Regel fällt. Das funktioniert auch dann, wenn das auslösende Produkt noch nicht im Warenkorb liegt — solange die Regel vom Typ „Definiert durch Produkte / Dynamische Produktgruppe" ist und das aktuelle Produkt zur Cross-Selling-Liste gehört. ### Listing- und Suchseiten Ebenso erscheinen Produkte mit rabattiertem Preis und Rabatt-Badge in: * Kategorie-Listings * Suchergebnisseiten * Suchvorschlägen (Auto-Suggest) So fällt das Angebot bereits in der Übersicht auf, nicht erst im Warenkorb. ## Wie sieht der Slider aus? Der Slider ist ein **Produkt-Slider im Shopware-Standard-Design**: * Titel „Passende Produkte" (übersetzbar pro Sprache über Shopware-Snippets). * Navigationspfeile außen, Touch-Swipe für Mobilgeräte. * Standard-Karten-Layout, kompatibel zu allen Standard-Themes. * Rabattierte Produkte erhalten ein farbiges **Badge** mit Prozentwert und individuellem Text. * Optional: **„In den Warenkorb"-Button** sofort sichtbar — auch bei Variantenprodukten (steuerbar in der Konfiguration). ## Was passiert beim Klick auf ein Slider-Produkt? Klickt eine Kundin auf das Slider-Produkt: 1. **Beim Hinzufügen in den Warenkorb** wird automatisch der konfigurierte Rabatt abgezogen — als eigene Rabattposition mit deiner gewählten Beschriftung („Name des Rabatts im Warenkorb"). 2. Im Warenkorb und Checkout zeigt Shopware den **reduzierten Preis pro Position** sowie die **separate Rabattzeile**. 3. Auch der **Bestelldruck und die Bestätigungsmail** enthalten den korrekten Rabatt — du musst dafür nichts zusätzlich konfigurieren. ## Rabatte werden überall korrekt durchgerechnet Das Plugin nutzt die Shopware-Standard-Preisberechnung. Daher funktionieren auch: * **Mehrwertsteuer** — Brutto- und Netto-Preise stimmen weiterhin überein. * **Staffelpreise** — bei mehreren Mengen wird jede Staffel separat rabattiert. * **Grundpreise** (Referenzpreise) — der angezeigte Preis pro Einheit ist ebenfalls korrekt reduziert. * **Streichpreise (UVP)** — der ursprüngliche Preis bleibt als Streichpreis sichtbar, der reduzierte Preis daneben. ## Mehrsprachigkeit Alle sichtbaren Texte sind übersetzbar: * **Regelname** und **Rabatt-Bezeichnung im Warenkorb** legst du pro Sprache in der Regel an. * **Badge-Text** kannst du ebenfalls pro Sprache übersetzen. * Der **Slider-Titel** wird über Shopware-Snippets (`prems-cross-selling-checkout.slider-title`) gesteuert. Was nicht übersetzt ist, fällt automatisch auf die Systemsprache zurück. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.premsoft.de/plugins/cross-selling-warenkorb-und-checkout/storefront-integration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.