Das brauchst du
WordPress ab 6.3, PHP ab 7.4 und Administratorrechte zum Installieren von Plugins. Lege in Accessonaut zuerst ein Projekt mit deiner tatsächlichen Website-Domain an und öffne im Projekt die Einbauseite.
Schritt für Schritt
- Öffne in WordPress Plugins → Plugin hinzufügen, suche nach „Accessonaut“ und klicke beim Plugin von Accessonaut auf „Jetzt installieren“. Es kommt direkt aus dem WordPress-Pluginverzeichnis, Updates erhältst du automatisch. Alternativ lädst du die ZIP-Datei auf der WordPress-Seite herunter und installierst sie unter Plugins → Plugin hinzufügen → Plugin hochladen.
- Aktiviere das Plugin und öffne Einstellungen → Accessonaut.
- Übertrage die HTTPS-Service-Adresse und die öffentliche Projekt-ID aus dem Einbaucode deines Accessonaut-Projekts. Wähle das zentrale Projektdesign oder gestalte Farben, Schrift, Formen, Texte und Abstände lokal. Die Vorschau lädst du bei Bedarf ausdrücklich.
- Lies die Hinweise zum externen Dienst und aktiviere die Verbindung. Speichere die Einstellungen und leere WordPress- und CDN-Caches.
Das WordPress-Plugin
Das Plugin setzt den Code für dich ein. Du installierst es direkt aus dem WordPress-Pluginverzeichnis, alternativ als ZIP. Seine Aktivierung allein startet keine Verbindung: Du schaltest das Widget erst nach der Konfiguration ausdrücklich ein.
Das Design an deine Website anpassen
Öffne im Accessonaut-Projekt „Lesehilfen-Widget“. 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 WordPress-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
Ein zusätzlicher Einbau im Theme oder Tag Manager erzeugt doppelte Scripts. Nutze eine Einbauart. Das Theme muss wp_footer() ausgeben. Das Plugin verändert keine Theme- oder Core-Dateien.
Häufige Fragen zu WordPress
Was passiert mit Caching-Plugins wie WP Rocket?
Das Plugin gibt das Script mit defer im Footer aus. Die WP-Rocket-Option „Delay JavaScript execution“ lädt Scripts erst nach der ersten Interaktion. Der Button erscheint dann verzögert. Soll er sofort sichtbar sein, trage widget.js unter „Excluded JavaScript Files“ ein. Leere danach den Cache über „Clear and preload cache“.
Funktioniert das Plugin in einer Multisite?
Ja. Du kannst es im Netzwerk aktivieren. Die Einstellungen speichert das Plugin aber pro Website. Ohne eigene Konfiguration bleibt das Widget auf einer Website aus. Trage deshalb in jeder Website Service-Adresse und Projekt-ID ein. Hat eine Website eine eigene Domain, lege dafür ein eigenes Accessonaut-Projekt an.
Wie gehe ich mit meinem Cookie-Banner um?
Das Widget setzt keine Cookies. Leseeinstellungen speichert es im lokalen Speicher des Browsers. Beim Laden ruft der Browser Script und Projektkonfiguration vom Dienst ab. Ob du das Script bis zur Einwilligung blockierst, entscheidest du nach deiner Datenschutzprüfung. Viele Consent-Plugins erkennen Scripts an der Adresse oder ID: Das Plugin nutzt die ID accessonaut-widget-js. Bedenke: Blockierst du es, steht die Lesehilfe erst nach der Einwilligung bereit.
Funktioniert das mit Block-Themes und dem Website-Editor?
Ja. Auch Block-Themes rufen über das Seitengerüst von WordPress wp_footer() auf. Dort gibt das Plugin das Script aus. Im Website-Editor und im übrigen Admin-Bereich lädt das Widget nicht. Prüfe das Ergebnis deshalb immer auf der öffentlichen Website.
Wie entferne ich das Widget wieder?
Deaktiviere das Plugin unter Plugins. Danach gibt WordPress kein Script mehr aus; deine Einstellungen bleiben erhalten. Löschst du das Plugin anschließend, entfernt es auch seine Einstellungen, in einer Multisite auf allen Websites des Netzwerks. Leere danach Seiten- und CDN-Caches.
Wenn etwas nicht klappt
Das Widget fehlt, obwohl die Verbindung aktiv ist.
Ursache: Ein Seiten-Cache liefert noch die alte Seite aus, oder das Theme gibt wp_footer() nicht aus.
Lösung: Leere Plugin-, Server- und CDN-Caches. Suche dann im Quelltext der öffentlichen Seite nach accessonaut-widget-js. Fehlt der Eintrag, prüfe das Footer-Template deines Themes.
Das Widget zeigt das Standarddesign und den Accessonaut-Hinweis, obwohl du ein Design gespeichert hast.
Ursache: Die Website läuft unter einer anderen Domain als im Projekt hinterlegt, etwa auf einer Staging-Subdomain. Dort lädt das Widget deine Projektkonfiguration nicht.
Lösung: Vergleiche die Domain im Projekt mit der Adresse im Browser. Das Präfix www spielt keine Rolle, eine Subdomain zählt aber als eigene Domain.
Ein älterer Einbau aus Theme oder Tag Manager wirkt weiter.
Ursache: Das Widget startet pro Seite nur einmal, und zwar mit dem Script, das zuerst ausgeführt wird. Ein zweites Script lädt trotzdem unnötig mit.
Lösung: Entferne den alten Code aus Theme-Dateien, Snippet-Plugins und dem Tag Manager. Nutze nur das Plugin.
Einbau prüfen
- Öffne die öffentliche Website 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.
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.
Die Lesehilfen erzeugen keine Konformitätsgarantie. Prüfe Barrieren im Quellcode und vollständige Nutzerabläufe zusätzlich automatisch und manuell.