> 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/quickstart.md).

# Quickstart

Dieser Quickstart führt dich in wenigen Minuten zur ersten aktiven Cross-Selling-Regel. Wir nehmen ein einfaches Beispiel: **„Wer eine Kaffeemaschine kauft, bekommt 10 % Rabatt auf Kaffeebohnen."**

{% stepper %}
{% step %}

## Plugin installieren und aktivieren

Falls noch nicht geschehen, installiere das Plugin wie in der [Installation](/plugins/cross-selling-warenkorb-und-checkout/installation.md) beschrieben und aktiviere es in der **Plugin-Konfiguration** über den Schalter **App aktivieren** für den gewünschten Verkaufskanal.
{% endstep %}

{% step %}

## Slider-Positionen festlegen

Bleibe in der Plugin-Konfiguration und stelle ein, wo deine Kund:innen die Cross-Selling-Produkte sehen sollen — zum Beispiel:

* **Cross-Selling Slider im Off-Canvas Warenkorb:** *Unterer Bereich des Off-Canvas*
* **Cross-Selling Slider im Warenkorb:** *Unterhalb vom Warenkorb*
* **Cross-Selling Slider im Checkout:** *Oberhalb vom Checkout*

Speichere die Konfiguration.
{% endstep %}

{% step %}

## Erste Regel anlegen

1. Öffne in der Administration den Menüpunkt **Cross-Selling Checkout** (Hauptmenü links).
2. Klicke oben rechts auf **Anlegen**.
   {% endstep %}

{% step %}

## Basis-Daten ausfüllen

Im Reiter **Basis-Daten** trägst du ein:

| Feld                                | Beispielwert                   |
| ----------------------------------- | ------------------------------ |
| Name                                | `Kaffeebohnen zur Maschine`    |
| Aktiv                               | An                             |
| Gültig von / Gültig bis             | Leer lassen oder Zeitraum      |
| Rabatt                              | `10` (Prozent)                 |
| Name des Rabatt im Warenkorb        | `10 % Rabatt auf Kaffeebohnen` |
| Badge bei Rabatt-Produkten anzeigen | An                             |

Der **Name** ist nur intern, **Name des Rabatts im Warenkorb** sehen deine Kund:innen als Beschriftung der Rabattposition im Warenkorb.
{% endstep %}

{% step %}

## Badge konfigurieren (optional)

Im Reiter **Badge** kannst du Text, Hintergrund- und Textfarbe für das Rabatt-Badge ändern. Lässt du die Farben leer, gelten die Standardfarben aus der Plugin-Konfiguration. Beispiel:

| Feld                   | Beispielwert     |
| ---------------------- | ---------------- |
| Badge-Text             | `Bundle-Rabatt`  |
| Badge-Text-Farbe       | `#ffffff` (Weiß) |
| Badge-Hintergrundfarbe | `#d9534f` (Rot)  |

Im Slider und auf der Produktdetailseite erscheint dann ein Badge wie `-10% Bundle-Rabatt`.
{% endstep %}

{% step %}

## Cross-Selling-Typ wählen

Im Reiter **Cross-Selling Einstellungen** wählst du, **wie** die Cross-Selling-Produkte gefunden werden:

* **Automatisch anhand des Cross-Sellings der Produkte im Warenkorb** — das Plugin nimmt die Produkte, die du bereits über das **native Shopware-Cross-Selling** an deinen Produkten gepflegt hast. Ideal, wenn du diese Pflege schon hast.
* **Definiert durch Produkte / Dynamische Produktgruppe** — du legst selbst fest, **welche Trigger-Produkte** die Regel auslösen und **welche Cross-Selling-Produkte** angeboten werden. Genau das wählen wir für unser Beispiel.
  {% endstep %}

{% step %}

## Trigger-Produkte festlegen

Im Reiter **Trigger-Produkte** legst du fest, welche Produkte im Warenkorb die Regel auslösen sollen. Zwei Wege stehen dir zur Auswahl:

* **Produkte** — wähle einzelne Produkte (in unserem Beispiel: deine Kaffeemaschinen).
* **Dynamische Produktgruppe** — wähle eine Gruppe wie „Alle Kaffeemaschinen". Die Gruppe pflegst du in **Kataloge → Dynamische Produktgruppen**.

Sobald **eines** der Trigger-Produkte im Warenkorb landet, gilt die Regel.
{% endstep %}

{% step %}

## Cross-Selling-Produkte festlegen

Im Reiter **Cross-Selling-Produkte** trägst du ein, **was angeboten wird**, sobald die Regel ausgelöst ist. Auch hier gibt es zwei Wege:

* **Manuelle Produktliste** — wähle einzelne Produkte (z. B. eine handverlesene Auswahl an Bohnen).
* **Dynamische Produktgruppe** — wähle eine Gruppe wie „Alle Kaffeebohnen". Auf diese Weise wachsen die Cross-Sellings automatisch mit deinem Sortiment.

Die Reihenfolge im Slider richtet sich nach der Sortier-Einstellung in der Plugin-Konfiguration. Bei manueller Liste kannst du die Position pro Produkt setzen.
{% endstep %}

{% step %}

## Speichern und testen

* Klicke oben rechts auf **Speichern**.
* Öffne deinen Shop in einem privaten Fenster.
* Lege ein Trigger-Produkt (z. B. eine Kaffeemaschine) in den Warenkorb.
* Öffne den Off-Canvas-Warenkorb, die Warenkorb-Seite oder den Checkout — die rabattierten Kaffeebohnen erscheinen mit Badge im Slider, und beim Hinzufügen wird der Rabatt automatisch in den Bestellpositionen abgezogen.
  {% endstep %}
  {% endstepper %}

## Nächste Schritte

* [Verwaltungs-Dashboard](/plugins/cross-selling-warenkorb-und-checkout/verwaltungs-dashboard.md) — alle Felder der Regel im Detail.
* [Dynamische Produktgruppen](/plugins/cross-selling-warenkorb-und-checkout/dynamische-produktgruppen.md) — wie du Gruppen einsetzt.
* [Rabatt-Badges](/plugins/cross-selling-warenkorb-und-checkout/rabatt-badges.md) — Badges gestalten.
* [Storefront-Integration](/plugins/cross-selling-warenkorb-und-checkout/storefront-integration.md) — wo deine Kund:innen alles sehen.


---

# 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/quickstart.md?ask=<question>
```

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.