January 14, 2026
Cecil 8.77.0 released
This release refactors and simplifies the image resizing and cropping logic, consolidating the functionality into a single, more flexible resize method. It also updates related Twig filters and templates to use the new approach and improves error handling and documentation throughout the image processing.
Image processing API refactor and simplification
- The
covermethod for cropping images to specific dimensions has been removed from both theAssetclass and the Twig filters. All resizing and cropping operations are now handled via an enhancedresizemethod that accepts both width and height, and crops the image if both are provided. - The
resizemethod inAssetand the corresponding Twig filter now accept both width and height as optional parameters, providing greater flexibility and reducing code duplication. - The
Image::resizemethod is updated to handle both resizing and cropping, replacing both the previousresizeandcovermethods. It now also includes an option to remove animation from images.
Template and filter usage updates
- The
coverTwig filter is removed, and all usages in templates are updated to use the newresize(width, height)signature. - The metatags template now uses the new
resizefilter for OpenGraph images, passing both width and height where appropriate.
Error handling and code clarity
- Exception messages throughout the image processing code have been standardized to include periods at the end and clarify the error context.
- Minor code cleanups and improved documentation for image processing methods.
HTML image rendering improvements
- The
sizesattribute for<source>elements is now only included when not empty, preventing invalid HTML. - The
srcsetattribute is only added to images when it is not empty, improving output correctness.
Overall, these changes modernize and streamline image handling, making the API easier to use and maintain.