Bildkonverter
Der Bildkonverter ist ein Tool, mit dessen Hilfe große Mengen an Bildern (Produktbilder, Kategoriebilder, Startseitenbanner etc.) automatisiert in verschiedene Formate/Größen konvertiert werden. Dabei können optimale Komprimierungen, Größen und Formate gewählt werden, die schnelle Ladezeiten ermöglichen und somit eine hohe Shop-Performance fördern.
Inhalt
Konfiguration und Nutzung des Dienstes
Erweiterung zur Unterstützung des Bildformates webp für Produktbilder
Besonderheiten in Verbindung mit dem Warenwirtschaftssystem VS/4
Zentrale Speicherung
Der Bildkonverter speichert die umgewandelten Produktbilder im Medien-Verzeichnis des Shops. Für jede Größenklasse, in der ein Bild erzeugt werden soll (gross, klein, mini und normal), definieren Sie in der Bildkonverter-Konfiguration wsimageconvert.cfg das gewünschte Unterverzeichnis. Durch diese Aufteilung kann ein konvertiertes Bild in allen Verzeichnissen mit dem gleichen Dateinamen abgelegt werden. Auch dies trägt zum hohen Automatisierungsgrad im Shop bei.
Sämtliche im Medien-Verzeichnis gespeicherte Produktbilder können in jedem Subshop verwendet werden.
Upload der Quellbilder
Damit verschiedene Stellen, z.B. auch Dienstleister des Shopbetreibers, unabhängig voneinander Bilder für den Shop bereitstellen können, werden die zu konvertierenden Bilder per SFTP in das Quellverzeichnis des Konverters geladen (auto-konvertierung/quellbilder). Innerhalb des Verzeichnisses können Unterverzeichnisse angelegt werden.
Für die Unterverzeichnisse können dann wieder in der Bildkonverter-Konfigurationsdatei wsimageconvert.cfg entsprechende Regeln für Komprimierung, Qualität, Zielverzeichnis für die Speicherung etc. definiert werden. Somit können alle Bild-Gruppen/BilderIhrem Einsatzzweck entsprechend verwaltet und bearbeitet werden.
Jeder Zugriffsberechtigte kann nach Abschluss des Hochladens im Servicebereich die Konvertierung starten und den Fortschritt und Erfolg prüfen.
Format und Abmessungen der Quellbilder
Die Quellbilder sollten am besten im Original vorliegen, um nach der Komprimierung und Konvertierung das bestmögliche Ergebnis ohne Qualitätsverluste zu erhalten.
Der WEBSALE Bildkonverter basiert auf den Softwarepaketen ImageMagick und cwebp, d. h. grundsätzlich werden alle Bildformate unterstützt, die von diesen Softwarepaketen unterstützt werden.
Die Groß-/Kleinschreibung der Dateinamen wird 1:1 für alle in den verschiedenen Bildgrößen erzeugten Bilder übernommen. Sie muss genau mit der Schreibweise der Bildnamen übereinstimmen, die bei den Produktdaten im Shop eingepflegt sind.
Konvertierung
Der Service "Bildkonverter" wird, wenn er nach der Beauftragung mit Ihren Bildgrößen vorkonfiguriert ist, im Online-Servicebereich der für die Bilder zuständigen Person oder Arbeitsgruppe angezeigt. Dort werden die konfigurierten Zielformate sowie deren Zielverzeichnisse aufgelistet. Ebenfalls wird, sofern Bilder für die Konvertierung hochgeladen wurden, die Anzahl der zu konvertierenden Quellbilder angezeigt.
Mit "Konvertierung starten" wird die Erzeugung der verschiedenen Bildgrößen gestartet. Mit "Abbrechen" kann der Lauf vorzeitig beendet werden.
Voreinstellungen, Konvertierungslaufzeit und Qualitätsergebnisse
Der Service "Bildkonverter" wird mit Voreinstellungen bereitgestellt, die Bilder erzeugen die einen guten Kompromiss zwischen a) möglichst kleinen Dateigrößen, b) möglichst guter Qualität und c) schneller Konvertierungslaufzeit darstellen.
Konvertierungsdauer: Der Bildkonverter kann in der Regel in Sekunden aus einem großformatigen Quellbild mehrere verkleinerte Zielbilder erzeugen. Die Konvertierungsdauer ist aber maßgeblich von den gewünschten Konvertierungseinstellungen pro Bild abhängig, z. B. Schärfungswert (-sharpen), Qualität (-quality) etc.
Konvertierungsqualität: Wir empfehlen eine mittlere Kompression zwischen "-quality 70" und "-quality 80". Die optimale Qualität für Ihre Bilder kann durch Tests ermittelt und entsprechend angepasst werden.
Statistik
Nach dem Abschluss der Konvertierung oder Abbruch durch den Benutzer wird eine Statistik angezeigt:
1. Anzahl der korrekt konvertierten Dateien
2. Anzahl der fehlerhaften Quelldateien
3. Anzahl der Dateien, die noch unkonvertiert im Quellverzeichnis vorhanden sind (nur beim vorzeitigen Abbruch des Konverterlaufs).
Die verbrauchte Rechenleistung für die Konvertierungen lässt sich im Online-Servicebereich unter "Statistik (Zugriffe) ==> WEBSALE ==> Software" mit dem Eintrag "wsimageconvert" abschätzen. Die für die Konvertierung verbrauchten Leistungseinheiten sind etwa ein Hundertstel der dort angegebenen Anzahl Zugriffe (Zugriffe/100).
Automatische Aufräumfunktion
Fertig bearbeitete sowie fehlerhafte Quellbilder werden automatisch aus dem Quellverzeichnis gelöscht. Damit ist gewährleistet, dass stets die Übersicht gewahrt bleibt, ob und welche Bilder für die Konversion vorliegen. Außerdem entfällt ein manuelles Aufräumen des Quellverzeichnisses. Es wird dadurch auch nur eine Konversion neuer Bilder durchgeführt, also nur Rechenleistung für die Konvertierung neuer Bilder verbraucht.
Fehlerprotokoll
Sollten während einer Konvertierung ein oder mehrere Fehler aufgetreten sein, wird ein Fehlerprotokoll angelegt, das von der Startseite des Bildkonverters aus über den Link "Letztes Fehlerprotokoll ansehen" aufgerufen werden kann. Über den Link "Fehlerprotokoll herunterladen" lässt sich das Protokoll im CSV-Format lokal herunterladen.
Beim jeweils nächsten Konverterlauf wird das Fehlerprotokoll des vorhergehenden Laufs gelöscht. Somit steht immer das Fehlerprotokoll des letzten Laufes zur Verfügung. Wenn alles korrekt ablief, gibt es kein Fehlerprotokoll.
Anbindung von Warenwirtschaft/Versandhandelssystem
Optional können für Verwaltungsfunktionen von Warenwirtschaften Listen der konvertierten Bilder bereitgestellt werden. Ebenso ist ein SFTP-Zugriff für das Abholen von konvertierten Bildern möglich, um diese auf das lokale System zu übertragen. Informationen hierzu erhalten Sie gerne von Ihrem WEBSALE-Ansprechpartner. Die Schnittstellendokumentation "REST-Bildkonverter" finden Sie unter 
https://doku.websale.de/schnittstellen.
Konfiguration und Nutzung des Dienstes
Freischaltung/Aktivierung
Der Bildkonverter muss für Ihren Shop technisch freigeschaltet werden. Bitte wenden Sie sich hierfür an Ihren WEBSALE-Ansprechpartner.
Konfigurationsdatei bearbeiten
Mit der Freischaltung wird auf dem Shopserver ein neues Verzeichnis auto-konvertierung sichtbar. In diesem Verzeichnis befindet sich die Konfigurationsdatei wsimageconvert.cfg, in der Sie die Einstellungen für die Konvertierungen der Bilder vornehmen (Start-Verzeichnis, Zielverzeichnis, gewünschtes Datenformat, Größen der Bilder etc.).
Laden Sie sich zum Bearbeiten die Bildkonverter-Konfigurationsdatei wsimageconvert.cfg herunter und nehmen Sie die gewünschten Einstellungen vor. Laden Sie die Datei nach abgeschlossener Bearbeitung wieder auf den Server hoch.
Die Datei ist in die Abschnitte <Basic> und <Convert> unterteilt. Im Abschnitt <Convert> werden durch die Unterabschnitte <+Entry> die einzelnen Konvertierungen definiert.
Beispiel-Datei wsimageconvert.cfg für die 4 Standardgrößen der Produktbilder gross, normal, klein und mini:
<Basic>
TransferList-Allow = no
TransferListDirectory = websale8_shop-<ihre-shopid>/produkte/medien/bildkonvertierungen
KeepSubDirectories = no
</Basic>
<Convert>
<+Entry>
Name = 1000x1100 px (gross)
DestDir = websale8_shop-<ihre-shopid>/produkte/medien/bilder/gross
ConvertArgs = -resize 1000x1100 -background white -compose Copy -gravity center -extent 1000x1100 -quality 75 -strip
</+Entry>
<+Entry>
Name = 600x660 px (normal)
DestDir = websale8_shop-<ihre-shopid>/produkte/medien/bilder/normal
ConvertArgs = -resize 600x660 -background white -compose Copy -gravity center -extent 600x660 -quality 75 -strip
</+Entry>
<+Entry>
Name = 400x440 px (klein)
DestDir = websale8_shop-<ihre-shopid>/produkte/medien/bilder/klein
ConvertArgs = -resize 400x440 -background white -compose Copy -gravity center -extent 400x440 -quality 75 -strip
</+Entry>
<+Entry>
Name = 100x110 px (mini)
DestDir = websale8_shop-<ihre-shopid>/produkte/medien/bilder/mini
ConvertArgs = -resize 100x110 -background white -compose Copy -gravity center -extent 100x110 -quality 75 -strip
</+Entry>
</Convert>
Referenz: Bildkonverter-Konfiguration wsimageconvert.cfg
Anpassungen von Konvertierungseinstellungen
Sie können die Konvertierungseinstellungen anpassen, indem Sie die vorhandenen ConvertArgs-Einträge verändern oder weitere hinzufügen.
...
<Convert>
<+Entry>
...
ConvertArgs = -resize 600x660 -background white -compose Copy -gravity center -extent 600x660 -quality 75 -strip
...
</+Entry>
...
</Convert>
Alle verfügbaren Anweisungen finden Sie auf der Webseite des externen Softwarepaketes "ImageMagick".
Externer Link: https://imagemagick.org/
Hinzufügen von Konvertierungseinstellungen für bestimmte Dateiformate
Wenn Bilder z. B. auch in den Formaten JPG und PNG geliefert werden und mit jeweils abweichenden Einstellungen konvertiert werden sollen, geben Sie diese Anweisungen mittels ConvertArgs-Dateityp-Einträgen an:
...
<Convert>
<+Entry>
Name = 600x660 px (normal)
DestDir = websale8_shop-<ihre-shopid>/produkte/medien/bilder/normal
ConvertArgs = -resize 600x660 -background white -compose Copy -gravity center -extent 600x660 -quality 75 -strip
ConvertArgs-JPG = -resize 350x350 -sharpen 0 -quality 70
ConvertArgs-PNG = -resize 350x350 -sharpen 0 -quality 60
</+Entry>
...
</Convert>
Hinzufügen neuer Konvertierungseinstellungen für einen anderen Bildtyp, z. B. Startseitenbanner
Fügen Sie hierfür einen neuen +Entry-Eintrag hinzu und geben Sie das entsprechende Quell- und Zielverzeichnis an:
...
<Convert>
<+Entry>
Name = Startseitenbanner
SrcDir = banner
DestDir = websale8_shop-<ihre-shopid>/produkte/medien/bilder/banner
ConvertArgs = -resize 1000x250 -background white -compose Copy -gravity center -extent 1000x250 -quality 75 -strip
</+Entry>
...
</Convert>
Erweiterung für Unterstützung des Bildformates webP für Produktbilder
Produkt- und Kategoriebilder werden über die Produkt- und Kategoriedaten in den Shop importiert. Produktdaten werden in Warenwirtschaften oder PIM-Systemen vom Versender gepflegt. Wenn diese Programme das Bildformat webp nicht unterstützen, müssen die Versender bei den Produkt- und Kategoriedaten die Bilder in den Dateiformaten JPG, JPEG und/oder PNG zuweisen.
Um trotzdem vom hochauflösenden und Ressourcen- und Ladezeit-schonenden webp-Format zu profitieren, haben wir einen Workaround geschaffen:
Konfigurationsdatei bearbeiten
Die Konfiguration hierfür erfolgt ebenfalls über einen separaten <+Entry>-Abschnitt in der Datei wsimageconvert.cfg
Über den Parameter Type = webp geben Sie an, dass von dem Originalbild eine webp-Kopie erstellt werden soll.
Über ConvertArgs-Webp = definieren Sie die gewünschten Einstellungen für das webp-Bild.
Der Parameter ConvertArgs = wird für webP zwingend benötigt, er muss aber keinen Wert enthalten.
Beispiel:
Für die webp-Konvertierung kommt zusätzlich zu ImageMagick noch cwebp zum Einsatz.
ConvertsArg übernimmt sozusagen die grundlegende Konvertierung des Originalbildes. Diese erfolgt durch ImageMagick.
Danach wird das von ImageMagick konvertierte Bild von dem Tool cwebp in ein webp-Bild umgewandelt.
Dafür werden die Regeln verwendet, die bei ConvertArgs-Webp eingetragen sind:
<+Entry>
Type = webp
Name = WEBP 1000x1100 px (gross)
DestDir = websale8_shop-<ihre-shopid>/produkte/medien/bilder/gross
ConvertArgs = -resize 1000x1100 -background white -compose Copy -gravity center -extent 1000x1100 -quality 75 -strip -colorspace sRGB
ConvertArgs-Webp = -resize 1000x1100 -lossless
</+Entry>
Referenz: Bildkonverter-Konfiguration wsimageconvert.cfg
Ausgabe in den Templates anpassen
Damit statt den normalen Original-Dateiformaten jetzt die webp-Formate verwendet werden, sind Anpassungen in den betreffenden Templates notwendig.
Wenn in den Daten als “Großbild (LargeImage)” 1234589.jpg hinterlegt ist, gibt das entsprechende Produktbild-Tag PR-LargeImage folgenden Dateipfad aus:
websale8_shop-<ihre-shopid>/produkte/medien/bilder/gross/1234589.jpg
Damit jetzt das durch den Bildkonverter erzeugt webp-Bild verwendet wird, muss die Dateiendung mit Hilfe des Tags DC-FPXX_replace ersetzt werden:
<!-- Anzeige Grossbild im webp-Dateiformat -->
~DC-FPLargeImage_set($PR-LargeImage$)~
~DC-FPLargeImage_replace(.jpg,.webp)~
<img src="~DC-FPLargeImage~" alt="~PR-Name~">
Referenz: DC-FPX_set
Referenz: DC-FPX_replace
Werden zwei Datei-Schreibweisen von JPG verwendet, z. B. .jpg und jpeg, dann müssen auch zwei Replace-Funktionen verwendet werden, um beide Fälle abzudecken:
<!-- Anzeige Grossbild im webp-Dateiformat -->
~DC-FPLargeImage_set($PR-LargeImage$)~
~DC-FPLargeImage_replace(.jpg,.webp)~
~DC-FPLargeImage_replace(.jpeg,.webp)~
<img src="~FPLargeImage~" alt="~PR-Name~">
Besonderheiten in Verbindung mit dem Warenwirtschaftssystem VS/4
Mit Aktivierung des Bildkonverters erfolgt die Übertragung der Bilder manuell durch den Versender. Er muss die Produktbilder auf dem Shopserver im Quellbilder-Verzeichnis des Bildkonverters bereitstellen: auto-konvertierung/quellbilder/<optional weiterer unterordner>
Mit der Nutzung des Bildkonverters deaktiviert D&G die automatische Übertragung der Bilder aus der VS/4 an den Shop.
Das Warenwirtschaftssystem VS/4 steht aktuell nur als On-Premise-Lösung (Stand 01/2023) zur Verfügung und benötigt für die Produktanlage das Bild "physisch" bei sich. Aus diesem Grund holt sich die VS/4 die Produktbilder vom Shopserver und speichert diese zusätzlich lokal bei sich. Dafür müssen folgende Einstellungen in der Konfigurationsdatei des Bildkonverters vorgenommen werden:
Anpassung des Basic-Abschnittes der Bildkonverter-Konfigurationsdatei wsimageconvert.cfg
▪Parameter TransferList-Allow = yes zum Erzeugen einer Transferliste, z. B. 20221115.dat.
Mit jeder Konvertierung wird eine neue Transferliste erzeugt. Eine Transferliste enthält die Informationen über jedes konvertierte Bild, z. B. Zielverzeichnis, Dateiname etc. Die Bilder, die in dieser Datei enthalten sind, lädt sich die VS/4 über einen separaten SFTP-Zugang und speichert diese bei sich "lokal" ab. Nach dem erfolgreich Download wird die Transferliste durch die VS/4 gelöscht.
▪Unter TransferListDirectory = wird das Verzeichnis angegeben, in dem die Transferlisten abgelegt werden.
<Basic>
TransferList-Allow = yes
TransferListDirectory = websale8_shop-<ihre-shopid>/produkte/medien/bildkonvertierungen
</Basic>
Referenz: Bildkonverter-Konfiguration wsimageconvert.cfg