WordPress zeigt die Erklärung nicht oder veraltet

Schnell eingrenzen

Ein Hinweis statt der Erklärung

Der Satz „Die Erklärung zur Barrierefreiheit kann gerade nicht geladen werden.“ erscheint, wenn das Plugin keine Erklärung abrufen kann und noch nie eine abgerufen hat. Die Ursachen, nach Häufigkeit:

1. Es ist noch keine Erklärung veröffentlicht. Das Plugin zeigt nur veröffentlichte Fassungen, nie einen Entwurf. Sehen Sie im Dienst im Reiter „Übersicht“ der Website in den Abschnitt „Erklärung“: Steht dort „Entwurf“ oder noch gar nichts, fehlt die Veröffentlichung. Was vorher zu tun ist – oft sind es offene manuelle Prüfschritte –, steht in Von der Prüfung zur veröffentlichten Erklärung.
2. Ihr Plan enthält das Veröffentlichen nicht. Veröffentlichen ist ab dem Plan Starter möglich. Prüfungen und Befunde funktionieren im Plugin auch ohne Veröffentlichung.
3. Das Token wurde zurückgezogen oder die Website-Kennung stimmt nicht. Werkzeuge → Barrierefreiheit nennt dann einen Fehler beim Abruf. Erzeugen Sie ein neues Token und verbinden Sie neu: WordPress-Plugin einrichten und verbinden.
4. Der Dienst war beim ersten Abruf nicht erreichbar. Laden Sie die Seite später erneut.

Hat das Plugin schon einmal eine Fassung geholt, zeigt es in all diesen Fällen stattdessen diese letzte Fassung weiter – mit ihrem ursprünglichen Datum. So verschwindet eine Erklärung nicht wegen eines Ausfalls von Ihrer Website. Die Kehrseite: Ein zurückgezogenes Token fällt auf der Seite selbst nicht auf, nur in Werkzeuge → Barrierefreiheit.

Die alte Fassung wird angezeigt: Zwischenspeicher

Zwischen Ihrer Freigabe und dem, was eine Besucherin sieht, liegen bis zu drei Zwischenspeicher:

1. Der Zwischenspeicher des Plugins. Das Plugin holt die Erklärung höchstens alle 60 Minuten und hebt sie so lange in WordPress auf. Nach einer neuen Veröffentlichung dauert es also bis zu 60 Minuten, bis WordPress die neue Fassung hat.
2. Der Seiten-Cache. Cache-Plugins wie WP Rocket, W3 Total Cache, LiteSpeed Cache oder WP Super Cache und viele Hoster speichern die fertige Seite – samt dem Text der Erklärung darin. Solange diese Kopie gilt, sieht niemand die neue Fassung, auch wenn das Plugin sie längst geholt hat. Je nach Einstellung sind das Stunden oder Tage.
3. Der Browser. Wer die Seite gerade geöffnet hat, sieht die neue Fassung nach dem Neuladen.

Was Sie tun können

• Warten Sie bis zu 60 Minuten nach der Veröffentlichung.
• Leeren Sie danach den Seiten-Cache der Seite mit der Erklärung – im Cache-Plugin oder in der Verwaltung Ihres Hosters oder CDN.
• Auf Dauer einfacher: Nehmen Sie die Seite mit der Erklärung vom Seiten-Cache aus. Die gängigen Cache-Plugins bieten dafür eine Liste von Adressen, die nie zwischengespeichert werden.

Welche Fassung gerade angezeigt wird

Vergleichen Sie zwei Versionsnummern:

• auf Ihrer WordPress-Seite die Zeile „Version …, Stand …“ unter dem Text,
• im Dienst im Reiter „Übersicht“ der Website die Zeile „Version …, veröffentlicht am …“ – oder die öffentliche Adresse der Erklärung, die immer die aktuelle Fassung zeigt.

Stimmen die Nummern nicht überein, liegt es an einem der Zwischenspeicher.

Davon raten wir ab

• „Jetzt prüfen“, nur um den Zwischenspeicher zu leeren. Der Start einer Prüfung verwirft zwar den Zwischenspeicher des Plugins, verbraucht aber Seitenkontingent und lädt Ihre Seiten erneut – und den Seiten-Cache leert er nicht.
• „Verbindung trennen“ und neu verbinden. Das löscht auch die zuletzt geholte Fassung, die bei einem Ausfall die Erklärung auf Ihrer Seite hält.
• „Status aktualisieren“ holt Status und Befunde neu, nicht die Erklärung.

Der Text passt nicht zur letzten Prüfung

Eine veröffentlichte Fassung ist eingefroren. Eine neue Prüfung ändert sie nicht – weder im Dienst noch in WordPress. Weicht das neue Ergebnis ab, markiert der Dienst die Erklärung als „veraltet“; sie bleibt dabei online.

Das Plugin zeigt diese Markierung nicht an, Sie sehen sie im Dienst. Aktuell wird der Text erst mit „Neue Version veröffentlichen“ – und dafür müssen wieder alle Voraussetzungen erfüllt sein, auch neu hinzugekommene Prüfschritte. Mehr dazu: Fassungen, „veraltet“ und PDF.

Immer noch nicht gelöst?

Schreiben Sie uns über das Kontaktformular. Nennen Sie die Adresse der Seite mit dem Shortcode, was dort steht, und die Versionsnummer, die der Dienst zeigt.