DEPRECATION WARNING

This documentation is not using the current rendering mechanism and will be deleted by December 31st, 2020. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

General settings

General settings are configured with the first tab of the configuration panel:

Overview of the general configuration panel

Directories

This is a comma-separated list of directories that should be monitored for image uploads. This includes any subdirectory of them too. In the example above, both fileadmin/ and uploads/ will be monitored.

You may use two different wildcards characters:

  • The single asterisk (*) searches for a single directory. E.g., fileadmin/*/images/ will match fileadmin/directory1/images/ and fileadmin/directory2/images/ but not fileadmin/directory3/subdirectory/images/.
  • The double asterisk (**) searches for any number of subdirectories. E.g., fileadmin/**/images/ will match any subdirectory images within fileadmin, and of course any sub-subdirectory of it too.

File size threshold

Only original pictures with file size bigger than this value will be processed. The field accepts suffices “B” for bytes, “K” for KB and “M” for MB. The number itself is interpreted as an integer.

Image types

This is the list of image formats that should be processed, if both the directory and the size threshold match. The actual list of available types is read from $TYPO3_CONF_VARS['GFX']['imagefile_ext'].

Important

PDF type is always removed from this list, whenever it is available, as it usually is not considered being an image even if it can be processed by TYPO3 as such (to extract preview of the cover page for instance).

Maximum width / height

These are the maximum dimensions in pixels a picture will be bound to after the resize processing. Aspect ratio will of course be preserved.

Maximum image size (pixel area)

This is the maximum size in pixels a picture will be bound to after the resize processing. Height and width are calculated as big as possible considering the defined maximum width / height. Aspect ratio will of course be preserved. The field accepts the suffice “M” for megapixels.