AI Alt Text

KI-generierte Alt-Texte für Bilder in der Mediathek – über eine verwaltete Cloud-API, ohne eigenen API-Schlüssel.

Was ist AI Alt Text?

Die Funktion erzeugt Alternativtexte für Rasterbilder (PNG, JPEG, WebP, GIF) anhand des Bildinhalts und optionaler Medien-Felder. Die Anfrage läuft über den EZZE-Cloud-Proxy zu externen KI-Diensten; du brauchst keinen eigenen OpenAI- oder Google-Key.

Was die KI kann: Kurze, beschreibende Alt-Texte in der gewählten Sprache vorschlagen; bei Bedarf auf vorhandenen Titel, Beschreibung, Bildunterschrift oder Dateiname aufbauen.

Was sie nicht kann / Grenzen: Keine rechtssichere WCAG-Bewertung einzelner Bilder; keine Garantie für inhaltliche Korrektheit oder passende Länge in jedem Kontext; SVG und andere Nicht-Rasterformate werden nicht unterstützt; dekorative Bilder erkennt das Plugin nicht automatisch – du musst ihren Zweck selbst prüfen und kennzeichnen; die KI ersetzt keine fachliche Prüfung durch Menschen.

Sinn und Einsatzmöglichkeiten

• Barrierefreiheit: Alt-Texte sind essentiell für Screenreader-Nutzer
• WCAG: Unterstützt Erfolgskriterium 1.1.1 (Nicht-Text-Inhalt); 1.4.5 (Bilder mit Text) kann bei Text im Bild mithelfen, ist aber kein Ersatz für echte Textalternativen im HTML
• SEO: Sinnvolle Bildbeschreibungen können Suchmaschinen helfen
• Zeitersparnis: Vorschläge für viele Medien, mit manueller Freigabe

Voraussetzungen (Aktivierung)

1. Kostenlose Cloud-Features-Verbindung: Bis die Aktivierung abgeschlossen ist, zeigt die Einstellungsseite nur eine Einrichtungskarte mit dem enthaltenen Kontingent und einem Link, der das Cloud-Features-Panel im Dashboard öffnet. Eine noch ausstehende E-Mail-Bestätigung wird als eigener Zustand angezeigt.
2. Kenntnisnahme zur externen Verarbeitung: Bestätigung, dass du berechtigt bist, Bilder zu nutzen und dass Bilddaten bzw. URLs an externe KI-Dienste gehen können. Ohne diese Kenntnisnahme bleibt „AI Alt Text aktivieren“ gesperrt.
3. AI Alt Text aktivieren (Hauptschalter): Erst danach sind die abhängigen Optionen und die Generierung nutzbar. Das Ausschalten der Funktion widerruft die Kenntnisnahme nicht.

Kenntnisnahme, Funktionsschalter, Folgeoptionen sowie Speicher- und Wiederherstellungsaktionen erscheinen erst, wenn die Cloud-Features-Verbindung bereit ist.

Nutzungs-Limits (Quota)

• Free: 25 Generationen einmalig (kein monatlicher Reset) Free
• Basic: 50/Monat ab Basic
• Plus: 100/Monat ab Plus
• Premium / Agency: 1.000/Monat pro Website ab Premium

Jede erfolgreiche Generierung (nicht leerer Alt-Text) verbraucht ein Kontingent. Bei erreichtem Limit blockiert das Plugin weitere Anfragen mit Hinweis auf Upgrade.

Einstellungen (Tab „Einstellungen“)

Alle Optionen findest du unter EZZE WCAG Pro → AI Alt Text → Einstellungen. Abhängige Felder werden ausgeblendet, solange der Hauptschalter aus ist. Die Schaltfläche Hilfe öffnet auf dem Desktop ein Seitenpanel und auf dem Smartphone ein zugängliches Bottom Sheet mit Hinweisen zu Datenschutz, Arbeitsablauf, Ausgabe, Berechtigungen und WCAG 1.1.1.

Bildzweck in der Mediathek

Jedes Bild hat für diesen redaktionellen Arbeitsablauf einen von drei Zuständen:

• Beschrieben: Der Alt-Text in der Mediathek ist befüllt.
• Als dekorativ geprüft: Der Alt-Text bleibt bewusst leer und der Bildzweck wurde bestätigt.
• Offen: Der Alt-Text ist leer und es gibt noch keine dekorative Kennzeichnung.

Öffne die Anhangdetails in der Mediathek und aktiviere Als dekorativ kennzeichnen direkt in der AI-Alt-Text-Karte, oder nutze dieselbe Aktion im Drei-Punkte-Menü einer Batch-Zeile. Ein dekoratives Bild muss einen leeren Alt-Text behalten. Ist die Kennzeichnung aktiv, ersetzt die Karte Kontingent und Vorschlagsgenerierung durch eine eindeutige Statusmeldung und die Aktion Dekorative Kennzeichnung aufheben; auch das Alt-Text-Feld bleibt bis dahin deaktiviert. Eine vorhandene Beschreibung wird nur nach ausdrücklicher Bestätigung gelöscht. Dekorativ geprüfte Bilder werden aus dem Filter für offene Alt-Texte und aus der Batch-Generierung ausgeschlossen, bleiben aber über den Filter Als dekorativ geprüft samt Status und Aufheben-Aktion erreichbar. Entfernst du die Kennzeichnung, wird das Bild wieder zur Prüfung angeboten.

Die Kennzeichnung gilt für den redaktionellen Status des Bildes in der Mediathek, nicht pauschal für jede Verwendung. Ein Bild kann in einem konkreten Block weiterhin einen eigenen Alt-Text erhalten. Umgekehrt unterdrückt die Kennzeichnung keine Befunde des Barrierefreiheitstests: Dieser bewertet das tatsächlich ausgegebene HTML jeder Seite unabhängig.

Auch wenn du die Mediathek aus einem Beitrag heraus öffnest, gilt diese Kennzeichnung für den Mediathek-Eintrag und löscht nach Bestätigung dessen Alt-Text. Bereits eingefügte Bildblöcke werden dadurch nicht geändert. Soll das Bild nur in einem bestimmten Block dekorativ sein, wähle den Bildblock im Editor aus und aktiviere dort Als dekorativ markieren.

Kenntnisnahme zur externen Verarbeitung

• Funktion: Rechtliches/organisatorisches Gate vor Cloud-Nutzung.
• Pflicht zum Aktivieren des Hauptschalters; ohne Freemius-Verbindung kann keine neue Kenntnisnahme bestätigt werden.
• Nach dem Speichern zeigt die Statuskarte Datum, Uhrzeit und den bestätigenden WordPress-Benutzer. Bereits vor Einführung des Bestätigungsverlaufs gespeicherte Kenntnisnahmen bleiben gültig und werden als historisch gekennzeichnet, ohne ein Datum zu erfinden.
• Kenntnisnahme widerrufen merkt den Widerruf vor. Beim nächsten Speichern wird AI Alt Text deaktiviert und der gespeicherte Bestätigungsbezug entfernt.

AI Alt-Text-Funktion aktivieren

• Funktion: Master-Schalter für Generierung, Mediathek-UI und Upload-Flows.
• Aus: Kein API-Aufruf, kein Button, kein Upload-Overlay – Batch-Tab zeigt nur Hinweis zur Aktivierung.

Bildauswahl und Datenschutz

Ein Auswahlfeld fasst den Verarbeitungsumfang eindeutig zusammen und zeigt daneben das zugehörige Datenschutzrisiko:

• Nur veröffentlichte Inhalte (empfohlen) – Standard. Vor dem API-Aufruf prüft das Plugin, ob das Bild in veröffentlichten Beiträgen oder Seiten vorkommt (u. a. Attachment-ID, URL oder Dateiname im post_content) oder ein veröffentlichtes Parent hat. Bilder nur in der Mediathek, in Entwürfen oder in Custom Post Types ohne Treffer werden abgelehnt.
• Alle Bilder der Mediathek – Hebt die Veröffentlichungs-Prüfung auf; auch interne und unveröffentlichte Medien können an die KI gehen. Die Ansicht kennzeichnet diesen Umfang mit einem höheren Datenschutzrisiko.

Ausnahme: Der Upload-Flow nach der Auswahl genau eines Bildes (siehe unten) umgeht diese Medienfilter bewusst für die frisch hochgeladene Datei, wenn der Upload-Flow aktiviert ist – damit der neue Upload nicht sofort blockiert wird.

Allgemeine Einstellungen

• Button „AI Alt-Text generieren“ in der Mediathek anzeigen (Standard: an) Zeigt direkt unter dem Alt-Text-Feld eine kompakte Vorschlagskarte mit eindeutigem Restkontingent. Ein generierter Vorschlag ersetzt den vorhandenen Alt-Text erst nach deiner Bestätigung. Aus: kein Button; der Upload-Flow kann auf bezahlten Plänen trotzdem aktiv sein, wenn er separat eingeschaltet ist.
• AI-Alt-Text direkt nach dem Upload eines einzelnen Bildes generieren (ab Basic; Standard: aus) Gilt in Mediathek (inkl. Listen-/Rasteransicht), Block-Editor und Medien-Modal. Der Ablauf startet nur, wenn du bei einem Upload genau eine Bilddatei auswählst; Mehrfachauswahlen werden ignoriert. Nutzt dieselbe Rollen- und Kontingent-Logik wie der Button. „Vor dem Generieren nachfragen“ und „Automatisch generieren“ schließen sich gegenseitig aus. Im Free-Plan nicht verfügbar.
• Sprache für generierte Alt-Texte (Standard: „Wie WordPress-Systemsprache“) Folgt Einstellungen → Allgemein → Sprache der Website (erste zwei Buchstaben des Locales, Fallback Englisch). Feste Sprache in der Liste überschreibt das dauerhaft – sinnvoll bei Multilingual-Plugins oder fremdsprachigem Inhalt.
• Minimale / maximale Zeichenlänge (Standard: 80 / 140; UI: min 10–200, max 50–200 in 10er-Schritten) Wird an den Proxy übergeben als Zielvorgabe; die KI kann trotzdem kürzer oder länger antworten. Empfehlung im UI: 80–140 Zeichen.
• Zusätzlicher Kontext für die KI (je Feld ein Schalter; Standard: alle an) Sendet – nur wenn befüllt – Titel, Beschreibung (Inhalt des Anhangs), Bildunterschrift (Excerpt) und/oder Dateiname mit. Gleiche Einstellungen gelten auch für AI Image Review. Ausgeschaltete Felder werden nicht übermittelt.

Berechtigungen ab Basic

• Free: Nur Benutzer mit manage_options (typisch Administrator); kein Berechtigungs-Block in den Einstellungen.
• Bezahlte Pläne: Pro Rolle mit upload_files ein-/ausschaltbar. Administrator ist immer aktiv und nicht deaktivierbar.
• Zusätzlich muss der Nutzer das jeweilige Medium bearbeiten dürfen (edit_post auf dem Anhang) – sonst Fehlermeldung auch bei erlaubter Rolle.

Batch-Verarbeitung ab Basic

Tab AI Alt Text → Batch (im Free-Plan nicht verfügbar; Aufruf leitet zu Einstellungen um).

• Filter und Sortierung: u. a. offener Alt-Text-Zweck, Als dekorativ geprüft, zu kurzer/zu langer Alt-Text (bezogen auf deine Min/Max-Einstellungen), Quelle (manuell/KI), MIME-Typ, Zeitraum; Suche nach Titel, Dateiname, Alt-Text. Sortiert werden kann nach Upload-Datum, Dateiname, Alt-Text-Länge oder Handlungsbedarf. Der Dekorativ-Filter holt markierte Bilder mit Kennzeichnung und Aufheben-Aktion wieder in die Liste. Auf Smartphones öffnet sich die Mehrfachauswahl als Bottom Sheet. Anwenden übernimmt den Entwurf; Abbrechen, Schließen, Escape, Hintergrund oder Herunterwischen verwerfen ihn. Übernommene Filter erscheinen als einzeln entfernbare Chips oberhalb der Ergebnisliste.
• Liste und Bearbeitung: Jeder Eintrag zeigt den aktuellen Alt-Text als kompakte zweizeilige Vorschau mit Status (Alt-Text fehlt, Gespeichert, Nicht gespeicherte Änderung, Vorschlag verfügbar oder Als dekorativ geprüft). Fehlt der gespeicherte Alt-Text, bietet die Karte direkt KI-Vorschlag generieren an; nach dem Speichern eines Alt-Texts erscheint wieder Alt-Text bearbeiten. Auf größeren Bildschirmen öffnet die Bearbeitungsaktion den Editor direkt in der Zeile; auf Smartphones nutzt sie ein Bottom Sheet. Fertig übernimmt die Änderung nur als nicht gespeicherten Entwurf, bis du sie über das Zeilenmenü oder die Sammelaktion speicherst. Der Hilfe-Button öffnet dieselben Hinweise als Seitenpanel beziehungsweise mobiles Bottom Sheet.
• Auswahl und Aktionen: KI-Vorschläge generieren, geprüfte Vorschläge freigeben und speichern oder manuelle Änderungen speichern. Geladene Medien auswählen bezieht sich auf die sichtbaren Zeilen. Nach dieser Auswahl kannst du für die Generierung ausdrücklich auf alle geeigneten Medien der aktuellen Filtermenge erweitern, ohne zuvor sämtliche Karten laden zu müssen. Dekorative oder anderweitig ungeeignete Medien werden gezählt, kenntlich gemacht und ausgeschlossen. Freigeben berücksichtigt nur vorhandene Vorschläge, manuelles Speichern nur vorhandene Entwürfe. Auf Smartphones zeigt ein kompaktes Dock am unteren Rand die aktive Auswahl. Über Massenaktionen öffnen öffnest du bei Bedarf ein Bottom Sheet mit Aktionsauswahl, Kontingent, erwartetem Verbrauch und Anwenden; es öffnet sich nicht automatisch und blockiert daher nicht die weitere Medienauswahl. Schließen, Escape, der Hintergrund oder Herunterwischen verwerfen keine bestehende Auswahl. Die frühere Direktaktion „Generieren & speichern“ ist bewusst nicht verfügbar, damit ein KI-Text die Prüfung nicht umgehen kann.
• Prüfung: Ein generierter Vorschlag erscheint in einem eigenen bearbeitbaren Bereich mit dem Status Nicht gespeichert; der aktuelle Alt-Text bleibt sichtbar und unverändert. Du kannst den Vorschlag verwerfen oder ausdrücklich Freigeben & speichern. Nicht gespeicherte manuelle Änderungen und Vorschläge bleiben beim Filtern und Nachladen im aktuellen Browser-Tab erhalten; beim Neuladen oder Verlassen der Seite gehen sie nach der Warnung des Browsers verloren.
• Kontingentplanung: Die Sammelaktionsleiste auf größeren Bildschirmen beziehungsweise das mobile Aktions-Sheet zeigt verfügbares KI-Kontingent, ausgewählte Bilder und den erwarteten Verbrauch gemeinsam an. Ist das bekannte Restkontingent kleiner als die Auswahl, bleibt die Generierung gesperrt; das Freigeben von Vorschlägen und das Speichern manueller Änderungen verbrauchen keine Generationen.
• Bild- und Qualitätsprüfung: Öffne ein Vorschaubild oder wähle Bild und Verlauf prüfen, um eine begrenzte Großansicht mit dem aktuellen Alt-Text zu vergleichen. Zurückhaltende Hinweise markieren sehr kurze, dateinamenähnliche, allgemein eingeleitete, doppelte oder ungewöhnlich lange Texte. Sie unterstützen die redaktionelle Prüfung und sind keine automatischen WCAG-Befunde.
• Lokaler Verlauf und Undo: Die letzten zehn gespeicherten Alt-Text-Versionen werden als private Metadaten am Medienanhang gespeichert. Der Detaildialog lädt sie erst beim Öffnen und kann jede Version wiederherstellen. Die Wiederherstellung bleibt umkehrbar, weil der ersetzte aktuelle Wert zum neuesten Verlaufseintrag wird.
• Bildzweck: Über das Drei-Punkte-Menü als dekorativ kennzeichnen oder eine vorhandene Kennzeichnung wieder aufheben. Dekorativ geprüfte Bilder bleiben von Generierung und Sammelauswahl ausgenommen.
• Ablauf: Verarbeitung sequentiell im Browser (kein WordPress-Cron-Job). Eine laufende Fortschrittsmeldung nennt Position und Medium. Nach Abschluss zeigt ein Ergebnisdialog erfolgreiche, fehlgeschlagene und übersprungene Einträge; fehlgeschlagene Einträge können gezielt erneut versucht werden. Tab während großer Batches offen lassen; bei einem Limit endet die Kette kontrolliert und die noch nicht verarbeiteten Einträge werden als übersprungen ausgewiesen.
• Medienauswahl-Regeln gelten wie bei Einzelgenerierung (außer Upload-Ausnahme).

Alt-Text direkt im WordPress-Bildblock generieren

Wähle im Block-Editor den nativen Block Bild (core/image) aus. In der rechten Seitenleiste findest du unter den Blockeinstellungen den Bereich AI Alt Text. Das gilt auch für einzelne Bildblöcke innerhalb einer Galerie.

1. Wähle ein Bild aus der Mediathek und klicke auf Vorschlag generieren.
2. Prüfe und bearbeite den Vorschlag passend zur Verwendung auf dieser Seite.
3. Klicke auf Vorschlag übernehmen und speichere den Beitrag oder das Template. Verwerfen lässt den bisherigen Alt-Text unverändert; über WordPress kannst du eine Übernahme rückgängig machen.

Die Übernahme ändert ausschließlich diesen Bildblock. Der Alt-Text in der Mediathek und andere Verwendungen desselben Bildes bleiben unverändert. Die Funktion folgt dem Hauptschalter von AI Alt Text und den erlaubten Rollen; der Schalter für den Mediathek-Button betrifft weiterhin nur die Mediathek. Jede Generierung nutzt das vorhandene Kontingent sowie die eingestellte Ausgabesprache und Bildauswahl. Bei der Beschränkung auf veröffentlichte Inhalte können Bilder abgelehnt werden, die ausschließlich in Entwürfen vorkommen. Der umgebende Blocktext wird nicht zusätzlich als Seitenkontext übertragen.

Extern verlinkte Bilder benötigen zuerst einen Mediathek-Eintrag. Als dekorativ markierte Bildblöcke und mit Datenquellen verknüpfte Bild- oder Alt-Text-Felder bieten keine Generierung an. Fehler lassen den bisherigen Alt-Text bestehen und erlauben einen erneuten Versuch. Ein Bildwechsel verwirft den bisherigen Vorschlag; bereits gestartete Serveranfragen können trotzdem Kontingent verbrauchen.

Einzelgenerierung in der Mediathek

Der Bereich AI Alt Text startet zugeklappt. Öffne ihn direkt unter dem Alt-Text-Feld; seine Breite folgt dem Textfeld, auch in der Medienauswahl des Blockeditors. Die Option Als dekorativ kennzeichnen zeigt den kurzen Hinweis Gilt für die Mediathek. Die Info-Schaltfläche öffnet die ausführliche Erklärung; mit erneutem Klick oder Escape schließt du sie. Auch der Bereich im nativen Bildblock startet zugeklappt und zeigt Vorschlagsfeld und Übernahmeaktionen erst nach erfolgreicher Generierung.

1. Bild in der Mediathek öffnen (unterstütztes Format).
2. In der Karte direkt unter dem Alt-Text-Feld Vorschlag generieren wählen.
3. Der Vorschlag erscheint zunächst getrennt vom vorhandenen Alt-Text. Du kannst ihn verwerfen, einen weiteren Vorschlag erzeugen oder Vorschlag übernehmen wählen.
4. Erst Vorschlag übernehmen setzt den Wert im Alt-Text-Feld. Prüfe ihn dort erneut und speichere den Anhang.

Ablauf direkt nach einem Einzelbild-Upload

• Vor dem Generieren nachfragen: Die Bildkachel bleibt sichtbar und erhält eine kompakte Karte mit Überspringen und Generieren. Die Karte ist kein zusätzliches Popup. Falls die Kachel noch nicht bereitsteht, erscheint vorübergehend dieselbe Abfrage als schwebende Leiste am unteren Rand.
• Automatisch generieren: Dieselbe Bildkachel zeigt den Ladezustand und anschließend kurz die erfolgreiche Speicherung. Der Alt-Text wird in diesem Modus ohne weitere Bestätigung am Anhang gespeichert.
• Beide Varianten gelten ausschließlich für die Auswahl genau einer Bilddatei. Bei einer Mehrfachauswahl startet kein Upload-Flow.

Was wird technisch übertragen?

• Bild-URL (bzw. Zugriff auf das Bild für die Cloud-Analyse)
• Einstellungen: Sprache, Min/Max-Länge, optional Medien-Felder
• Site-Identifikation über Freemius/Proxy-Auth (kein eigener API-Key in WordPress)

Der Cloud-Proxy lädt Bilder ausschließlich über HTTP/HTTPS, prüft DNS-Ziele und jeden Redirect erneut und lehnt lokale, private oder reservierte Netzwerkadressen ab. Pro Bild gelten maximal 10 MiB; akzeptiert werden nur tatsächlich erkannte JPEG-, PNG-, WebP- und GIF-Dateien. Zertifikatsfehler oder abweichende Dateitypen werden nicht umgangen.

Anwendungsbeispiele

Beispiel 1: Bestand ohne Alt-Texte

Ab Basic: Batch mit Filter „ohne Alt-Text“, KI-Vorschläge generieren, jeden Vorschlag prüfen und anschließend ausdrücklich freigeben und speichern.

Beispiel 2: Neue Uploads (ab Basic)

Upload-Flow mit Nachfrage aktivieren; dekorative Bilder bewusst überspringen, den Alt-Text leer lassen und ihren Zweck anschließend in der Mediathek bestätigen.

Beispiel 3: Mehrsprachigkeit

Feste Sprache wählen, wenn Alt-Texte nicht der WordPress-Admin-Sprache folgen sollen.

Tipps & typische Fehler

• Generierte Texte immer redaktionell prüfen – besonders bei Infografiken, Diagrammen und Markenbildern.
• Datenschutz: „Nur veröffentlichte …“ lassen; erweiterte Mediathek-Option nur mit aktualisierter Datenschutzerklärung.
• Bild in WooCommerce/ACF/Custom Post Types nicht gefunden? → Veröffentlichungs-Prüfung schlägt fehl; erweiterte Option oder manuell Alt-Text setzen.
• Die Kontingentanzeige nennt ausdrücklich den verbleibenden Wert, zum Beispiel „999 von 1000 übrig“. Ist der Dienst nicht erreichbar, wird das statt einer scheinbaren Zahl klar benannt.
• Keine automatische „KI-generiert“-Markierung im HTML – nur der gespeicherte Alt-Text in der Mediathek.

Hinweis: Cloud-Features erfordern Freemius-Opt-In, Kenntnisnahme und aktivierten Hauptschalter. OpenAI o. Ä. laufen über den verwalteten Proxy – kein eigener API-Schlüssel im Plugin.

Wer darf generieren? Free: Administratoren. Ab Basic: konfigurierbare Rollen mit Medien-Upload-Recht. Einstellungen speichern: manage_options.