Fehlerbehebung

Meldungen des Plugins in der Browser-Konsole beginnen mit [Leichte Sprache]. Sehen Sie dort zuerst nach.

Der Button erscheint nicht

1. Fehlt im Reiter „Netzwerk“ der Entwicklerwerkzeuge leichte-sprache.js mit Status 200, steht die Zeile nicht in der ausgelieferten Seite, oder eine Content-Security-Policy blockiert das Skript (mit Meldung in der Konsole).
2. Meldet die Konsole page language is not de: plugin not started, prüfen Sie <html lang="de"> oder setzen Sie data-lang.
3. Meldet sie CMS editing mode (…): plugin not started, sind Sie im CMS angemeldet. Testen Sie in einem privaten Browserfenster (Redaktionsmodus).
4. Bei data-placement="none" oder data-button="none" zeigt das Plugin keinen Button.
5. Fehlt das Element aus data-button, erscheint der schwebende Button, und die Konsole meldet button target "…" not found, using a floating button. Bei data-placement="above" steht der Button unter der Hauptüberschrift im Inhalt.
6. Ein Element mit höherem z-index kann den schwebenden Button verdecken. Erhöhen Sie data-z-index oder wählen Sie eine andere Position.
7. In automatisierten Browsern (Playwright, Selenium, Lighthouse) und für Crawler startet das Plugin ohne Meldung nicht. Für Tests gibt es data-force.

Läuft das Plugin, ist window.LeichteSprache in der Konsole ein Objekt, sonst undefined.

Der Button meldet „Leichte Sprache ist gerade nicht möglich.“

Die Übersetzungs-Schnittstelle hat die Anfrage abgelehnt oder war nicht erreichbar. Den Grund nennt die Konsole:

Meldung in der Konsole	Ursache	Abhilfe
Leichte Sprache: HTTP 403	Die Adresse ist für Ihre Website nicht freigeschaltet, oder data-site stimmt nicht. Typisch für Test- und Vorschau-Systeme.	Kennung prüfen, neue Adressen freischalten lassen
Verstoß gegen connect-src	Die Content-Security-Policy erlaubt die Verbindung zur Schnittstelle nicht.	connect-src https://leichtesprache.participaite.de ergänzen
Failed to fetch, NetworkError oder Zeitüberschreitung	Die Schnittstelle war nicht erreichbar, etwa wegen einer Netzwerksperre oder einer Störung.	Später noch einmal versuchen, bleibt es so, an info@participaite.de schreiben

Der Button meldet „Diese Seite gibt es nicht in Leichter Sprache.“

Die Adresse der Seite enthält einen Teil aus data-skip-urls. Ein kurzer Teil wie form trifft dabei auch /informationen/ und /plattform/. Verwenden Sie eindeutige Teile mit Schrägstrichen, zum Beispiel /formulare/.

Texte bleiben im Standarddeutsch

Manches bleibt absichtlich im Original, etwa Navigation, Formulare, Tabellen, Kontaktdaten, Daten oder Bildnachweise (vollständige Liste). Bei anderem Inhalt kommen diese Gründe in Frage:

• Der Text liegt außerhalb des Inhaltsbereichs, den LeichteSprache.contentRoots in der Konsole zeigt. Legen Sie den Bereich mit data-content fest.
• Das Element oder ein Element darüber trägt eine Klasse oder ID wie nav, menu, kontakt oder search, und das Plugin hält den Bereich für Seitenrahmen. Setzen Sie translate="yes" am betroffenen Element.
• Bei einer Störung, starker Auslastung oder erreichtem Stundenkontingent bleiben neue Abschnitte vorerst im Original. Nach dem Neuladen der Seite versucht das Plugin es erneut.
• Stimmte eine Zahl in der Übersetzung nicht und gelang auch kein neuer Versuch, bleibt der Abschnitt bewusst im Original.
• Ersetzt ein Skript Ihrer Seite einen übersetzten Abschnitt dreimal durch den Originaltext, lässt das Plugin ihn danach in Ruhe.
• Ändert Ihre Anwendung, etwa eine Single-Page-App, Inhalte so, dass das Plugin es nicht bemerkt, rufen Sie danach window.LeichteSprache.refresh() auf.
• Bilder, PDF-Dateien und Text aus CSS übersetzt das Plugin nicht.

Das Layout passt nicht

CSS-Haken und Beispiele für die oft längeren Texte, etwa für Kästen mit fester Höhe oder Aufzählungszeichen aus ::before, stehen unter Gestaltung. Ungeeignete Elemente nehmen Sie mit class="ls-skip" oder data-skip aus.

Alle Meldungen in der Konsole

Meldung	Bedeutung
[Leichte Sprache] page language is not de: plugin not started	Die Seitensprache passt nicht zu data-lang, das Plugin startet nicht.
[Leichte Sprache] CMS editing mode (…): plugin not started	Ein Bearbeitungsmodus wurde erkannt. In Klammern steht, woran.
[Leichte Sprache] content selector "…" not found, detecting the content area	data-content passt auf kein sichtbares Element, das Plugin sucht den Inhaltsbereich selbst.
[Leichte Sprache] button target "…" not found, using a floating button	data-button passt auf kein Element, der schwebende Button erscheint.
[Leichte Sprache] data-labels is not JSON	data-labels ist kein gültiges JSON, die Standard-Beschriftungen gelten.
Error: Leichte Sprache: HTTP …	Die Schnittstelle hat eine Anfrage abgelehnt, siehe oben.
Error: Leichte Sprache: invalid answer	Die Antwort der Schnittstelle war unvollständig. Bitte an info@participaite.de melden.

Wenn Sie nicht weiterkommen

Schreiben Sie an info@participaite.de und schicken Sie mit:

• die Adresse der Seite,
• ein Bildschirmfoto mit eingeschalteter Leichter Sprache,
• Browser und Gerät, zum Beispiel „Firefox auf Windows“ oder „Safari auf dem iPhone“.