Payload CMS Release: 2.18.2
Tag Name: v2.18.2
Release Date: 5/17/2024
Payload CMSPayload CMS is a modern, self-hosted headless content management system built with TypeScript, Node.js, and MongoDB. It's designed specifically for developers who want full control over their content management system while maintaining a powerful admin interface for content editors.
TL;DR
PayloadCMS v2.18.2 fixes an important bug that allows focal points to be saved for uploaded images even when no image sizes are defined. This enhances the flexibility of the media management system by ensuring that users can still set focal points for their images regardless of whether they've configured specific image sizes for resizing.
Highlight of the Release
- Fixed bug that prevented focal points from being saved when no image sizes were defined
- Improved compatibility with different image field configurations
- Enhanced the flexibility of the media management system
Migration Guide
No migration is required for this release. The fix is backward compatible and will automatically apply to existing implementations.
If you were previously using workarounds to enable focal points when no image sizes were defined, you can now remove those workarounds as the functionality is natively supported.
Upgrade Recommendations
This upgrade is recommended for all users who utilize image uploads in their Payload CMS implementation, especially those who don't define specific image sizes but still want to use focal points.
The update is a minor bug fix with no breaking changes, making it a safe upgrade that should not impact existing functionality. Users can upgrade with minimal risk.
Bug Fixes
Focal Point Saving Issue Fixed
Fixed a bug that prevented focal points from being saved for images when no imageSizes were defined in the configuration. This issue was limiting the functionality of the media management system, as users couldn't set focal points unless specific image sizes were configured.
The fix ensures that focal points can be saved regardless of whether image sizes are defined, providing more flexibility in how images are managed within Payload CMS. This builds upon improvements made in PR #6364.
New Features
No new features were added in this release. This is a bug fix release focused on improving the existing focal point functionality for images.
Security Updates
No security fixes were included in this release.
Performance Improvements
No specific performance improvements were included in this release. The changes were focused on fixing functionality rather than performance optimization.
Impact Summary
This release has a moderate impact on the user experience for content editors working with images in Payload CMS. By fixing the focal point functionality to work without defined image sizes, it removes a limitation that could affect content management workflows.
For developers, this change provides more flexibility in how they configure image fields, allowing them to implement focal point functionality without necessarily defining image sizes. This can be particularly useful for implementations where image resizing happens outside of Payload or where the original image dimensions need to be preserved.
The fix is fully backward compatible and requires no changes to existing code or configurations.
Full Release Notes
Statistics:
File Changed7
Line Additions51
Line Deletions24
Line Changes75
Total Commits2
User Affected:
- Can now set focal points for images even when no image sizes are defined
- Experience improved reliability when working with the media library
- No longer encounter errors or limitations when trying to set focal points on images without defined sizes
Contributors:
