Wave Access
Das Handbuch zum Barrierefreiheits-Plugin: von der Installation über die Widget-Anpassung bis zu Prüfberichten, Erklärung und KI-Werkzeugen. Alle Einstellungen findest du in WordPress unter Einstellungen → Barrierefreiheit.
Installation
- Plugin-ZIP im WordPress-Backend unter Plugins → Installieren → Plugin hochladen auswählen und installieren — oder den Ordner
wave-accessnach/wp-content/plugins/laden. - Plugin in der Plugin-Liste aktivieren. Dort findest du auch direkt den Link Einstellungen.
- Fertig — das Eingabehilfen-Widget erscheint sofort unten rechts auf deiner Website. Alle Basis-Fixes (Skip-Links, Fokus-Indikator, ARIA-Landmarks) sind ab Werk aktiv.
Lizenz aktivieren Pro
Deinen Lizenzschlüssel findest du in der Bestell-E-Mail und im Kundenbereich.
- Öffne Einstellungen → Barrierefreiheit → Lizenz.
- Schlüssel eintragen (Format
WAVE-XXXX-XXXX-XXXX) und auf Aktivieren klicken. - Der Tarif (Pro, Pro AI oder Agency) wird angezeigt und alle enthaltenen Funktionen schalten sich frei — ein Schlüssel für alles, auch die KI-Funktionen.
Agency-Lizenzen lassen sich auf bis zu 25 Websites aktivieren; die Übersicht der belegten Sites zeigt der Lizenz-Tab und der Kundenbereich. Mit „Lizenz von dieser Website lösen" gibst du einen Platz wieder frei — praktisch beim Umzug von Kundenprojekten.
Widget: Funktionen für Besucher
Das Widget bietet Besuchern zehn Anzeige-Modi und vier Regler — alle Einstellungen werden 30 Tage im Browser des Besuchers gespeichert (ohne Tracking, ohne Server-Übertragung):
| Anzeige-Modi | Farben umkehren · Monochrom · Dunkler Kontrast · Heller Kontrast · Niedrige Sättigung · Hohe Sättigung · Links hervorheben · Überschriften hervorheben · Bildschirmleser (Vorlesen per Klick/Markierung) · Lesemodus |
|---|---|
| Regler | Inhaltsskalierung · Schriftgröße · Zeilenhöhe · Zeichenabstand (je 80–200 %) |
| Sprachen | Die Oberfläche folgt der Website-Sprache — 29 europäische Sprachen sind enthalten |
Im Reiter Widget schaltest du Funktionsgruppen einzeln ab (z. B. Grauskala, Kontrast-Modi, Schrift-Regler, Link-Unterstreichung), wenn du das Panel schlanker halten willst.
Schwebender Button
Alles im Reiter Widget → Schwebender Button:
| Position | Vier Ecken: unten rechts (Standard), unten links, oben rechts, oben links |
|---|---|
| Rand-Abstand | 8–80 px Abstand zum Seitenrand |
| Größe | S (48 px) · M (56 px) · L (64 px) |
| Icon | Person (Standard) · Rollstuhlfahrer · Schieberegler — oder ein eigenes Bild aus der Mediathek (PNG/SVG, quadratisch empfohlen) |
Du kannst den Button auch komplett ausschalten und das Panel stattdessen selbst platzieren — siehe Einbindung.
Aussehen & Theme
| Akzentfarbe | Färbt Button, aktive Kacheln und Slider. Per Farb-Picker (Farbfläche, HEX, RGB) — oder als CSS-Variable, siehe unten. |
|---|---|
| Panel-Rundung | Eckenradius des Panels, 4–40 px |
| Panel-Theme | Hell (weiß) · Dunkel (anthrazit) · Eigene Variablen (Design-Kopplung) |
| Branding | „powered by Wave Tools"-Link im Panel-Fuß — abschaltbar ab Pro, White-Label ab Agency |
Design-Kopplung per CSS-Variablen
Für Entwickler: Statt fester Farben kannst du das Widget an die CSS-Custom-Properties deines Themes koppeln. Dann folgt es automatisch jedem Design-Wechsel — inklusive Dark-Mode.
Akzentfarbe
Im Feld Akzentfarbe statt eines Hex-Werts einfach die Variable eintragen:
var(--primary) oder kurz: --primary
Panel-Hintergrund und Textfarbe
Panel-Theme auf Eigene Variablen stellen und die Variablennamen eintragen, die dein Theme definiert, z. B.:
:root { --site-bg: #ffffff; --site-text: #1d1d1f; }
@media (prefers-color-scheme: dark) {
:root { --site-bg: #1c1b22; --site-text: #f4f4f5; }
}
Das Widget übernimmt background: var(--site-bg) und color: var(--site-text) und leitet alle Sekundärfarben (Kachel-Hintergründe, Trennlinien, Rahmen) per color-mix() automatisch daraus ab. Wechselt die Website per Media-Query oder Klasse ins Dunkle, zieht das Widget ohne weitere Konfiguration mit.
Gutenberg-Block
Suche im Block-Editor nach „Eingabehilfen-Panel" (Kategorie Widgets). Der Block rendert dasselbe Panel wie der schwebende Button — ideal für Footer, Popups oder eine eigene „Barrierefreiheit"-Seite. In der Block-Seitenleiste stellst du Titel, Titel-Anzeige und Zurücksetzen-Button ein.
Shortcode
Das Panel an beliebiger Stelle — auch in Theme-Dateien via do_shortcode():
[wave_access]
[wave_access title="Hilfe bei der Bedienung" show_title="1" show_reset="0"]
| Attribut | Werte | Bedeutung |
|---|---|---|
title | Text | Überschrift des Panels (Standard: „Eingabehilfen") |
show_title | 1 / 0 | Überschrift anzeigen |
show_reset | 1 / 0 | Zurücksetzen-Button anzeigen |
Elementor
Ist Elementor aktiv, erscheint automatisch das Widget „Wave Access – Eingabehilfen" im Elementor-Panel (Kategorie Allgemein, Suchwörter „accessibility", „barrierefreiheit"). Per Drag & Drop platzieren; Titel, Titel-Anzeige und Zurücksetzen-Button stellst du direkt in den Widget-Optionen ein.
WPBakery
Ist WPBakery (Visual Composer) aktiv, findest du das Element „Wave Access – Eingabehilfen" im Element-Katalog unter Inhalt — mit denselben drei Optionen wie Block und Shortcode.
Barrierefreiheitserklärung Pro
Der Reiter Erklärung erzeugt eine fertige Barrierefreiheitserklärung nach BFSG/EAA als WordPress-Seite:
- Organisation, Kontakt-E-Mail und optional Telefon eintragen.
- Konformitätsstatus wählen — teilweise vereinbar ist der übliche, ehrliche Stand.
- Bekannte Einschränkungen ergänzen (z. B. „Ältere PDF-Dokumente sind noch nicht barrierefrei").
- Sprache wählen — alle 29 Plugin-Sprachen stehen zur Auswahl (Deutsch und Englisch redaktionell gepflegt, weitere folgen).
- Seite erstellen — die Erklärung erscheint als veröffentlichte Seite; bei Änderungen einfach erneut speichern, die Seite wird aktualisiert.
Prüfbericht & PDF
Der Reiter Prüfbericht bündelt drei Werkzeuge:
- Übersicht — Statistik zu Bildern ohne Alt-Text, Checklisten-Fortschritt und Gesamtstatus. Hier startest du auch den PDF-Prüfbericht Pro: eine druckoptimierte Nachweis-Dokumentation (Zusammenfassung, aktive Maßnahmen, komplette Checkliste, Bilderliste), die du über den Druckdialog als PDF speicherst.
- Bilder-Analyse — Detailliste aller Bilder ohne Alt-Text mit Vorschau, Fundstellen und Direktlink zur Bearbeitung. Free zeigt die ersten 50 Bilder; Pro prüft unbegrenzt und exportiert als CSV.
- BFSG-Checkliste — 27 Kriterien nach WCAG 2.1 AA in fünf Kategorien, mit Fortschrittsbalken und Speicherfunktion. Die Selbstbewertung fließt in den PDF-Bericht ein.
KI-Funktionen Pro AI
Die KI-Funktionen laufen über die Wave-Tools-Server in Deutschland und werden über deine Lizenz freigeschaltet. Kontingente je Tarif findest du unter Tarife.
Automatische Alt-Texte
- Beim Upload: Schalter „Alt-Texte automatisch beim Upload" — neue Bilder werden asynchron beschrieben.
- Bestand nachrüsten: „Mediathek prüfen" zählt Bilder ohne Alt-Text, „Jetzt erzeugen" arbeitet sie mit Fortschrittsanzeige ab. Vorhandene Alt-Texte bleiben unangetastet.
- Sprache: folgt der Website-Sprache, überschreibbar im KI-Tab.
Leichte Sprache & KI-Vorlesen
Beide Funktionen sind Bestandteil des Pro-AI-Tarifs und werden automatisch über deine Lizenz freigeschaltet, sobald sie für dein Konto verfügbar sind — du siehst den Status im KI-Tab.
Backend-Optionen
| Dashboard-Widget | Status-Übersicht auf dem WP-Dashboard — abschaltbar unter Allgemein → Backend-Integration |
|---|---|
| Admin-Leiste | Schnellzugriff „Barrierefreiheit" in der oberen Leiste — ebenfalls abschaltbar |
| Tab-Visualisierer | Zeigt Admins die Tab-Reihenfolge mit Nummern direkt im Frontend (Reiter Tab-Reihenfolge) |
| E-Mail-Hinweise | Optionale Benachrichtigung, wenn ein Bild ohne Alt-Text hochgeladen wird |
Tarife im Überblick
| Free | Pro | Pro AI | Agency | |
|---|---|---|---|---|
| Widget + Basis-Fixes + Checkliste | ✓ | ✓ | ✓ | ✓ |
| Alt-Text-Prüfung | 50 Bilder | unbegrenzt + CSV | unbegrenzt + CSV | unbegrenzt + CSV |
| Barrierefreiheitserklärung + PDF-Bericht | — | ✓ | ✓ | ✓ |
| KI: Alt-Texte / Leichte Sprache / Vorlesen | — | — | ✓ | ✓ (gepoolt) |
| Websites | ∞ | 1 | 1 | bis 25 |
| Branding abschaltbar / White-Label | — | ✓ / — | ✓ / — | ✓ / ✓ |
Preise und Bestellung: wavetools.io/#pricing · Verwaltung: Kundenbereich
Troubleshooting
Die häufigsten Stolpersteine und ihre Lösungen — die meisten Probleme sind in wenigen Minuten behoben.
Das Widget erscheint nicht im Frontend
Prüfe zuerst, ob das Plugin in der Plugin-Liste wirklich aktiviert und der schwebende Button im Reiter Widget eingeschaltet ist. Danach ist meist ein Caching-Plugin oder CDN die Ursache: Leere den Cache (z. B. WP Rocket, LiteSpeed Cache, Cloudflare) und lade die Seite in einem Inkognito-Fenster neu. Optimierungs-Plugins, die JavaScript verzögern (defer) oder zusammenfassen, können das Widget-Skript blockieren — nimm wave-access dort von der Optimierung aus. Kontrolliere außerdem, ob Ausschluss-Regeln (bestimmte Seiten oder Inhaltstypen) greifen.
Der Lizenzschlüssel wird nicht angenommen
Der Schlüssel hat das Format WAVE-XXXX-XXXX-XXXX — achte beim Kopieren aus der Bestell-Mail auf Leerzeichen am Anfang oder Ende. Ist das Site-Limit deines Tarifs erreicht, lehnt der Server die Aktivierung ab: Öffne den Kundenbereich und gib mit „Lizenz von dieser Website lösen" einen Platz frei. Schlägt die Aktivierung mit einem Verbindungsfehler fehl, erreicht dein Server wavetools.io nicht — bitte deinen Hoster, ausgehende HTTPS-Verbindungen zu wavetools.io zuzulassen (Firewall, hosts-Datei).
Die KI-Funktionen liefern kein Ergebnis
Häufigste Ursache: Das monatliche Kontingent ist aufgebraucht — der KI-Tab zeigt den Verbrauch an, bei 80 % und 100 % bekommst du eine Warn-Mail. Zusätzliches Kontingent kaufst du im Kundenbereich zu. Prüfe außerdem, ob dein Tarif KI überhaupt enthält (Pro AI oder Agency — siehe Tarife). Bleiben Anfragen ganz ohne Antwort, blockiert dein Server möglicherweise ausgehende HTTPS-Verbindungen zum Wave-Tools-Proxy — frag im Zweifel deinen Hoster.
Vorlesen nutzt die Systemstimme statt der KI-Stimme
Die KI-Stimme setzt eine aktive Pro-AI-Lizenz (oder Agency) und freies Kontingent voraus — fehlt eines von beidem, fällt das Widget automatisch auf die Systemstimme des Browsers zurück. Prüfe Lizenz und Verbrauch im KI-Tab. Beim ersten Vorlesen einer Seite dauert es zudem einen Moment: Das Audio wird auf dem Server erzeugt und danach gecacht — ab dem zweiten Abruf startet es sofort.
Das Widget passt optisch nicht zum Theme
Position, Größe, Akzentfarbe und Panel-Theme stellst du unter Einstellungen → Barrierefreiheit → Widget ein. Soll das Widget automatisch den Farben deines Themes folgen — inklusive Dark-Mode —, koppel es per CSS-Variablen an dein Design: siehe Design-Kopplung. So bleibt es auch nach einem Theme-Wechsel stimmig, ohne dass du Farben von Hand nachpflegen musst.
Die Darstellung bricht mit Optimierungs-/Minify-Plugins
Manche Optimierungs-Plugins (Autoptimize, WP Rocket, SiteGround Optimizer u. a.) fassen CSS und JavaScript zusammen oder minifizieren so aggressiv, dass Stile oder Skripte des Widgets kaputtgehen. Schließe die Dateien des Plugins (Pfad enthält wave-access) dort vom Minify/Combine aus, leere anschließend den Cache und prüfe die Seite im Inkognito-Fenster. Die Assets des Widgets sind bereits schlank und optimiert — zusätzliches Minify bringt praktisch nichts.
Der externe Scan meldet „Kontingent erreicht" oder einen Fehler
Der Scan hat monatliche Limits je Tarif: Free 2, Pro 20, Agency 100 Scans — der Zähler setzt sich zum Monatswechsel zurück. Außerdem kann der Scanner nur öffentlich erreichbare Seiten prüfen: Wartungsmodus, Basic-Auth-Passwortschutz oder eine lokale Entwicklungsumgebung verhindern den Zugriff und führen zu einem Fehler. Schalte den Schutz kurz ab oder scanne die Live-Site.
Ein verfügbares Update wird nicht angezeigt
WordPress prüft nur etwa alle zwölf Stunden auf Updates. Stoße die Prüfung manuell an: Dashboard → Aktualisierungen → „Erneut prüfen" — das leert den Update-Transient. Erscheint das Pro-Update dann immer noch nicht, wirf einen Blick auf deine Lizenz: Ist sie abgelaufen, liefert der Update-Server nur noch Free-Updates; nach der Verlängerung im Kundenbereich stehen Pro-Updates sofort wieder bereit.
Support
Fragen, Fehler, Wünsche? Schreib an support@wavetools.io — Pro-Kunden antworten wir mit Priorität. Hilfreich sind deine WordPress- und Plugin-Version (siehe Plugin-Liste) sowie eine kurze Beschreibung, was du erwartet und was du stattdessen gesehen hast.