Bildkonverter-Konfiguration wsimageconvert.cfg
Die Bildkonverter-Konfigurationsdatei wsimageconvert.cfg befindet sich im Verzeichnis auto-konvertierung. Hier nehmen Sie die Einstellungen für die Konvertierungen der Bilder vor (Start-Verzeichnis, Zielverzeichnis, gewünschtes Datenformat, Größen der Bilder etc.).
Wegweiser: Bildkonverter
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.
<Basic>
TransferList-Allow =
TransferListDirectory =
TransferListSrcDirectory =
TransferListRemoveSrcDirectory =
KeepSubDirectories =
DeleteSrcSubDirectories =
</Basic>
<Convert>
<+Entry>
Name =
Type =
DestDir =
SrcDir =
ExclDir =
ConvertArgs =
ConvertArgs-JPG =
ConvertArgs-PNG =
ConvertArgs-GIF =
ConvertArgs-Webp =
</+Entry>
...
</Convert>
Erklärung der möglichen Parameter im Abschnitt <Basic>:
Parameter |
Zweck |
Werte |
TransferList-Allow |
Legt fest, ob Transferlisten erstellt werden sollen. Der Dateiname besteht aus einem Datum und einer fortlaufenden Nummer je Tag, d. h.<Datum>-<fortlaufende Nummer>.dat Beispiel: 20200930-0.dat Die Transferlisten enthalten eine Übersicht aller Dateien, die konvertiert worden sind. Beispiel: produkte/klein/04202C2.PNG produkte/klein/360030C.PNG |
yes no Standard: no |
TransferListDirectory |
Pflicht-Parameter, wenn TransferList-Allow = yes Angabe des Verzeichnis-Pfades, der relativ zum Shopverzeichnis sein muss. Das Verzeichnis muss manuell auf dem Server angelegt werden. In diesem Verzeichnis werden die Transferlisten abgelegt. |
Verzeichnis-Pfad, z. B. auto-konvertierung/protocol |
TransferListSrcDirectory |
Optional, nur verwendbar, wenn TransferList-Allow = yes Angabe eines Unterverzeichnisses, dessen Bilder in die Transferliste geschrieben werden sollen. Alle anderen Bilder werden nicht übernommen. Im Standard werden alle im Quellverzeichnis vorhandenen Bilder in die Transferliste geschrieben. |
Unterverzeichnis, z. B. subdirectory |
TransferListRemoveSrcDirectory |
Optional, nur verwendbar, wenn TransferListSrcDirectory definiert wurde. Mit der Einstellung yes wird das in TransferListSrcDirectory definierte Unterverzeichnis aus dem Transferlisteneintrag entfernt. |
yes no Standard: no |
KeepSubDirectories |
Im Quellverzeichnis auto-konvertierung/quellbilder können Unterverzeichnisse angelegt werden, Mit dieser Einstellung kann festgelegt werden, ob die Unterverzeichnisse bei der Konvertierung mit in die Ausgabeverzeichnisse übernommen werden sollen oder nicht. Der Bildkonverter durchsucht das Quellverzeichnis sowie alle Unterverzeichnisse nach Dateien zum Konvertieren. Standardmäßig werden aber alle konvertierten Dateien "flach" direkt in die Ausgabeverzeichnisse kopiert. Mit KeepSubDirectories = yes werden die Unterverzeichnisse mit in das Ausgabeverzeichnisse übernommen und automatisch angelegt, falls diese noch nicht existieren. |
yes no Standard: no |
DeleteSrcSubDirectories |
Die in auto-konvertierung/quellbilder angelegten Unterverzeichnisse werden nach einem Konvertierungslauf standardmäßig behalten. Um die Unterverzeichnisse nach einer Konvertierung zu löschen, muss DeleteSrcSubDirectories = yes gesetzt werden. Voraussetzung ist, dass das Unterverzeichnis keine Bilder mehr beinhaltet. |
yes no Standard: no |
Erklärung der möglichen Parameter im Abschnitt <Convert>:
Parameter |
Zweck |
Werte |
||||
<+Entry> |
Für jede Optimierung/Komprimierung muss ein eigener <+Entry>-Abschnitt angelegt werden. |
|
||||
Name |
Beschreibung des Abschnittes Diese Beschreibung wird im OSB-Dienst "Bildkonverter" auf der Startseite unter der Überschrift "Konvertierungs-Formate" angezeigt |
Z. B. jpg-Produktbild 1000x1000 Pixel |
||||
Type |
Optional: Angabe des Dateityps, in den die Datei konvertiert werden soll. Soll der Dateityp nach der Konvertierung gleichbleiben, muss kein Wert angegeben werden. Möglich ist die Konvertierung von .jpg, .png und .gif jeweils ineinander. .png und .jpg lassen sich zu .webp konvertieren. Eine Konvertierung von .gif in .webp ist nicht möglich, ebenso wenig wie eine Konvertierung von .webp in ein anderes Dateiformat. Die Schreibweise des Wertes von Type bestimmt die Schreibweise der Dateiendung (Groß- und Kleinschreibung). Type = png: Originaldatei 04531.PNG wird zu 04531.png Type = Png: Originaldatei 04531.PNG wird zu 04531.Png
|
jpg png gif webp und andere Schreibweisen (Groß-/Kleinbuchstaben) |
||||
DestDir |
Zielverzeichnis, in das die Dateien konvertiert werden sollen. Angabe ist relativ zum Root-Verzeichnis des Shops, also bspw. /cluster/www/html/<shopid> |
Z. B. websale8_shop-xyz/produkte/medien/bilder/gross |
||||
SrcDir |
Optional: Auflistung aller Unterverzeichnisse des Quellverzeichnisses auto-konvertierung/quellbilder, die für das Format berücksichtigt werden sollen. Es werden dann nur die aufgelisteten Verzeichnisse berücksichtigt. Alle anderen Verzeichnisse werden ignoriert. Mehrere Verzeichnisse können über | (Pipe) getrennt angegeben werden. Wird kein Verzeichnis angegeben, werden sämtliche Verzeichnisse inklusive des Hauptverzeichnisses berücksichtigt. |
Z. B. produkte/gross |
||||
ExclDir |
Optional: Auflistung aller Unterverzeichnisse des Quellverzeichnisses auto-konvertierung/quellbilder, die für das Format ignoriert werden sollen. Mehrere Verzeichnisse können über | (Pipe) getrennt angegeben werden. Wird in der Regel nur benötigt, wenn kein SrcDir-Verzeichnis angegeben ist. |
Z. B. produkte/gross |
||||
ConvertArgs |
Kommandozeilen-Argumente, die an ImageMagick zum Konvertieren der Bilder übergeben werden. Hier wird also festgelegt, was mit den Dateien passieren soll, also beschneiden, auffüllen, vergrößern, verkleinern, minimieren, komprimieren etc. Hinweis: Die Konvertierungseinstellung "Schärfen" (-sharpen) geht am massivsten in die Konvertierungsdauer ein, hat jedoch für die Endqualität der Bilder nur eine untergeordnete Rolle. Mit geringster Schärfung "-sharpen 0" verdoppelt sich die Konvertierungsdauer - ohne, dass eine wirkliche Schärfung vorgenommen wird! Bei "-sharpen 5" beträgt der Unterschied sogar 500 %, ohne jedoch besonderen Nutzen zu bringen! Zudem ist bei stärkerer Schärfung die Dateigröße des Zielbildes größer. |
Z. B. -resize 400x400> -background white -compose Copy -gravity center -extent 400x400 -quality 80 -strip |
||||
ConvertArgs-JPG |
Optional: Überschreibt die Kommandozeilen-Argumente aus ConvertsArgs für Bilder mit der Dateiendung .jpg oder .jpeg (case insensitive) |
Z. B. -resize 350x350 -sharpen 0 -quality 70 |
||||
ConvertArgs-PNG |
Optional: Überschreibt die Kommandozeilen-Argumente aus ConvertsArgs für Bilder mit der Dateiendung .png (case insensitive) |
Z. B. -resize 350x350 -sharpen 0 -quality 70 |
||||
ConvertArgs-GIF |
Optional: Überschreibt die Kommandozeilen-Argumente aus ConvertsArgs für Bilder mit der Dateiendung .gif (case insensitive) |
Z. B. -resize 350x350 -sharpen 0 -quality 70 |
||||
ConvertArgs-Webp |
Optional: Argumente für das Programm cwebp, das Dateien in das webp-Format umwandelt. Funktioniert nur, wenn der Parameter Type mit dem Wert webp angegeben wird. Der Parameter ConvertArgs wird ebenfalls zwingend benötigt, er muss aber keinen Wert enthalten. Eine Liste mit Argumenten finden Sie unter: https://developers.google.com/speed/webp/docs/cwebp Wenn Bilder in webp umgewandelt werden sollen, wird zuerst ImageMagick mit den Argumenten aus ConvertArgs ausgeführt. cwebp unterstützt keine Bilder mit dem Farbraum CMYK. Darum muss bei ConvertArgs der Parameter -colorspace rgb angegeben werden.
|
Z. B. -resize 400x400 -lossless |
