SW Shopware 6 Shopware Anfänger

FAQ Schema.org Generator — Dokumentation

DfFaqSchema installieren und konfigurieren: FAQ-Einträge pro Produkt, Kategorie und CMS-Seite, CMS-Element für Erlebniswelten und FAQPage-JSON-LD-Markup in Shopware 6.5 bis 6.7.

Aktualisiert Modulversion 1.0.0

Überblick

DfFaqSchema fügt editierbare Frage-Antwort-Blöcke auf Produktseiten, Kategorieseiten und Erlebniswelten-Layouts in Shopware 6 hinzu. Jeder Block wird als Bootstrap-Akkordeon gerendert und mit Schema.org-FAQPage-Markup in JSON-LD versehen, das automatisch in die Seite injiziert wird. Das Plugin unterstützt Shopware 6.5, 6.6 und 6.7 und erfordert keine Änderungen an Ihrem Theme.

Installation

Über die Administration

  1. Öffnen Sie Erweiterungen, dann Meine Erweiterungen, und laden Sie die ZIP-Datei des Plugins hoch.
  2. Klicken Sie auf Installieren und aktivieren Sie das Plugin.

Über die Konsole

bin/console plugin:refresh
bin/console plugin:install --activate DfFaqSchema
bin/console cache:clear

Build der Administration

Das Administrationsmodul und das CMS-Element benötigen einen einmaligen Asset-Build:

./bin/build-administration.sh

Ohne diesen Schritt erscheinen der Menüpunkt FAQ Schema.org und das CMS-Element nicht in der Administration. Der Storefront funktioniert sofort nach der Aktivierung.

Konfiguration

Öffnen Sie Erweiterungen, Meine Erweiterungen, dann die Konfiguration von DfFaqSchema. Zwei Optionen stehen zur Verfügung, global oder pro Verkaufskanal:

  • FAQs auf Produktseiten anzeigen: aktiviert Akkordeon und JSON-LD auf Produktseiten (standardmäßig aktiviert).
  • FAQs auf Kategorieseiten anzeigen: aktiviert Akkordeon und JSON-LD auf Navigationsseiten (standardmäßig aktiviert).

FAQ-Einträge erstellen

Öffnen Sie Inhalte, dann FAQ Schema.org. Das Listing zeigt alle Einträge mit Frage, Zuweisung, Position und Status.

Felder eines Eintrags

  • Frage: der Fragetext (übersetztes Feld).
  • Antwort: die Antwort als Rich Text über den integrierten Editor (übersetztes Feld).
  • Position: die Anzeigereihenfolge im Akkordeon, aufsteigend.
  • Aktiv: nur aktive Einträge werden angezeigt und ausgezeichnet.
  • Zuweisung: Produkt, Kategorie oder CMS-Seite. Der Typwähler blendet das passende Suchfeld ein.

Einen Eintrag übersetzen

Wechseln Sie die Sprache über den Sprachwechsler oben auf der Detailseite und erfassen Sie die übersetzte Frage und Antwort. Jede Storefront-Sprache zeigt ihre eigenen Inhalte und das JSON-LD folgt automatisch.

Ein Eintrag ohne Übersetzung in einer Sprache fällt auf die Systemstandardsprache zurück, nach dem Standardmechanismus von Shopware.

Anzeige auf Produkt und Kategorie

Einem Produkt zugewiesene Einträge erscheinen unter dem Hauptinhalt der Produktseite. Einer Kategorie zugewiesene Einträge erscheinen unter dem Listing der Navigationsseite. In beiden Fällen wird das passende FAQPage-JSON-LD in den Head des Dokuments injiziert. Die erste Frage des Akkordeons ist standardmäßig geöffnet.

CMS-Element für die Erlebniswelten

  1. Erstellen Sie Ihre Einträge im Modul, ohne sie einem Produkt oder einer Kategorie zuzuweisen (Zuweisung CMS-Seite).
  2. Öffnen Sie Inhalte, dann Erlebniswelten, und bearbeiten Sie ein Layout.
  3. Fügen Sie einen Textblock hinzu und ersetzen Sie dessen Element durch das Element FAQ (Schema.org).
  4. Wählen Sie in der Elementkonfiguration die anzuzeigenden Einträge aus.

Akkordeon und JSON-LD werden genau an der Position des Elements gerendert. Sie können mehrere FAQ-Elemente auf demselben Layout verwenden.

JSON-LD-Markup und Validierung

Das Plugin generiert ein FAQPage-Objekt mit einer Question-Entität pro angezeigtem Eintrag, wobei die Antwort als HTML im Feld text der Answer-Entität übergeben wird, was Google akzeptiert. Das Markup deckt nur Inhalte ab, die tatsächlich auf der Seite sichtbar sind, im Einklang mit den Rich-Results-Richtlinien.

Zur Validierung einer Seite nutzen Sie den Test für Rich-Suchergebnisse von Google: fügen Sie die URL Ihrer Produktseite ein und prüfen Sie, dass das FAQ-Element fehlerfrei erkannt wird.

Ob Rich Results tatsächlich erscheinen, liegt im Ermessen von Google, das sie seit 2023 überwiegend autoritativen Behörden- und Gesundheitsseiten vorbehält. Das Markup bleibt wertvoll für das Verständnis Ihrer Seiten durch Suchmaschinen und KI-Assistenten.

Fehlerbehebung

  • Der Menüpunkt FAQ Schema.org erscheint nicht: führen Sie den Build der Administration aus und leeren Sie den Browser-Cache.
  • Das Akkordeon erscheint nicht auf einer Produktseite: prüfen Sie, dass der Eintrag aktiv ist, diesem Produkt zugewiesen ist und die Produktanzeige-Option für den betreffenden Verkaufskanal aktiviert ist.
  • Das JSON-LD fehlt: das Markup wird nur generiert, wenn mindestens ein aktiver Eintrag auf der Seite angezeigt wird. Suchen Sie im Quellcode der Seite nach application/ld+json.
  • Das CMS-Element zeigt nichts an: prüfen Sie, dass in der Elementkonfiguration Einträge ausgewählt wurden und dass diese aktiv sind.

Deinstallation

Die Deinstallation entfernt die Tabellen des Plugins und seine Konfiguration. Aktivieren Sie bei der Deinstallation die Option zum Behalten der Daten, um Ihre Fragen und Antworten für eine Neuinstallation zu bewahren.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren