WordPress-Plugin einrichten und verbinden

Das Plugin ist die Verbindung zwischen Ihrer WordPress-Installation und Ihrem Konto. Geprüft wird im Dienst, in einem echten Browser; WordPress startet die Prüfung, zeigt die Befunde und bindet die veröffentlichte Erklärung ein. Die Einrichtung dauert wenige Minuten.

Bevor Sie beginnen

• Im Dienst ein Konto mit der Rolle „Inhaberin oder Inhaber“ oder „Administration“. Nur diese Rollen sehen den Reiter „Einbindung“, in dem das Token entsteht.
• In WordPress ein Konto mit Administratorrechten, WordPress ab Version 6.5 und PHP ab 8.1.
• Für den Text der Erklärung: Das Plugin zeigt nur eine veröffentlichte Erklärung. Prüfen und Befunde ansehen geht auch vorher; Text im Shortcode erst nach der Veröffentlichung, und die ist ab dem Plan Starter enthalten.

1. Plugin installieren

Das Plugin heißt „Barrierepruefung.de – Web Accessibility Checker“. Installieren und aktivieren Sie es. Nach der Aktivierung führt ein Hinweis zur Seite Werkzeuge → Barrierefreiheit; in der Pluginliste steht dafür auch der Link „Einstellungen“.

Den Quelltext und die Hinweise zur Installation finden Sie im öffentlichen Repository des Plugins.

2. Website im Dienst anlegen

Im Dienst unter „Websites“ → „Website hinzufügen“. Tragen Sie genau die Adresse ein, unter der Ihre WordPress-Installation erreichbar ist – so, wie sie im Browser steht, mit oder ohne www. Die Seite Werkzeuge → Barrierefreiheit nennt Ihnen diese Adresse.

Weicht die Adresse ab, scheitert die Domain-Bestätigung in Schritt 5 ohne erkennbaren Grund.

3. Token erzeugen

Öffnen Sie im Dienst „Websites“ → Ihre Website → Reiter „Einbindung“, Abschnitt „WordPress-Plugin und API“. Geben Sie eine „Bezeichnung“ ein – etwa „WordPress auf beispiel.de“ – und wählen Sie „Token erzeugen“.

Der Dienst zeigt jetzt drei Angaben: „API-Token“, „Website-Kennung“ und „Adresse des Dienstes“.

Das Token erscheint nur dieses eine Mal. Kopieren Sie alle drei Angaben, bevor Sie „Ich habe das Token gespeichert“ wählen. Geht das Token verloren, erzeugen Sie ein neues.

Das Token gilt nur für diese eine Website. Es darf Prüfungen auslösen, Ergebnisse und die Erklärung lesen – mehr nicht.

4. Verbindung in WordPress eintragen

In WordPress unter Werkzeuge → Barrierefreiheit, Abschnitt „Mit Ihrem Konto verbinden“:

• API-Token: vollständig einfügen, einschließlich der Zahl und des senkrechten Strichs am Anfang.
• Website-Kennung: die Kennung aus Schritt 3.
• Adresse des Dienstes: so lassen, wie sie vorbelegt ist – das ist die Adresse, an die das Plugin seine Anfragen schickt.

Dann „Verbinden“. Die Seite meldet „Verbindung hergestellt. Bestätigen Sie jetzt die Domain.“

5. Domain bestätigen

Wählen Sie „Domain jetzt bestätigen“. Das Plugin liefert den Nachweis selbst aus – als Meta-Element und als Datei unter /.well-known/a11y-site-verification.txt. Einen DNS-Eintrag brauchen Sie nicht. Die Seite meldet „Die Domain ist bestätigt.“

Der Dienst prüft die Bestätigung täglich nach. Haben Sie die Domain nur über das Plugin bestätigt und deaktivieren es später, geht die Bestätigung bei der nächsten Nachprüfung verloren.

6. Erste Prüfung starten

„Jetzt prüfen“ startet eine Prüfung; sie dauert in der Regel einige Minuten. Die Seite aktualisiert sich bewusst nicht von selbst – ein automatisches Neuladen würde den Fokus verschieben und Menschen mit Screenreader unterbrechen. Wählen Sie „Nachsehen, ob die Prüfung fertig ist“.

Danach steht die Befundliste auf derselben Seite: Befunde in WordPress abarbeiten.

7. Erklärung veröffentlichen und einbinden

Das Plugin kann nicht veröffentlichen. Beantworten Sie im Dienst die manuellen Prüfschritte, ergänzen Sie die Pflichtangaben und geben Sie die Erklärung frei: Von der Prüfung zur veröffentlichten Erklärung.

Setzen Sie dann den Shortcode [barrierefreiheitserklaerung] auf eine Seite: Erklärung in WordPress anzeigen: Shortcode und Block.

Verbindung korrigieren

Unter „Eingetragene Verbindung“ steht, was gespeichert ist. „Verbindung trennen“ löscht Token, Website-Kennung und den gespeicherten Text der Erklärung aus WordPress; danach tragen Sie die Verbindung neu ein. Im Konto ändert das nichts: Das Token bleibt gültig, bis Sie es im Reiter „Einbindung“ „Zurückziehen“.

Was das Plugin überträgt

Die Adresse Ihrer Website, das Token und die Website-Kennung – keine Inhalte und keine personenbezogenen Daten Ihrer Besucherinnen und Besucher. Anfragen gehen an den Dienst,

• wenn Sie eine Prüfung starten oder die Domain bestätigen,
• wenn Sie Werkzeuge → Barrierefreiheit öffnen – höchstens alle 5 Minuten, danach aus dem Zwischenspeicher,
• wenn Sie die Fundstellen einer Regel aufklappen,
• wenn die Erklärung angezeigt wird – höchstens alle 60 Minuten, danach aus dem Zwischenspeicher.

Beim Deinstallieren entfernt das Plugin alle Einstellungen und Zwischenspeicher, auch das Token.