Strapi Release: 3.0.0-alpha.11

TL;DR

Strapi v3.0.0-alpha.11 introduces a major new feature: the File Upload plugin with support for local server and AWS S3 storage. This release also adds polymorphic relations to the framework, fixes critical bugs in user relations and default language handling, and includes several enhancements like new language translations (Turkish and Chinese) and improved logging options. This alpha release represents a significant step forward in Strapi's media management capabilities.

Highlight of the Release

• New File Upload plugin with support for local server and AWS S3 storage
• Polymorphic relations added to the framework
• Fixed user relations in /user/me endpoint
• Added Turkish and Chinese language translations
• Improved logging configuration with environment variables

Migration Guide

Upgrading to v3.0.0-alpha.11

1. Update your Strapi installation:

   npm install [email protected] --save
   

   or

   yarn upgrade [email protected]
   

2. File Upload Configuration: If you're planning to use the new File Upload plugin, you'll need to configure it:

   • For local storage, ensure your server has appropriate write permissions
   • For AWS S3, you'll need to provide your AWS credentials in the plugin settings

3. Polymorphic Relations: If you're using the new polymorphic relations feature, review your content type models to ensure they're properly structured for these relationship types.

4. Logger Configuration: If you want to customize logging behavior, you can now use environment variables to configure the Strapi logger.

Upgrade Recommendations

This release adds significant new functionality with the File Upload plugin and polymorphic relations. If you need media management capabilities in your Strapi application, upgrading is highly recommended.

However, as this is still an alpha release (v3.0.0-alpha.11), it's advisable to:

1. Test thoroughly in a development environment before deploying to production
2. Back up your data before upgrading
3. Review the full changelog for any potential breaking changes

For production environments, consider waiting for more stable releases unless you specifically need the new features introduced in this version.

Bug Fixes

User Relations Fix

Fixed an issue with the /user/me endpoint where one-to-many relations weren't being properly returned. This ensures that when retrieving the current user's data, all related information is correctly included in the response.

Default Language Fix

Resolved an issue with default language handling in the admin panel. The system now properly falls back to English default translation messages when they are not present in the current locale, improving the user experience for international users and removing error messages in the console.

New Features

File Upload Plugin

The major feature of this release is the new File Upload plugin that allows users to:

• Upload and manage files directly within Strapi
• Store files either locally or on AWS S3
• Associate media files with content types
• Configure upload providers through an admin interface
• Manage file relationships with other content types

The plugin includes a complete UI for file management with features like:

• File preview
• Upload animation
• File details display
• Search functionality
• File deletion

Polymorphic Relations

This release introduces polymorphic relations to the framework, allowing content types to have relationships with multiple other content types through a single association field. This powerful feature enables more flexible content modeling scenarios.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Improved Database Handling

Several improvements were made to database handling, particularly for relationships:

• Enhanced handling of empty relationships on the morphological side
• Improved management of one-to-many relationships
• Optimized SQL queries to only execute when using SQL databases
• Better handling of associations between file uploads and other models

Logger Optimization

The logging system has been updated to allow configuration through environment variables, giving developers more control over log output and potentially improving performance by reducing unnecessary logging.

Impact Summary

Strapi v3.0.0-alpha.11 significantly enhances the platform's capabilities with the introduction of the File Upload plugin, allowing for comprehensive media management directly within Strapi. This addresses a major feature gap in previous versions and eliminates the need for third-party solutions for basic file handling.

The addition of polymorphic relations expands Strapi's data modeling flexibility, enabling more complex content structures and relationships. This is particularly valuable for projects with diverse content types that need to share common relationships.

The international user experience is improved with new language translations (Turkish and Chinese) and fixes to the default language handling. The enhanced logging configuration provides developers with more control over system visibility.

Bug fixes for user relations ensure that API responses correctly include related data, improving the reliability of user data retrieval.

Overall, this release represents a substantial step forward in Strapi's evolution as a comprehensive headless CMS, particularly in media management capabilities.

Full Release Notes