¶ Barrierefreiheit-Widget
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
¶ Überblick
Ein schwebendes Barrierefreiheits-Widget für Sylius-2-Shops, gebaut mit Blick auf das deutsche Barrierefreiheitsstärkungsgesetz (BFSG) und WCAG 2.1 AA. Besucher stellen Schriftgröße, Kontrast, Farbfilter für Farbsehschwächen, einen Blaulichtfilter und reduzierte Bewegung selbst ein, dazu kommt ein Skip-Link für Tastaturnutzer.
Cookie-frei: Die Einstellungen eines Besuchers leben ausschließlich im
localStoragedes Browsers. Es wird kein Cookie gesetzt, das Widget braucht deshalb keinen Eintrag in einem Consent-Tool.
Dieses Plugin allein macht einen Shop nicht BFSG-konform. Es hilft in einzelnen Bereichen (Skip-Link für 2.4.1, Kontrast/Schriftgröße/reduzierte Bewegung für 1.4.3, 1.4.4, 2.3.3), kann aber Kontrast, Markup oder Inhalte eines Themes nicht selbst reparieren. Ein echtes Audit des gesamten Shops bleibt notwendig.
¶ Dokumentation
| Seite | Inhalt |
|---|---|
| Installation und Betrieb | Installation, Update, Deinstallation |
| Konfiguration | Einstellungen pro Channel, Admin-Grid, Praxis-Beispiele |
| Storefront-Integration | Twig Hooks, Skip-Link-Ziel, Theming, Verhalten im Detail, Theme-Kompatibilität |
| Shop API / Headless | Endpunkt, Anfrage/Antwort, Fehlerformat |
| Erweiterbarkeit | Öffentliche Interfaces, Template-Override, interne Klassen |
| Fehlerbehebung und FAQ | Typische Probleme, bekannte Einschränkungen, häufige Fragen |
| Technische Details | Ablauf, Plugin-Struktur, Entity |
¶ Features
| Feature | Beschreibung |
|---|---|
| Fünf Werkzeuge | Schriftgröße (klein/normal/groß), Kontrast (normal/hoch/invertiert), Farbfilter für Farbsehschwächen (Protanopie, Deuteranopie, Tritanopie), Blaulichtfilter, reduzierte Bewegung |
| Skip-Link | Tastatur-Link "Zum Inhalt springen" ganz oben auf der Seite |
| Cookie-frei | Einstellungen leben nur im localStorage, kein Cookie, kein Consent-Eintrag nötig |
| Pro Channel | Widget an/aus, Position und angebotene Werkzeuge separat je Channel |
| Dual-Mode | Twig-Storefront rendert das Widget, dieselben Channel-Einstellungen sind über die Shop API lesbar |
| Kein Build-Schritt | Reines CSS/JavaScript, installiert mit assets:install |
¶ Anforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| PHP | ^8.3 | |
| Sylius | ^2.2 | getestet auf 2.2 und 2.3 |
| Symfony | ^7.4 | |
| Datenbank | MySQL 8 oder MariaDB | Die Migration ist in MySQL-Syntax geschrieben und bricht auf anderen Plattformen bewusst ab; PostgreSQL wird nicht unterstützt |
¶ Lizenz
Kommerzielle Lizenz: Eine Lizenz gilt für eine Sylius-Installation (alle Channels sowie deren Entwicklungs- und Staging-Umgebungen). Eine Weitergabe ist nicht erlaubt, Updates sind 12 Monate ab Kauf enthalten. Die Versionen 1.0.0 und 1.1.0 wurden unter der MIT-Lizenz veröffentlicht, diese Einräumung bleibt für diese Versionen gültig.
¶ Support
Bei Fragen zur Lizenz, technischen Fragen oder Fehlern erreichst du mich unter support@markus-michalski.net.