Files of the types image (
image) or resource (
generic) are used to store images or any kind of binary data in the CMS. The binary data is stored in the version of the respective file as a blob (binary large object).
The thumbnail function offers you the possibility to create small preview images (thumbnails) from this content data. The HTML user interface of the Content Manager accesses these thumbnails via the
thumbnail version field in order to support the user during file selection.
The Content Manager always calls the
generateThumbnail Tcl function after data has been assigned to the draft version of an image file or a resource. Its function is to calculate a thumbnail from the binary data passed to it. The Content Manager includes a
generateThumbnail function which fulfills this task with the aid of the
generateThumbnailForPng functions built into the Content Manager. The Content Manager stores the thumbnail in the
thumbnail version field.
generateThumbnail function is contained in the
generateThumbnail.tcl script. This script is to be found in the
serverCmds directory under the
config directory of the Content Manager. The callback function can create thumbnails for versions of the
png types (capitalization is irrelevant). It can be extended if necessary to also generate thumbnails for data of other types.
The following arguments are passed to the
generateThumbnails function in the order given below.
contentId: the ID of the respective version.
objId: the ID of the file to which the version with the
blobFile: the name of the file containing the source document from which the thumbnail is to be created.
contentType: the file name extension of the version.
thumbnailSize: the size of the thumbnail in pixels (same value for width and height). It can be configured using the
thumbnailSizesystem configuration entry.
The function returns the base-64-encoded thumbnail image. The Content Manager stores this image as the value of the
thumbnail field in the respective version.