> 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/bilder-preise-und-ersatz.md).

# Bilder, Preise, Ersatz und Sichtbarkeit

Ersatz bei zu wenigen Empfehlungen, Ersatzbild, Live-Preise, Sichtbarkeitsprüfung und der Umgang mit ausverkauften Produkten in Cross Selling Pro.

Diese Seite fasst die Einstellungen zusammen, die für alle Empfehlungen gelten: Was passiert, wenn eine Vorlage zu wenige Produkte findet? Welches Bild erscheint bei Produkten ohne Bild? Welcher Preis steht auf der Karte? Und wie verhindern Sie, dass Kunden Produkte sehen, die sie nicht kaufen dürfen oder können?

Den Ersatz stellen Sie je Vorlage ein. Ersatzbild, Live-Preise und Sichtbarkeit stehen in der Plugin-Konfiguration.

## Wo Sie die Einstellungen finden

* **Ersatz:** in der [Empfehlungs-Vorlage](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/empfehlungs-vorlagen.md), Abschnitt „5. Darstellung“.
* **Ersatzbild, Live-Preise, Sichtbarkeit:** in der Plugin-Konfiguration. Sie öffnen sie über **Erweiterungen → Meine Erweiterungen** beim Plugin mit „Konfigurieren“ oder im Plugin-Dashboard über die Seitenleiste **System → Plugin-Konfiguration**. Wie überall in Shopware können Sie die Werte für alle Verkaufskanäle oder für einen einzelnen Verkaufskanal setzen. Ein Wert im Verkaufskanal hat Vorrang.

## Ersatz, wenn zu wenige Empfehlungen kommen

Ohne Ersatz verschwindet ein Block ganz, wenn die Vorlage nichts liefert. Mit Ersatz zeigen Sie in diesem Fall andere Produkte.

| Einstellung              | Wirkung                                                                                                              | Standard        |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------- | --------------- |
| „Fallback-Schwelle (≤)“  | Der Ersatz greift, sobald die Anzahl der geladenen Produkte kleiner oder gleich diesem Wert ist (0 bis 50).          | 0               |
| „Fallback-Typ“           | woher die Ersatzprodukte kommen: „Kein Fallback“, „Andere Vorlage“, „Feste Produkte“ oder „Dynamische Produktgruppe“ | „Kein Fallback“ |
| „Fallback-Vorlage“       | die zweite Vorlage, die einspringt (bei „Andere Vorlage“)                                                            |                 |
| „Fallback-Produkte“      | die Produkte, die Sie selbst auswählen (bei „Feste Produkte“)                                                        |                 |
| „Fallback Produktgruppe“ | die dynamische Produktgruppe (bei „Dynamische Produktgruppe“)                                                        |                 |

So verhält sich der Ersatz im Shop:

* Kamen **keine** Produkte, zeigt der Block nur die Ersatzprodukte.
* Kamen **einige** Produkte, aber nicht mehr als die Schwelle, füllt der Ersatz bis zum Limit der Vorlage auf.
* Ersatzprodukte sind in der Statistik als Ersatz gekennzeichnet und zählen weiter zu dem Ort, an dem sie erschienen sind.

**Beispiel:** Limit 6, Schwelle 3, Typ „Andere Vorlage“ mit einer Bestseller-Vorlage. Findet die Vorlage nur 2 Produkte, ergänzt der Block 4 Bestseller.

{% hint style="warning" %}
Der Ersatz „Andere Vorlage“ wirkt nur in **Erlebniswelten-Elementen** und im **Conversion Booster**. Im Offcanvas-Warenkorb, auf der Warenkorbseite und im Kundenkonto gibt es diesen Ersatz nicht. Nutzen Sie dort „Feste Produkte“ oder „Dynamische Produktgruppe“.
{% endhint %}

Gut zu wissen:

* Der Empfehlungstyp der Ersatz-Vorlage muss in Ihrem Paket enthalten sein. Sonst entfällt der Ersatz.
* Bei „Dynamische Produktgruppe“ nimmt Cross Selling Pro höchstens 50 Produkte der Gruppe, sortiert nach Lagerbestand (höchster zuerst) und dann nach Verkäufen.
* Die Standardwerte „0“ und „Kein Fallback“ bedeuten: Liefert die Vorlage nichts, verschwindet der Block.

## Ersatzbild für Produkte ohne Bild

In der Plugin-Konfiguration, Karte „Produktbilder“, wählen Sie unter **„Ersatzbild für Produkte ohne Bild“** ein Bild aus den Medien.

Das Bild erscheint in allen Empfehlungen, wenn ein Produkt kein Bild hat oder das Bild nicht lädt: in Erlebniswelten-Elementen, im Offcanvas-Warenkorb und auf der Warenkorbseite, bei Meilenstein-Produkten, im Bundle-/Set-Konfigurator, im Vorschaufenster und im Conversion Booster.

Wählen Sie kein Bild aus, nimmt Cross Selling Pro das Ersatzbild aus dem Such-Plugin InsightSearch, falls dort eines gepflegt ist. Sonst erscheint ein grauer Platzhalter.

{% hint style="info" %}
Ein eigenes Ersatzbild mit Ihrem Logo oder in Ihren Shopfarben wirkt meist ruhiger als der graue Platzhalter.
{% endhint %}

## Live-Preise

In der Plugin-Konfiguration, Karte „Live-Preise“, steht der Schalter **„Live-Preise aus Shopware anzeigen“**. Er ist ab Werk **aus**.

| Zustand        | Welcher Preis auf der Karte steht                                                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| aus (Standard) | der Preis, den InsightSearch aus Ihrem Produkt-Feed bzw. aus der Übertragung kennt. Er kann vom Preis eines Kunden abweichen, etwa bei Kundengruppen-Preisen oder Netto-Anzeige. |
| an             | der echte, kundenindividuelle Preis aus Shopware, mit erweiterten Preisen und Preis-Plugins. Die Preiszeile bleibt kurz leer und wird dann nachgeladen.                          |

Live-Preise wirken in Erlebniswelten-Elementen, im Conversion Booster, im Offcanvas-Warenkorb, im Kundenkonto und im Bundle-/Set-Konfigurator. **Auf der Warenkorbseite wirken sie nicht.**

Für jede angezeigte Gruppe von Produkten ist eine zusätzliche Abfrage an Ihren Shop nötig. Steht „Preis anzeigen“ im Element aus, wird kein Preis nachgeladen.

Schalten Sie die Live-Preise ein, wenn Sie mit Kundengruppen-Preisen, Staffeln oder B2B-Preisen arbeiten und auf der Karte genau den Preis zeigen möchten, den der Kunde auch bezahlt.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-374efefcc2ba4f54f0baad8a4ad3f7cc06219fc0%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-plugin-konfiguration.png?alt=media" alt="Plugin-Konfiguration mit Bereichsnavigation und den Einstellungskarten"><figcaption></figcaption></figure>

## Sichtbarkeitsprüfung

In der Plugin-Konfiguration, Karte „Sichtbarkeit“, steht der Schalter **„Nur Produkte zeigen, die der Kunde sehen darf“**. Er ist ab Werk **an**.

Vor der Anzeige prüft Cross Selling Pro jede Empfehlung gegen Shopware:

* Ist das Produkt aktiv?
* Ist es im Verkaufskanal sichtbar (mindestens „per Link“)?
* Darf die Kundengruppe es sehen?
* Blendet ein anderes Plugin es aus, etwa „nur für angemeldete Kunden“?

Nicht sichtbare Produkte werden ausgeblendet. Die Prüfung kostet eine zusätzliche Abfrage je Empfehlungsblock. Sind die Live-Preise eingeschaltet, liefert dieselbe Abfrage die Preise gleich mit.

Schlägt die Prüfung einmal fehl, erscheinen alle Produkte wie ohne Prüfung.

{% hint style="warning" %}
Die Sichtbarkeitsprüfung prüft **keinen Lagerbestand**. Ausverkaufte Produkte steuern Sie in der Vorlage (siehe nächster Abschnitt).
{% endhint %}

## Ausverkaufte Produkte

Wie ausverkaufte Produkte behandelt werden, hängt von der Quelle der Vorlage ab.

| Quelle                             | Verhalten                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| InsightSearch (Standard)           | Der Lagerstatus kommt aus dem Produkt-Feed bzw. der Übertragung und folgt der Lieferbarkeit in Shopware (mit Abverkauf und Mindestabnahme). Ein Produkt mit Varianten gilt als lieferbar, wenn eine Variante lieferbar ist. In der Vorlage schiebt „Lieferbare Produkte bevorzugen“ lieferbare Produkte nach vorne, nicht lieferbare bleiben möglich. Der Regel-Baustein „Nur lieferbar“ blendet sie ganz aus. |
| Dynamische Produktgruppe           | Es erscheinen nur bestellbare Produkte. Produkte ohne Haken bei „Abverkauf“ bleiben auch bei Bestand 0 drin, weil Shopware sie dann weiter verkauft.                                                                                                                                                                                                                                                           |
| Bundle-/Set-Vorlage, Cross-Selling | nur mit „Nur verfügbare Produkte anzeigen“ in der Set-Vorlage. Bei der Quelle „Dynamische Produktgruppe“ im Set gilt das immer.                                                                                                                                                                                                                                                                                |

Mehr zu den Regeln auf der Seite [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).

## Darstellung auf Mobilgeräten

Unter 768 px Bildschirmbreite gelten überall die mobilen Regeln:

* **Erlebniswelten-Slider:** Wischen mit dem Finger, die Zahl der Karten richtet sich nach der Breite. Das Raster zeigt unter 576 px zwei Spalten, Spotlight geht bis auf eine Spalte zurück, beim Mosaik stehen Kacheln und Text untereinander.
* **Offcanvas-Warenkorb und Warenkorbseite:** eigene Schalter für Mobilgeräte am Ausspielort, siehe [Ausspielorte und Darstellung](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/ausspielorte.md).
* **Conversion Booster:** Das Raster der Alternativen hat je nach Breite eine bis vier Spalten.

## 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/f32dff0f1cc709459b5a5ff4a1bb45cac9453b03" %}
[Slider Erlebniswelten](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/slider-erlebniswelten.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 %}

{% content-ref url="/pages/GGXPYNq3gHeZ8533R9E7" %}
[Fehlersuche und häufige Fragen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/fehlersuche-und-faq.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/bilder-preise-und-ersatz.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.
