# Storefront Integration Das Plugin rendert FAQs an drei Stellen in der Storefront: 1. Auf der Produktdetailseite, automatisch. 2. In Erlebniswelten, über zwei eigene CMS-Elemente. 3. Als `FAQPage`-JSON-LD-Rich-Snippet im Seiten-``, automatisch. ## Produktdetailseite Auf jeder Produktdetailseite lädt das Plugin alle aktiven FAQ-Gruppen, deren dynamische Produktgruppe zum aktuellen Produkt passt. Leere Gruppen (ohne aktive Einträge) werden nicht ausgegeben. Die Platzierung steuerst du über die Einstellung **FAQ-Platzierung auf der Produktdetailseite** in der Plugin-Konfiguration: * **Tab vor Bewertungen** — In der Tab-Navigation der Produktdetailseite wird ein neuer Tab "FAQ" vor dem Bewertungs-Tab eingefügt. * **Tab nach Bewertungen** (Standard) — Der Tab "FAQ" wird hinter dem Bewertungs-Tab eingefügt. * **Unterhalb der Beschreibung** — Der FAQ-Block wird direkt unterhalb der Produktbeschreibung gerendert, ohne Tab. Innerhalb des FAQ-Blocks rendert jede Gruppe ihren Namen (immer) und ihre Beschreibung (gesteuert durch "Sichtbarkeit der Gruppenbeschreibung"), gefolgt von einem Akkordeon der FAQ-Einträge sortiert nach Priorität. ## Erlebniswelten Das Plugin fügt zwei CMS-Elemente in den Erlebniswelten hinzu, beide unter der Kategorie **FAQ** in der Element-Seitenleiste: ### FAQ-Gruppen Eine oder mehrere FAQ-Gruppen zur Ausgabe wählen. Das Element rendert die ausgewählten Gruppen in Prioritäts-Reihenfolge. Jede Gruppe rendert ihren Titel, ihre Beschreibung (abhängig von den Sichtbarkeits-Einstellungen) und das Akkordeon ihrer aktiven Einträge. Sinnvoll für: einen eigenen FAQ-Bereich auf einer Landingpage, in dem du bestehende FAQ-Gruppen bündeln willst, ohne den Inhalt neu anzulegen. ### FAQ-Einträge Einen oder mehrere einzelne FAQ-Einträge zur Ausgabe wählen. Das Element rendert die ausgewählten Einträge in einem einzigen Akkordeon, unabhängig von den Gruppengrenzen. Sinnvoll für: ausgewählte Fragen auf der Startseite oder einer Kampagnen-Landingpage hervorheben, ohne Bezug zur Gruppenstruktur. Beide CMS-Elemente liefern dasselbe `FAQPage`-JSON-LD-Rich-Snippet für die enthaltenen Einträge aus, damit Suchmaschinen die Antworten erkennen. ## Sichtbarkeit der Gruppenbeschreibung Ob die Beschreibung einer FAQ-Gruppe oberhalb der Einträge gerendert wird, steuerst du auf zwei Ebenen: 1. **Plugin-Ebene** — Setze "Sichtbarkeit der Gruppenbeschreibung" in der Plugin-Konfiguration auf **Anzeigen** (Standard) oder **Ausblenden**. Das ist der globale Standard. 2. **Pro Gruppe** — Setze auf der Detailseite einer FAQ-Gruppe "Sichtbarkeit der Gruppenbeschreibung" auf **Wie Einstellung im Plugin** (Standard), **Anzeigen** oder **Ausblenden**. Der Gruppen-Wert hat immer Vorrang vor der Plugin-weiten Einstellung. Das gilt sowohl für die Produktdetailseite als auch für die Erlebniswelten-Elemente. ## Rich Snippets (SEO) Sobald FAQs gerendert werden (Produktdetailseite oder Erlebniswelten), fügt das Plugin automatisch ein `FAQPage`-JSON-LD-Rich-Snippet in den Seiten-`` ein. Das Snippet enthält Frage- und Antworttext aller gerenderten Einträge und ist gemäß Schema.org-`FAQPage`-Schema strukturiert, was die Seite für Googles FAQ-Rich-Result qualifiziert. Dafür ist keine zusätzliche Konfiguration erforderlich — das Snippet wird aus denselben Daten erzeugt, die auch auf der Seite gerendert werden. --- # Agent Instructions: 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/faq-produkte-und-erlebniswelten/storefront-integration.md?ask= ``` 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.