Ab Version 1.3.0 generiert Alt-Text Optimizer Pro Alt-Texte in beliebig vielen Shop-Sprachen – zum Beispiel Deutsch, Französisch und Spanisch in einem einzigen Durchgang. Jede Sprache bekommt ihren eigenen Text, und dein Shop liefert Besuchern automatisch den passenden aus.

Du betreibst einen einsprachigen Shop? Dann musst du hier nichts tun. Ohne konfigurierte Zielsprachen verhält sich das Plugin genau wie bisher: ein Alt-Text in der Shop-Standardsprache. Bestehende Installationen laufen nach dem Update unverändert weiter.

Wie die Texte gespeichert werden

Die Alt-Texte landen als Medien-Übersetzungen in Shopware (media_translation) – also genau dort, wo Shopware auch sonst übersetzte Inhalte ablegt. Das hat zwei angenehme Folgen:

Jede Sprache behält ihren eigenen Alt-Text. Der französische Text überschreibt nicht den deutschen.
Das Storefront wählt automatisch den Text zur Sprache, in der ein Besucher gerade unterwegs ist – ohne dass du irgendetwas einrichten musst.

Zielsprachen festlegen

Die Auswahl findest du unter Einstellungen → Erweiterungen → Alt-Text Optimizer Pro in der Karte „Bildanalyse Einstellungen“:

Zielsprachen – die Shop-Sprachen, in denen generiert werden soll. Die Auswahl gilt als Standard für alle Wege: Einzel-Generierung, Browser-Läufe, Hintergrund-Läufe und die nächtliche automatische Generierung.
Generierungsmodus – wie das Plugin bei mehreren Zielsprachen mit der OpenAI-API spricht (siehe unten).

Unterstützt werden alle Shop-Sprachen, nicht nur ein fester Katalog – also auch Polnisch, Schwedisch oder Tschechisch. Den Sprachnamen für die KI ermittelt das Plugin automatisch aus der Locale der jeweiligen Sprache.

„Standardsprache“ meint immer die Shop-Standardsprache, also die Systemsprache deines Shops – nicht die Sprache, in der die Administration für dich angezeigt wird. Ein französischsprachiger Admin-Benutzer in einem deutschen Shop erzeugt standardmäßig also deutsche Alt-Texte. Das Modul zeigt die konkrete Sprache immer mit an (z. B. „Shop-Standardsprache (de-DE)“).

Generierungsmodi

Modus	Funktionsweise	Wann sinnvoll
Eine Anfrage pro Bild (Standard)	Ein einziger Vision-Aufruf pro Bild; die KI liefert alle gewählten Sprachen in einer strukturierten Antwort zurück. Deutlich günstiger.	Der Normalfall – große Mediatheken, Fokus auf Kosten
Eine Anfrage pro Bild und Sprache	Ein eigener Aufruf je Bild und Sprache mit sprachspezifischem Prompt. Fehler und Wiederholungen wirken pro Sprache.	Maximale Textqualität je Sprache, gezieltes Nachgenerieren

Bei genau einer Zielsprache verhalten sich beide Modi identisch – es gibt dann ohnehin nur einen Aufruf mit sprachspezifischem Prompt.

Schlägt im Modus „Eine Anfrage pro Bild“ eine einzelne Sprache fehl (etwa weil ein Schlüssel in der KI-Antwort fehlt), werden die erfolgreichen Sprachen trotzdem gespeichert. Nur die fehlgeschlagene Sprache wird als Fehler protokolliert – ein Bild ist also nie „ganz oder gar nicht“ erledigt.

Zu den Kosten: Jede zusätzliche Sprache erhöht die API-Kosten. Im Modus „Eine Anfrage pro Bild“ nur moderat (es kommen ein paar Antwort-Tokens dazu), im Modus „Eine Anfrage pro Bild und Sprache“ linear – drei Sprachen bedeuten dort drei Anfragen pro Bild.

Vorhandene Alt-Texte schützen

Die Option „Vorhandene Alt-Texte überspringen“ (Standard: aktiv) sorgt dafür, dass pro Bild nur in den Sprachen generiert wird, in denen noch kein Text existiert. Vorhandene Texte – auch von Hand gepflegte – werden nie überschrieben, und du zahlst keine API-Kosten für Arbeit, die längst erledigt ist. Übersprungene Sprachen erscheinen im Ergebnis transparent als „bereits vorhanden“.

Bewusst überschreiben kannst du weiterhin: Der Modus „Neu generieren“ – im Reiter „KI-generiert“ oder über die Einzelaktion „Neu generieren“ – ignoriert die Option und erzeugt die gewählten Sprachen neu. Die Generierungsseite sagt dir vor dem Start immer, welches Verhalten gerade aktiv ist.

Anwendungsfall: neue Shop-Sprache nachrüsten

Der häufigste Fall aus der Praxis: Deine Alt-Texte stehen bereits in der Shop-Standardsprache, jetzt launcht der Shop zusätzlich auf Französisch – und nur die neue Sprache soll dazukommen, ohne die bestehenden Texte anzufassen.

So gehst du sicher vor:

Die neue Sprache im Shop anlegen und in den Plugin-Einstellungen unter „Zielsprachen“ ergänzen (also z. B. Deutsch und Französisch).
Prüfen, dass „Vorhandene Alt-Texte überspringen“ aktiviert ist (Standard).
Im Reiter „Sprache fehlt“ (so heißt „Ohne Alt-Text“ in Mehrsprach-Shops) erscheinen jetzt alle Bilder, denen in der neuen Sprache der Text fehlt – auch die, die in der Standardsprache längst einen haben. Die Spalte „Sprachen“ zeigt die fehlende Sprache als rotes Badge.
„Alle generieren“ oder „Im Hintergrund generieren“ starten. Pro Bild wird nur in den fehlenden Sprachen generiert; die bestehenden Texte werden weder überschrieben noch verursachen sie Kosten und tauchen im Protokoll als „bereits vorhanden“ auf.

Optional kannst du über den Sprachfilter gezielt nur die neue Sprache auswählen – das Ergebnis ist dasselbe.

Nutze für diesen Fall nicht den Reiter „KI-generiert“ mit „Alle neu generieren“. Das ist der bewusste Überschreib-Pfad: Er erzeugt alle gewählten Sprachen neu – inklusive der Texte, die du behalten wolltest.

Kindsprachen: Text der Elternsprache übernehmen

Kindsprachen wie „Deutsch (Schweiz)“ mit der Elternsprache Deutsch würden normalerweise einen praktisch identischen Text noch einmal kostenpflichtig erzeugen. Mit der Option „Kindsprachen: Text der Elternsprache übernehmen“ wird der Text der Elternsprache stattdessen einfach kopiert – ohne API-Kosten. Im Protokoll steht das Ergebnis dann als „übernommen“.

Hat die Elternsprache (noch) keinen Text, wird die Kindsprache normal generiert bzw. als Fehler ausgewiesen.

Geschützte Begriffe

Unter „Geschützte Begriffe (nicht übersetzen)“ hinterlegst du kommagetrennt deine Marken- und Produktnamen – zum Beispiel AquaFlex Pro, SoftTouch. Die KI wird angewiesen, diese Begriffe in allen Sprachen unverändert zu übernehmen. So wird aus „AquaFlex Pro“ im französischen Alt-Text nicht plötzlich eine übersetzte Fantasie-Variante.

Produktkontext in der richtigen Sprache

Ist „Produktname einbeziehen“ aktiv, bekommt die KI Produktname und -beschreibung in der jeweiligen Zielsprache. Existiert für eine Sprache keine Übersetzung, greift automatisch der Text der Shop-Standardsprache – es wird also nie ohne Kontext generiert. Dadurch landet deine lokalisierte Produktterminologie auch im passenden Alt-Text.

Sprachabdeckung im Admin

Im Modul (Inhalte → Alt-Text Optimizer Pro) zeigt dir die Karte „Sprachabdeckung“ je Sprache – bezogen auf alle unterstützten Bilder der gesamten Mediathek, unabhängig von Ordnern:

wie viele Bilder in dieser Sprache schon einen Alt-Text haben,
wie viele noch fehlen,
und den Fortschritt als Balken.

Ein Klick auf eine Zeile filtert die Liste direkt nach genau dieser Sprache.

Sprach-Features in Mehrsprach-Shops

Sobald dein Shop mehr als eine Sprache hat, zeigt das Modul Sprachinformationen – und zwar unabhängig davon, ob du Zielsprachen konfiguriert hast:

Der Reiter „Ohne Alt-Text“ heißt dann „Sprache fehlt“. Die gelisteten Bilder haben in mindestens einer Sprache noch keinen Alt-Text, können in anderen aber längst einen besitzen.
Die Spalte „Sprachen“ zeigt pro Bild farbige Badges: rot = Alt-Text fehlt in dieser Sprache, grün = vorhanden (mit Tooltip). Welche Sprachen betrachtet werden, folgt einer festen Reihenfolge: aktive Filterauswahl → konfigurierte Zielsprachen → alle Shop-Sprachen.
Der Sprachfilter listet immer alle Shop-Sprachen. Mit gewählter Sprache siehst du gezielt die Bilder, denen genau in dieser Sprache der Text fehlt – das funktioniert auch ohne konfigurierte Zielsprachen.
Die ungefilterte Ansicht bedeutet je nach Konfiguration Unterschiedliches, und der Filter benennt das explizit: Mit Zielsprachen heißt die Standardoption „Alle Zielsprachen“ (fehlt in mindestens einer Zielsprache), ohne Zielsprachen „Shop-Standardsprache (z. B. de-DE)“ (fehlt in der Standardsprache).

Im Reiter „KI-generiert“ stehen alle vorhandenen Alt-Texte eines Bildes pro Sprache untereinander, jeweils mit Sprachkürzel davor. Auch hier gibt es einen Sprachfilter: Er zeigt nur Bilder, die in der gewählten Sprache bereits einen Text haben – die Spalte zeigt dann genau diesen Text.

Das Entfernen von KI-Alt-Texten betrifft immer alle Sprachen, in denen das Plugin generiert hat – der Bestätigungsdialog weist darauf hin. Von Hand gepflegte Texte bleiben dabei unberührt.

Was heißt eigentlich „fehlend“?

Ein Alt-Text gilt in einer Sprache als fehlend, wenn für diese Sprache keine eigene Übersetzungszeile mit Text existiert.

Die Sprachvererbung von Shopware – eine Kindsprache wie „Deutsch (Schweiz)“ erbt zur Laufzeit die Texte ihrer Elternsprache – wird dabei bewusst nicht berücksichtigt. Sonst könnten Kindsprachen nie eigene Alt-Texte bekommen. Für SEO und Barrierefreiheit zählt der explizit gepflegte Text pro Sprache.

Technische Hinweise

Diesen Abschnitt brauchst du für die normale Nutzung nicht – er ist für Entwickler und Agenturen gedacht.

Gespeichert wird über die Shopware-DAL als translations-Payload. Es gibt keine direkten SQL-Schreibzugriffe auf Core-Tabellen.
Läufe speichern ihre Zielsprachen im Feld language_ids (JSON) der Tabelle viove_alttext_run. Bestandsläufe ohne Sprachen gelten als Läufe in der Shop-Standardsprache.
Teilen sich zwei Shop-Sprachen dieselbe Locale (z. B. zwei Varianten mit de-DE), wird der Text einmal generiert und beiden Sprachen zugewiesen.
Die Längenlimits (min./max. Zeichen) zählen echte Zeichen und sind multibyte-sicher – auch bei Akzenten und nicht-lateinischen Schriften.
Die Plugin-Einstellungen sind zwar pro Verkaufskanal speicherbar, die Läufe im Admin-Modul arbeiten jedoch global (ohne Verkaufskanal-Kontext). Maßgeblich ist dort die globale Konfiguration.

Wie du große Mengen entspannt im Hintergrund abarbeitest und Läufe nachträglich nachvollziehst, zeigt das nächste Kapitel: Hintergrund- & geplante Läufe.