Installation

1. Plugin hochladen und aktivieren
2. Einstellungen → Permalinks einmal speichern (damit die FAQ-URLs aktiv werden)
3. FAQs anlegen und über Shortcode, Block oder WooCommerce-Tab ausgeben

Custom Post Type & Kategorien

FAQsy registriert den Custom Post Type faqsy_faq mit eigenem Menüpunkt im WordPress-Dashboard. Jede FAQ besteht aus:

• Titel → die Frage
• Inhalt → die Antwort (voller WordPress-Editor mit Gutenberg)
• Auszug (optional)
• Revisionen zur Nachverfolgung von Änderungen

FAQ-Kategorien

Über die hierarchische Taxonomie „FAQ-Kategorien“ (faqsy_category) lassen sich FAQs thematisch gruppieren – z. B. nach „Versand“, „Retoure“ oder „Allgemein“. Die Kategorien können direkt im Shortcode und im Block als Filter verwendet werden.

Sortierung & Reihenfolge

Jeder FAQ-Eintrag besitzt ein Feld „Reihenfolge“ (basierend auf menu_order). Kleinere Werte erscheinen weiter oben. Die Reihenfolge kann direkt in der FAQ-Übersicht im Dashboard per Quick Edit angepasst werden, ohne den einzelnen Beitrag öffnen zu müssen.

In der Admin-Übersicht stehen zusätzlich eine sortierbare Spalte für die Reihenfolge sowie ein Dropdown-Filter für FAQ-Kategorien zur Verfügung.

Shortcode

Der Shortcode gibt FAQs an beliebiger Stelle aus – auf Seiten, in Beiträgen oder in Page-Builder-Modulen.

Vollständige Syntax

[faqsy ids="" category="" limit="" layout="accordion" schema="1" sort="manual" order="asc"]

Parameter im Detail

Parameter	Beschreibung	Standardwert
ids	Kommaseparierte FAQ-IDs, z. B. ids="12,34,56". Gibt nur die angegebenen FAQs in der festgelegten Reihenfolge aus.	(alle)
category	Kommaseparierte Kategorie-Slugs, z. B. category="versand,retoure". Filtert FAQs nach einer oder mehreren Kategorien.	(alle)
limit	Maximale Anzahl der angezeigten FAQs. -1 = unbegrenzt.	-1
layout	Darstellungsform: accordion (Akkordeon mit Auf-/Zuklappen) oder list (einfache Definition-Liste).	Einstellung im Backend
schema	JSON-LD FAQPage Schema ausgeben: 1 = aktiv, 0 = deaktiviert.	Einstellung im Backend
sort	Sortierung: manual (nach Reihenfolge-Wert), title (alphabetisch) oder date (nach Datum).	manual
order	Sortierrichtung: asc (aufsteigend) oder desc (absteigend). Bei date ist der Standard desc, ansonsten asc.	automatisch

Beispiele

Alle FAQs der Kategorie „Versand“ als Akkordeon:

[faqsy category="versand" layout="accordion" schema="1"]

Die 5 neuesten FAQs als Liste, ohne Schema:

[faqsy limit="5" layout="list" schema="0" sort="date" order="desc"]

Drei bestimmte FAQs in fester Reihenfolge:

[faqsy ids="12,34,56"]

Gutenberg-Block

FAQsy bietet einen nativen Gutenberg-Block, der direkt im Block-Editor eingefügt werden kann. Der Block befindet sich in der Kategorie „Widgets“ und erscheint unter dem Namen „FAQsy“.

Block-Einstellungen (Seitenleiste)

Alle Parameter, die auch im Shortcode verfügbar sind, lassen sich bequem über die Block-Seitenleiste konfigurieren:

Einstellung	Beschreibung
IDs (CSV)	Konkrete FAQ-IDs, kommasepariert
Kategorien (Slug)	FAQ-Kategorie-Slugs, kommasepariert
Limit	Maximale Anzahl der FAQs
Layout	Akkordeon oder Liste
Sortierung	Manuell, Alphabetisch oder nach Datum
Reihenfolge	Standard, Aufsteigend oder Absteigend
FAQPage Schema	JSON-LD Schema ein-/ausschalten (Toggle)

Der Block zeigt im Editor eine Live-Vorschau mit den gewählten Einstellungen an. Die eigentliche FAQ-Darstellung wird serverseitig (dynamisch) gerendert.

Layouts

Akkordeon

Das Akkordeon-Layout zeigt die Fragen als klickbare Buttons an. Beim Klick wird die zugehörige Antwort mit einer sanften Animation ein- bzw. ausgeblendet. Der erste Eintrag ist standardmäßig geöffnet.

• +/− Symbole zeigen den aktuellen Status an
• Sanfte CSS-Transitions für Auf-/Zuklappen
• Anpassbare Farben und Eckenradius (über die Einstellungen)

Liste

Das Listen-Layout gibt die FAQs als einfache Definitions-Liste (<dl>/<dt>/<dd>) aus – ohne JavaScript, ohne interaktive Elemente. Ideal für reine Inhaltsseiten oder Print-Stylesheets.

WooCommerce-Integration

FAQsy erkennt automatisch, ob WooCommerce aktiv ist, und erweitert das Plugin um folgende Funktionen:

Produkt-FAQs

Auf jeder WooCommerce-Produktseite steht eine Metabox „Produkt-FAQs“ zur Verfügung. Dort lassen sich beliebige FAQ-Einträge per SelectWoo-Suche (Autocomplete) dem Produkt zuweisen. Die zugewiesenen FAQs erscheinen automatisch in einem eigenen „FAQ“-Tab auf der Produktdetailseite – dargestellt als Akkordeon mit aktivem Schema.

Umgekehrte Zuweisung: FAQ → Produkte

Beim Bearbeiten einer FAQ findest du in der Seitenleiste die Metabox „WooCommerce Produkte“. Dort kannst du Produkte auswählen, auf denen die aktuelle FAQ erscheinen soll – ebenfalls mit praktischer SelectWoo-Suche.

Bidirektionale Synchronisation

Alle Zuordnungen zwischen FAQs und Produkten werden bidirektional synchron gehalten:

• Weist du einem Produkt eine FAQ zu, wird die FAQ automatisch auch mit dem Produkt verknüpft – und umgekehrt.
• Wird eine Zuordnung auf einer Seite entfernt, verschwindet sie auch auf der anderen.
• Dies garantiert jederzeit konsistente Verknüpfungen, egal ob du von der Produkt- oder der FAQ-Seite aus arbeitest.

Produktkategorie-FAQs

FAQs können auch WooCommerce-Produktkategorien zugewiesen werden. Die Zuweisung erfolgt direkt beim Bearbeiten einer Produktkategorie über ein Mehrfach-Auswahlfeld. Die zugeordneten FAQs werden automatisch auf der jeweiligen Produktkategorie-Archivseite oberhalb der Produkte als Akkordeon mit Schema ausgegeben.

Shortcode [faqsy_product]

Für individuelle Platzierungen der Produkt-FAQs außerhalb des Standard-Tabs – z. B. in Landingpages oder Page-Builder-Layouts – gibt es den Shortcode:

[faqsy_product product_id="123" layout="accordion" schema="1"]

Parameter	Beschreibung	Standardwert
product_id	ID des WooCommerce-Produkts. Ohne Angabe wird das aktuelle Produkt erkannt.	aktuelles Produkt
layout	accordion oder list	accordion
schema	JSON-LD Schema: 1 oder 0	1

JSON-LD FAQPage Schema

Wenn aktiviert, gibt FAQsy zusätzlich zur sichtbaren Darstellung ein JSON-LD <script> im FAQPage-Format aus. Dieses strukturierte Daten-Markup wird von Suchmaschinen wie Google erkannt und kann zu Rich Results (FAQ-Snippets) in den Suchergebnissen führen.

Das Schema enthält für jede FAQ automatisch:

• @type: Question mit dem Fragetext (name)
• @type: Answer mit dem Antworttext (text)

Die Schema-Ausgabe lässt sich global in den Einstellungen oder pro Shortcode/Block individuell ein- und ausschalten.

Einstellungen

Die Plugin-Einstellungen findest du unter Einstellungen → FAQsy im WordPress-Dashboard.

Allgemein

Einstellung	Beschreibung
Standard-Layout	Legt fest, welches Layout standardmäßig verwendet wird: Akkordeon oder Liste. Gilt als Fallback, wenn im Shortcode/Block kein Layout angegeben wird.
FAQPage Schema aktivieren	Aktiviert/deaktiviert die JSON-LD FAQPage Schema-Ausgabe als globalen Standard. Kann pro Shortcode/Block überschrieben werden.

Farben & Styling

Die folgenden Einstellungen beeinflussen das Erscheinungsbild des Akkordeon-Layouts:

Einstellung	Beschreibung	Standardwert
Hintergrund (Frage)	Hintergrundfarbe der einzelnen FAQ-Items (Frage-Zeile).	#F2EDE4
Hintergrund Hover	Hintergrundfarbe beim Hover über ein FAQ-Item.	#E5D9C7
Textfarbe (Frage)	Textfarbe für die Frage und die Antwort.	#3B3A2C
Eckenradius	Border-Radius der FAQ-Items. Gültige CSS-Werte wie 0, 6px, 0.5rem oder 10px.	10px

Alle Farbeinstellungen verwenden native Color-Picker. Die Werte werden als CSS Custom Properties (--faqsy-item-bg, --faqsy-item-hover-bg, --faqsy-text, --faqsy-item-radius) inline auf den Wrapper geschrieben, sodass sie problemlos mit jedem Theme zusammenarbeiten.

Technische Details

Eigenschaft	Wert
WordPress-Minimum	5.8
Getestet bis	WordPress 6.6
WooCommerce	Optional – wird automatisch erkannt
Custom Post Type	faqsy_faq
Taxonomie	faqsy_category
Archiv-URL	/faq/
Kategorie-URL	/faq-kategorie/{slug}/
Externe Requests	Keine – DSGVO-freundlich
Internationalisierung	i18n-ready (Text Domain: faqsy)
Lizenz	GPLv2 or later

Deinstallation

Bei der Deinstallation (Löschen des Plugins) werden alle Plugin-Optionen automatisch aus der Datenbank entfernt. Die FAQ-Beiträge selbst bleiben erhalten und können bei Bedarf manuell gelöscht werden.