sitegeist/kaleidoscope-svg

Add SVG processing capabilities to Neos via contao/imagine-svg

dev-main 2025-10-07 08:36 UTC

Requires

• php: ^8.2
• contao/imagine-svg: ^1.0.0
• neos/media: ^8.3 || ^9.0

Requires (Dev)

• phpstan/phpstan: ^1.8
• squizlabs/php_codesniffer: ^3.7

GPL-3.0-or-later

README

SVG cropping and resizing for neos via contao/imagine-svg

This package allows to crop and resize SVG images in Neos and also will detect dimensions in newly uploaded SVG images to properly handle the different image orientations of SVG images.

!!! This package has no hard dependency to Sitegeist.Kaleidoscope however it surely is meant to be used together with it and developed and tested for it. Use cases outside of Kaleidoscope are not actively tested yet. !!!

Usage

Mainly the package only has to be installed to allow cropping of svg images.

However there is a command to detect the dimensions of already uploaded for SVG images via cli.

./flow svgimage:calculatedimensions [<options>]

OPTIONS:
  --force              re calculate dimensions for all svg assets

Authors & Sponsors

• Martin Ficzel - [e-mail]

The development and the public-releases of this package is generously sponsored by our employer http://www.sitegeist.de.

Installation

Sitegeist.Kaleidoscope.Svg is available via packagist run composer require sitegeist/kaleidoscope-svg. We use semantic versioning so every breaking change will increase the major-version number.

Contribution

We will gladly accept contributions. Please send us pull requests.