Strapi Release: 3.0.0-beta.18.4

TL;DR

Strapi v3.0.0-beta.18.4 brings significant enhancements to the admin interface with multiple language translations (Czech, Slovak, Russian, and Chinese), improved UI components, and better documentation. This release includes important bug fixes for enumeration fields, profile button errors, and database operations. Notable new features include support for Mailgun templates, VK authentication provider, and a private field option in the Content Type Builder. The update focuses on improving user experience, fixing critical issues, and expanding documentation to help developers better utilize Strapi's features.

Highlight of the Release

• Added support for Czech, Slovak, Russian, and improved Chinese translations
• Fixed enumeration field issues, now allowing null values
• Added VK authentication provider
• Improved Mailgun integration with template and variable support
• Added private field option in Content Type Builder
• Fixed critical profile button error causing 500 Internal Server Error
• Enhanced documentation with email troubleshooting, authentication guides, and database configuration options

Migration Guide

This is a minor update (v3.0.0-beta.18.3 to v3.0.0-beta.18.4) and doesn't require specific migration steps. However, here are some recommendations:

1. Update your dependencies:

   npm install [email protected] --save
   # or
   yarn upgrade [email protected]
   

2. Review your enumeration fields: If you're using enumeration fields and want to take advantage of the new null value support, you may need to update your validation logic accordingly.

3. Check custom authentication providers: If you've implemented custom authentication providers, review the VK provider implementation as a reference for best practices.

4. Update Mailgun configuration: If you're using Mailgun for email delivery, you can now take advantage of templates and variables by updating your configuration.

5. Review private fields usage: Consider using the new private field option in your content types to better control API responses.

Upgrade Recommendations

Priority: Medium

This update is recommended for all Strapi users, especially those who:

• Use enumeration fields in their content types
• Have international users who would benefit from the new language translations
• Use Mailgun for email delivery
• Need the VK authentication provider
• Want to control field visibility in API responses with the new private field option
• Have experienced any of the specific bugs fixed in this release

The update is relatively small and focused on bug fixes and enhancements, making it a low-risk upgrade that provides valuable improvements to stability and functionality.

To upgrade, run:

npm install [email protected] --save
# or
yarn upgrade [email protected]

After upgrading, restart your Strapi server and verify that your custom configurations and plugins continue to work as expected.

Bug Fixes

Admin Interface

• Profile Button Error: Fixed a critical issue where the Profile button was throwing a 500 Internal Server Error when refreshing the page from the admin screen.
• Forgot Password Flow: Resolved errors in the forgot password functionality, improving the user recovery experience.
• Left Menu Container Height: Adjusted the LeftMenuLinkContainer height to prevent overlaying the header in the sidebar while scrolling.
• Content Type Fields Scrolling: Fixed an issue where the dropdown to display available fields didn't scroll properly on the page for customizing fields in the entry list.
• Upload Provider Configuration: Fixed a problem where the configuration form for selected upload providers wasn't displaying correctly.

Data Management

• Enumeration Field Values: Added support for setting enumeration fields to null, providing more flexibility in data management.
• Entry Deletion with Associations: Fixed an issue where entries couldn't be deleted if query parameters contained associations.
• Morphological Association Population: Resolved a bug where morphological associations were being overwritten during population operations.
• Component File Path: Updated the path of component files for database collection updates to fix related errors.

Framework

• Database Name Validation: Added an alert when dots are present in database names, preventing MongoDB compatibility issues.
• Admin Path with Proxy: Updated the admin path variable when proxy is enabled, ensuring proper routing in proxy environments.
• Plugin Relations: Fixed issues with relations created from plugin models by properly setting the plugin in target attributes.

New Features

Authentication & Email

• VK Authentication Provider: Added support for VK (VKontakte) as an authentication provider, expanding social login options for your users.
• Mailgun Templates Support: Enhanced the email plugin with support for Mailgun templates and variables, allowing for more sophisticated and customizable email communications.

Content Type Builder

• Private Field Option: Added a new private option for fields in the Content Type Builder. This feature allows developers to hide specific fields in API responses while keeping them in the database, providing better control over data exposure.

Internationalization

• New Language Support: Added complete translations for Czech and Slovak languages in the admin interface.
• Improved Existing Translations: Enhanced Russian and Chinese (zh-Hans) translations with more accurate and comprehensive language support.

Security Updates

• JWT Secret Documentation: Added documentation about setting the JWT secret code via the JWT_SECRET environment variable, promoting better security practices.

• User Authentication: Fixed issues with updating user profiles when logged in via providers other than local authentication, ensuring proper validation is applied only when necessary.

• File URL Handling: Modified file URL handling to leave URLs as relative rather than absolute, which can help prevent certain security issues related to domain validation.

Performance Improvements

• Admin Interface Optimization: Several UI components have been optimized for better performance, including the left menu container height adjustment which improves scrolling behavior.

• Framework Improvements:

  • Enhanced handling of morphological associations to prevent unnecessary data overwrites during population operations.
  • Improved database operations with better handling of relations and associations.

• Plugin Validator Enhancement: Improved the plugin name validator in install/uninstall plugin operations, making the process more efficient and reducing errors.

Impact Summary

Strapi v3.0.0-beta.18.4 is a quality-of-life update that focuses on improving the user experience, fixing critical bugs, and expanding language support. The release addresses several important issues that were affecting day-to-day operations, particularly in the admin interface.

The most significant improvements include:

1. Enhanced internationalization with new Czech and Slovak translations, plus improvements to Russian and Chinese translations, making Strapi more accessible to international teams.

2. Critical bug fixes for the profile button 500 error, enumeration field handling, and entry deletion with associations, which were causing workflow disruptions for many users.

3. New features like the VK authentication provider, Mailgun template support, and private field option in the Content Type Builder, which expand Strapi's capabilities and flexibility.

4. Improved documentation covering email troubleshooting, authenticated requests, database configuration options, and security considerations, helping developers better understand and utilize Strapi's features.

This release maintains backward compatibility while adding useful enhancements that improve both developer and content manager experiences. The fixes for UI issues like menu height, scrolling problems, and configuration form display make the admin interface more usable, while the framework-level improvements ensure more reliable data operations.

Full Release Notes