Das brauchst du
Ein Super-User-Konto oder eine Benutzergruppe, deren Textfilter Script-Tags zulässt. Dein Template muss eine Modulposition am Seitenende ausgeben. Lege in Accessonaut zuerst ein Projekt mit deiner tatsächlichen Website-Domain an und öffne im Projekt die Einbauseite.
Schritt für Schritt
- Stelle in deinem Benutzerprofil den Editor vorübergehend auf „Editor – Keiner“. Der Standard-Editor lässt bestimmte HTML-Tags wie Scripts nicht zu.
- Öffne System → Site Module, wähle Neu und den Modultyp „Eigenes Modul“. Füge den unveränderten Einbaucode ein und blende den Modultitel aus.
- Wähle eine Position am Seitenende. Im Standard-Template Cassiopeia steht die Position
debugdirekt vor dem schließenden body-Tag. Setze unter Menüzuweisung „Auf allen Seiten“. - Speichere das Modul und stelle deinen Editor zurück. Leere bei aktivem Seiten-Cache den Joomla-Cache und prüfe mehrere öffentliche Seiten.
So sieht die Einbindung aus
Verwende den fertigen Code aus deinem Projekt. Das Beispiel benötigt deine echte Projekt-ID und die öffentlich erreichbare Service-Adresse.
<script src="https://accessonaut.com/widget.js"
data-project-id="DEINE_PROJEKT_ID"
data-language="de" defer></script>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
Standardmäßig speichern nur Super User Script-Tags ungefiltert. Für andere Gruppen entfernt die Globale Konfiguration unter Textfilter solche Tags. Andere Templates benennen ihre Modulpositionen anders; prüfe die Position nach jedem Template-Wechsel. Ändere die Dateien von Cassiopeia nicht direkt, da Updates sie überschreiben.
Häufige Fragen zu Joomla
Was muss ich bei einer mehrsprachigen Website beachten?
Setze im Modul das Feld Sprache auf „Alle“. Sonst erscheint das Modul nur in einer Sprache. Mit data-language="auto" folgt das Widget dem lang-Attribut der Seite. Es spricht Deutsch, Englisch und Spanisch.
Warum sehe ich Änderungen nicht sofort?
Ist das Plugin „System - Page Cache“ aktiv, liefert Joomla zwischengespeicherte Seiten aus. Laut Joomla leert eine Inhaltsänderung diesen Cache nicht automatisch. Leere den Cache deshalb im Bereich Wartung des Systems-Menüs.
Was ist bei einer Content Security Policy zu tun?
Joomla bringt CSP-Optionen mit, standardmäßig ausgeschaltet. Je nach Version findest du sie im Plugin „System - HTTP Headers“ oder in den Optionen der Content Security Policy. Ergänze deine Service-Adresse in script-src und connect-src. Das Widget fügt style-Elemente ohne Nonce ein; style-src muss eingebettete Styles erlauben. Teste zuerst im Report-Only-Modus.
Wie entferne ich das Widget wieder?
Setze das Modul auf versteckt oder verschiebe es in den Papierkorb. Leere den Papierkorb, wenn du es endgültig löschen willst. Leere danach den Seiten-Cache.
Wenn etwas nicht klappt
Im Modul steht nur Text, das Script fehlt im Quelltext.
Ursache: Der Editor oder der Textfilter deiner Benutzergruppe hat das script-Tag entfernt.
Lösung: Stelle den Editor auf „Editor – Keiner“, füge den Code erneut ein und speichere als Super User. Prüfe die Textfilter in der Globalen Konfiguration.
Das Widget erscheint nur auf einigen Seiten.
Ursache: Die Menüzuweisung des Moduls ist eingeschränkt oder das Feld Sprache steht auf einer einzelnen Sprache.
Lösung: Setze die Menüzuweisung auf „Auf allen Seiten“ und die Sprache auf „Alle“.
Nach einem Template-Wechsel ist das Widget weg.
Ursache: Das neue Template kennt die gewählte Modulposition nicht.
Lösung: Weise dem Modul eine Position am Seitenende im neuen Template zu.
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.