Barrierefreiheits-Widget in WooCommerce einbinden.

Eigene Lesehilfen gezielt auf WooCommerce-Shopseiten einbinden. Die Lesehilfen ergänzen deine Arbeit an einer zugänglichen Website.

Anleitung geprüft am

Das brauchst du

WordPress ab 7.0, aktives WooCommerce ab 11.2.2, PHP ab 7.4 (empfohlen 8.3) und Administratorrechte. Das normale WordPress-Plugin ist optional. Lege in Accessonaut zuerst ein Projekt mit deiner tatsächlichen Website-Domain an und öffne im Projekt die Einbauseite.

Schritt für Schritt

  1. Erstelle eine Sicherung und richte eine Testkopie deines Shops ein. Prüfe WordPress, PHP und WooCommerce auf die benötigten Versionen.
  2. Lade die ZIP-Datei auf der WooCommerce-Downloadseite herunter und installiere sie über Plugins → Plugin hinzufügen → Plugin hochladen. Aktiviere Accessonaut for WooCommerce.
  3. Öffne WooCommerce → Accessonaut. Übertrage die HTTPS-Service-Adresse und die öffentliche Projekt-ID aus deinem Accessonaut-Projekt.
  4. Wähle das zentrale Projektdesign oder lokale Einstellungen. Fünf Vorlagen und eine ausdrücklich geladene Vorschau helfen beim Anpassen.
  5. Prüfe die Bereichsauswahl: Shopübersicht, Produkte sowie Produktkategorien und Produktschlagwörter sind vorausgewählt. Warenkorb, Kasse und Kundenkonto sind zunächst abgewählt und werden nur durch deine gesonderte Freigabe eingebunden.
  6. Lies die Hinweise zum externen Dienst und schalte das Widget ausdrücklich ein. Speichere, leere Caches und prüfe die gewählten Seiten einschließlich mobiler Ansichten und Tastaturbedienung.

Das WooCommerce-Plugin

Das Plugin setzt den Code für dich ein. Es ist als ZIP verfügbar. Seine Aktivierung allein startet keine Verbindung: Du schaltest das Widget erst nach der Konfiguration ausdrücklich ein. Das WooCommerce-Plugin funktioniert ohne den normalen WordPress-Connector.

Plugin und Installationshinweise

Das Design an deine Website anpassen

Öffne im Accessonaut-Projekt „Widget & Browser-Assistent“. Fünf Vorlagen und eine Live-Vorschau helfen dir beim Gestalten: Farben, Schriften, Menübreite, Ecken, Schatten, Symbol oder beschrifteter Öffner sowie eigene Texte. Position und Randabstände lassen sich für Desktop und Smartphone abstimmen. Nach dem Speichern übernimmt dein vorhandener Einbaucode das Projektdesign automatisch; die öffentliche Konfiguration wird bis zu einer Minute zwischengespeichert.

Im WooCommerce-Plugin kannst du stattdessen lokale Einstellungen wählen. Diese haben Vorrang vor dem Projektdesign. Die Gestaltung ist in allen Tarifen verfügbar. Im Free-Tarif bleibt der Accessonaut-Hinweis sichtbar. Persönliche Leseeinstellungen deiner Besuchenden haben Vorrang vor Designvorgaben.

Darauf achten

Bestellbestätigungen und Seiten zum Bezahlen bereits angelegter Bestellungen bleiben dauerhaft ausgeschlossen. Bei gleichzeitiger Nutzung übernimmt der WordPress-Connector ab Version 1.2.0 die übrigen Seiten; WooCommerce-Bereiche werden vom WooCommerce-Plugin gesteuert. Zusätzliche Scripts aus Theme oder Tag Manager musst du entfernen. Die Einbindung verändert keine Bestell-, Zahlungs- oder Store-API-Logik.

Einbau prüfen

  • Öffne eine ausdrücklich aktivierte Shopseite in einem privaten Fenster. Das Widget wird genau einmal angezeigt.
  • Erreiche den Button mit der Tastatur. Öffne das Panel, ändere die Textgröße und schließe es wieder.
  • Prüfe Startseite, Unterseite, Formular und mobile Ansicht. Das Widget darf keine wichtigen Bedienelemente verdecken.
  • Prüfe im Netzwerk-Tab, dass widget.js und die Projektkonfiguration von deiner Service-Adresse geladen werden. Bei Fehlern kontrolliere Domain, Projekt-ID und CSP.
  • Bei Free-Projekten bleibt der sichtbare Accessonaut-Hinweis Bestandteil des Widgets. Berechtigungen kommen aus deinem Projekt.

Warenkorb, Kasse und Konto gesondert testen

  • Prüfe Produktvarianten, Mengenwahl, Mini-Warenkorb und Dialoge mit der Tastatur. Kontrolliere Fokus, Schließen und die Rückkehr zum auslösenden Element.
  • Teste deinen klassischen oder blockbasierten Warenkorb und Checkout mit gefülltem Test-Warenkorb, Formularfehlern, Versand- und Zahlungswahl. Wenn du beide Varianten verwendest, prüfe beide.
  • Warenkorb, Kasse und Kundenkonto bleiben ohne gesonderte Freigabe ohne Woo-Widget. Bestellbestätigungen und Seiten zum Bezahlen bereits angelegter Bestellungen bleiben immer ausgeschlossen.
  • Prüfe eingebettete Zahlungsfelder separat und verwende Testzahlungen im Testshop. Das Plugin verändert keine Zahlungs-, Bestell- oder Store-API-Abläufe.
  • Wenn beide Accessonaut-Plugins aktiv sind, verwende den normalen Connector ab 1.2.0. WooCommerce-Bereiche folgen ausschließlich den Einstellungen des WooCommerce-Plugins; die übrigen Seiten dem normalen Connector.

Datenschutz und Grenzen

Beim Laden ruft der Besucherbrowser das Script und die Projektkonfiguration vom Accessonaut-Dienst ab. Dabei fallen IP-Adresse, Browser-Anfragedaten und Website-Hostname an. Darstellungswünsche werden lokal im Browser gespeichert. Berücksichtige die Einbindung in deinen Datenschutzhinweisen und prüfe deine konkrete Konfiguration.

Der WooCommerce-Modus verwendet für die Projektkonfiguration nur den Website-Ursprung aus Protokoll, Hostname und gegebenenfalls Port. Vollständige Seitenadressen und Parameter werden dafür nicht gesendet. Die Widget-Anfragen erfolgen ohne Referrer. Alt-Text-Zuordnungen und der private Browser-Assistent werden in diesem Modus nicht geladen.

Die Lesehilfen erzeugen keine Konformitätsgarantie. Prüfe Barrieren im Quellcode und vollständige Nutzerabläufe zusätzlich automatisch und manuell.

Offizielle Plattformdokumentation

WooCommerce: Shopbereiche und Endpunkte unterscheiden

Praxiswissen für deine nächsten Schritte

Alle Artikel im Wissensbereich