fromholdio/silverstripe-svgenius

First-class SVG handling for Silverstripe CMS & front-end

1.0.1 2024-01-06 07:24 UTC

Requires

• enshrined/svg-sanitize: ^0.16.0
• meyfa/php-svg: ^0.14.5
• silverstripe/framework: ^5.0.0

BSD-3-Clause

• Luke Fromhold

• assets
• silverstripe
• svg

README

First-class SVG handling for Silverstripe CMS & front-end.

Requires Silverstripe 5+.

• SVGs can be uploaded into Asset Admin just like images
• Thumbnail of SVG is displayed on Asset Admin grid view
• Asset CMS fields adjusted to hide focuspoint field for SVGs when jonom/focuspoint is installed
• Retrieve height, width, orientation, and apply resizing by ratio, width or height using existing manipulation methods (Fit, FitMax, ScaleWidth, ScaleMaxWidth, ScaleHeight, ScaleMaxHeight)
• Can embed in front-end as an tag, or embed the svg file contents
• SVG contents are passed through santisation library enshrined\svgSanitize

Note, this behaviour is not included out-of-the-box in Silverstripe due to the security risks inherent with user-supplied SVG files. Per above, this module does process SVGs through a sanitisation process, but this needs to be combined with your own strategies and in consideration of your use case to reach acceptable security.