# WordPress-Plugin einrichten und verbinden Schritt für Schritt – Plugin installieren, Token erzeugen, Verbindung eintragen, Domain bestätigen und die erste Prüfung aus WordPress starten. **Kurz gesagt** - Das Plugin prüft nicht selbst – es verbindet WordPress mit Ihrem Konto, startet dort Prüfungen und holt die veröffentlichte Erklärung. - Sie brauchen drei Angaben aus Ihrem Konto – API-Token, Website-Kennung und die Adresse des Dienstes. - Text im Shortcode gibt es erst, wenn die Erklärung im Dienst veröffentlicht ist – das ist ab dem Plan Starter möglich. 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](https://github.com/lukasboc/barrierepruefung-wordpress). ## 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](https://barrierepruefung.de/hilfe/wordpress-befunde). ## 7. Erklärung veröffentlichen und einbinden Das Plugin kann nicht veröffentlichen. Beantworten Sie im Dienst die [manuellen Prüfschritte](https://barrierepruefung.de/hilfe/manuelle-pruefschritte), ergänzen Sie die Pflichtangaben und geben Sie die Erklärung frei: [Von der Prüfung zur veröffentlichten Erklärung](https://barrierepruefung.de/hilfe/veroeffentlichen). Setzen Sie dann den Shortcode `[barrierefreiheitserklaerung]` auf eine Seite: [Erklärung in WordPress anzeigen: Shortcode und Block](https://barrierepruefung.de/hilfe/wordpress-einbinden). ## 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. --- Zuletzt gegen das Produkt geprüft: 2026-09-13 · https://barrierepruefung.de/hilfe/wordpress-einrichten