TL;DR
Strapi v3.0.0-beta.20.1 is a maintenance release that includes numerous bug fixes and enhancements across the admin interface, core framework, and plugins. Key improvements include front-end media library usage tracking, platform-agnostic file handling, and fixes for issues with rich text editing of Chinese characters. The release also contains extensive documentation updates and dependency upgrades to improve stability and developer experience.
Highlight of the Release
- Fixed rich text editor support for Chinese characters
- Added front-end media library usage tracking events
- Fixed AWS SES email provider in eu-central-1 region
- Made file handling platform-agnostic for better Windows compatibility
- Fixed core store string handling
- Improved documentation with numerous fixes and enhancements
Migration Guide
No specific migration steps are required for this release as it's primarily a maintenance release with bug fixes and enhancements.
However, if you're using any of the following features, you should be aware of the changes:
-
AWS SES in eu-central-1 region: The fix for AWS SES in eu-central-1 region should automatically resolve issues without requiring changes to your code.
-
Core Store String Handling: If you were working around the issue of core store returning null instead of strings, you can now remove those workarounds.
-
Custom GraphQL Resolvers: If you experienced issues with GraphQL shadow CRUD when resolvers were not defined in a plugin, this should now work correctly without additional configuration.
Upgrade Recommendations
This is a recommended upgrade for all Strapi beta users, especially for:
- Users working with Chinese content in the rich text editor
- Users deploying on AWS and using SES in the eu-central-1 region
- Developers using GraphQL with custom resolvers
- Users experiencing issues with permissions at startup
- Windows developers experiencing test failures
The release contains numerous bug fixes and enhancements that improve stability and user experience. As this is a patch release (beta.20.0 to beta.20.1), the upgrade should be straightforward with minimal risk.
Bug Fixes
Rich Text Editor Chinese Character Support
Fixed an issue where the rich text editor couldn't save Chinese characters properly, improving the experience for users working with Chinese content.
AWS SES Email Provider Fix
Resolved an issue with the AWS SES email provider not working in the eu-central-1 region, ensuring proper email functionality for users in that region.
Core Store String Handling
Fixed a bug where the core store returned null instead of string values, ensuring proper data handling and preventing unexpected behavior.
GraphQL Shadow CRUD
Fixed an issue where the GraphQL shadow CRUD would break the build when resolvers were not defined in a plugin, improving stability for GraphQL implementations.
Missing Permissions at Startup
Fixed an issue with missing permissions at startup in the users-permissions plugin, ensuring proper authorization from the beginning.
Single Types Navigation
Improved navigation for single types in the admin interface, making it more intuitive and user-friendly.
Rackspace Upload
Fixed Rackspace upload functionality to properly use hash values, ensuring consistent and reliable file uploads.
New Features
Front-end Media Library Usage Tracking
Added tracking events for the media library to better understand how users interact with this feature. This includes a rate limiter wrapper to prevent excessive event logging.
Collection API ID in Content Manager
Added the collection API ID in the content manager edit view header for better context and improved developer experience when working with content types.
Security Updates
No specific security fixes were mentioned in this release. However, the general dependency upgrades may include security patches from the updated libraries.
Performance Improvements
Dependency Upgrades
Several dependencies were upgraded to their latest versions, including reactstrap, react-intl, react-helmet, and react-redux. These upgrades improve performance and stability of the admin interface.
Removal of koa-qs Dependency
Removed the koa-qs dependency as it is no longer maintained, replacing it with a more efficient implementation. This change improves the maintainability and performance of the core framework.
Impact Summary
Strapi v3.0.0-beta.20.1 is a maintenance release that focuses on bug fixes, documentation improvements, and minor enhancements across the platform. The most notable fixes include support for Chinese characters in the rich text editor, AWS SES functionality in the eu-central-1 region, and platform-agnostic file handling for better Windows compatibility.
For developers, the release improves the stability of GraphQL implementations, fixes core store string handling, and provides better documentation for custom providers and authentication errors. Content editors will benefit from improved single types navigation and UI enhancements. Administrators will see fixes for permission issues at startup and improved upload functionality.
The release also includes several dependency upgrades to improve performance and stability of the admin interface. While there are no breaking changes, the numerous bug fixes and enhancements make this a recommended upgrade for all Strapi beta users.
Full Release Notes
💅 Enhancement
- [admin] docs: DE Abbrechen does not mean reset (#5796) @MartinMuzatko
- [admin] Add front-end media lib usage events (#5923) @soupette
- [admin] Front-end improvements (#5942) @soupette
- [core:framework] Enhancement/usage (#5848) @Aurelsicoko
- [core:framework] remove koa-qs dependency as it is not anymore maintained (#5922) @domenicoven
- [core:framework] Make unit tests on files platform agnostic by using path.combine. Avoid them failing on Windows (#5943) @domenicoven
- [documentation] Remove invalid plugin development tip, and revert structure comment (#5574) @derrickmehaffy
- [documentation] Add a link to build docs for custom providers (#5626) @derrickmehaffy
- [documentation] Update documentation from Content to Collection Type (#5725) @adriatic
- [documentation] Fix upload models name definition (#5778) @lauriejim
- [documentation] Update migration-guide-beta.19-to-beta.19.4.md (#5827) @tonytoth
- [documentation] Add warning about changing models globalId (#5829) @Convly
- [documentation] Fix documentation typos (#5856) @pierreburgy
- [documentation] Fix typo in documentation (#5866) @epegzz
- [documentation] Remove options from the model documentation (#5883) @lauriejim
- [documentation] Add a simple example of using env vars in provider config files (#5896) @alexandrebodin
- [documentation] Update documentation of authentication errors (#5926) @Astraeus-
- [documentation] Fix Typo in AWS deployment documentation (#5932) @bjdixon
- [documentation] Add rfcs into the contribution docs (#5966) @lauriejim
🐛 Bug fix
- [admin] typo fixes (#5795) @ierehon1905
- [admin] Upgrade reactstrap dependency. (#5851) @soupette
- [core:database] Fix relation detection for components in mongoose connector (#5713) @mkqavi
- [core:framework] Fixed: Core store returned null instead of string (#5957) @aPisC
- [plugin:content-manager] Fix register new fields in content manager (#5847) @soupette
- [plugin:content-manager] fix #4621 - rich text can't save Chinese (#5951) @abucraft
- [plugin:email] Fix AWS SES not working in eu-central-1 region (#5853) @epegzz
- [plugin:graphql] fix shadow crud breaking build when resolvers are not defined in a plugin (#5899) @petersg83
- [plugin:upload] Fix rackspace upload to use hash (#5855) @alexandrebodin
- [plugin:users-permissions] fix missing permissions at startup (#5814) @petersg83
- [plugin:users-permissions] Fix #5854 - GraphQL implementation of updateRole and deleteRole fails (#5857) @stevenraines