FAQ Professional

Behoben

Betrifft die Verwaltung der FAQs im Backend, wenn nicht anders angegeben.

• Eine neu zugeordnete Frage landet am Ende der Liste statt ganz oben. Bisher setzte jedes Speichern ihre Position in allen Gruppen zurück. Bestehende Gruppen werden beim Update einmalig durchnummeriert, Ihre Reihenfolge bleibt erhalten.
• Der Zitat-Knopf im Antwort-Editor löschte markierten Text, statt ihn umzuwandeln. Er umschließt ihn jetzt.
• Der eingetippte Suchbegriff blieb nach dem Auswählen im Feld stehen. Er verschwindet jetzt, und die Liste bietet danach wieder alle Einträge an.
• Die Fragen- und Gruppenliste merken sich die eingeblendeten Spalten — je Benutzerkonto, samt Reihenfolge und Kompaktmodus.
• Nach dem Speichern kehren Sie dorthin zurück, wo Sie hergekommen sind. Wer auf der Maske bleiben will, nimmt den zweiten Knopf daneben.
• Die Speichern-Knöpfe zeigen an, dass geschrieben wird. Bei vielen Zuweisungen dauert das spürbar.
• Ein aktiver Eintrag lässt sich immer abschalten, auch wenn er seine letzte Zuweisung verloren hat. Gesperrt ist nur noch das Anschalten.
• Gruppen mit mehr als rund 9.400 Zuweisungen wurden unvollständig angezeigt. Wer so speicherte, konnte den nicht geladenen Teil verlieren. Der Bestand wird jetzt vollständig gelesen.
• Die Beschreibung einer FAQ-Gruppe erscheint jetzt im Shop, zwischen Gruppenüberschrift und erster Frage.
• Der Abbrechen-Knopf im Löschen-Dialog zeigt wieder „Abbrechen" statt eines internen Textschlüssels.
• Beschriftungen in der Verwaltung sind richtiggestellt. „Vertriebskanal" heißt jetzt „Verkaufskanal", wie bei Shopware selbst.
• Die Beschriftung des Antwortfelds steht wieder über dem Feld, mit richtigem Abstand nach unten.

Neu

• „Alle Verkaufskanäle" mit einem Schalter — auch für später angelegte Kanäle. Ihre bisherige Auswahl bleibt gespeichert und gilt wieder, sobald Sie ihn ausschalten.
• FAQ-Gruppen lassen sich Kategorien und Artikeln zuweisen, nicht mehr nur über Tags. Ein Tag genügt weiterhin, eine Kategorie genügt auch. Unterkategorien erben die Zuweisung nicht.
• Sprungmarken wahlweise ohne Gruppennamen. Aus versand-wie-lange-dauert-die-lieferung wird dann wie-lange-dauert-die-lieferung. Bereits geteilte Links funktionieren in jedem Fall weiter. Voreingestellt ist die bisherige Form — wer nichts umstellt, merkt nichts.
• Die Auswahl von Gruppen, Tags, Kategorien und Artikeln ist übersichtlicher. Getippte Begriffe werden zuerst am Wortanfang gesucht; für großen Bestand gibt es „Alle anzeigen" mit Suche und Alphabet-Register.
• Gleichnamige FAQ-Gruppen sind unterscheidbar — die Fragenanzahl steht dahinter, etwa „Versand & Lieferung (195)".
• Fragen- und Gruppenliste lassen sich nach Verkaufskanal filtern.
• Die Gruppenliste zeigt die Spalten „Kategorien" und „Artikel".
• Kategorieseiten zeigen zugewiesene FAQ-Gruppen auch ohne CMS-Block. Ein vorhandener Block hat weiterhin Vorrang.

Wichtig beim Update

Shops mit Elasticsearch brauchen einen Reindex, damit „Alle Verkaufskanäle" auch in der Shop-Suche greift. Einzelheiten in UPGRADE.md.

An Ihren bestehenden Links ändert sich nichts.

Behoben

Betrifft die Anzeige der FAQs im Shop, und dort vor allem Besucher, die ohne
Maus arbeiten — mit der Tastatur oder mit einem Bildschirmleser.

• Ein Rahmen zeigt wieder, wo die Tastatur gerade steht. Wer sich mit der
  Tabulatortaste durch die Fragen bewegt, sieht die aktuelle Frage jetzt
  hervorgehoben; bisher war nicht zu erkennen, welche Frage sich beim Drücken
  der Eingabetaste öffnen würde. Beim Bedienen mit der Maus erscheint der Rahmen
  nicht — dort weiß man ohnehin, wo man ist.
• Ein Link in einer Frage steht der Bedienung nicht mehr im Weg. Enthielt
  eine Frage einen Link, saß dieser im Aufklapp-Schalter. Bildschirmleser können
  ein Bedienelement in einem Bedienelement nicht auflösen: Der Link war nicht
  erreichbar und der Schalter nicht zuverlässig bedienbar. In der Frage werden
  Links jetzt als Text angezeigt; Auszeichnungen wie fett oder kursiv bleiben
  erhalten. In der Antwort ändert sich nichts — dort bleiben Links
  anklickbar, und dorthin gehören sie auch.

Beide Punkte betreffen verbindliche Stufen der Barrierefreiheit (WCAG 2.2,
Stufe A und AA). Für Online-Shops fordert das Barrierefreiheitsstärkungsgesetz
sie seit Juni 2025.

Verbessert

• Optimierungen am Quellcode für bessere Lesbarkeit.

Behoben

Betrifft Installationen, in denen die Administration aus dem Quelltext neu
gebaut wird — typischerweise Agentur- und Deployment-Umgebungen. Wer das Plugin
über den Store installiert und die mitgelieferten fertigen Dateien verwendet,
war nicht betroffen.

• Der Bau der Administration läuft wieder durch. Dem Paket fehlte die
  Datei, in der die benötigten JavaScript-Pakete aufgeführt sind. Ohne sie lädt
  Shopware sie nicht, und der Bau bricht mit „Rollup failed to resolve import"
  ab; bisher half nur, die Datei von Hand zu ergänzen.
• Sieben JavaScript-Pakete sind jetzt ausdrücklich aufgeführt. Sie kamen
  bisher nur deshalb mit, weil ein anderes Paket sie mitbringt. Bei
  Paketverwaltern mit strenger Ablage — etwa pnpm oder Yarn — konnte der Bau
  daran scheitern.

Verbessert

• Die Aufzählung auf der noch leeren Statistik-Seite endet mit Satzzeichen und
  schreibt „30 Tage" als Zahl.

Behoben

Betrifft die Statistik-Seite im Backend, und dort vor allem Shops, in denen
noch wenig oder gar nichts passiert ist. Die Seite ließ überall dort Teile weg
oder verschob sie, wo eine Zahl noch fehlte.

• Es stehen wieder vier Kacheln nebeneinander. Die vierte — „Bewertungen" —
  fehlte, solange niemand eine Antwort bewertet hatte; jetzt zeigt sie einen
  Strich, bis die erste Bewertung eingeht.
• Die kleinen Diagramme in den Kacheln haben wieder ihre volle Höhe. Fehlt
  über einem Diagramm die grüne oder rote Vergleichszahl — in den ersten Tagen
  eines Shops ist das der Normalfall —, wurde es bisher auf ein Viertel
  zusammengedrückt, und darunter blieb eine große leere Fläche stehen.
• In Kacheln ohne Zahlen steht eine feine Linie dort, wo später die Balken
  erscheinen. Bisher war die Fläche einfach leer.
• Der Zeitraum unter der ersten Kachel erscheint erst, wenn es einen gibt.
  Bisher stand dort auf einem neuen Shop das Wort „Verlauf:" und dahinter
  nichts.
• Wer nach Vertriebskanal oder Sprache einschränkt und dort noch keine
  Aufrufe hat, liest jetzt genau das. Bisher erschien derselbe Satz wie auf
  einem Shop ganz ohne Daten — auch dann, wenn andere Kanäle längst Zahlen
  lieferten.
• Der Knopf „Statistiken zurücksetzen" erscheint nur, wenn es etwas
  zurückzusetzen gibt.
• Eine interne Verknüpfung zwischen Frage und FAQ-Gruppe war falsch
  benannt. Auf die Anzeige im Shop und im Backend hatte das keine
  Auswirkung — die Verknüpfung wird an keiner Stelle des Plugins gelesen. Wer
  das Plugin mit eigenem Code erweitert, erhält sie jetzt wie erwartet.

Neu

• Eine noch leere Statistik-Seite erklärt, was dort entstehen wird — und
  nennt die Voraussetzung dafür: Die FAQs müssen im Shop sichtbar sein, als
  eigene Seite, als Reiter am Produkt, in der Kategorie oder als CMS-Block.

Verbessert

• Optimierungen am Quellcode für bessere Lesbarkeit.

Behoben

Betrifft alle Shops. Dem Befehlsmenü im Antwort-Editor — es erscheint nach
der Eingabe eines Schrägstrichs — fehlten zwei Verhaltensweisen, die
erst auffallen, wenn man nach dem Schrägstrich weiterschreibt.

• Die Auswahl grenzt sich mit jedem getippten Zeichen ein. Wer nach dem
  Schrägstrich tab eintippt, sieht nur noch die Befehle, die dazu passen;
  bisher blieb die vollständige Liste stehen.
• Das Menü folgt der Schreibmarke. Es steht jetzt bei jedem Zeichen unter
  der Stelle, an der geschrieben wird; bisher blieb es dort stehen, wo der
  Schrägstrich getippt wurde.

Verbessert

• Die unterstützten PHP-Fassungen sind ausdrücklich benannt: 8.2 bis 8.5.
  Die Installation auf einer älteren Fassung wird damit von vornherein
  abgewiesen, statt erst im Betrieb zu scheitern — bisher stand dort eine
  offene Untergrenze, obwohl der Code Sprachmittel ab 8.2 verwendet.
• Der Quelltext wurde durchgehend auf die Ausdrucksmittel dieser Fassungen
  umgestellt und ist damit kürzer und einheitlicher zu lesen. Am Verhalten
  ändert das nichts.

Ebenfalls enthalten

Die Fassung 6.7.1 wurde nicht einzeln veröffentlicht. Wer von 6.7.0 kommt,
erhält ihre Neuerungen mit dieser Aktualisierung:

• Die Statistik zeigt Verläufe. Unter jeder der vier Kacheln steht, wie sich
  der Wert entwickelt hat: ein Balken je Tag für die Aufrufe, ein Ring für die
  Bewertungen. Wer mit dem Zeiger über einen Tag fährt, liest Datum und Anzahl.
• Die Bewertungsquote wird eingeordnet. Neben dem Prozentwert steht ein Satz,
  der ihn benennt. Wie belastbar die Quote ist, richtet sich nach der Zahl der
  abgegebenen Stimmen.
• Jede Kachel nennt die Veränderung zum vorangegangenen Zeitraum gleicher
  Länge.
• Meldungstitel und Spaltenüberschriften erscheinen in der eingestellten
  Sprache der Administration. Betroffen waren die Listen und
  Bearbeitungsseiten für Fragen und Gruppen.

Neu

• Die Statistik zeigt Verläufe. Unter jeder der vier Kacheln steht, wie sich der Wert entwickelt hat: ein Balken je Tag für die Aufrufe, ein Ring für die Bewertungen. Wer mit dem Zeiger über einen Tag fährt, liest Datum und Anzahl — auch bei Tagen ohne einen einzigen Aufruf. Bisher standen dort vier Zahlen ohne Verlauf.
• Die Bewertungsquote wird eingeordnet. Neben dem Prozentwert steht ein Satz, der ihn benennt. Wie belastbar die Quote ist, richtet sich nach der Zahl der abgegebenen Stimmen: Sind es wenige, nennt der Hinweis beim Überfahren den Bereich, in dem der tatsächliche Wert liegt.
• Jede Kachel nennt die Veränderung zum vorangegangenen Zeitraum gleicher Länge — grün bei Zuwachs, rot bei Rückgang, grau bei unverändertem Wert. Liegt noch kein vollständiger Vorzeitraum vor, erscheint der absolute Zuwachs anstelle eines Prozentwerts.

Behoben

Betrifft Shops, deren Administration auf Englisch geführt wird.

• Meldungstitel und Spaltenüberschriften erscheinen in der eingestellten Sprache der Administration. Betroffen waren die Listen und Bearbeitungsseiten für Fragen und Gruppen; bisher standen diese Texte fest im Programmcode und blieben dort auch in einem englischen Backend deutsch.

Wartung

• Die Grundlagen des Editors für Antworten und Gruppenbeschreibungen sind aktualisiert. Die eingespielten Änderungen betreffen Tabellen, Listen und das Zusammenspiel mit der Administration. Am Bearbeiten von Fragen und Antworten ändert sich nichts.
• Der Bauvorgang des Plugins ist wiederholbar. Alle verwendeten Fremdpakete sind auf feste Fassungen und Prüfsummen festgelegt. Bisher galt das nur für einen Teil von ihnen, sodass zwei Installationen unterschiedliche Pakete erhalten konnten. Für den Betrieb im Shop ändert sich dadurch nichts.
• Die Auswertung der Statistik ist in einzeln prüfbare Bestandteile zerlegt, die beiden Indexer der Administration teilen sich eine gemeinsame Grundlage, und die Routendefinition liegt als YAML vor. Am Verhalten ändert sich nichts.

• Beim Update werden Fragen und Gruppen abgeschaltet, denen ein Verkaufskanal oder eine Gruppe fehlt. Die Regel steht seit jeher am Aktiv-Schalter: „Aktiv kann nur gesetzt werden, wenn Vertriebskanal und Gruppe zugewiesen sind." Durchgesetzt hat sie bisher aber die Listenansicht im Admin — beim bloßen Öffnen, still und ohne Rückmeldung. Das hatte eine Folge, die kaum jemand vermuten würde: Solche Fragen waren im Shop über die Suche auffindbar, und zwar so lange, bis zufällig ein Mitarbeiter die passende Admin-Seite aufrief. Ob ein Kunde einen Treffer sah, hing damit am Verhalten im Backend. Das Update setzt die Regel einmalig und nachvollziehbar durch; danach ändert sie niemand mehr im Vorbeigehen. Betroffene Einträge bleiben erhalten und stehen in der Liste weiterhin mit rotem Hinweis — sie sind nur nicht mehr aktiv.
• Verkaufskanäle ohne Storefront lassen sich nicht mehr auswählen. Die Auswahlfelder bei FAQ-Gruppen, bei Fragen und im Statistik-Filter boten bisher alle Kanäle an, auch „Headless" und „Produktvergleich". Keiner davon hat eine HTML-Storefront: Eine dort zugeordnete FAQ wird nirgends ausgespielt, und im Statistik-Filter kam verlässlich eine leere Auswertung heraus, ohne dass erkennbar war, warum. Bereits gespeicherte Zuordnungen zu solchen Kanälen entfernt das Update. An Fragen und Gruppen selbst ändert sich dabei nichts.
• Die FAQ-Listen im Admin öffnen sich deutlich schneller. Die Gruppenliste hängte an jede Zeile sämtliche Fragen der Gruppe an, nur um vier Zahlen anzuzeigen: Anzahl, Klicks und die Hilfreich-Bewertung. Bei einem gut gefüllten FAQ-Bestand kamen so je Seitenaufruf mehrere Megabyte zusammen; jetzt sind es einige Dutzend Kilobyte. Auch die Fragenliste lud je Zeile vollständige Verkaufskanal-Datensätze, damit eine Spalte Namen anzeigt. Die angezeigten Zahlen sind unverändert; sie werden jetzt berechnet statt zusammengetragen.
• Einträge pro Seite sind in beiden Listen gleich: 25, 50 oder 100. Bisher boten die Fragen 15/30/50/100 an und starteten mit 15, die Gruppen 15/25/50/100 und starteten mit 25. Die kleinste Stufe entfällt — fünfzehn Zeilen sind auf einem heutigen Bildschirm eine halbe Seite.
• Neu: Wie lange das Klickprotokoll aufbewahrt wird. Unter „Aufbewahrung" wählbar: 12 Monate, 24 Monate oder unbegrenzt. Eine tägliche Aufgabe räumt danach von selbst auf. Ab Werk steht die Einstellung auf „unbegrenzt" — ein Update soll keine Statistik löschen, um die niemand gebeten hat. Wer aufräumen möchte, stellt es dort ein.
• Die Statistik wertet spürbar schneller aus. Der Filter nach Verkaufskanal und Sprache griff auf Spalten zu, die in keinem Index standen; jede Auswertung las dafür die vollständige Klick-Tabelle. Bei wenigen Zeilen fällt das nicht auf, mit echtem Verkehr sehr wohl. Außerdem berücksichtigt „Statistik zurücksetzen" jetzt den eingestellten Filter, statt immer alles zu leeren.
• Die Suche im Admin findet jetzt auch Umlaute. „Größe" oder „Rückgabe" lieferten dort bisher keinen einzigen Treffer, obwohl die Fragen vorhanden waren.
• Eine Frage erscheint auf einer Seite nur noch einmal. Steht dieselbe Frage in zwei Gruppen — etwa eine allgemeine Frage, die überall erscheinen soll, zusätzlich zum Produkt-Reiter — wurde sie bisher mehrfach ausgegeben, sichtbar und in der Auszeichnung für Suchmaschinen. Das gilt jetzt über die ganze Seite hinweg, nicht mehr nur je Ausgabebereich.
• Das Kopier-Symbol ist ab Werk ausgeschaltet. Neu unter „Formatierung / Aussehen“: „Kopier-Symbol hinter jeder Frage anzeigen“. Nach einem Update ändert sich damit nichts an Ihrer FAQ-Seite — auch der Innenabstand der Fragen bleibt unangetastet. Wer die Funktion möchte, schaltet sie dort ein.
• Angesprungene Fragen stehen jetzt oben statt in der Bildmitte. Derselbe Link endete bisher an drei verschiedenen Stellen, je nachdem ob man ihn neu aufrief, in der Adresszeile erneut bestätigte oder die Seite neu lud. Alle drei Wege führen jetzt an dieselbe Stelle, mit Abstand zur Kopfzeile.
• Ein Kopier-Symbol hinter jeder Frage. Ein Klick legt den Link genau zu dieser Frage in die Zwischenablage — praktisch, um einem Kunden per Mail die eine passende Antwort zu schicken, statt ihn auf die FAQ-Seite zu verweisen. Bewusst als Schaltfläche gebaut und nicht als Link: Bei tausenden Fragen entstünden sonst ebenso viele zusätzliche interne Verweise auf einer Seite, die Suchmaschinen allesamt verfolgen. Es entsteht dadurch kein einziger zusätzlicher Link auf Ihrer Seite.
• Der Sprachwechsel behält die geöffnete Frage. Wer eine Frage aufgeschlagen hat und die Sprache umstellt, landet nicht mehr am Seitenanfang, sondern bei derselben Frage in der neuen Sprache. Gibt es sie dort nicht, bleibt es beim Seitenanfang.
• Die FAQ-Vorschläge in der Suche verwiesen in Fremdsprachen ins Leere. In einem Shop mit Sprachdomänen zeigte jeder Vorschlag auf die Adresse ohne Sprachkürzel — also auf eine Seite, die es nicht gibt. Der Fehler blieb unbemerkt, weil er in der Standardsprache nicht auftritt.
• Links auf eine einzelne Frage sind jetzt lesbar. Statt …/faq-seite#faq-d4d4d4d4…-f6f6f6f6… heißt es künftig …/faq-seite#allgemeine-fragen-wie-kann-ich-bestellen — Gruppenname und Frage in Kurzform. Wer so einen Link in einer E-Mail, im Chat oder im Ticket weitergibt, sieht auf einen Blick, wohin er führt; ein KI-Assistent, der die llms.txt liest, gibt ihn ebenso weiter. Umgesetzt im FAQ-Akkordeon, in den Suchvorschlägen, auf der Suchergebnis-Seite und in der llms.txt.
• Bereits geteilte Links funktionieren unverändert weiter. Jede Frage behält zusätzlich ihre bisherige Sprungmarke faq-{Gruppen-ID}-{Frage-ID} an genau der Stelle, an der sie immer stand. Ein Link, den ein Kunde vor Monaten gespeichert oder in einem Forum hinterlassen hat, springt weiterhin zur richtigen Frage und klappt sie auf. Keine bisherige Sprungmarke entfällt.
• Behoben: Eine einzige unvollständig übersetzte FAQ-Gruppe legte /llms-full.txt in dieser Sprache komplett lahm. Die Seite antwortete mit einem Serverfehler, und damit fehlten nicht nur die eine Gruppe, sondern alle anderen gleich mit. Dieser Zustand entsteht in jedem Shop, sobald jemand eine Gruppe anlegt und die Übersetzung später nachreicht. Eine Gruppe ohne Übersetzung erscheint jetzt einfach ohne Namen.
• Die maschinenlesbaren Dateien sind jetzt je Sprache richtig. Adressen tragen den Sprachpfad der jeweiligen Verkaufskanal-Domain (/en/… statt der deutschen Adresse), und die FAQ-Seite wird über die SEO-Adresse genau dieser Sprache ermittelt. Gibt es die Seite in einer Sprache nicht, erscheinen dort keine Fragen-Links — und die Datei sagt ausdrücklich, warum, statt so auszusehen, als hätte der Shop keine FAQs.
• Die Ankerlinks folgen dem Text, der in der jeweiligen Sprache tatsächlich angezeigt wird. Greift die Einstellung „Bei fehlender Übersetzung auf Standardsprache zurückgreifen", steht auf der Seite der Text der Standardsprache — und der Link zeigt dann auch dorthin. Jede Frage behält dabei in jeder Sprache ihren eigenen, eindeutigen Anker.
• Die llms.txt ist jetzt ein Wegweiser statt eines Datenbergs. Sie führt je FAQ-Gruppe einen Abschnitt und verlinkt darin jede Frage direkt an ihre Stelle auf Ihrer FAQ-Seite — ein KI-Assistent springt damit zur einzelnen Antwort, statt sich durch alles zu lesen. Zuvor stand der gesamte Bestand in dieser einen Datei; in einem Shop mittlerer Größe waren das mehrere Megabyte, an denen viele Abrufe abbrachen. Jetzt sind es einige Dutzend Kilobyte.
• Neu: /llms-full.txt mit der vollständigen Sammlung. Alle Fragen mit ihren kompletten Antworten, verlinkt aus der llms.txt, damit ein Modell sie auch findet. Antworten werden dort nicht mehr nach 500 Zeichen abgeschnitten.
• Aufzählungen und Absätze in Antworten laufen nicht mehr zu einem Wort zusammen. Aus „Zahlungsarten:PayPalKreditkarteVorkasse" wird wieder „Zahlungsarten: PayPal, Kreditkarte, Vorkasse" — das gilt für Listen, Absätze, Überschriften, Zeilenumbrüche und Tabellen gleichermaßen. Ausgerechnet in der Datei für Maschinen stand bisher an vielen Stellen Kauderwelsch.
• Der Verweis auf /faq ist entfallen: Diese Adresse gibt es im Shop nicht, der Link lief ins Leere. Verlinkt wird jetzt die Seite aus der Einstellung „FAQ-Landingpage für Suchergebnisse". Ist dort keine ausgewählt, erscheint gar kein Fragen-Link — lieber keiner als ein toter.
• Beide Dateien zeigen nur Gruppen, die im Shop auch erscheinen, und werden als Markdown ausgeliefert, wie es llmstxt.org vorsieht. Die bisherige Adresse /llms.txt antwortet unverändert weiter.
• FAQs lassen sich jetzt auch in einer Spalte platzieren. Bisher gab es die FAQ-Ausgabe nur als ganzen Baustein über die volle Breite. Neu ist ein FAQ-Element, das sich im Erlebniswelt-Editor über „Element austauschen" in jede Spalte setzen lässt — etwa in die rechte Hälfte eines Zwei-Spalten-Layouts. Welche Fragen erscheinen, richtet sich wie gewohnt nach den Tags der Seite. Die Überschriften-Ebene des Gruppennamens ist am Element einstellbar, damit sie in die Gliederung der jeweiligen Seite passt.
• Der FAQ-Baustein zeigt im Erlebniswelt-Editor jetzt, was später im Shop erscheint. Bisher stand dort nur der Titel und darunter ein leerer Kasten. Wählen Sie in der Seitenleiste unter „Demo-Entität" ein Beispielprodukt oder eine Beispielkategorie, sehen Sie die Gruppen und Fragen, die für dieses Objekt tatsächlich gelten. Ohne Auswahl erklärt ein Hinweis, wovon die Auswahl abhängt — angezeigt wird nur, was der Shop später auch ausgibt.
• FAQ-Baustein und FAQ-Element stehen im Auswahldialog jetzt unter einer eigenen Überschrift „FAQ Professional" statt unter „Text". Bestehende Erlebniswelten bleiben davon unberührt.
• Stehen mehrere FAQ-Bereiche auf einer Seite, klappen sie sich nicht mehr gegenseitig zu. Zuvor schloss das Öffnen einer Frage eine offene Frage im anderen Bereich.
• Die Auszeichnung nach schema.org steht jetzt genau einmal je Seite, unabhängig davon, ob die FAQs über den Produkt-Reiter, den Baustein oder das neue Element erscheinen.
• Neuer Editor für Antworten und Gruppenbeschreibungen. An die Stelle des bisherigen Textfelds tritt ein Editor mit Bildern, Video, Zitaten, Hinweisboxen und Schnellbefehlen über die Schrägstrich-Taste. Bestehende Inhalte werden unverändert übernommen — geprüft an einem Querschnitt echter Feldinhalte, jeder davon zeichengenau.
• Die Frage ist jetzt ein einfaches Textfeld. Eine Frage braucht keine Formatierung. Bereits gespeicherte Fragen bleiben unangetastet und werden im Shop unverändert dargestellt; wer eine davon bearbeitet, sieht die enthaltene Auszeichnung als Text.
• Beim Öffnen eines FAQ-Eintrags im Editor werden enthaltene Links nicht mehr verändert. Zuvor hätte der Editor ihnen beim Speichern rel="nofollow" und ein neues Zielfenster verpasst — also die Bewertung durch Suchmaschinen berührt, ohne dass jemand etwas bearbeitet hat.
• Die Suchergebnis-Seite gruppiert FAQ-Treffer jetzt nach ihrer Gruppe und zeigt deren Namen als Überschrift, statt ihn als Kennzeichen neben jede Frage zu setzen. Damit sieht sie aus wie der CMS-Block und der Produkt-Tab.
• „War diese Antwort hilfreich?" funktioniert auf der Suchergebnis-Seite jetzt tatsächlich — die Schaltflächen waren dort zwar sichtbar, aber ohne Wirkung.
• Auf einer Fremdsprache zeigt das Feld wieder den Text der Standardsprache als Platzhalter, damit beim Übersetzen sichtbar ist, worum es geht.
• Vier Darstellungs-Einstellungen wirken wieder: Symbolart, Symbolposition, Trennlinie und deren Farbe ließen sich zwar einstellen, hatten aber keine Auswirkung auf die Anzeige.
• Die Optionen „Gruppenname als Überschrift anzeigen", „Gruppenname fett darstellen" und „Frage fett darstellen" lassen sich jetzt tatsächlich abschalten.
• FAQs neben den Suchvorschlägen erscheinen jetzt auch in Shops mit mehreren Sprachdomains.
• Die strukturierten Daten enthalten nur noch Fragen, die auf der Seite auch sichtbar sind, und sind auf 100 Einträge begrenzt.
• Die geplante Aufräum-Aufgabe für Bewertungen älter als ein Jahr brach beim ersten Löschlauf ab. Behoben.
• Die Beschreibungstexte versprechen keine Google-Rich-Snippets mehr: Google hat die FAQ-Darstellung in den Suchergebnissen im Mai 2026 abgeschaltet. Die Auszeichnung nach schema.org bleibt unverändert erhalten und wird von Suchmaschinen und KI-Assistenten weiterhin ausgewertet.
• Neues Versionsschema: die ersten beiden Stellen benennen die Shopware-Linie, für die diese Version gedacht ist. Inhaltlich ist sie die direkte Fortsetzung von 2.4.0.

• Erste Version für Shopware 6.6. Der Funktionsumfang entspricht Version 2.4.0 der Shopware-6.7-Linie.
• Neues Versionsschema: Die ersten beiden Stellen benennen die Shopware-Linie, für die eine Version gedacht ist. Versionen 6.6.x laufen auf Shopware 6.6, Versionen 6.7.x auf Shopware 6.7.

• Sie können jetzt wählen, ob die FAQs auf der Suchergebnis-Seite über oder unter den Produkten erscheinen. Neue Einstellung unter „Suche".

Neue Funktionen

- Neue Einstellung unter „Allgemeines": „Bei fehlender Übersetzung auf Standardsprache zurückgreifen" (standardmäßig aus). Wenn aktiviert, werden noch nicht übersetzte FAQs in der Standardsprache des Shops angezeigt, statt ausgeblendet zu werden.

- Neue Spalte „Übersetzungen" in der FAQ-Liste und in der FAQ-Gruppen-Liste. Sie zeigt auf einen Blick, welche Sprachen bereits übersetzt sind (✓) und welche noch fehlen (✗).

Verbesserungen

- Die FAQ-Suche zeigt jetzt nur FAQs in der Sprache, in der man gerade surft. Eine deutsche FAQ erscheint nicht mehr, wenn man im englischen Shop sucht (außer die neue Fallback-Einstellung oben ist aktiviert).

- Die FAQ-Suche bleibt jetzt automatisch aktuell. Es muss kein separater Befehl mehr ausgeführt werden.

- Klarere Bezeichnung in den Sucheinstellungen („search suggest" statt „search dropdown"), damit die Option leichter zu finden ist.

- Beim Bearbeiten einer FAQ oder FAQ-Gruppe in einer anderen Sprache als der Standardsprache des Shops kann der Text jetzt leer gelassen werden, dann wird der Inhalt der Standardsprache verwendet. Nur in der Standardsprache muss der Text weiterhin ausgefüllt werden.

Bugfixes

- Fehler behoben, der Produkt- und andere Seiten in einer Sprache lahmlegen konnte, in der die FAQs noch nicht übersetzt waren (z. B. ein englischer Shop mit nur auf Deutsch gepflegten FAQs). Nicht übersetzte FAQs werden jetzt einfach ausgeblendet oder in der Standardsprache angezeigt, wenn die neue Fallback-Einstellung aktiviert ist.

- Die Meldungen „Question & Answer need to be filled" und „Groupname needs to be assigned" erscheinen nicht mehr, wenn eine Übersetzung in einer anderen als der Standardsprache gespeichert wird. Diese Texte sind dort nicht mehr erforderlich. 

## Neue Funktionen

- Plugin-Konfiguration „Suche": Neuer Toggle „FAQs auf der Suchergebnis-Seite anzeigen" (Standard: an) — deaktiviert die FAQ-Liste auf der `/search`-Ergebnis-Seite vollständig

- Plugin-Konfiguration „Suche": Neue Option „Ausblenden" für die Position im Such-Dropdown — deaktiviert FAQ-Vorschläge im Suggest-Dropdown vollständig

## Verbesserungen

- FAQ-Akkordeon-Anker-IDs umgestellt von Fragen-Slug auf das stabile Format `faq-{groupId}-{faqId}` — verhindert Anker-Kollisionen bei gleichlautenden Fragen in verschiedenen Gruppen und überlebt Umformulierungen der Frage. Auch in Suchergebnis-Seite und Such-Suggest-Links konsistent angepasst

- Administration: `flagUrl` im FAQ-Overview verwendet jetzt den Shopware-`asset`-Filter statt eines hartcodierten `/bundles/`-Pfads — korrekte Auflösung auch in Setups mit externem Asset-Storage (CDN/S3)

## Bugfixes

- Suchergebnis-Seite und Such-Suggest: HTML-Entities in FAQ-Fragen (z. B. `&`) wurden doppelt encodiert und als `&` angezeigt — `|striptags` wurde um `|raw` ergänzt, damit bereits encodierte Entities aus dem Rich-Text-Feld nicht erneut escaped werden

Fehlenden use-Import für FaqGroupCollection in ProductPageLoadedSubscriber ergänzt

- Neue Funktion: Dynamische /llms.txt-Route — gibt alle aktiven FAQ-Gruppen mit Fragen und Antworten als maschinenlesbaren Klartext aus, kompatibel mit dem llmstxt.org-Standard für KI-Readiness.

- Verbesserung: Anzeigeposition-Logik überarbeitet — „Produkt-Tab oder falls vorhanden nur im CMS-Block" zeigt FAQs im Produkt-Tab nur dann, wenn kein CMS-FAQ-Block auf der Seite vorhanden ist (CMS hat

Vorrang). Konfigurationslabel entsprechend angepasst.

- Bugfix: Anzeigeposition „Überall" zeigte FAQs nicht im Produkt-Tab an, wenn gleichzeitig ein CMS-FAQ-Block auf der Seite vorhanden war — Bedingung korrigiert.

- Verbesserung: Konfigurationsoption „FAQ nicht als Tab anzeigen" entfernt — die Tab-Sichtbarkeit wird über die Gruppeneinstellung „Anzeigeposition" pro FAQ-Gruppe gesteuert.

- Sicherheit: LIMIT-Werte in SQL-Abfragen des Statistik-Controllers werden jetzt explizit zu int gecastet. Whitelist-Guard in FaqHelpfulService ergänzt — Spaltenname wird vor der SQL-Verwendung validiert.

- Statistik: Meistgelesene Fragen werden jetzt immer aus `syn_faq_click_log` gelesen — behebt fehlende Einträge wenn der denormalisierte `click_count`-Cache veraltet war

- Statistik: Länderflaggen im "Klicks nach Sprache & Domain"-Widget wurden nicht angezeigt — Dateierweiterung korrigiert (`.svg` → `.png`), Mapping für `en-US` (→ `us`) und `no-NO` (→ `nb`) korrigiert

• FAQ-Sucheinstellung + verbesserte Suche mit Suchbegriff für Indexseiten
• schema.org answerCount Fehler behoben
• Refactoring des Frontends zur Steuerung von CMS/Tab/beide Ansichten
• Fehlende Snippets hinzugefügt
• FAQ/FAQ-Gruppen-Seiten aktualisieren nun den globalen Suchfilter auf FAQ/FAQ-Gruppe

• FAQ und Gruppen auf ausgewählte Verkaufskanäle beschränken auf alle Seiten

• FAQ und Gruppen auf ausgewählte Verkaufskanäle beschränken

• Problem mit FAQ-Styles beheben

• erste Veröffentlichung im Shopware-Store

• Migrations-Tabellen erstellt

• Herstellerpräfix zu CSS-Klassen und Twig-Blöcken hinzufügen
• Dateien umbenannt, um Herstellerpräfix einzuschließen
• Refactoring durchgeführt, um interne CSS-Klassen plugin-spezifisch zu machen
• Fehlenden Migrations-Ordner hinzufügen

• Fehler in der FAQ-Gruppierung behoben

• Shopware-Code-Review-Fehler behoben

• Shopware-Code-Review-Fehler behoben

Fehlerhafte Namespaces entfernt.