/ Dokumentation / Wave Access

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

  1. Plugin-ZIP im WordPress-Backend unter Plugins → Installieren → Plugin hochladen auswählen und installieren — oder den Ordner wave-access nach /wp-content/plugins/ laden.
  2. Plugin in der Plugin-Liste aktivieren. Dort findest du auch direkt den Link Einstellungen.
  3. Fertig — das Eingabehilfen-Widget erscheint sofort unten rechts auf deiner Website. Alle Basis-Fixes (Skip-Links, Fokus-Indikator, ARIA-Landmarks) sind ab Werk aktiv.
Updates kommen direkt über das WordPress-Update-System — Pro-Versionen über den Wave-Tools-Update-Server, die Free-Version lädst du bis zur Veröffentlichung auf wordpress.org hier: wave-access.zip.

Lizenz aktivieren Pro

Deinen Lizenzschlüssel findest du in der Bestell-E-Mail und im Kundenbereich.

  1. Öffne Einstellungen → Barrierefreiheit → Lizenz.
  2. Schlüssel eintragen (Format WAVE-XXXX-XXXX-XXXX) und auf Aktivieren klicken.
  3. 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-ModiFarben umkehren · Monochrom · Dunkler Kontrast · Heller Kontrast · Niedrige Sättigung · Hohe Sättigung · Links hervorheben · Überschriften hervorheben · Bildschirmleser (Vorlesen per Klick/Markierung) · Lesemodus
ReglerInhaltsskalierung · Schriftgröße · Zeilenhöhe · Zeichenabstand (je 80–200 %)
SprachenDie 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:

PositionVier Ecken: unten rechts (Standard), unten links, oben rechts, oben links
Rand-Abstand8–80 px Abstand zum Seitenrand
GrößeS (48 px) · M (56 px) · L (64 px)
IconPerson (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

AkzentfarbeFärbt Button, aktive Kacheln und Slider. Per Farb-Picker (Farbfläche, HEX, RGB) — oder als CSS-Variable, siehe unten.
Panel-RundungEckenradius des Panels, 4–40 px
Panel-ThemeHell (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.

Fallbacks sind eingebaut: Ist eine Variable auf der Seite nicht definiert, nutzt das Widget Weiß/Anthrazit.

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"]
AttributWerteBedeutung
titleTextÜberschrift des Panels (Standard: „Eingabehilfen")
show_title1 / 0Überschrift anzeigen
show_reset1 / 0Zurü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:

  1. Organisation, Kontakt-E-Mail und optional Telefon eintragen.
  2. Konformitätsstatus wählen — teilweise vereinbar ist der übliche, ehrliche Stand.
  3. Bekannte Einschränkungen ergänzen (z. B. „Ältere PDF-Dokumente sind noch nicht barrierefrei").
  4. Sprache wählen — alle 29 Plugin-Sprachen stehen zur Auswahl (Deutsch und Englisch redaktionell gepflegt, weitere folgen).
  5. Seite erstellen — die Erklärung erscheint als veröffentlichte Seite; bei Änderungen einfach erneut speichern, die Seite wird aktualisiert.
Verlinke die Erklärung im Footer deiner Website — das erwarten Nutzer und Marktüberwachung. Die Erklärung ersetzt keine Rechtsberatung.

Prüfbericht & PDF

Der Reiter Prüfbericht bündelt drei Werkzeuge:

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

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-WidgetStatus-Übersicht auf dem WP-Dashboard — abschaltbar unter Allgemein → Backend-Integration
Admin-LeisteSchnellzugriff „Barrierefreiheit" in der oberen Leiste — ebenfalls abschaltbar
Tab-VisualisiererZeigt Admins die Tab-Reihenfolge mit Nummern direkt im Frontend (Reiter Tab-Reihenfolge)
E-Mail-HinweiseOptionale Benachrichtigung, wenn ein Bild ohne Alt-Text hochgeladen wird

Tarife im Überblick

FreeProPro AIAgency
Widget + Basis-Fixes + Checkliste
Alt-Text-Prüfung50 Bilderunbegrenzt + CSVunbegrenzt + CSVunbegrenzt + CSV
Barrierefreiheitserklärung + PDF-Bericht
KI: Alt-Texte / Leichte Sprache / Vorlesen✓ (gepoolt)
Websites11bis 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.

Dein Problem ist nicht dabei? Melde dich — alle Infos unter Support. Lizenz, Rechnungen und Kontingente verwaltest du im Kundenbereich.

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.