> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Gruppierungsprodukte anzeigen

> Wie Sie in WEBSALE V8s ein Produktsortiment aus einem nicht bestellbaren Hauptprodukt und mehreren bestellbaren Unterprodukten darstellen.

Ein Gruppierungsprodukt fasst ein Sortiment zusammen, beispielsweise einen Herrenanzug aus Sakko, Hemd, Hose und Krawatte. Beschreibung und Bebilderung stehen einmal am Sortiment, bestellt werden die Teile einzeln.

## Aufbau

| Teil | Rolle | Bestellbar |
| - | - | - |
| Hauptprodukt | trägt Beschreibung und Bebilderung des Sortiments | nein |
| Unterprodukte | die einzelnen Artikel des Sortiments | ja |

Weil das Hauptprodukt die Darstellung übernimmt, brauchen die Unterprodukte weder Beschreibung noch Bilder. Es genügen die Angaben, die sie voneinander unterscheiden:

* Produktname, beispielsweise "Krawatte"
* Produktnummer
* Preis
* Varianten, falls vorhanden, beispielsweise Größe und Farbe

## Wo Haupt- und Unterprodukte erscheinen

Welche der beiden Seiten sichtbar wird, hängt vom Template ab.

| Ort | Darstellung |
| - | - |
| Kategorieansicht | nur das Hauptprodukt, denn die Unterprodukte stehen in der Regel in keiner Kategorie |
| Einzelproduktansicht | Hauptprodukt und Unterprodukte als feste Einheit |
| Warenkorb | nur die Unterprodukte, ohne das Hauptprodukt |
| Suchergebnis | das gefundene Unterprodukt allein, ohne das Hauptprodukt |

Aus den beiden letzten Zeilen ergeben sich zwei Konsequenzen für die Pflege und für das Verhalten im Shop.

Soll im Warenkorb ein Thumbnail erscheinen, muss es am Unterprodukt hinterlegt sein. Das Bild des Hauptprodukts steht dort nicht zur Verfügung.

Folgt der Käufer aus dem Suchergebnis dem Link auf ein Unterprodukt, landet er auf dem Hauptprodukt mit allen Unterprodukten. Klickt er dagegen im Warenkorb auf "ändern", erscheint das Hauptprodukt nur mit dem zu ändernden Unterprodukt.

## Integration in die Einzelproduktansicht

Die Darstellung besteht aus zwei Bereichen, die einander ausschließen. Die Klammerung [`ST-ParentProduct`](https://dokumentation.websale.de/v8s/referenz/tags/st/seitenzustand-und-navigation#die-tags-im-uberblick) entscheidet, welcher davon greift.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
...
{!ST-ParentProduct}
   <!-- Daten des Produktsortiments, also des Hauptprodukts -->
{/!ST-ParentProduct}

{ST-ParentProduct}
   {CAT-AdvData($ChildProducts,99)}
      {@PR-Data}
         <!-- Daten des Unterprodukts -->
         ~PR-Name~
         ~PR-Number~
         ~PR-Price~ ~WS-Currency~
      {/@PR-Data}
   {/CAT-AdvData($ChildProducts,99)}
{/ST-ParentProduct}
...
```

Im Bereich des Hauptprodukts erscheinen weder das Mengeneingabefeld noch die Bestell-Buttons, weil das Hauptprodukt selbst nicht bestellbar ist.

Die Unterprodukte spricht [`CAT-AdvData()`](https://dokumentation.websale.de/v8s/referenz/tags/cat/navigation-und-kategoriebaum#die-tags-im-uberblick) über den Pseudo-Kategorieindex `$ChildProducts` als Liste an. Das zweite Argument begrenzt die Anzahl, im Beispiel auf 99. Die Schleife `{@[PR-Data](/v8s/referenz/tags/pr/grundlagen-und-produktdaten#die-tags-im-uberblick)}` durchläuft die Liste.

Gezählt und ausgegeben werden nur gültige Unterprodukte. Ein inaktives oder gelöschtes Unterprodukt taucht in der Liste nicht auf, ohne dass eine Lücke entsteht.

Ist kein gültiges Unterprodukt vorhanden, entfällt der gesamte `CAT-AdvData`-Bereich. Beim Ändern einer Warenkorbposition enthält die Liste genau das eine Unterprodukt, das geändert werden soll.

## Verwandte Themen

* Wegweiser: [Gewähltes Produkt anzeigen](https://dokumentation.websale.de/v8s/produkte/gewaehltes-produkt-anzeigen.md)
* Wegweiser: [Set-Produkte, wenn die Teile gemeinsam als ein Artikel bestellt werden sollen](https://dokumentation.websale.de/v8s/warenkorb/warenkorb-anzeigen-loeschen.md#set-produkte)


## Related topics

- [Set-Produkte mit fester Zusammenstellung](https://dokumentation.websale.de/v8s/set-produkte/set-produkte-mit-fester-zusammenstellung.md)
- [Produktvergleich](https://dokumentation.websale.de/v8s/interaktive-funktionen/produktvergleich.md)
- [ST- (Seitenzustand und Navigation)](https://dokumentation.websale.de/v8s/referenz/tags/st/seitenzustand-und-navigation.md)
- [Zähler und Vergleiche im Template](https://dokumentation.websale.de/v8s/fortgeschrittene-designtechniken/zaehler-und-vergleiche-im-template.md)
- [Kategorie anzeigen](https://dokumentation.websale.de/v8s/kategorien/kategorie-anzeigen.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.