Produktbild-Upscaler

Konfigurationsanleitung: Produktbild-Upscaler

Voraussetzungen

• Shopware 6.7
• PHP-Extension GD (Pflicht). Imagick ist optional und wird empfohlen, weil es schärfere Kanten liefert.
• Ein laufender Message-Queue-Worker. Neue Uploads und Aufträge über die Warteschlange werden im Hintergrund verarbeitet.

Die Konfiguration finden Sie unter Erweiterungen → Meine Erweiterungen → Produktbild-Upscaler → Konfigurieren. Alle Einstellungen gelten shopweit. Eine Auswahl pro Verkaufskanal hat keine Wirkung.

Empfohlene erste Schritte

1. Unter Zielgröße die Mindestkante prüfen. Der Standardwert von 500 px erfüllt die Anforderung von Google Shopping.
2. Speichern.
3. In der Kachel Bestand verarbeiten auf „Alle Produktbilder hochskalieren“ klicken. Das Browserfenster muss während des Laufs geöffnet bleiben.
4. Ab jetzt werden neu zugewiesene Produktbilder automatisch verarbeitet.

Die Originalbilder werden dabei nie verändert. Das Plugin legt Kopien an und stellt nur die Produktzuordnung auf die größere Fassung um.

Die Einstellungen im Einzelnen

Bestand verarbeiten

Zeigt den aktuellen Stand: noch zu kleine Bilder, bereits verarbeitete Bilder, das aktive Verfahren. Bietet je nach Lage die passenden Aktionen an:

• Alle Produktbilder hochskalieren – Verarbeitet alle zu kleinen Produktbilder blockweise. Der Lauf lässt sich jederzeit abbrechen.
• In die Warteschlange stellen – Wie oben, aber über den Worker im Hintergrund. Das Fenster muss nicht geöffnet bleiben.
• Auf neue Mindestkante erneuern – Erscheint, wenn Sie die Mindestkante erhöht haben. Rendert betroffene Kopien neu aus dem unveränderten Original.
• Vorhandene Bilder wieder verlinken – Hängt bereits erzeugte Kopien wieder an die Produkte, ohne sie neu zu berechnen.
• Zurücksetzen – Hängt die Produkte zurück auf die Originale. Die Kopien bleiben erhalten.
• Verwaiste Bilder zurücksetzen – Für Sonderfälle, etwa nach einem Datenbank-Umzug: Kopien ohne gespeicherte Zuordnung werden über den Dateinamen ihrem Original zugeordnet. Mit „Vorschau anzeigen“ prüfen Sie vorher, was passiert.

Bildquelle

Originalbilder als Produktbilder verwenden (Standard: aus)
Hängt beim Speichern alle Produkte zurück auf die Originale. Gelöscht wird nichts: Entfernen Sie den Haken, werden die Kopien wieder angehängt. Solange der Haken gesetzt ist, verarbeitet das Plugin keine neuen Uploads.

Zielgröße

Mindestkante in Pixeln (Standard: 500)
Bilder werden so vergrößert, dass die kürzere Kante diesen Wert erreicht. Das Seitenverhältnis bleibt erhalten: Aus 400 × 365 wird 548 × 500, nicht 500 × 500.

Maximaler Skalierungsfaktor (Standard: 4,0)
Bilder, die stärker vergrößert werden müssten, werden übersprungen und protokolliert. Das schützt vor sichtbarem Qualitätsverlust.

Maximales Seitenverhältnis (Standard: 3,0, also 3:1)
Überspringt sehr lange oder schmale Bilder, etwa Maßzeichnungen oder Streifen mit dem Lieferumfang. Sie hängen zwar am Produkt, sind aber keine Produktfotos.

Bildverarbeitung

Verfahren (Standard: Automatisch)
„Automatisch“ wählt das beste verfügbare Verfahren: Imagick, sofern installiert, sonst GD. „ImageMagick erzwingen“ oder „GD erzwingen“ brauchen Sie nur in Ausnahmefällen.

Nachschärfung (Standard: 0,35)
Von 0,0 (aus) bis 1,0 (Maximum). Bei stark komprimierten Ausgangsbildern verstärken hohe Werte auch JPEG-Artefakte.

JPEG-Qualität (Standard: 90) und WebP-Qualität (Standard: 90)
Von 1 bis 100, gilt nur für die erzeugten Kopien. Für Produktbilder sind 85 bis 92 ein guter Bereich.

Automatik

Neu hochgeladene Produktbilder automatisch verarbeiten (Standard: an)
Zu kleine Bilder werden beim Zuweisen an ein Produkt in die Warteschlange gestellt. Der Upload selbst wird dadurch nicht langsamer.

Verarbeitung stoppen

„Verarbeitung stoppen und Queue abbrechen“ sperrt neue Aufträge und entfernt die wartenden Aufträge dieses Plugins. Andere Shopware-Aufträge bleiben unberührt. Eine Bildverarbeitung, die gerade läuft, wird noch sicher beendet. Lassen Sie die Seite bis zur Erfolgsmeldung geöffnet. Bilder und Produktzuordnungen werden dabei nicht verändert.

Mit „Verarbeitung wieder freigeben“ heben Sie die Sperre auf. Verworfene Aufträge kommen dabei nicht zurück; stellen Sie sie bei Bedarf neu ein.

Deaktivieren und Deinstallieren

• Deaktivieren und Deinstallieren verändern keine Produktbilder. Produkte mit hochskalierter Kopie behalten sie.
• Sollen die Produkte vorher wieder die Originale zeigen: Aktivieren Sie unter Bildquelle „Originalbilder als Produktbilder verwenden“ und warten Sie, bis alle Zuordnungen umgehängt sind.
• Vor dem Deaktivieren empfiehlt sich „Verarbeitung stoppen“, damit keine Aufträge dieses Plugins in der Queue zurückbleiben.
• Deinstallieren mit „Alle Daten löschen“ entfernt die Zuordnungstabelle, die Plugin-Einstellungen, den Medien-Tag webla-upscaled und die Medienordner des Plugins. Die Kopien wandern in den übergeordneten Ordner und bleiben als Produktbilder im Einsatz. Die Originale hängen danach an keinem Produkt mehr und gelten für media:delete-unused als ungenutzt.

Benutzerrechte

• Status ansehen – Produkte lesen, Medien lesen
• Hochskalieren – Produkte bearbeiten, Medien erstellen
• Zurücksetzen – Produkte bearbeiten
• Erneuern, Kopien löschen – zusätzlich Medien löschen

Konsolenbefehle

Für große Bestände oder Automatisierung per Cronjob:

• bin/console webla:upscale:scan – Zeigt, welche Produktbilder zu klein sind, und ändert nichts. --details listet jedes Bild, --min-edge= prüft einen anderen Wert.
• bin/console webla:upscale:run – Skaliert zu kleine Bilder hoch, standardmäßig über die Queue. --sync verarbeitet sofort, --limit= begrenzt die Anzahl, --dry-run zeigt nur an, --refresh erneuert Kopien unter der aktuellen Mindestkante, --media-id= verarbeitet einzelne Bilder.
• bin/console webla:upscale:status – Zeigt den aktuellen Stand.
• bin/console webla:upscale:revert – Hängt alle Produkte zurück auf die Originale. --limit= für einen Probelauf, --delete löscht zusätzlich die Kopien (mit Rückfrage; --force überspringt sie).
• bin/console webla:upscale:processing [status|stop|resume] – Zeigt, stoppt oder gibt die Verarbeitung frei, ohne Bilder zu löschen.
• bin/console webla:upscale:repair-orphans – Setzt verwaiste Kopien zurück. --dry-run zeigt nur an, --queue verarbeitet über die Warteschlange.

Protokoll

Das Plugin schreibt in eine eigene Logdatei: var/log/webla_image_upscaler_.log. In der Produktivumgebung werden nur Warnungen und Fehler protokolliert, zum Beispiel übersprungene Bilder. Erfolgsmeldungen je Bild erscheinen nur in der Entwicklungsumgebung.