Neue Funktionen
- Neu: KI-Assistent zum Erstellen von FAQ-Antworten – „Antwort mit KI generieren" und „Antwort verbessern" direkt in der Eintrags-Maske. Vorschläge erscheinen als Live-Vorschau und werden erst nach Bestätigung („Übernehmen") in die Antwort übernommen.
- Unterstützt OpenAI und Anthropic mit eigenem API-Schlüssel; Tonalität, Modell und Token-Limit konfigurierbar.
- Optionales Live-Streaming der Antwort (gleichmäßiger Schreib-Effekt).
- Neue Einstellungskarte „FAQ Manager – KI-Assistent" inklusive Datenschutz-Hinweis.
Neue Funktionen
- Neu: Bewertungs-Hinweis im Statistik-Dashboard — nach aktiver Nutzung (ab 5 FAQ-Einträgen oder 50 Aufrufen) erscheint ein dezenter, schließbarer Hinweis mit Link zur Bewertung im Shopware Store.
Verbessert
- Statistik-Dashboard: Inhalt in einem zentrierten Container vereinheitlicht — KPI-Kacheln, Top-Listen und die untere Reihe haben jetzt dieselbe Breite.
- Statistik-Dashboard: Die Kategorien-Liste zeigt nun die Anzahl der FAQ-Einträge je Kategorie und ist danach sortiert.
Neue Funktionen
- Neu: Pro-Element-Einstellungen für die CMS-Elemente „FAQ Manager – Einträge" und „FAQ Manager – Kategorien". Erste Frage aufgeklappt, Autor anzeigen, Datum anzeigen und Datumsformat lassen sich jetzt direkt am jeweiligen Element konfigurieren – unabhängig von der globalen Plugin-Konfiguration.
- Autor und Datum werden in den CMS-Elementen nebeneinander dargestellt; der Trenner „/" erscheint nur, wenn beide aktiviert sind.
Behoben
- Bootstrap-5-Kompatibilität: data-parent durch data-bs-parent in den CMS-Element-Templates ersetzt, damit das Akkordeon korrekt zusammenklappt.
Neue Funktionen
- Neu: Store-API-Detailendpunkte für einzelne FAQ-Entitäten:
- GET /store-api/faq/page/{pageId} — gibt eine einzelne FAQ-Seite mit Kategorie-Verknüpfungen zurück
- GET /store-api/faq/category/{categoryId} — gibt eine einzelne FAQ-Kategorie mit Items und Medien zurück
- GET /store-api/faq/item/{itemId} — gibt ein einzelnes aktives FAQ-Item mit Kategorien und Medien zurück
- Routen geben eine 404-Antwort zurück, wenn die angeforderte Entität nicht existiert
- Behoben: Kategorie-Templates 2 und 3 nutzen jetzt korrekt faqCategoryItems statt faqCategory.list — FAQ-Einträge wurden bei Template 2 und 3 nicht angezeigt
- Behoben: ManyToOneAssociationField-Name in FaqListMediaDefinition von faq_manager_list auf faqManagerList korrigiert, um dem Entity-Property-Namen zu entsprechen (Store-PHPStan: shopware.bestPractise.dal.propertyMissing)
- Behoben: TranslationCollection in Entity-Klassen durch die korrekten konkreten Collection-Klassen ersetzt (FaqCategoriesTranslationCollection, FaqListTranslationCollection, FaqPagesTranslationCollection)
Technische Verbesserungen (Store-PHPStan-Compliance)
- Behoben: SystemConfigService::get() übergibt jetzt überall die salesChannelId für korrekte SalesChannel-spezifische Konfiguration
- Behoben: Context::createDefaultContext() durch Context::createCLIContext() in Command und Twig-Extension ersetzt
- Behoben: EqualsFilter('id', ...) durch new Criteria([$id]) bzw. Criteria::setIds() ersetzt (DAL Best Practice)
- Behoben: Alle Entity-Klassen um fehlende Properties aus den Definitions ergänzt (title, question, answer, author, metaTitle, metaKeywords, metaDescription, translations, parent, u.a.)
- Behoben: Setter-Typen in Entity-Klassen korrigiert (z.B. string → int/bool bei setPosition, setActive)
- Behoben: Pagination-Template (storefront/component/pagination.html.twig) überschrieb die Shopware-Standard-Pagination auf allen Kategorieseiten — in den FAQ-eigenen Pfad (page/faq/component/pagination.html.twig) ausgelagert
- Behoben: PHPStan Store-Check-Fehler durch Entfernen der direkten AbstractReverseProxyGateway-Typisierung (optionale Storefront-Abhängigkeit)
- Behoben: PHPStan-Warnung für optionale Storefront-Abhängigkeit (AbstractReverseProxyGateway) unterdrückt
Neue Funktionen
- Neu: Statistik-Dashboard in der Administration — KPI-Karten (Seiten, Kategorien, Items, Views) sowie Top-10-Listen der meistgelesenen Fragen und Seiten
- Neu: Paginierung für FAQ-Kategorieseiten — konfigurierbare Einträge pro Seite in den Plugin-Einstellungen (0 = alle anzeigen)
- Neu: „Ähnliche Fragen"-Bereich auf FAQ-Item-Detailseiten
- Neu: Import/Export-Profile für FAQ-Items, -Seiten und -Kategorien (automatisch beim Installieren angelegt)
- Neu: HTTP-Cache-Invalidierung — automatische Entwertung des Varnish/Shopware-Reverse-Proxy-Caches bei Änderungen an FAQ-Inhalten
Bugfixes
- Behoben: PHP 8.2 TypeError beim Laden von FAQ-Daten in der Administration — nicht typisierte $updatedAt-Eigenschaft aus Entity-Klassen entfernt
- Behoben: Statistik-Dashboard zeigte leere weiße Seite — Administration-Komponenten auf Meteor Component Library (mt-card, mt-loader, mt-button, mt-icon) migriert
- Behoben: Suchvorschläge zeigten falsche Trefferanzahl (searchResultsCount statt searchResults.total)
- Behoben: Twig-Extension lädt FAQ-Kategorien und Items jetzt im korrekten SalesChannel-Kontext statt im generischen Default-Kontext
Technische Verbesserungen
- updated_at-Spalte zu allen FAQ-Entitäten (Seiten, Kategorien, Items) hinzugefügt
- Entity-Definition: ParentFkField durch FkField für parent_id in FAQ-Items ersetzt
- Import/Export-Profile werden beim Deinstallieren korrekt entfernt
- Twig-Extension: Konstruktor-Promotion und RequestStack-Injektion für korrekten Kontext
- Admin-Build auf Vite-Pipeline umgestellt (./bin/build-administration.sh) für korrekte Asset-Generierung in Shopware 6.7
- Behoben: Veraltete MissingRequestParameterException durch RoutingException::missingRequestParameter() ersetzt (Shopware 6.7 kompatibel)
Bugfixes
- Behoben: Call to a member function getActive() on null im FaqController wenn ein FAQ-Item nicht gefunden wird (z.B. ungültige URL oder gelöschter Eintrag)
- Behoben: TypeError in FaqPageNotFoundException wenn der page_id-Query-Parameter fehlt — gibt nun einen sauberen HTTP 400-Fehler zurück
Technische Verbesserungen
- Veraltete shopware.snippet.file-Service-Definitionen aus services.xml entfernt, die unter Symfony 7.4 Deprecation-Warnings verursachten — Storefront-Snippets werden automatisch aus Resources/snippet/ geladen
Fixed: Rich-Text-Editor in der Administration zeigt bei neuen Seiten/Einträgen keine „custom code“-Warnung mehr für leere Inhalte
- Initialisiert Seiten-Beschreibungen (`pages.description`) mit gültigem HTML p-tag
- Initialisiert FAQ-Antworten (`item.answer`) beim Erstellen und Bearbeiten ebenfalls mit p-tag
Fixed: Bestehende FAQ‑Texte wurden für den neuen Editor bereinigt
- Migration normalisiert br-tag in Beschreibungen und Antworten
- Reduziert unnötige „Code changes required“-Dialoge beim Bearbeiten bestehender Inhalte
Fehlerbehebungen
KRITISCH: Behandlung von Many-to-Many-Beziehungen in der Administrationsoberfläche korrigiert.
Veraltete sw-entity-many-to-many-select-Komponente auf sw-entity-multi-select-Komponente migriert.
Doppelte Einträge beim Zuweisen von Kategorien, Seiten oder Elementen in der Administrationsoberfläche behoben.
404-Fehler beim Entfernen von Many-to-Many-Assoziationen behoben.
Verbesserung aller FAQ-Admin-Detailseiten (Kategorien, Seiten, Elemente) mit modernen Entitätsauswahlkomponenten.
Technische Verbesserungen
Aktualisiert: Alle veralteten sw-entity-many-to-many-select-Komponenten wurden durch sw-entity-multi-select ersetzt.
Aktualisierung von faq-manager-categories-detail für die Zuweisung von Seiten und Listenelementen.
Aktualisierung von faq-manager-pages-detail für die Zuweisung von Kategorien.
Aktualisiert: faq-manager-items-detail für die Zuweisung von Kategorien mit benutzerdefinierten Label-Slots
Aktualisiert: Korrekte Ereignisbehandlung mit @update:entity-collection für reaktive Aktualisierungen hinzugefügt
Aktualisiert: Attribut entity-name zu allen Entitätsauswahlkomponenten hinzugefügt, um die Typsicherheit zu verbessern
Veraltete Eigenschaft :local-mode entfernt (wird automatisch von der neuen Komponente verarbeitet)
Aktualisiert: Admin-Komponenten modernisiert, um sie an die Best Practices von Shopware 6.7+ anzupassen
Fehlerbehebungen
- KRITISCH: PHP-Fehler beim Zugriff auf gelöschte FAQ-Kategorien oder -Seiten über alte SEO-URLs behoben
- Robuste Null-Prüfungen in der Methode `FaqController::page()` hinzugefügt, um Fehler vom Typ „Aufruf einer Member-Funktion getActive() auf Null“ zu verhindern
- Umfassende Validierung in der Methode `FaqController::category()` hinzugefügt, um Fehler vom Typ „Aufruf einer Member-Funktion getPages() auf Null“ zu verhindern
- Verwaiste SEO-URLs geben nun korrekt 404-Seiten zurück, anstatt weiße Fehlerbildschirme anzuzeigen. - NEU: Implementierung benutzerdefinierter Ausnahmeklassen (`FaqPageNotFoundException`, `FaqCategoryNotFoundException`) für eine bessere Fehlerbehandlung.
- NEU: Hinzufügen von `FaqSeoUrlCleanupService` zum automatischen Entfernen verwaisten SEO-URLs für gelöschte Entitäten.
- NEU: Konsolenbefehl `faq:cleanup-seo-urls` zum manuellen Bereinigen verwaisten SEO-URLs hinzugefügt
- Verbesserte Fehlerbehandlung in allen Controller-Methoden, um ähnliche Probleme zu vermeiden
- Verbesserte Benutzererfahrung durch Anzeige korrekter 404-Seiten anstelle von kritischen Fehlern
Technische Verbesserungen
- Korrekte Ausnahmebehandlung mit HTTP 404-Antworten für fehlende Entitäten hinzugefügt
- Automatischer Mechanismus zum Bereinigen von SEO-URLs implementiert
- Verbesserte Robustheit des Controllers durch umfassende Null-Prüfung
- Neue Service-Ebene für die Verwaltung von SEO-URLs hinzugefügt
Codequalität und Compliance
- Aktualisiert: Codeformatierung mit „shopware-cli extension format“ für PSR-12-Compliance korrigiert
- Aktualisiert: Shopware-Codierungsstandards mit „shopware-cli extension fix“ angewendet
- Aktualisiert: Alle Validierungsprobleme für die Shopware Store-Konformität behoben
- Aktualisiert: Beschreibungen der Plugin-Metadaten korrigiert, um die Längenanforderungen (150–185 Zeichen) zu erfüllen
- Aktualisiert: Fehlende Übersetzungsschlüssel für vollständige Internationalisierungsunterstützung hinzugefügt
- Aktualisiert: Sichergestellt, dass alle Snippet-Dateien eine konsistente Schlüsselabdeckung über alle Sprachen hinweg aufweisen
Neue Funktion: FAQ-Seiten können nun für bestimmte Verkaufskanäle konfiguriert werden.
Verwendung:
- Inhalte → FAQ Manager → Seiten
- FAQ-Seite bearbeiten/erstellen
- Feld "Verkaufskanäle" (rechte Spalte) → Kanäle auswählen
- Speichern
⚠️ WICHTIG: Ohne Auswahl wird die FAQ-Seite NICHT angezeigt!
Anleitung: https://docs.fulltime-ecommerce.de/plugins-und-erweiterungen/shopware-6/faq-manager/sales-channel-auswahl-fur-faq-seiten-version-2.2.0+
- Code-Qualitätsverbesserungen und PSR-4 Konformität
- Performance-Optimierungen für JavaScript und SCSS
- Verbesserte API-Implementierungen und Fehlerbehandlung
- Optimierte Administration UI-Komponenten
- Verbesserte Store-Kompatibilität und Plugin-Beschreibungen
- Fehlende Übersetzungsschlüssel behoben
- FAQ-Sichtbarkeits-Datenbankstruktur behoben
- Doppelte Einträge in Visibility-Tabelle behoben
- NEUE FUNKTION: Sales Channel Auswahl
- FAQ-Seiten für spezifische Verkaufskanäle konfigurierbar
- Multi-Shop-Unterstützung
- View-Tracking-System für FAQ-Einträge
- Shopware 6.7 Kompatibilität
- Verbesserte Dokumentation
Dieses Update des FAQ Managers für Shopware 6.7 bringt erhebliche Verbesserungen in Bezug auf Kompatibilität, Benutzeroberfläche und Code-Wartbarkeit mit sich.
Wichtige Änderungen:
- Shopware 6.7 Kompatibilität: Vollständige Anpassungen, um die Kompatibilität mit Shopware 6.7 sicherzustellen.
- UI-Verbesserungen:
- Ersetzung von sw-* Komponenten durch mt-* Äquivalente für eine modernere und konsistentere Oberfläche (z.B. bei SEO-Formularen und Detailseiten).
- Einführung von sw-tabs für eine bessere Organisation der Detailbereiche (Allgemein, Einstellungen, SEO).
- Optimierung der Suchleiste und Listeninteraktionen.
- Aktualisierte Icons: Modernisierte Modul-Icons von default-object-graduate-cap zu regular-graduation-cap.
- Code-Bereinigung: Entfernung von ungenutztem Code zur Verbesserung der Wartbarkeit.
Antwortdaten für FAQ-Kategorien (store-api) optimiert
Kategorien-Repository hinzugefügt
Store-api Endpunkt für FAQ Kategorien hinzugefügt
- CMS-Element für FAQ-Kategorien und Einträge angepasst
- store-api Endpunkt hinzugefügt
- Kategorieauswahl mit Seitenzuordnung erweitert
- Macht die Auswahl von Kategorien/Artikeln im CMS Element optional
Entfernt unbenutzte Spracheigenschaft
Indexer für Kategorien, Artikel und Seiten korrigiert
- Neuer Twig Blöcke hinzugefügt
- Anfangszustand für Akkordeon hinzugefügt
- Ein neues Einkaufserlebnis-Element für FAQ-Kategorien wurde hinzugefügt
Warnungen der statischen Code-Analyse behoben
Feld „association_fields“ entfernt
- Storefront JS wurde angepasst
Anpassungen für Shopware 6.6
- Problem mit dem Einblenden von Elementen auf der Suchseite behoben
- Indizierungseinstellungen hinzugefügt (https://docs.fulltime-ecommerce.de/plugins-und-erweiterungen/shopware-6/faq-manager/indexierung-der-faq-seite)
- Option zum Einfügen von FAQs in die Sitemap hinzugefügt (https://docs.fulltime-ecommerce.de/plugins-und-erweiterungen/shopware-6/faq-manager/faqs-in-sitemap-integrieren)
Titeltyp zu Seite, Kategorie und Eintrag hinzufügen
App aktualisiert und refaktoriert mit Rector für Shopware 6.5 (https://github.com/FriendsOfShopware/shopware-rector/)
- Sortierung von Kategorien und Einträgen korrigiert
- Such-URL-Parameter korrigieren
- Einstellung des Suchformulars korrigiert
- In Vorlage 1 und Vorlage 2 wurde die Überschrift von h2 auf h1 angepasst
Integration in Erlebniswelten
https://docs.fulltime-ecommerce.de/plugins-und-erweiterungen/shopware-6/faq-manager/fragen-in-eine-erlebniswelt-einbinden
- FUTI-FAQ-SW6-25: Korrekturen für Verkaufskanäle
- FUTI-FAQ-SW6-19: Maximale Zeichenanzahl für Meta-Title/Description und SEO-Keywords definiert
- FUTI-FAQ-SW6-20: Bilder in eigenen Ordner laden
- FUTI-FAQ-SW6-21: Sortierung nach Kategorien innerhalb der Einträge korrigiert
- FUTI-FAQ-SW6-22: Sortierung nach Seiten innerhalb der Kategorien korrigiert
- FUTI-FAQ-SW6-23: Übersetzung innerhalb von Einträgen hinzufügen (Kategorie)
- FUTI-FAQ-SW6-24: Übersetzung innerhalb von Kategorien hinzufügen (Seite)
- FUTI-FAQ-SW6-17: Metadaten korrigiert
- FUTI-FAQ-SW6-18: Such-URL geändert
- FUTI-FAQ-SW6-16: Zuordnungsfehler behoben
- FUTI-FAQ-SW6-15: Mobil Fehler mit langem Text in Fragen behoben
- FUTI-FAQ-SW6-14: Kompatibilität zu Shopware 6.4.7.x hergestellt
- FUTI-FAQ-SW6-13: Zugriff auf globales Shopware-Objekt (SW-6.4.5.0)
- FUTI-FAQ-SW6-10: Korrektur der Installationsroutine (Migration)
- FUTI-FAQ-SW6-11: Integrierte Suchfunktion
- FUTI-FAQ-SW6-12: Zweigblöcke wurden hinzugefügt
- FUTI-FAQ-SW6-6: Kompatibilität mit Shopware 6.4 hergestellt
- FUTI-FAQ-SW6-7: Plugin-Einstellung: Autor anzeigen
- FUTI-FAQ-SW6-8: Plugin-Einstellung: Datumsformate
- FUTI-FAQ-SW6-9: Plugin-Einstellung: Direkte Links zu Kategorien und Fragen anzeigen
- FUTI-FAQ-SW6-3: HTML-Interpretation für Seiten-Beschreibung
- FUTI-FAQ-SW6-4: FAQ Seiten Einstellung: Erste Frage aufgeklappt
- FUTI-FAQ-SW6-5: Kompatibilität mit Shopware 6.3 hergestellt
- Kompatibilität mit Shopware 6.2 hergestellt
- Veraltete mapApiErrors, verwendet wird nun mapPropertyErrors
- https://github.com/shopware/platform/blob/v6.2.0/UPGRADE-6.2.md#seo-urls
- FUTI-FAQ-SW6-1: Hinzufügen von Bildern zu den FAQ-Einträgen
- FUTI-FAQ-SW6-2: Kompatibilität mit Shopware 6.3 hergestellt
- Spaltenstandard für Aktiv in Liste hinzufügen
- FAQ-Seiten, Kategorien und Fragen aus httpCache entfernt
Erste Version für Shopware 6
Shopware