README

Media Processing for TYPO3 integrates various image processing libraries and SaaS cloud services into TYPO3 by leveraging their APIs to process images. This basically replaces the need for local image processing libraries like ImageMagick for image processing operations.

Integrations

resize: Integration supports resize operations.
crop: Integration supports crop operations.
focus: Integration supports gravity or focus points. (experimental)
sign: Integration supports URL signing.

🟢 supported and integrated
🟡 supported but not integrated
🔴 unsupported

Installation 📦

Composer Mode

Install the somehow-digital/typo3-media-processing package from the Composer Package Repository.

composer require somehow-digital/typo3-media-processing

Legacy Mode

Install the media_processing extension from the TYPO3 Extension Repository.

Requirements

TYPO3 12
PHP with openssl extension

Setup ⚙️

By choosing and configuring one of the available image processing integrations, TYPO3 will use the configured integration to process images instead of using the local image processing library.

Configuration

Extension configuration is located in the TYPO3 backend under Admin Tools → Settings → Extension Configuration.

common common

imgproxy integration.imgproxy

See also the official imgproxy documentation for more information.

imagor integration.imagor

See also the official imagor documentation for more information.

thumbor integration.thumbor

See also the official thumbor documentation for more information.

optimole.com integration.optimole

See also the official optimole documentation for more information.

bunny.net integration.bunny

See also the official bunny.net documentation for more information.

cloudflare.com integration.cloudflare

See also the official cloudflare documentation for more information.

imagekit.io integration.imagekit

See also the official imagekit.io documentation for more information.

sirv.com integration.sirv

See also the official sirv.com documentation for more information.

imgix.com integration.imgix

See also the official imgix.com documentation for more information.

cloudinary.com integration.cloudinary

See also the official cloudinary.com documentation for more information.

cloudimage.io integration.cloudimage

See also the official cloudimage.io documentation for more information.

gumlet.com integration.gumlet

See also the official gumlet.com documentation for more information.

Usage 🪄

Backend

The backend Invalidate processed media action can be used to invalidate processed files for the active media processing integration.

CLI

The TYPO3 CLI cleanup:invalidatemedia command can be used to invalidate processed files for the active media processing integration.

vendor/bin/typo3 cleanup:invalidatemedia

Support 🛟

Roadmap 🚧

Version 1.0.0 🏷️ developing

✅ Support for TYPO3 12.
✅ Support resize operations.
✅ Support crop operations.
✅ Backend toolbar action and CLI command for processed media invalidation.
✅ Integration for imgproxy library.
✅ Integration for imagor library.
✅ Integration for thumbor library.
✅ Integration for optimole.com service.
✅ Integration for bunny.net service.
✅ Integration for cloudflare.com service.
✅ Integration for imagekit.io service.
✅ Integration for sirv.com service.
✅ Integration for imgix.com service.
✅ Integration for cloudinary.com service.
✅ Integration for cloudimage.io service.
✅ Integration for gumlet.com service.
Release.

Version 2.0.0 🏷️ planning

Support for TYPO3 13.
Support for gravity configuration via focusArea operations.
Support for manual and smart gravity configuration.
Integration for glide library.
Integration for imaginary library.
Integration for imageflow library.
Integration for weserv library.
Integration for fastly.com service.
Integration for shortpixel.com service.
Integration for imagify.io service.
Integrations per site.
Send HEAD requests to speed up image generation.

Version 3.0.0 🏷️ researching

Integration for more image processing libraries/services.
Integration for video processing libraries/services.

somehow.digital

somehow-digital / typo3-media-processing

Maintainers

Details