Beschreibung
Das Plugin verbindet deine WordPress-Installation mit einem Prüfdienst für digitale Barrierefreiheit. Aus dem Backend heraus startest du eine Prüfung, siehst die offenen Befunde samt Hinweis zur Behebung und gibst den Text deiner Erklärung zur Barrierefreiheit per Shortcode oder Block auf einer Seite aus.
Unter Werkzeuge Barrierefreiheit stehen die Befunde der letzten Prüfung als Arbeitsliste: je Regel der Schweregrad, das Erfolgskriterium, die Zahl der Fundstellen, was zu tun ist und welche Seiten betroffen sind. Klapp eine Regel auf, um ihre einzelnen Fundstellen zu sehen — Seite, Selektor, die gemessenen Werte und den HTML-Ausschnitt —, damit du die Stelle in WordPress findest. Darunter steht das Seitenkontingent des laufenden Abrechnungszeitraums. Behoben wird in WordPress; die nächste Prüfung startest du danach an derselben Stelle.
Screenshots der Fundstellen bleiben auf der Website des Dienstes und sind über den Link zum vollständigen Bericht erreichbar.
Unter Werkzeuge Barrierefreiheit Erklärung zur Barrierefreiheit gehst du den ganzen Weg bis zur veröffentlichten Erklärung, ohne WordPress zu verlassen: Prüfschritte beantworten, angeben, wer die Erklärung abgibt, den Betroffenheits-Check beantworten, die Pflichtangaben ausfüllen, den Entwurf prüfen und veröffentlichen. Schritte, Fragen und Rechtstexte kommen vom Dienst und sind damit immer aktuell. Jede veröffentlichte Fassung wird mit dem Namen der Person festgehalten, die sie freigegeben hat. Danach findet das Plugin die Seite, die die Erklärung einbindet, oder legt eine als Entwurf an.
Veröffentlichen aus WordPress setzt ein Token voraus, dem eine Administratorin oder ein Administrator im Dienst das Veröffentlichen ausdrücklich erlaubt hat.
Die Erklärung wird serverseitig eingebunden — sie ist damit auch ohne JavaScript und für assistive Technologien vollständig vorhanden.
Was das Plugin nicht tut
Es verändert deine Website nicht und repariert nichts automatisch. Sogenannte Accessibility-Overlays beseitigen keine Barrieren, verschlechtern die Lage für Menschen mit assistiven Technologien regelmäßig und sind kein Nachweis der Konformität.
Externe Dienste
Dieses Plugin ruft einen externen Dienst auf, dessen Adresse du bei der Einrichtung selbst einträgst (Standard: barrierepruefung.de).
Was übertragen wird:
- die Adresse dieser Website,
- das API-Token, das du erzeugt hast,
- die Kennung deiner Website beim Dienst,
- wenn du Prüfschritte, den Betroffenheits-Check oder die Pflichtangaben beantwortest oder die Erklärung veröffentlichst: deine Antworten und Angaben sowie den Anzeigenamen der WordPress-Person, die das tut. Der Dienst hält diesen Namen als Nachweis fest, wer eine Fassung freigegeben hat.
No content and no personal data of your visitors are transmitted. Transmission happens
when you start a scan, when you connect the plugin or verify the domain, when the page Tools Accessibility is
opened (at most every five minutes, from the cache after that), when you expand a rule to see
its occurrences, or when the statement is retrieved (at most once an hour, likewise from the
cache after that).
Datenschutzerklärung des Dienstes: https://barrierepruefung.de/datenschutz
Allgemeine Geschäftsbedingungen: https://barrierepruefung.de/agb
Shortcode
[barrierefreiheitserklaerung] outputs the text of your accessibility statement, rendered on
serverseitig gerendert. Der Block „Erklärung zur Barrierefreiheit“ bietet denselben Umfang und dieselbe Einbindung — mit den Einstellungen teil, stand und ueberschrift.
Beispiel für die vollständige Erklärung:
[barrierefreiheitserklaerung]
Beispiel nur für den Abschnitt zu den Mängeln, eine Ebene tiefer eingebunden:
[barrierefreiheitserklaerung teil="maengel" ueberschrift="3"]
teil
Welcher Ausschnitt der Erklärung ausgegeben wird.
komplett(Standard) — die vollständige Erklärung.maengel— nur der Abschnitt zu bekannten Barrieren.kontakt— nur der Abschnitt mit den Kontaktdaten für Rückmeldungen.
Ein unbekannter Wert liefert ohne Fehlermeldung die vollständige Erklärung, genau wie komplett — ebenso, wenn der angefragte Abschnitt in der geladenen Erklärung nicht vorkommt.
ueberschrift
Die Ebene, die die oberste Überschrift der Ausgabe erhält (Standard 2). Gemessen wird relativ zur obersten Überschrift, die in der Erklärung tatsächlich vorkommt — nicht fest an einer h1 —, damit sich der Text in die Überschriftenhierarchie deiner Seite einfügt.
Erlaubt sind Werte von 2 bis 4; kleinere oder größere Werte werden ohne Fehlermeldung auf diesen Bereich begrenzt (1 verhält sich also wie 2, 5 wie 4). Überschriften weiter unten in der Erklärung werden entsprechend mitverschoben, aber nie über h6 hinaus.
stand
ja (default) appends a paragraph with the version number and the date of the statement — but
nur, wenn die geladene Erklärung ein Datum mitbringt. Tut sie das nicht, entfällt der Absatz auch mit stand="ja". Jeder andere Wert unterdrückt den Absatz in jedem Fall.
sprache
Wird angenommen, hat in dieser Version aber keine Wirkung — die Sprache der Ausgabe richtet sich allein nach der im Dienst hinterlegten Sprachfassung.
Screenshots



Blöcke
Dieses Plugin bietet 1 Block.
- Erklärung zur Barrierefreiheit
Installation
- Installiere und aktiviere das Plugin. Öffne Werkzeuge Barrierefreiheit — die Seite erklärt jeden der folgenden Schritte, auch, woher jeder Wert kommt.
- Lege ein Konto bei barrierepruefung.de an oder melde dich an, falls du schon eines hast.
- Fügen Sie diese Website dort hinzu und geben Sie dabei genau die Adresse dieser WordPress-Installation an. Wenn eine andere Adresse gespeichert ist, kann die Domain nicht verifiziert werden.
- Wähle unter Websites [Website] Einbindung, Abschnitt WordPress-Plugin und API, die Schaltfläche Token erzeugen. API-Token und Website-Kennung werden einmalig an dieser Stelle angezeigt.
- Enter both under Tools Accessibility and leave the service address as it is. Connecting verifies the domain right away — the plugin serves the proof itself, you do not need DNS access.
- Starte eine Prüfung und füge den Shortcode
[barrierefreiheitserklaerung]auf einer Seite ein.
FAQ
-
Muss ich einen DNS-Eintrag setzen?
-
Nein. Das Plugin liefert den Nachweis selbst aus, als Meta-Element und als Datei unter /.well-known/a11y-site-verification.txt.
-
Die Domain kann nicht verifiziert werden. Was nun?
-
The page names the reason. Most often a caching plugin or a cache at the host still serves the
homepage from before you connected, without the verification tag. The plugin then tries the file
/.well-known/a11y-site-verification.txt, which caches usually let through. If both fail,
clear the cache and choose Verify domain now again. -
Ich habe eine Prüfung gestartet — wo ist das Ergebnis?
-
Eine Prüfung dauert einige Minuten. Die Seite aktualisiert sich nicht von selbst, weil ein automatisches Neuladen den Fokus verschieben und Screenreader-Nutzende unterbrechen würde (WCAG 2.2.2). Solange eine Prüfung läuft, sagt Werkzeuge Barrierefreiheit das und bietet „Nachsehen, ob die Prüfung fertig ist“ als Hauptschaltfläche an.
-
Was passiert, wenn der Dienst nicht erreichbar ist?
-
Die zuletzt erfolgreich geladene Fassung der Erklärung wird weiter ausgeliefert — mit ihrem ursprünglichen Datum. Eine Erklärung, die wegen eines Ausfalls von der Website verschwindet, wäre für dich ein rechtliches Problem.
-
In welchen Sprachen gibt es das Plugin?
-
Englisch (Ausgangssprache) und Deutsch, in beiden Anreden: informell (de_DE, „Du“) und formell (de_DE_formal, „Sie“), so wie WordPress sie unterscheidet. Die Vorlage für weitere Übersetzungen liegt dem Plugin unter
languages/barrierepruefung-de-web-accessibility-checker.potbei. -
Ich habe mich beim Verbinden vertippt — wie komme ich zurück?
-
Unter Werkzeuge Barrierefreiheit steht die gespeicherte Verbindung samt der Schaltfläche „Verbindung trennen“. Danach erscheint das Formular wieder, und du kannst Token, Website-Kennung und Adresse neu eintragen. Die Adresse des Dienstes lässt sich dort auch einzeln auf den Standardwert zurücksetzen. Dein Konto bleibt unberührt; das Token bleibt gültig und wird im Konto widerrufen.
-
Was bleibt nach der Deinstallation zurück?
-
Nichts. Die Deinstallation entfernt alle Optionen und Zwischenspeicher, einschließlich des Tokens und der zuletzt geladenen Fassung der Erklärung — im Netzwerk für jede Unterseite einzeln.
-
Ersetzt die automatische Prüfung ein Gutachten durch Fachleute?
-
Nein. Automatische Tests decken nur einen Teil der Anforderungen ab. Durch die übrigen Prüfschritte führt dich der Dienst; die Erklärung sagt ausdrücklich, dass sie auf einer Selbstbewertung beruht.
Rezensionen
Mitwirkende und Entwickler
„Barrierepruefung.de – Web Accessibility Checker“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:
Mitwirkende„Barrierepruefung.de – Web Accessibility Checker“ wurde in 1 Sprache übersetzt. Danke an die Übersetzer für ihre Mitwirkung.
Übersetze „Barrierepruefung.de – Web Accessibility Checker“ in deine Sprache.
Interessiert an der Entwicklung?
Durchstöbere den Code, sieh dir das SVN-Repository an oder abonniere das Entwicklungsprotokoll per RSS.
Änderungsprotokoll
0.7.2
- Fixed: Public bodies got stuck in the step „Who is making the statement“. The service now asks
whether the body belongs to the federal level or to a state, because the applicable law
depends on it; the plugin showed the reason but had no field for it. The choice is now part of
the step. Which states are offered comes from the service. - Fixed: The note on a discarded answer spoke of a changed page template. It now says what the
service means: this scan measured something that contradicts the answer taken over. - Geändert: Jeder offene Schritt enthält nun auch einen Link zu der Stelle im Service, an der er abgeschlossen werden kann.
- Changed: The manual checks say what they are – the questions that have to be answered before
publishing – and link to the remaining questions in the service. Criteria nobody has assessed
are named as not assessed in the statement. - Changed: The hint on the competent enforcement body reflects that it is pre-filled according
to the federal or state level.
0.7.1
- Fixed: The domain could not be verified behind a page cache – the cache served the homepage
from before connecting, without the verification tag. If the tag is not found, the plugin now
tries the file under /.well-known/, which bypasses page caches. - Fixed: The verification file carried the code of the meta tag. The service issues a separate
code for each method, so verifying by file could never succeed. Sites updated from 0.7.0 fetch
the missing code on the next verification. - Fixed: A site already verified another way (for example by DNS) was reported as „not verified“
after connecting again. - Changed: Connecting now verifies the domain right away; the button remains for another attempt.
- Changed: If verification fails, the page explains why and what to do, instead of showing a
code such as „meta_tag_nicht_gefunden“. - Changed: Uninstalling also removes the code of the verification file.
0.7.0
- Neu: Ein neuer Reiter „Erklärung zur Barrierefreiheit“ führt Schritt für Schritt zur veröffentlichten Erklärung: Prüfschritte, wer die Erklärung abgibt, Betroffenheits-Check, Pflichtangaben, Prüfen und Veröffentlichen. Schritte und Texte kommen vom Dienst; einen Schritt, den diese Version noch nicht kennt, verlinkt sie in den Dienst, statt ihn wegzulassen.
- Neu: Die Freigabe schickt die Kennung des Entwurfs, den du geprüft hast, und einen Einmalschlüssel mit — ein Doppelklick erzeugt so nie eine zweite Fassung, und ein inzwischen geänderter Entwurf wird nicht ungesehen veröffentlicht.
- Neu: Nach dem Veröffentlichen zeigen Seiten, die die Erklärung einbinden, sofort die neue Fassung, und das Plugin findet diese Seiten — oder legt eine als Entwurf an.
- Neu: Die Verwaltungsseite zeigt, wenn die veröffentlichte Erklärung veraltet ist.
- Geändert: Getestet mit WordPress 7.1.1.
- Geändert: Neuer Tag „barriereprüfung“, damit das Plugin unter diesem Suchbegriff gefunden wird; dafür entfällt „bitv“, da das Verzeichnis nur fünf Tags auswertet.
- Geändert: Anfragen an den Dienst tragen die Sprache der WordPress-Person, damit die Texte des Dienstes in dieser Sprache erscheinen.
- Geändert: Deutsch liegt jetzt in beiden Anreden bei, so wie WordPress sie unterscheidet: de_DE duzt, das neue de_DE_formal siezt. Bisher siezte de_DE, und Installationen auf „Deutsch (Sie)“ sahen Englisch.
0.6.4
- Behoben: In der deutschen Übersetzung schloss der Hinweis vor der ersten Prüfung die zitierte Beschriftung der Schaltfläche mit einem geraden statt mit dem deutschen Anführungszeichen.
- Geändert: Neue Versionen gelangen aus dem getaggten GitHub-Release ins Plugin-Verzeichnis, beide tragen damit dasselbe Paket.
0.6.3
- Behoben: Eine Regel mit genau einer Fundstelle bot „Show 1 occurrences“ an. Der Zeichenkette fehlte die Einzahl. Sie liegt jetzt in beiden Formen bei, auf Englisch und auf Deutsch — und Sprachen mit anderen Pluralregeln bekommen ebenfalls den nötigen Platz.
0.6.2
- Behoben: Nach dem Bestätigen der Domain meldete die Seite oben „Die Domain ist bestätigt“ und zeigte darunter weiter „Domain bestätigt: nein“ samt der Schaltfläche, die das gerade erledigt hatte — bis zu fünf Minuten lang, und nur „Status aktualisieren“ kam dagegen an. Das Bestätigen verwirft jetzt den Zwischenspeicher, wie es das Starten einer Prüfung schon tat. Ein gescheiterter Versuch lässt ihn stehen: Beim Dienst hat sich dann nichts geändert.
- Behoben: Das Eintragen einer neuen Verbindung und das Zurücksetzen der Adresse des Dienstes verwerfen ebenfalls den Zwischenspeicher. Er gehört zu einer Verbindung und einer Adresse.
0.6.1
- Geändert: Die Einrichtungsanleitung erklärt nicht mehr, was das Token darf und wo es gespeichert wird — an dieser Stelle suchst du das Token, nicht seine Rechte.
- Geändert: Der letzte Schritt sagt jetzt, was die Adresse des Dienstes ist — wohin das Plugin seine Anfragen schickt —, statt dazu zu raten, ob man sie ändern sollte.
0.6.0
- Geändert: Der Plugin-Slug — und mit ihm die Text-Domain, der Ordnername im ZIP und die künftige Adresse im Verzeichnis — lautet jetzt „barrierepruefung-de-web-accessibility-checker“ statt „a11y-checker“. Der alte war die Abkürzung eines Namens, den bereits ein anderes Plugin trägt.
- Geändert: Interne Präfixe sind mitgezogen, solange das noch günstig ist: Optionen und Transients heißen „barrierepruefung_“, Klassen „Barrierepruefung_“, Dateien „includes/class-barrierepruefung-*.php“.
- Geändert: Die Verwaltungsseite liegt jetzt unter „?page=barrierepruefung“, der Block heißt „barrierepruefung/erklaerung“, und die CSS-Klassen im Frontend lauten „barrierepruefung-erklaerung“, „barrierepruefung-stand“ und „barrierepruefung-hinweis“.
- Geändert: Die Deinstallation entfernt jetzt auch die Optionen und Transients, die unter dem alten Präfix geschrieben wurden.
- Unverändert: der Nachweis der Verfügungsgewalt über die Domain („a11y-site-verification“) — dieser Name gehört dem Dienst, nicht diesem Plugin.
- Hinweis zum Update: Die Plugin-Datei wurde umbenannt, deshalb deaktiviert WordPress eine Vorabfassung, wenn du sie ersetzt. Trage die Verbindung nach dem Aktivieren neu ein. Eine mit dem Block eingefügte Erklärung meldet „unerwarteten Inhalt“, weil sich der Namensraum des Blocks geändert hat; der Shortcode [barrierefreiheitserklaerung] ist nicht betroffen.
0.5.1
- Geändert: Der Link in der Plugin-Liste heißt jetzt durchgehend „Einstellungen“ — die Beschriftung, die neben jedem anderen Plugin steht und nach der deshalb gesucht wird.
- Geändert: Das Plugin wird Lukas Bock zugeschrieben, mit Link auf barrierepruefung.de.
0.5.0
- Neu: Die Seite erklärt beim ersten Aufruf die Einrichtung — dass das Plugin nicht selbst prüft, sondern der Weg in den Dienst ist, dass das Token für genau diese eine Website gilt, und dann Schritt für Schritt, woher Konto, Token und Website-Kennung kommen (Websites -> deine Website -> Einbindung, Abschnitt WordPress-Plugin und API). Vorher war es ein Satz, der ein Konto voraussetzte, von dem noch niemand wusste.
- Neu: Die Anleitung nennt die Adresse dieser Installation. Ist beim Dienst eine andere hinterlegt, scheitert die Bestätigung der Domain später ohne sichtbaren Grund.
- Neu: Nach der Aktivierung verweist ein einmaliger Hinweis auf die Seite, und die Plugin-Liste trägt einen Link „Einrichten“.
- Neu: Das Token-Feld sagt, dass die Nummer und der senkrechte Strich davor zum Token gehören.
- Geändert: Während eine Prüfung läuft, ist „Nachsehen, ob die Prüfung fertig ist“ die Hauptschaltfläche, und der Hinweis auf die laufende Prüfung steht über den Schaltflächen statt darunter. Vorher ging die graue Schaltfläche „Status aktualisieren“ neben dem blauen „Jetzt prüfen“ unter, und nach dem Start einer Prüfung war nicht zu sehen, wie man zum Ergebnis kommt.
- Geändert: „Jetzt prüfen“ ist ausgeblendet, solange eine Prüfung läuft — ein zweiter Lauf verbrauchte nur Kontingent.
- Geändert: Solange die erste Prüfung noch läuft, sagt der Abschnitt mit den Befunden das, statt auf eine Schaltfläche zu verweisen, die es in dem Moment nicht gibt.
- Geändert: Die Seite sagt jetzt auch, warum sie sich nicht von selbst aktualisiert: Ein automatisches Neuladen würde den Fokus verschieben und Screenreader-Nutzende unterbrechen (WCAG 2.2.2).
0.4.0
- Neu: Jede Regel in der Befundliste lässt sich aufklappen. „N Fundstellen anzeigen“ holt die einzelnen Fundstellen dieser einen Regel — Seite, Selektor, Messwerte wie „Kontrast 2,41:1 statt 4,5:1“, Farbwerte, den Zustand, in dem das Element sichtbar wird, den Viewport und den HTML-Ausschnitt. Geblättert wird in Schritten von 20.
- Neu: Aufklappen und Blättern sind gewöhnliche Links. Weiterhin kein JavaScript im Plugin, und geholt wird nur die Regel, an der du gerade arbeitest.
- Geändert: Die Befunde stehen jetzt vor dem Kontingent. Sie sind der Grund, warum man die Seite öffnet.
- Geändert: Screenshots werden nicht ins WordPress-Backend geladen. Die Seite verweist stattdessen auf den vollständigen Bericht und sagt, dass man sich zum Öffnen erst anmelden muss.
- Behoben: Für abgemeldete Personen endete der Link zum vollständigen Bericht auf einer bloßen Fehlerseite. Der Dienst schickt Abgemeldete jetzt zur Anmeldung und danach zurück zum Bericht.
0.3.1
- Geändert: Die readme und die Plugin-Beschreibung sind jetzt englisch, wie es das WordPress-Plugin-Verzeichnis verlangt.
- Geändert: Englisch ist jetzt die Ausgangssprache der eigenen Zeichenketten des Plugins. Deutsch liegt als Übersetzung in languages/barrierepruefung-de-web-accessibility-checker-de_DE.po bei — eine deutsche Installation zeigt genau denselben Text wie zuvor.
- Geändert: Getestet bis WordPress 7.1.
- Bekannte Einschränkung: Mitgeliefert wird nur die Übersetzung de_DE. Installationen mit de_AT, de_CH oder de_DE_formal fallen auf Englisch zurück, bis das Plugin im Verzeichnis steht und translate.wordpress.org diese Sprachpakete liefert.
0.3.0
- Neu: Werkzeuge Barrierefreiheit zeigt die offenen Befunde der letzten Prüfung — je Regel den Schweregrad, das Erfolgskriterium, die Zahl der Fundstellen, einen Hinweis zur Behebung und die betroffenen Seiten. Behoben wird in WordPress, „Jetzt prüfen“ schließt die Runde.
- Neu: Die Seite nennt das Seitenkontingent des laufenden Abrechnungszeitraums.
- Neu: Die Schaltfläche „Status aktualisieren“ holt Kontingent und Befunde neu. Sie ersetzt bewusst ein automatisches Neuladen der Seite, das für Screenreader-Nutzende störend wäre.
- Neu: Läuft gerade eine Prüfung, sagt die Seite das, statt ein veraltetes Ergebnis zu zeigen.
- Geändert: Stand und Befunde werden fünf Minuten zwischengespeichert; das Starten einer Prüfung und „Status aktualisieren“ verwerfen den Zwischenspeicher.
- Geändert: Lässt sich die Website nicht abrufen, steht jetzt der Grund des Dienstes dabei.
0.2.1
- Neu: Die gespeicherte Verbindung ist unter Werkzeuge Barrierefreiheit sichtbar und lässt sich wieder aufheben. Bisher blendete das Plugin das Formular aus, sobald Token und Website-Kennung einmal gespeichert waren — auch wenn sie falsch waren.
- Neu: Die Adresse des Dienstes lässt sich einzeln auf den Standardwert zurücksetzen; das Formular schlägt die zuletzt eingetragene Adresse vor statt immer den Standard.
- Behoben: Eine verworfene Adresse blieb als leere Option stehen; jede Anfrage ging danach an einen relativen Pfad. In diesem Fall gilt jetzt wieder der Standardwert.
0.2.0
- Behoben: Die Überschriftenebene wird jetzt an der obersten tatsächlich ausgegebenen Überschrift gemessen. Bisher blieb die h1 der Erklärung in der Standardeinstellung eine h1 — mitten in einer Seite ist das selbst ein Verstoß gegen WCAG 1.3.1 —, und ein mit teil=“maengel“ oder teil=“kontakt“ eingebundener Abschnitt kam eine Ebene zu tief heraus. Wenn du die Ebenen bisher mit ueberschrift=“3″ von Hand ausgeglichen hast, stell jetzt auf ueberschrift=“2″ um (oder lass das Attribut weg).
- Behoben: Die Rückmeldung im Backend wurde zweimal URL-dekodiert; eine Meldung mit einer wörtlichen Prozentfolge (z. B. „%41“) kam dadurch als Zeichen an.
0.1.0
- Erste Veröffentlichung: Verbindung, Bestätigung der Domain, Starten einer Prüfung, Shortcode und Block.
- Deutsche und englische Sprachfassung, vollständige Deinstallation.
