Imaginator 

Extension key

imaginator

Package name

schliesser/imaginator

Version

main

Language

en

Author

André Buchmann

License

This document is published under the Open Publication License.

Rendered

Mon, 20 Jul 2026 15:04:11 +0000


Zero-config responsive images for TYPO3. The integrator writes no sizes and no per-image breakpoints: at render time the extension emits a real <picture> / <img> with a quantized width-ladder srcset and sizes="auto", so the browser's preload scanner fetches the correctly-sized image in a single request. Candidate URLs are HMAC-signed and served as real image bytes by a local processing endpoint. JavaScript is never required for sharpness.

For editors 

A backend aspect-ratio field per content element lets editors pick the framing once per breakpoint and get uniform, consistent images across every image of that content element, with no ragged grids from mismatched upload dimensions. Crop and focus area are honored, so the chosen subject stays in frame at every size.

For developers 

Drop one <i:image> and get sharp, perfectly-sized images on every device. No hand-tuned sizes, no breakpoint lists, no layout shift (CLS). The width ladder bounds processing to a fixed set of sizes, so you serve fewer, smaller bytes and score better Core Web Vitals (LCP/CLS) out of the box. Processing is pluggable: classic sync on first request, async via a signed middleware endpoint (default), or an external processor such as imgproxy.


Introduction 

What the extension does, how it works, where to get support and how to contribute.

Installation 

Install via Composer, activate the extension and derive the signing key.

Configuration 

Extension Configuration settings, the focus-area feature toggle, processors and Content Security Policy.

Usage 

The <i:image> Fluid ViewHelper, the aspect-ratio field and crop / focus-area handling.

Extend 

Register your own image processor by tagging a service.

Migrations 

Move an existing site from EXT:pictureino to Imaginator.