teufels / tt3-image

1.8.1 2026-09-02 08:37 UTC

Requires

• typo3/cms-core: ^12.4 || ^13.4 || ^14.3

GPL-2.0-or-later

• teufels GmbH

Published on Packagist.org on 2026-09-02 08:38 UTC

README

[ ṯeufels ] Image

Provide Viewhelpers, Crop Variants and SVG (inline/file) Support

This version supports TYPO3

Composer support

composer req teufels/tt3-image

Requirements

• none

How to use

• Install with composer
• (Optional) Import Static Template (before sitepackage)
  • will be automatically imported - on problems or need of changed order include manual

How to use (ViewHelper)

{namespace tt3Image=Teufels\Tt3Image\ViewHelpers}
<f:format.raw>
    <tt3Image:inlineSvg filePath="/absolute/path/to/some_file.svg" removeStyleAttributes="1" />
</f:format.raw>

How to use (Template)

<v:render.template file="EXT:tt3_image/Resources/Private/Partials/Media/Rendering/Image.html" variables="{file: image}" />

Migration from hive_image

• migrate from old ViewHelper hiveImage to tt3Image, see above how to use ViewHelper

Changelog

1.8.x

• 1.8.1 [REFACTOR] maintain composer description
• 1.8.0 [BUGFIX] Normalize Extbase/Core file references for reliable rendering
• 1.8.0 [BUGFIX] Fix dimensions fallback and preserve aspect ratio for auto values
• 1.8.0 [REFACTOR] Keep conditional title/role output with parser-safe image tag rendering
• 1.8.0 [BUGFIX] Fix lazy-loading output when imagelazyload/settings are missing

  1.7.x

• 1.7.0 TYPO3 v14 support

  1.6.x

• 1.6.2 [BUGFIX] Implement fallback handling if dimensions is NULL
• 1.6.1 [BUGFIX] Implement correct fallback chain for SVG settings (site config → new constants → legacy constants)
• 1.6.0 [FEATURE] add feature "fetchpriority" setting for images

  1.5.x

• 1.5.6 add support for site sets
• 1.5.5 fix deprecated renderStatic and CompileWithContentArgumentAndRenderStatic in JsonDecodeViewHelper
• 1.5.4 fix missing settings in TYPO3 v13
• 1.5.3 fix TTER-31: Error on no-processing images
• 1.5.2 fix wrong role='img' inside img-tag (file) on fileSVG
• 1.5.1 Migrate configuration path from plugin.tx_tt3_image to plugin.tx_tt3image while maintaining backwards compatibility
• 1.5.0 add own ViewHelper for JSON Decode to remove the addiction to fluidtypo3/vhs

  1.4.x

• 1.4.0 TYPO3 v13 support

  1.3.x

• 1.3.0 add necessary accessibility attributes. Implement toggle option for 'decorative' images.

  1.2.x

• 1.2.0 add toggle for possibility to disable lazy loading

  1.1.x

• 1.1.0 put maxWidth image size in Constants to change on purpose
• 1.1.0 change breakpoint for largest image (1920) from 1280 to 1200

  1.0.x

• 1.0.2 stucture code
• 1.0.1 cleanup TypoScript / compress Code
• 1.0.0 intial from hive_image