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

# Verwaltungs-Dashboard

Das Plugin ergänzt das Shopware-Hauptmenü um einen eigenen Eintrag **Cross-Selling Checkout**. Darin pflegst du sämtliche Regeln, mit denen du Cross-Selling-Produkte und Rabatte steuerst.

## Die Regel-Liste

Die Übersicht zeigt alle vorhandenen Cross-Selling-Regeln. Pro Zeile siehst du:

| Spalte         | Bedeutung                                                                                    |
| -------------- | -------------------------------------------------------------------------------------------- |
| **Name**       | Der von dir vergebene Regelname.                                                             |
| **Status**     | `Aktiv`, `Inaktiv` oder `Abgelaufen` (wenn das Gültig-Bis-Datum in der Vergangenheit liegt). |
| **Gültig von** | Startdatum, ab dem die Regel greift. Leer = sofort gültig.                                   |
| **Gültig bis** | Enddatum, bis zu dem die Regel greift. Leer = unbegrenzt.                                    |
| **Rabatt (%)** | Prozentualer Rabatt, der auf die Cross-Selling-Produkte angewendet wird.                     |

Über **Anlegen** legst du eine neue Regel an, über die Zeilenaktionen kannst du bestehende bearbeiten oder löschen.

## Regel anlegen oder bearbeiten

Der Editor ist in mehrere Reiter gegliedert:

| Reiter                      | Inhalt                                                                            |
| --------------------------- | --------------------------------------------------------------------------------- |
| Basis-Daten                 | Name, Status, Gültigkeit, Rabatt, Rabatt-Bezeichnung im Warenkorb, Badge-Schalter |
| Badge                       | Badge-Text, Text- und Hintergrundfarbe                                            |
| Cross-Selling Einstellungen | Cross-Selling-Typ (automatisch / individuell)                                     |
| Trigger-Produkte            | Welche Produkte die Regel auslösen                                                |
| Cross-Selling Produkte      | Welche Produkte als Cross-Selling angeboten werden                                |

## Reiter „Basis-Daten"

| Feld                                    | Bedeutung                                                                                                                 |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Name**                                | Interner Anzeigename in Liste und Übersichten. Übersetzbar.                                                               |
| **Aktiv**                               | Schalter: aktiv / inaktiv. Inaktive Regeln werden in der Storefront ignoriert.                                            |
| **Gültig von / Gültig bis**             | Optionales Zeitfenster. Außerhalb des Fensters wird die Regel nicht angewendet — du kannst dadurch Aktionen vorausplanen. |
| **Rabatt**                              | Prozent-Wert zwischen 0 und 100. Bei `0` wird kein Rabatt angewendet, der Slider zeigt die Produkte aber trotzdem an.     |
| **Name des Rabatt im Warenkorb**        | Beschriftung der Rabattposition im Warenkorb. Übersetzbar. Beispiel: „Bundle-Rabatt 10 %".                                |
| **Badge bei Rabatt-Produkten anzeigen** | Wenn aktiv, erhält jedes Produkt, das unter diese Regel fällt, ein Rabatt-Badge in der Storefront.                        |

## Reiter „Badge"

Steuert das Erscheinungsbild des Rabatt-Badges. Lässt du Farben leer, gelten die Standardfarben aus der Plugin-Konfiguration.

| Feld                       | Bedeutung                                                                                    |
| -------------------------- | -------------------------------------------------------------------------------------------- |
| **Badge-Text**             | Zusatztext neben dem Rabatt-Prozentwert. Übersetzbar. Beispiel: `Bundle-Aktion`, `Top-Deal`. |
| **Badge-Text-Farbe**       | Farbe des Textes. Hex-Code wie `#ffffff`.                                                    |
| **Badge-Hintergrundfarbe** | Hintergrundfarbe. Hex-Code wie `#d9534f`.                                                    |

> Weitere Details und Praxisbeispiele findest du auf der Seite [Rabatt-Badges](/plugins/cross-selling-warenkorb-und-checkout/rabatt-badges.md).

## Reiter „Cross-Selling Einstellungen"

Zwei Typen stehen zur Auswahl:

* **Automatisch anhand des Cross-Sellings der Produkte im Warenkorb**\
  Das Plugin schaut nach den Produkten, die du bereits im **Shopware-Standard-Cross-Selling** an deinen Produkten gepflegt hast. Steht eines dieser Produkte im Warenkorb, werden seine Cross-Sellings im Slider angezeigt und können automatisch rabattiert werden.

  *Ideal, wenn du eh schon Cross-Sellings an deinen Produkten pflegst und keine doppelte Liste führen möchtest.*
* **Definiert durch Produkte / Dynamische Produktgruppe**\
  Du legst selbst fest, welche Produkte als **Trigger** dienen und welche Produkte als **Cross-Selling** angeboten werden. Beide Listen können entweder manuell oder über eine **dynamische Produktgruppe** gefüllt werden.

  *Ideal für Aktionen wie „Wer Produkt A kauft, erhält 10 % auf alle Produkte aus Kategorie B"*.

## Reiter „Trigger-Produkte"

Nur sichtbar, wenn der Typ **Definiert durch Produkte / Dynamische Produktgruppe** gewählt ist.

| Feld                         | Bedeutung                                                                                                              |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Produkte**                 | Manuelle Liste an Triggerprodukten. Sobald **eines** davon im Warenkorb landet, ist die Regel aktiv.                   |
| **Dynamische Produktgruppe** | Alternativ eine Produktgruppe. Trifft die Filterregel der Gruppe auf ein Produkt im Warenkorb zu, ist die Regel aktiv. |

Du kannst entweder Produkte, eine Gruppe oder beides kombinieren. Die Regel ist aktiv, sobald **irgendein** Treffer entsteht.

## Reiter „Cross-Selling Produkte"

| Feld                         | Bedeutung                                                                                                                                                            |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Produkte**                 | Manuell ausgewählte Produkte, die als Cross-Selling angeboten werden. Du kannst die **Position** pro Produkt festlegen, um eine feste Reihenfolge zu erzwingen.      |
| **Dynamische Produktgruppe** | Alternativ eine Produktgruppe. Sortierung und Maximalzahl steuerst du global in der [Konfiguration](/plugins/cross-selling-warenkorb-und-checkout/konfiguration.md). |

Produkte, die bereits im Warenkorb liegen, werden im Slider automatisch ausgeblendet — Doppelangebote verhindert das Plugin von selbst. Auch das Trigger-Produkt selbst wird nicht als sein eigenes Cross-Selling-Produkt angezeigt.

## Mehrsprachigkeit

Folgende Felder sind übersetzbar:

* **Name** der Regel
* **Name des Rabatts im Warenkorb**
* **Badge-Text**

Wechsle in der oberen Sprach-Auswahl der Detail-Seite die Sprache und pflege die Übersetzungen wie bei Shopware üblich. Was nicht übersetzt ist, fällt automatisch auf die Systemsprache zurück.

## Was passiert beim Speichern?

Sobald du speicherst, wirkt die Regel im Hintergrund über den Cart-Processor von Shopware:

* In der Storefront wird **bei jedem Warenkorb-Aufruf** geprüft, welche Cross-Selling-Produkte angeboten werden sollen.
* Beim Hinzufügen eines Cross-Selling-Produkts wird der Rabatt automatisch in den Warenkorb übernommen — inkl. Mehrwertsteuer, Staffelpreisen und Grundpreisen.
* Auf Produktdetail-, Listing- und Suchseiten wird der reduzierte Preis automatisch angezeigt, wenn das Produkt unter eine aktive Regel fällt.

Mehr zu den Anzeigeorten findest du auf [Storefront-Integration](/plugins/cross-selling-warenkorb-und-checkout/storefront-integration.md).


---

# 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/verwaltungs-dashboard.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.
