> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen.md).

# Vorlagen

Was Vorlagen in Cross Selling Pro sind, wo sie wirken und wie Sie die Vorlagen-Liste verwalten.

Vorlagen sind die zentralen Bausteine von Cross Selling Pro. In einer Vorlage legen Sie einmal fest, welche Produkte empfohlen werden, wie sie ausgewählt und sortiert werden und wie viele erscheinen. Diese Vorlage wählen Sie danach überall dort aus, wo Empfehlungen erscheinen sollen. Ändern Sie die Vorlage, ändert sich jede Stelle, die sie nutzt.

Eine Vorlage allein zeigt im Shop noch nichts. Sichtbar wird sie erst, wenn Sie sie in einer Erlebniswelt oder an einem Ausspielort (zum Beispiel im Warenkorb) einbinden.

## Zwei Arten von Vorlagen

| Art                     | Wofür                                                                                                         | Paket                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **Empfehlungs-Vorlage** | Steuert einen Empfehlungsblock: Empfehlungstyp, Herkunft der Produkte, Filter, Gewichtung, Anzahl und Button. | ab Paket Basic (einzelne Typen und Funktionen erst in höheren Paketen) |
| **Bundle-/Set-Vorlage** | Bündelt mehrere Produkte, die Kunden neben einem Hauptprodukt per Auswahl gemeinsam in den Warenkorb legen.   | ab Paket Experte                                                       |

Diese Seite und die folgenden Unterseiten behandeln die Empfehlungs-Vorlagen. Bundle-/Set-Vorlagen haben eine eigene Seite.

## Wo Empfehlungs-Vorlagen wirken

Eine Empfehlungs-Vorlage kann an mehreren Stellen gleichzeitig im Einsatz sein:

| Stelle                                                                    | So binden Sie die Vorlage ein                                                                           | Paket                              |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Erlebniswelten (Produktseite, Startseite, Kategorieseiten, eigene Seiten) | Block aus der Kategorie „AI CrossSelling“ einfügen und im Element das Feld „Empfehlungs-Vorlage“ wählen | Typ und Layout bestimmen das Paket |
| Offcanvas-Warenkorb                                                       | Ausspielorte, Unterpunkt „Offcanvas“, Feld „Empfehlungs-Vorlage“                                        | ab Paket Starter                   |
| Warenkorbseite                                                            | Ausspielorte, Unterpunkt „Warenkorb“, Feld „Empfehlungs-Vorlage“                                        | ab Paket Starter                   |
| Kundenkonto                                                               | Ausspielorte, Unterpunkt „Kundenkonto“, Feld „Empfehlungs-Vorlage auswählen“                            | ab Paket Experte                   |
| Als Ersatz in einer anderen Vorlage                                       | In der anderen Vorlage unter „5. Darstellung“ den „Fallback-Typ“ „Andere Vorlage“ wählen                | wie die Vorlage selbst             |
| Zum Auffüllen einer Bundle-/Set-Vorlage                                   | In der Bundle-/Set-Vorlage, Karte „Empfehlungen“                                                        | ab Paket Experte                   |

Die Checkout-Zwischenseite zeigt eine Erlebniswelt. Welche Vorlagen dort laufen, bestimmen Sie über die Elemente in dieser Erlebniswelt.

{% hint style="info" %}
Umgekehrt geht es auch: Eine Bundle-/Set-Vorlage kann die Quelle einer Empfehlungs-Vorlage sein. Dann zeigt der Empfehlungsblock die Produkte dieser Bundle-/Set-Vorlage.
{% endhint %}

## Die Vorlagen-Liste

Sie öffnen die Liste im Shopware-Admin unter **Inhalte → KI-gestütztes Cross-Selling** und dort in der Seitenleiste unter **Ausspielung → Empfehlungs-Vorlagen**.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-3f40d0ec976a908ffee5a160ad6e9d8552c31c61%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-vorlagen-liste.png?alt=media" alt="Liste der Empfehlungs-Vorlagen mit Name und Typ"><figcaption></figcaption></figure>

Die Liste zeigt je Vorlage:

| Spalte            | Inhalt                                                                               |
| ----------------- | ------------------------------------------------------------------------------------ |
| „Name“            | Der interne Name. Ein Klick öffnet die Vorlage.                                      |
| „Typ“             | Der Empfehlungstyp in Klartext, zum Beispiel „Bestseller (Meistverkaufte Produkte)“. |
| „Aktualisiert am“ | Wann die Vorlage zuletzt gespeichert wurde.                                          |

Über das Menü am Zeilenende erreichen Sie „Bearbeiten“ und „Löschen“. Eine neue Vorlage legen Sie oben rechts mit „Vorlage anlegen“ an.

Gibt es noch keine Vorlage, erscheint der Hinweis „Noch keine Vorlagen“. Auf der Übersicht des Plugin-Dashboards wird Ihnen dann zusätzlich der Einrichtungsassistent angeboten.

{% hint style="danger" %}
**Löschen geht ohne Rückfrage.** Ein Klick auf „Löschen“ entfernt die Vorlage sofort. Erlebniswelten und Ausspielorte, die diese Vorlage nutzen, zeigen danach keine Empfehlungen mehr. Prüfen Sie vorher, wo die Vorlage eingebunden ist.
{% endhint %}

## Aufbau einer Empfehlungs-Vorlage

Das Formular einer Vorlage ist von oben nach unten in Karten gegliedert. Die nummerierten Abschnitte folgen der Reihenfolge, in der InsightSearch rechnet: erst die Herkunft der Produkte, dann die Filter, dann die Reihenfolge, zuletzt die Darstellung.

| Karte            | Was Sie dort festlegen                                                            | Ausführlich                                                                                                                                                                                  |
| ---------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| „Schnellstart“   | Ein „Preset“ setzt bewährte Startwerte für einen Einsatzzweck.                    | [Empfehlungs-Vorlagen anlegen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/empfehlungs-vorlagen.md) |
| „Allgemein“      | Name, Empfehlungstyp, interne Beschreibung                                        | [Empfehlungs-Vorlagen anlegen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/empfehlungs-vorlagen.md) |
| „1. Quelle“      | Woher die Produkte kommen, feste Produkte, Referenzprodukt im Warenkorb           | [Empfehlungs-Vorlagen anlegen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/empfehlungs-vorlagen.md) |
| „2. Filter“      | Welche Produkte überhaupt in Frage kommen, Regel-Baukasten                        | [Filter und Regel-Baukasten](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/filter-und-regeln.md)               |
| „3. Gewichtung“  | In welcher Reihenfolge die übrigen Produkte erscheinen                            | [Gewichtung, Vielfalt und Booster](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/gewichtung-und-booster.md)    |
| „4. Booster“     | Zusatzpunkte für gleiche Marke oder Kategorie (nur im Expertenmodus)              | [Gewichtung, Vielfalt und Booster](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/gewichtung-und-booster.md)    |
| „5. Darstellung“ | Anzahl, Button-Aktion, Ersatz bei zu wenigen Treffern                             | [Empfehlungs-Vorlagen anlegen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/empfehlungs-vorlagen.md) |
| „Vorschau“       | Ergebnis der Vorlage testen, bevor sie live geht (erst nach dem ersten Speichern) | [Vorschau und Sandbox](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorschau-und-sandbox.md)                  |

### Einfach oder ausführlich: der Expertenmodus

Oben rechts auf der Seite einer Vorlage steht der Schalter „Expertenmodus anzeigen“. Ohne ihn sehen Sie nur die wichtigsten Felder. Mit ihm erscheinen zusätzlich der Regel-Baukasten, die Feineinstellungen der Gewichtung, der Abschnitt „4. Booster“ und weitere Schalter und Zahlenfelder.

Der Expertenmodus ändert nichts an der Vorlage selbst, er blendet nur Felder ein. Er wird nicht gespeichert und ist beim nächsten Öffnen wieder aus. Was Sie im Expertenmodus einstellen, bleibt natürlich gespeichert und wirkt auch dann, wenn der Schalter aus ist.

## Drei Wege zur ersten Vorlage

1. **Einrichtungsassistent:** Im Plugin-Dashboard oben rechts „Einrichtungsassistent“. Er legt mehrere Vorlagen mit vereinfachten Einstellungen auf einmal an und kann Vorlagen dem Warenkorb zuweisen.
2. **Preset:** Neue Vorlage anlegen und in der Karte „Schnellstart“ ein „Preset“ wählen, zum Beispiel „Zubehör (Produktseite)“ oder „Bestseller“. Danach ist jeder Wert frei anpassbar.
3. **Von Hand:** Neue Vorlage anlegen und die Abschnitte selbst ausfüllen. Eine neue Vorlage startet mit dem Typ „Ähnliche Produkte (Alternativen)“, „Limit“ 6 und der Button-Aktion „In den Warenkorb“.

## Eine Vorlage, viele Stellen

Weil eine Vorlage an vielen Stellen hängen kann, lohnt sich ein klares Vorgehen:

* **Sprechende Namen:** Der Name ist nur im Admin sichtbar. Nennen Sie Ort und Zweck, zum Beispiel „PDP Zubehör“ oder „Warenkorb Ergänzungen“.
* **Beschreibung nutzen:** Im Feld „Beschreibung“ notieren Sie, wo die Vorlage eingebunden ist. Das hilft vor dem Löschen oder bei größeren Änderungen.
* **Eigene Vorlage je Zweck:** Wollen Sie an einer Stelle etwas ausprobieren, legen Sie lieber eine Kopie mit neuem Namen an, statt eine Vorlage zu ändern, die an vielen Stellen läuft.
* **Ersatz einplanen:** Typen, die Bestell- oder Besucherdaten brauchen, liefern in neuen Shops anfangs wenig. Hinterlegen Sie unter „5. Darstellung“ eine Ersatz-Vorlage, zum Beispiel mit dem Typ „Bestseller“.

## Wann wirkt eine Änderung?

Gespeicherte Änderungen an einer Vorlage gelten ab der nächsten Empfehlung, die der Shop abruft. Zwischengespeicherte Erlebniswelt-Seiten, die diese Vorlage nutzen, verwirft Shopware beim Speichern automatisch, Sie müssen den Zwischenspeicher dafür nicht leeren.

Änderungen an Produktdaten (Preis, Lager, Kategorie) wirken dagegen erst, wenn InsightSearch die Produktdaten das nächste Mal eingelesen hat.

## Weiterlesen

{% content-ref url="/pages/2829bd749e75a2c5fa0d0691f89169becd233751" %}
[Empfehlungs Vorlagen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/empfehlungs-vorlagen.md)
{% endcontent-ref %}

{% content-ref url="/pages/YEzwBfwJdo4PQnilLZp7" %}
[Empfehlungs-Typen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/empfehlungs-typen.md)
{% endcontent-ref %}

{% content-ref url="/pages/7a7f42ea35a7e41da3bf9c7ff69fda6fbe34001d" %}
[Bundle-/Set-Vorlagen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/bundle-set-vorlagen.md)
{% endcontent-ref %}

{% content-ref url="/pages/GG8JfBfbbZLaf1c7u3hP" %}
[Ausspielorte und Darstellung](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/ausspielorte.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
