CDN Product Images: Fehlerbehebung

Bekannte Probleme, Einschränkungen und FAQ zum Sylius-Plugin CDN Product Images.

CDN Product Images: Fehlerbehebung

Diese Dokumentation bezieht sich immer auf die aktuellste veroeffentlichte Version.

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Häufige Probleme

Symptom: Der Admin-Sidebar-Eintrag "CDN Integration" fehlt komplett.
Check: Sind die Admin-Routen des Plugins importiert (config/routes/mmd_sylius_cdn_product_images.yaml)?
Lösung: Routen-Import gemäß Installation ergänzen und den Cache leeren - ohne Import degradiert das Plugin bewusst zu "Menüeintrag fehlt" statt die komplette Admin-Sidebar mit einem Fehler zu blockieren.

Symptom: Das CDN-Bild-Feld erscheint bei Taxon-Bildern, aber nicht bei Produktbildern.
Check: Wurde das Template templates/bundles/SyliusAdminBundle/product/form/sections/media/images.html.twig in der eigenen App angelegt?
Lösung: Override gemäß Installation einfügen - Sylius' Produktbild-Template hat (im Gegensatz zum Taxon-Bild-Template) keinen Hook-Punkt, den das Plugin selbst bedienen könnte.

Symptom: Ein eingetragenes CDN-Bild wird angezeigt, aber immer in Originalgröße statt zugeschnitten.
Check: Liegt die URL wirklich auf der konfigurierten CDN-Domain, und wurde sie ursprünglich als mm-media-cdn-"original"-URL erzeugt?
Lösung: Nur eine solche URL wird erkannt und neu signiert; eine URL mit fremdem Host oder einem bereits anderen Preset wird bewusst unverändert durchgereicht.

Symptom: Die Einstellungsseite "CDN Integration" liefert HTTP 500.
Check: Wurden einzelne Routen des Plugins händisch kopiert statt die komplette admin.yaml zu importieren - fehlt dadurch die Route zum Entfernen des Tokens?
Lösung: Admin-Routen vollständig importieren statt einzelne Routen zu kopieren (siehe Installation).

Symptom: Ein Formular-POST mit dem Feld clearToken entfernt das gespeicherte Token nicht mehr.
Check: Stammt der Request von einem älteren Skript oder Behat-Szenario, das noch eine inzwischen entfernte Checkbox simuliert?
Lösung: Den dedizierten "Remove token"-Button (bzw. dessen eigene Route) verwenden - das Feld wird absichtlich ignoriert.

Symptom: Nach einer Rotation des eigenen APP_SECRET werden CDN-Bilder plötzlich nicht mehr signiert.
Check: Zeigt die Einstellungsseite den Hinweis, dass ein Token gespeichert, aber nicht mehr entschlüsselbar ist?
Lösung: Erwartetes Verhalten. Über "Remove token" entfernen und das Token einmal neu eintragen.

Symptom: POST /api/v2/admin/products/{code}/images mit cdnUrl antwortet mit HTTP 400.
Check: Wurde zusätzlich file oder productVariants gesendet, oder ist die URL keine gültige http(s)-URL mit höchstens 255 Zeichen?
Lösung: Entweder file oder cdnUrl senden, und productVariants nicht zusammen mit cdnUrl verwenden. Details unter Admin API.

Bekannte Einschränkungen

Nur die Neuanlage eines Produkt- oder Taxon-Bildes unterstützt eine CDN-URL, über das Admin-Formular ebenso wie über die Admin API. Ein bereits lokal hochgeladenes Bild lässt sich über das Bearbeiten-Formular noch nicht auf CDN-Modus umstellen.
Per Admin API ist productVariants zusammen mit cdnUrl nicht möglich, und cdnUrl fehlt noch in der OpenAPI-Dokumentation.
Keine Erreichbarkeits-Prüfung der eingetragenen URL beim Speichern.
Das Produktbild-Feld braucht einmalig einen Template-Override in der konsumierenden App (siehe Installation) - bei Taxon-Bildern ist das nicht nötig.
Noch keine Integrationstest-Suite gegen eine echte, bootbare Sylius-Anwendung; die CI führt ausschließlich die Unit-Suite aus.

FAQ

Allgemein

Kann ich CDN-Bilder und lokale Uploads gleichzeitig verwenden? Ja, pro Bild einzeln - die Erkennung erfolgt rein am Pfad-Präfix http(s)://.
Was passiert mit einer URL, die nicht von mm-media-cdn stammt? Sie wird unverändert durchgereicht, ohne Fehler, aber ohne kontextgenaues Resizing.

Konfiguration

Muss ich etwas in config/packages/ eintragen? Nein, die Konfiguration erfolgt vollständig über die Sylius-Admin-Oberfläche.
Was passiert, wenn ich das Signing-Token-Feld leer lasse und speichere? Das aktuell gespeicherte Token bleibt unverändert - zum Entfernen den dedizierten Button nutzen.

Kompatibilität

Funktioniert das Plugin auch ohne Shop-API? Ja - die API-Dekoration wird nur aktiv, wenn SyliusApiBundle registriert ist, alles andere läuft unabhängig davon.