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

# Slider Erlebniswelten

Alle Erlebniswelten-Elemente von Cross Selling Pro, ihre Kartenlayouts, Paketgrenzen und jedes Feld im Erlebniswelten-Editor.

Mit den Erlebniswelten-Elementen von Cross Selling Pro bauen Sie Empfehlungen in jede Shopware-Erlebniswelt ein: auf der Startseite, auf Kategorieseiten, auf Landingpages und im Layout der Produktseite. Jedes Element steht für ein festes Kartenlayout. Welche Produkte erscheinen, bestimmt die Empfehlungs-Vorlage, die Sie im Element auswählen.

Diese Seite ist ein Nachschlagewerk: Sie finden hier alle Elemente, alle Kartenlayouts mit dem nötigen Paket und alle Felder, die der Erlebniswelten-Editor anbietet.

## Bevor Sie beginnen

Sie brauchen mindestens eine [Empfehlungs-Vorlage](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/empfehlungs-vorlagen.md). Ohne Vorlage zeigt das Element im Editor den Hinweis „Keine Vorlagen vorhanden“ mit dem Knopf „Vorlage anlegen“.

Eine Vorlage erscheint erst im Shop, wenn sie in einem Element oder an einem [Ausspielort](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/ausspielorte.md) eingebunden ist.

## So funktionieren die Elemente im Shop

Ein paar Regeln gelten für alle Elemente gleich. Sie erklären die meisten Fragen, die nach dem Einbau auftauchen.

* **Die Produkte werden nachgeladen.** Beim Aufruf der Seite zeigt das Element kurz „Empfehlungen werden geladen...“. Die Karten baut der Browser des Besuchers danach auf. Persönliche Daten des Besuchers stehen deshalb nie im zwischengespeicherten Seiteninhalt.
* **Keine Empfehlungen, kein Block.** Kommt für ein Element nichts zurück, entfernt es sich vollständig. Es bleibt keine leere Fläche und kein Hinweistext stehen. Wenn Sie das vermeiden möchten, richten Sie in der Vorlage einen Ersatz ein (siehe [Bilder, Preise, Ersatz und Sichtbarkeit](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/bilder-preise-und-ersatz.md)).
* **Paketgrenzen sind im Shop unsichtbar.** Gehört das Kartenlayout oder der Empfehlungstyp der Vorlage nicht zu Ihrem Paket, zeigt der Shop an dieser Stelle nichts, ohne Hinweis und ohne Ersatz. Im Editor sehen Sie dann auf dem Element „Wird nicht ausgespielt · Verfügbar ab …“ mit dem Link „Pakete ansehen“.
* **Das Ausgangsprodukt fehlt immer.** Auf einer Produktseite werden das aktuelle Produkt und seine Varianten nicht empfohlen. Mehr dazu auf der Seite [Produktseite](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/produktseite.md).

## Element einbauen

{% stepper %}
{% step %}

### Erlebniswelt öffnen

1. Öffnen Sie im Shopware-Admin **Inhalte → Erlebniswelten**.
2. Öffnen Sie die gewünschte Erlebniswelt oder legen Sie eine neue an. Für Empfehlungen zum gerade angesehenen Produkt wählen Sie ein Layout vom Typ Produktseite.
   {% endstep %}

{% step %}

### Block einfügen

1. Öffnen Sie in der rechten Leiste die Blöcke und wählen Sie die Block-Kategorie **„AI CrossSelling“**.
2. Ziehen Sie den gewünschten Block an die passende Stelle. Der Name des Blocks verrät das Kartenlayout, zum Beispiel „AI CrossSelling: Standard-Karten“.
   {% endstep %}

{% step %}

### Element einstellen

1. Klicken Sie das Element an. Rechts öffnen sich die Einstellungen mit den Reitern „Einstellungen“ und „Design“.
2. Wählen Sie unter „Empfehlungs-Vorlage“ die Vorlage aus.
3. Tragen Sie bei Bedarf Titel und Untertitel ein und schalten Sie Marke, Beschreibung, Badges und Preis nach Wunsch.
   {% endstep %}

{% step %}

### Speichern und zuweisen

1. Klicken Sie auf **Speichern**.
2. Weisen Sie ein neues Layout seiner Seite zu: einer Kategorie (Reiter „Layout“ in der Kategorie), einem einzelnen Produkt (Reiter „Layout“ im Produkt) oder als Standard-Layout.
   {% endstep %}
   {% endstepper %}

{% hint style="info" %}
Sie können mehrere Elemente mit unterschiedlichen Vorlagen auf dieselbe Seite setzen, zum Beispiel oben „Bestseller“ und weiter unten „Zuletzt angesehen“.
{% endhint %}

## Alle Elemente im Überblick

In der Block-Kategorie „AI CrossSelling“ finden Sie neun Empfehlungs-Elemente und zwei Sonder-Elemente. Die Namen stehen im Admin immer auf Deutsch, auch wenn der Admin auf Englisch eingestellt ist.

| Element im Editor                | Kartenlayout                     | Art             | Verfügbar ab Paket |
| -------------------------------- | -------------------------------- | --------------- | ------------------ |
| AI CrossSelling: Standard-Karten | Hochformat-Karten mit Bild oben  | Slider          | Basic              |
| AI CrossSelling: Minimal         | sehr kompakte Mini-Karten        | Slider          | Basic              |
| AI CrossSelling: Kompakt         | kleine Karten, Bild links        | Slider          | Starter            |
| AI CrossSelling: Große Kacheln   | breite Karten mit Marke          | Slider          | Starter            |
| AI CrossSelling: Detailkarten    | große Karten mit Beschreibung    | Slider          | Experte            |
| AI CrossSelling: Raster          | Kartenraster                     | statisch        | Experte            |
| AI CrossSelling: Liste           | Einträge untereinander           | statisch        | Experte            |
| AI CrossSelling: Mosaik          | Kachelblock mit Textbereich      | statisch        | Experte            |
| AI CrossSelling: Spotlight       | große und kleine Karten gemischt | statisch        | Experte            |
| Cogi Bundle/Set Configurator     | Set-Konfigurator                 | eigenes Element | Experte            |
| Cogi Conversion Booster Overlay  | Produktfenster mit Alternativen  | eigenes Element | Advanced           |

Neben dem Layout muss auch der **Empfehlungstyp der Vorlage** in Ihrem Paket enthalten sein. Welcher Typ ab welchem Paket gilt, steht auf der Seite [Voraussetzungen und Pakete](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/voraussetzungen-und-pakete.md).

{% hint style="warning" %}
Ein Auswahlfeld „Slider-Design“ gibt es im Element nicht mehr. Das Kartenlayout wählen Sie allein über den Block. Möchten Sie das Layout wechseln, setzen Sie einen anderen Block ein und wählen dort dieselbe Vorlage.
{% endhint %}

## Die Kartenlayouts im Shop

### Slider-Layouts

Standard-Karten, Minimal, Kompakt, Große Kacheln und Detailkarten sind Slider. Sie zeigen Pfeile und Punkte, laufen nicht von selbst weiter und springen am Ende wieder an den Anfang zurück. Auf Mobilgeräten (unter 768 px Breite) wischt der Besucher mit dem Finger.

Wie viele Karten nebeneinander stehen, rechnet der Slider aus der Breite des Platzes und der Mindestbreite einer Karte aus. In einem schmalen Platz stehen also weniger Karten, auf einer breiten Seite mehr. Mindestens eine Karte ist immer sichtbar.

| Layout          | Mindestbreite einer Karte |
| --------------- | ------------------------- |
| Standard-Karten | 220 px                    |
| Detailkarten    | 260 px                    |
| Minimal         | 320 px                    |
| Kompakt         | 340 px                    |
| Große Kacheln   | 360 px                    |

### Statische Layouts

Raster, Liste, Mosaik und Spotlight zeigen die Produkte ohne Slider.

* **Raster:** Karten in Spalten, jede Spalte mindestens 210 px breit. Auf kleinen Bildschirmen (unter 576 px) immer zwei Spalten. Der Produktname nimmt höchstens zwei Zeilen ein.
* **Liste:** Einträge untereinander, das Bild steht links in der Höhe der Zeile. Badges sind in diesem Layout immer aus.
* **Mosaik:** Ein Block aus zwei oder vier Kacheln, daneben ein freier Textbereich. Auf Mobilgeräten stehen Kacheln und Text untereinander.
* **Spotlight:** Eine oder zwei große Karten, daneben kleinere. Die große Karte belegt zwei mal zwei Felder. Je nach Bildschirmbreite sind es vier, drei, zwei oder eine Spalte.

### Was auf einer Karte steht

Eine Karte zeigt, je nach Schaltern im Element: Produktbild, Badges (zum Beispiel „Topseller“ oder eigene Badges), Marke, Produktname, kurze Beschreibung, Preis und einen Button. Liegt ein Streichpreis vor, erscheint er mit der Ersparnis in Prozent. Produkte mit Varianten in unterschiedlichen Preisen zeigen einen „ab“-Preis ohne Streichpreis.

Bild und Name führen auf die Produktseite.

### Der Button auf der Karte

Was der Button tut, legen Sie in der Vorlage im Feld „Button-Aktion“ fest:

| Option                   | Wirkung in Erlebniswelten-Elementen                                                                                                 |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| „Zum Produkt“ (Standard) | öffnet die Produktseite                                                                                                             |
| „In den Warenkorb“       | legt ein Stück in den Warenkorb und öffnet den Offcanvas-Warenkorb                                                                  |
| „Details + Warenkorb“    | wirkt nur im Offcanvas-Warenkorb und auf der Warenkorbseite. In Erlebniswelten-Elementen verhält sich der Button wie „Zum Produkt“. |

Sonderfälle:

* **Produkte mit Varianten** zeigen „Variante wählen“. Ein Fenster mit der Variantenauswahl und dem Kaufbereich der Produktseite öffnet sich, damit der Besucher die richtige Variante einlegt.
* **Produkte, die gestaltet werden müssen** (Printess, Custom Products, eigener Konfigurator), landen nie direkt im Warenkorb. Je nach Einstellung zeigt die Karte „Jetzt gestalten“ und öffnet den Editor oder führt auf die Produktseite. Details auf der Seite [Zusammenspiel mit anderen Plugins](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/zusammenspiel-mit-anderen-plugins.md).

## Felder im Erlebniswelten-Editor

Alle neun Empfehlungs-Elemente nutzen dieselben Einstellungen. Ganz oben steht der Knopf **„Cross-Selling-Statistiken öffnen“**. Er öffnet die Statistik genau dieses Elements in einem neuen Tab.

### Reiter „Einstellungen“

| Feld                    | Wirkung im Shop                                                              | Standard                                           |
| ----------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------- |
| „Titel“                 | Überschrift über den Karten. Leer bedeutet: keine Überschrift.               | leer                                               |
| „Untertitel“            | kleinere Zeile unter der Überschrift                                         | leer                                               |
| „Marke anzeigen“        | Herstellername auf der Karte                                                 | an bei Große Kacheln, sonst aus                    |
| „Beschreibung anzeigen“ | kurzer Beschreibungstext auf der Karte                                       | an bei Detailkarten, sonst aus                     |
| „Badges anzeigen“       | Badges wie Topseller, Sale oder Neu                                          | an bei Standard-Karten und Detailkarten, sonst aus |
| „Preis anzeigen“        | Preis auf der Karte                                                          | an                                                 |
| „Empfehlungs-Vorlage“   | welche Vorlage die Produkte liefert. Daneben der Knopf „Vorlagen verwalten“. | keine                                              |

Besonderheiten je Layout:

* **Kompakt und Minimal** haben keine Schalter für Marke und Beschreibung. Beides bleibt im Shop aus.
* **Liste** hat keinen Schalter für Badges. Badges bleiben aus.
* Ist das Layout in Ihrem Paket nicht enthalten, liegt eine Paket-Sperre über den Einstellungen.

{% hint style="info" %}
Die **Anzahl der Produkte** stellen Sie nicht im Element ein, sondern in der Vorlage im Feld „Limit“ (1 bis 50). Hat die Vorlage keinen Wert, zeigt das Element bis zu 6 Produkte.
{% endhint %}

### Zusatzfelder für Mosaik

| Feld                           | Optionen                                                                | Standard      |
| ------------------------------ | ----------------------------------------------------------------------- | ------------- |
| „Position der Kacheln“         | „Kacheln links, Text rechts“, „Kacheln rechts, Text links“              | Kacheln links |
| „Breiten-Verhältnis“           | „Kacheln größer (60/40)“, „Ausgeglichen (50/50)“, „Text größer (40/60)“ | 50/50         |
| „Kachelgröße“                  | Klein, Mittel, Groß                                                     | Mittel        |
| „Kachel-Anzahl“                | „4 Kacheln (2×2)“, „2 Kacheln (1×2)“                                    | 4 Kacheln     |
| „Horizontal-Slider aktivieren“ | an, aus                                                                 | aus           |
| „Textbereich“                  | freier Text mit Formatierung                                            | leer          |

So wirkt der Slider-Schalter: Ist er aus, zeigt das Mosaik genau zwei oder vier Kacheln, weitere Produkte der Vorlage entfallen. Ist er an, werden die Kacheln selbst zu einem Wisch-Slider mit Pfeilen und Punkten, der alle Produkte der Vorlage enthält. Lassen Sie den Textbereich leer, nehmen die Kacheln die volle Breite ein.

### Zusatzfelder für Liste

| Feld                           | Grenzen                        | Standard |
| ------------------------------ | ------------------------------ | -------- |
| „Zeilenhöhe (px)“              | 48 bis 400, in Schritten von 8 | 96       |
| „Vertikaler Slider aktivieren“ | an, aus                        | aus      |
| „Sichtbare Einträge“           | 1 bis 20                       | 4        |

Mit dem vertikalen Slider scrollt der Besucher innerhalb der Liste, wenn die Vorlage mehr Produkte liefert, als Einträge sichtbar sind.

### Zusatzfelder für Spotlight

| Feld                         | Optionen                                                   | Standard         |
| ---------------------------- | ---------------------------------------------------------- | ---------------- |
| „Spotlight-Modus“            | „1 Groß + 4 Klein“, „1 Groß + 2 Klein“, „2 Groß + 4 Klein“ | 1 Groß + 4 Klein |
| „Position des Hauptprodukts“ | Links, Rechts                                              | Links            |

Spotlight zeigt je Modus höchstens 5, 3 oder 6 Produkte. Liefert die Vorlage mehr, entfallen die übrigen.

### Reiter „Design“

Oben steht der Hinweis „Leer lassen = Werte werden vom Theme geerbt (Standard).“ Alles, was Sie hier nicht ausfüllen, übernimmt das Element aus Ihrem Theme.

| Bereich                      | Felder                                                                                                                            |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Typografie                   | „Schriftgröße (px)“ (8 bis 80), „Schriftgewicht“ (Standard, Normal, Medium (500), Halbfett (600), Fett (700))                     |
| „Warenkorb-Button“           | „Schriftgröße (px)“ (8 bis 60), „Schriftgewicht“, „Farbe“ (Standard, Primär, Sekundär, Erfolg (Grün), Gefahr (Rot), Dunkel, Hell) |
| „Benutzerdefinierte Klassen“ | „CSS-Klassen“ für eigenes Styling, mehrere durch Leerzeichen getrennt                                                             |

## Die beiden Sonder-Elemente

**Cogi Bundle/Set Configurator** zeigt einen kleinen Set-Konfigurator. Er funktioniert nur im Layout einer Produktseite. Felder: „Titel“, „Untertitel“ und „Set-Vorlage“. Verhalten und Produktquelle legen Sie in der Set-Vorlage fest. Mehr dazu auf der Seite [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).

**Cogi Conversion Booster Overlay** gehört ebenfalls in das Layout der Produktseite und erscheint nur, wenn die Adresse einen bestimmten Parameter enthält. Alle Felder beschreibt die Seite [Conversion Booster](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/conversion-booster.md).

## Gut zu wissen

* **Seiten ohne Produkt:** Auf Startseite, Kategorie- und Landingpages gibt es kein aktuelles Produkt. Typen, die ein Ausgangsprodukt brauchen (zum Beispiel „Ähnliche Produkte (Alternativen)“), liefern dort in der Regel nichts, und das Element verschwindet. Nehmen Sie dort Typen wie „Bestseller“, „Trends“, „Persönlich“ oder „Zuletzt angesehen“, oder legen Sie in der Vorlage ein festes Referenzprodukt fest.
* **Änderungen an der Vorlage** wirken sofort: Beim Speichern verwirft Shopware die zwischengespeicherten Seiten, die diese Vorlage nutzen. Änderungen an den Element-Einstellungen folgen dem normalen Zwischenspeicher von Shopware. Mehr auf der Seite [Wann wirkt eine Änderung?](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/wann-wirkt-eine-aenderung.md).
* **Vorlage löschen:** Eine Vorlage wird ohne Rückfrage gelöscht. Elemente, die sie nutzen, zeigen danach nichts mehr.
* **Themes:** Die Karten sind für das Shopware-Standard-Theme gebaut und übernehmen Farben und Schriften des Themes. Bei Themes mit stark eigenem Stil kann eine Anpassung über den Reiter „Design“ oder eigene CSS-Klassen nötig sein.

## 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/zhBEWCXL11vaeg0MI33M" %}
[Produktseite](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/produktseite.md)
{% endcontent-ref %}

{% content-ref url="/pages/4a495bc8ca00433afbc3971e437cf102495ab38e" %}
[Conversion-Booster](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/conversion-booster.md)
{% endcontent-ref %}

{% content-ref url="/pages/P6r8PyBDNZuKdzqoI1D2" %}
[Bilder, Preise, Ersatz und Sichtbarkeit](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/bilder-preise-und-ersatz.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/slider-erlebniswelten.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.
