Die Extension analysiert Bilder im TYPO3-Dateimanager mithilfe einer KI-gestützten Vision API und erstellt daraus beschreibende Alt-Texte. Diese Vorschläge werden direkt im Filelist-Modul des Backends angezeigt und können von Redakteuren übernommen oder angepasst werden. Die Extension ist explizit auf Barrierefreiheit ausgerichtet, nicht auf SEO.

Die Extension unterstützt TYPO3 ab Version 12 (einschließlich TYPO3 v14) und erfordert PHP 8.2. Sie ist im offiziellen TYPO3 Extension Repository (TER) sowie über Packagist installierbar (composer require mfd/ai-filemetadata).

Die Extension selbst ist Open Source und kostenlos. Für die Bildanalyse wird ein API-Key eines OpenAI-kompatiblen Dienstes benötigt, der kostenpflichtig ist. Die Kosten sind jedoch sehr gering: Bei unseren Tests haben wir für 100 Bilder weniger als 1 Euro bezahlt.

Wir nutzen ai_filemetadata auf marketing-factory.de selbst und haben sie im Projekt SEGGER implementiert. Mit fast 20.000 Downloads im TYPO3 Extension Repository wird sie darüber hinaus von einer wachsenden Zahl weiterer TYPO3-Projekte eingesetzt.

Das Barrierefreiheitsstärkungsgesetz (BFSG) setzt die EU-Richtlinie 2019/882 in deutsches Recht um und verpflichtet Betreiber vieler Webseiten und Online-Shops dazu, digitale Angebote barrierefrei zu gestalten. Fehlende oder unzureichende Alt-Texte gelten als Barriere für Menschen mit Sehbeeinträchtigungen und können rechtliche Konsequenzen nach sich ziehen.

Nein. SEO-Alt-Texte enthalten typischerweise Keywords, beschreiben aber nicht den tatsächlichen Bildinhalt. Für die Barrierefreiheit braucht es eine inhaltlich präzise Beschreibung dessen, was das Bild zeigt, damit Screenreader-Nutzer den visuellen Kontext vollständig erfassen können. ai_filemetadata ist explizit auf diese Art von beschreibenden Alt-Texten ausgerichtet.

Die WCAG-Richtlinien unterscheiden zwischen informativen Bildern, die eine inhaltliche Beschreibung benötigen, dekorativen Bildern, bei denen der Alt-Text leer bleiben sollte, und funktionalen Bildern wie Icons oder Buttons, bei denen die Funktion und nicht das Aussehen beschrieben wird. ai_filemetadata ist auf informative Bilder ausgerichtet. Die automatische Erkennung dekorativer Bilder ist als zukünftiges Feature geplant.

Mehr dazu in unserem Blogbeitrag: BFSG: Was ist der richtige Alt-Text für welche Bilder?

Standardmäßig wird die OpenAI Vision API mit dem Modell gpt-4o-mini genutzt. Die Extension ist jedoch so konfigurierbar, dass sie mit jeder OpenAI-kompatiblen API-Schnittstelle funktioniert, zum Beispiel mit dem AI-Hosting von Mittwald oder anderen selbst gehosteten Modellen.

Ja. ai_filemetadata unterstützt alle aktiven Sprachen einer TYPO3-Instanz. Die Alt-Texte werden für jede konfigurierte Sprache separat generiert. Über ein Sprach-Mapping in der system/settings.php lässt sich zusätzlich steuern, welche Sprachen für bestimmte Ordner gelten sollen.

Ja. Der Prompt, der an das KI-Modell gesendet wird, lässt sich in der Extension-Konfiguration unter "Alt Text Prompt" individuell anpassen, zum Beispiel für eine spezifische Tonalität oder abweichende Längenvorgaben. Die Konfiguration erfolgt unter Admin Tools > Settings > Extension Configuration.

Nicht zwingend. Die Extension bietet eine optionale Bildverkleinerung vor der Übermittlung. Da für die Bildanalyse eine Auflösung von 512x512 Pixeln in den meisten Fällen vollständig ausreicht, lässt sich damit die Anzahl der verarbeiteten Tokens und damit die API-Kosten deutlich reduzieren.

Hinweis: Die Verkleinerung erfolgt zur Laufzeit durch TYPO3. Bei großen Bildbestandän oder hochauflösenden Originaldateien kann das zu einer spürbar längeren Verarbeitungszeit und höherer Serverlast führen. Es empfiehlt sich daher, diese Option zunächst mit einer begrenzten Anzahl von Bildern zu testen, bevor sie produktiv eingesetzt wird.

Ja. Die Extension bietet einen CLI Command, mit dem Alt-Texte für einen bestimmten Ordner in einem Batch-Prozess generiert werden können:

bin/typo3 ai:generate-alt-texts --path="1:mein-ordner/" [--overwrite] [--limit=1]

Der optionale Parameter --overwrite überschreibt bereits vorhandene Alt-Texte, --limit begrenzt die Anzahl der verarbeiteten Bilder pro Aufruf. Das ist besonders praktisch beim initialen Einsatz auf Webseiten mit einem großen Bildbestand.

Ja. Über die system/settings.php lassen sich gezielt Ordnerpfade von der Verarbeitung ausschließen. Das ist sinnvoll für Verzeichnisse mit sensiblen Inhalten oder Bildern, deren Lizenz eine Verarbeitung durch externe KI-Dienste nicht erlaubt.

Die Bilder werden zur Analyse an den konfigurierten externen API-Dienst übermittelt. Vor dem Einsatz sollte daher geprüft werden, ob die Bildübermittlung mit der eigenen Datenschutzrichtlinie vereinbar ist. Gleiches gilt für Bildlizenzen: Manche Lizenzmodelle schließen die Verarbeitung durch KI-Dienste ausdrücklich aus.

Ja. Die Extension erzeugt Vorschläge, keine finalen Texte. Alle generierten Alt-Texte können jederzeit im TYPO3-Backend überschrieben werden. Der redaktionelle Prozess bleibt vollständig in der Hand des Teams.

ai_filemetadata ist ein Open-Source-Projekt, und Beiträge sind ausdrücklich willkommen. Der gesamte Quellcode liegt auf GitHub. Neue Ideen, Fehlermeldungen und Feature-Anfragen können über den Issue-Tracker eingereicht werden. Für kommerzielle Unterstützung oder individuelle Erweiterungen stehen wir gerne direkt zur Verfügung.

Das ist die typische Ausgangssituation: ein gewachsener Bildbestand, tausende Dateien, kaum oder keine Alt-Texte. Hier empfiehlt sich ein zweistufiges Vorgehen.

Schritt 1: Erstbestand per CLI aufarbeiten. Mit dem CLI Command der Extension lassen sich alle Bilder eines Ordners in einem Batch-Prozess automatisch mit Alt-Texten versehen:

bin/typo3 ai:generate-alt-texts --path="1:mein-ordner/"

Das lässt sich schrittweise, Ordner für Ordner, durchführen und so an die verfügbaren Ressourcen anpassen.

Schritt 2: Nachhaltigen Redaktionsprozess etablieren. Damit neue Bilder dauerhaft korrekt gepflegt werden, braucht es mehr als ein Tool. Wir helfen dabei, einen Redaktionsprozess in TYPO3 aufzubauen, der sicherstellt, dass Alt-Texte künftig systematisch geprüft und freigegeben werden, zum Beispiel über Workflow-Mechanismen im TYPO3-Backend.