SvenDasFaq

Häufige Fragen pro Produkt — mit Blöcken, Icons, FAQPage-JSON-LD und KI-Generierung aus Beschreibung & Eigenschaften

ⓘ

Was ist SvenDasFaq? Ein Shopware 6 Plugin, das pro Produkt strukturierte FAQs pflegt — entweder individuell am Produkt oder als wiederverwendbare Blöcke (z. B. „Versand", „Pflege", „Material") — und sie als Akkordeon, CMS-Element und FAQPage-JSON-LD im Shop ausspielt.

FAQs sind eines der wirksamsten Mittel, um Conversion zu steigern und gleichzeitig SEO-Sichtbarkeit aufzubauen. SvenDasFaq verbindet beides: Sie pflegen Fragen und Antworten direkt am Produkt oder in zentralen Blöcken, der Storefront-Output ist visuell aufgeräumt (gruppiert, Akkordeon, Bilder), und parallel landet eine Schema.org-konforme FAQPage in der Seite. Google, ChatGPT Search, Perplexity und Co. lesen sie als strukturierte Q&A.

Funktionen im Überblick

📝

Per-Produkt-FAQs

FAQs direkt am Produkt pflegen — Akkordeon-Repeater im Standard-„Zusatzfelder"-Block. Frage, Rich-Text-Antwort und optional ein Bild pro Eintrag.

🧩

Wiederverwendbare Blöcke

Themen-Blöcke wie „Versand", „Pflege", „Rückgabe" einmal pflegen und an beliebig vielen Produkten zuweisen — mit eigenem Icon je Block.

🎨

Gruppierte Storefront-Ausgabe

Per-Produkt-FAQs erscheinen als erste Gruppe, jeder Block wird zur eigenen Sektion mit Heading, Icon und eigenem Akkordeon — visuell klar getrennt.

🔎

FAQPage-JSON-LD

Schema.org FAQPage als flache Liste aller Fragen — sichtbar für Google FAQ Rich Results und für LLM-Crawler wie ChatGPT, Perplexity und Google SGE.

🧮

Erlebniswelten-Element

CMS-Element „Produkt-FAQs" für die Erlebniswelten — nur auf product_detail-Layouts, identischer Output wie die Auto-Append-Sektion.

⚙

Konfigurierbare Auto-Append-Sektion

Plugin-Schalter onlyViaCmsElement: entweder automatisch unter der Produktseite oder ausschließlich dort, wo Sie das CMS-Element platzieren.

🤖

KI-FAQ-Generierung NEU

Anthropic Claude oder OpenAI generieren auf Knopfdruck FAQ-Vorschläge aus Produktbeschreibung & Eigenschaften — mit Vorschau-Modal im Admin und CLI-Batch für ganze Kategorien.

KI-FAQ-Generierung

Ab Version 1.3 hat SvenDasFaq eine eingebaute KI-Integration — nach demselben Muster wie DasBild, aber rein textbasiert. Die KI bekommt Produktname, Beschreibung (HTML wird gestrippt) und die Property-Werte des Produkts zu sehen und liefert eine konfigurierbare Anzahl FAQ-Vorschläge zurück. Bilder werden nicht analysiert — das ist absichtlich, weil sich FAQ-Texte aus dem geschriebenen Produktinhalt deutlich konsistenter ableiten lassen als aus visuellen Eindrücken.

Im Admin erscheint im FAQ-Editor ein Button „KI: FAQs aus Produkt vorschlagen". Klick öffnet ein Modal mit den Vorschlägen — jeder einzeln per Checkbox an- oder abwählbar. Nach „Auswahl übernehmen" werden die ausgewählten FAQs an die bestehende Liste angehängt und können vor dem Speichern noch ganz normal editiert werden. Bestehende FAQs werden dem Prompt mitgegeben, damit die KI nicht doppelt vorschlägt.

Für Batch-Jobs gibt es den CLI-Befehl bin/console sven:das-faq:generate mit Optionen für Einzelprodukt, Kategorie (rekursiv via --include-children), --dry-run, --limit, --mode=append|replace und --force. Details in KI-FAQ-Generierung und CLI-Befehle.

ⓘ

Sicherheits-Defaults: Nur Hauptprodukte (keine Varianten) werden verarbeitet. Produkte mit bestehenden FAQs werden standardmäßig übersprungen — erst --force rührt sie an. Default-Modus ist append, keine kuratierte FAQ wird versehentlich überschrieben.

Storefront & SEO

Die Storefront-Ausgabe orientiert sich an dem, was Käufer:innen heute gewohnt sind: ein klar betiteltes Akkordeon mit Plus/Minus-Indikator (kein Bootstrap-Standard-Chevron), zweispaltiger Layout-Modus mit Bild links und Text rechts auf Desktop, einspaltig auf dem Smartphone. Die Überschrift ist dynamisch — „Häufige Fragen zu Produktname" — und wird über das Snippet sven-dasfaq.product.heading pro Sprache gesteuert.

Pro zugewiesenem Block entsteht eine eigene Sektion mit eigener Überschrift, optionalem Icon links daneben und eigenem Akkordeon. Block-Beschreibungen werden als Lead-Zeile unter der Sektion-Überschrift gerendert. Auf SEO-Ebene bleibt es eine einzige FAQPage — die Schema.org-Spezifikation sieht genau eine FAQPage pro URL vor, deshalb ist das JSON-LD eine flache Liste aller Fragen, unabhängig von der visuellen Gruppierung.

CMS-Element für Erlebniswelten

Wenn Sie die FAQs nicht automatisch unter der Produktseite haben möchten, sondern an einer bestimmten Position im Erlebniswelten-Layout, gibt es das CMS-Element „Produkt-FAQs". Es ist auf product_detail-Layouts beschränkt — auf anderen Layout-Typen taucht es im Element-Picker nicht auf — und greift auf dieselbe Datenquelle wie die Auto-Append-Sektion zu (siehe FaqAggregator-Service). So sehen Storefront-Subscriber und CMS-Element-Resolver immer dieselben Items, in derselben Reihenfolge, mit denselben Bildern.

Den Auto-Append-Modus können Sie pro Sales-Channel über die Plugin-Konfiguration deaktivieren (Schalter onlyViaCmsElement). Damit erscheinen die FAQs ausschließlich dort, wo Sie das CMS-Element platziert haben.

Technische Details

Datenmodell

Per-Produkt-FAQs: JSON in product.customFields.sven_dasfaq_items. Pro Eintrag: Frage, HTML-Antwort, optional mediaId.
Blöcke: eigene DAL-Entität sven_dasfaq_block (id, name, description, icon_id, items JSON). N:M zu Produkt via sven_dasfaq_block_product (versionsbewusst).
ProductExtension stellt die inverse Assoziation svenDasFaqBlocks am Produkt bereit und implementiert getEntityName() + getDefinitionClass() für SW 6.6/6.7-Kompatibilität.

Aggregation

Der zentrale FaqAggregator-Service mischt Per-Produkt-Items mit allen zugewiesenen Block-Items, lädt referenzierte Medien (FAQ-Bilder + Block-Icons) in einem einzigen Batch und gibt ein FaqAggregation-DTO mit groups, flatItems und media zurück. Auto-Append-Subscriber und CMS-Element-Resolver delegieren beide an ihn.

Voraussetzungen

Shopware 6.6 oder 6.7
PHP 8.1+

Migrationen

Migration1779235200InitBlocks — legt Block- und Mapping-Tabellen an (Uninstall räumt auf).
Migration1779321600AddBlockIcon — ergänzt icon_id auf sven_dasfaq_block mit FK auf media (idempotenter Column-Exists-Check).

Verfügbarkeit

SvenDasFaq ist aktuell nicht über den Shopware Store erhältlich, sondern wird auf Anfrage individuell lizenziert — inklusive Installation, Anbindung an Ihr Theme und optionalem Customizing (Icons, Layout, Snippets, eigene Felder pro Block). Den Quellcode finden Sie auf GitHub.