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.

Introduction

What does it do?

This extension automatically resizes images to a given maximum height/width or total image size right after they have been uploaded to the TYPO3 website. The aspect ratio is of course kept.

The idea behind this extension is that TYPO3 should make both administrators and editors happy. Administrators want the website’s footprint on server as small as possible to be able to handle backups efficiently and want the web server to deliver the pages as quick as possible. On the other hand, editors should be able to do their job and not bother with technical considerations such as the size of a picture on disk or that uploading their wonderful sunset taken during holidays with their 12 MP camera will slow down the time rendering of their great photo gallery where pictures are shown with a maximum definition of 800 × 600 pixels. Moreover, editors are either not aware of this or are simply unable to “prepare” their pictures as they are using a foreign computer (in a cyber café) or on the road with their laptop, neither of them running their beloved image editing software.

General configuration settings let you choose which directories should be somehow “monitored” for uploaded pictures and define the file types that should be handled (e.g., “jpg” and “tif” but not “png” nor “gif”) and a file size threshold (e.g., “skip any picture smaller than 400 KB”). After all, if an editor managed to create a picture of many mega-pixels that weights only a few KB, why should we bother?

Hint

You may use extension “extractor” available in TER to automatically extract and populate metadata when you upload assets to your website. This is likely to give you much better results than just relying on the built-in PHP-based metadata extractor.

Screenshots

Configuration settings

The following two figures General configuration options to resize uploaded images and Additional options and conversion of image format show how an administrator may easily configure rules to resize uploaded images.

Overview of the general configuration panel

General configuration options to resize uploaded images

Overview of the general options panel

Additional options and conversion of image format

Screencast

The team from jweiland.net prepared a screencast showing how to install and configure this extension in your TYPO3 website:

Thanks a lot for providing this online resource to the community.

Requirements

In order to extract metadata while resizing images and automatically rotate images based on the EXIF information, those PHP methods should be available:

  • exif_read_data;
  • iptcparse.