English Version

Zurück zur Übersicht

Sylius Media Alt Text: Fehlerbehebung

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Der Menüeintrag fehlt im Admin

• Symptom: In der Sidebar gibt es unter „MMKreativ Plugins“ keinen Eintrag „Bild-Alt-Texte“.
• Prüfen: Existiert config/routes/mmd_sylius_media_alt_text.yaml? Der Setup-Befehl meldet einen fehlenden Import.
• Lösung: Route importieren (siehe Installation) und den Cache leeren. Ohne die Route lässt das Plugin den Eintrag weg, statt die Sidebar zu zerstören.

Die Alt-Text-Felder fehlen im Bildformular

• Symptom: Im Produkt-, Kategorie- oder Avatar-Formular erscheint kein Editor.
• Prüfen: Ist „Alt-Texte ausgeben“ in den Einstellungen eingeschaltet? Wurde mmd:media-alt-text:setup ausgeführt (fehlt die Tabelle, behandelt das Plugin die Ausgabe als ausgeschaltet und schreibt eine Warnung ins Log)?
• Lösung: Setup-Befehl ausführen und Schalter einschalten.

Die Storefront zeigt weiter den Produktnamen

• Symptom: Trotz gepflegtem Text steht im alt-Attribut der Name.
• Prüfen:
  1. Ist die Ausgabe eingeschaltet?
  2. Gibt es den Text in der angezeigten Sprache oder der Standardsprache? Eine dritte Sprache wird nicht verwendet.
  3. Überschreibt Dein Theme das Template unter templates/bundles/SyliusShopBundle? Dann gewinnt Dein Template.
• Lösung: Im eigenen Template mmd_image_alt(image, fallback) verwenden (siehe Storefront).

Die Admin API antwortet mit 422

• Symptom: PUT oder Upload mit altTexts scheitert.
• Prüfen: Ist jede Sprache im Shop aktiviert, jeder Text höchstens 255 Zeichen lang, altTexts ein Objekt mit String-Werten und decorative ein Boolean?
• Lösung: Anfrage korrigieren. Es wird nichts teilweise gespeichert.

Nach dem Update stimmen die Tabellen nicht

• Symptom: Fehler wegen fehlender Tabellen oder Spalten.
• Lösung: bin/console mmd:media-alt-text:setup erneut ausführen. Meldet er offene Sylius-Migrationen, zuerst doctrine:migrations:migrate.

Bekannte Einschränkungen

• Datenbank: Nur MySQL und MariaDB, die Migrationen verweigern andere Plattformen.
• Viele Bilder pro Seite: Der Alt-Text eines Bildes wird mit einer Abfrage gelesen und für die Anfrage gemerkt. Eine Shop-API-Liste mit vielen Bildern kostet eine Abfrage pro Bild.
• Dekorative Bilder in Links: Die Produktgalerie bekommt dafür ein aria-label mit dem Produktnamen.
• Weitere Bildtypen: Es gibt kein Tag, nur den Überschreib-Weg über die Registry (siehe Erweiterbarkeit).
• Erkennung dekorativer Bilder: Ein Bild gilt als dekorativ, sobald eine seiner Zeilen so markiert ist.

FAQ

Macht das Plugin meinen Shop BFSG-konform? Nein. Es liefert das fehlende Alt-Text-Feld, der Rest des Shops braucht ein eigenes Audit.

Gehen Texte verloren, wenn ich die Ausgabe ausschalte? Nein, sie bleiben gespeichert.

Gilt die Einstellung pro Channel? Nein, sie gilt für den ganzen Shop.

Kann ich Texte per Skript setzen? Ja, über die Admin API oder für einen ersten Stand mit dem Backfill-Befehl.