Strapi Release: 3.0.0-alpha.10.3

TL;DR

Strapi v3.0.0-alpha.10.3 introduces a major new upload plugin with file management capabilities, polymorphic relations support, UI improvements, and multiple language translations. This release enhances content management with better file handling, more flexible data relationships, and an improved user experience.

Highlight of the Release

• New Upload Plugin with file management capabilities
• Support for polymorphic associations between content types
• Multiple language translations added (German, Polish, Turkish)
• S3 integration for file uploads
• Improved UI components and navigation

Migration Guide

Migrating from v3.0.0-alpha.9 to v3.0.0-alpha.10.x

This release includes significant changes that require attention when upgrading:

1. Upload Plugin Integration

   • The new upload plugin is installed by default
   • Configure your storage provider (local or S3) in the plugin settings

2. Polymorphic Relations

   • If using polymorphic relations, update your models to use the new syntax
   • Review the polymorphic documentation for implementation details

3. UI Component Changes

   • The 'Cancel' button has been renamed to 'Reset' to better reflect its functionality
   • If you've extended any core components, check for compatibility with the refactored components

4. Node.js Version

   • Note that the required Node.js version has been updated

For detailed instructions, refer to the migration guide from alpha.9 to alpha.10 included in the release.

Upgrade Recommendations

Who should upgrade:

• All users working with alpha versions of Strapi 3.0.0 should upgrade to benefit from the new file management capabilities and polymorphic relations.
• Developers who need file upload functionality in their projects will find this upgrade particularly valuable.
• International teams will benefit from the expanded language support.

Upgrade priority: Medium-High

Upgrade difficulty: Medium

• The upgrade introduces significant new features but also includes some structural changes that may require adjustments to existing projects.
• Users with custom plugins or extensions should test thoroughly after upgrading.

Upgrade steps:

1. Backup your project before upgrading
2. Update your package.json to reference the new version
3. Run npm install or yarn install to update dependencies
4. Review the migration guide for any specific actions needed
5. Test your application thoroughly, especially if using custom plugins or extensions

Bug Fixes

Fixed Issues

• Fixed issue with users being removed when updating roles (#688)
• Fixed upload plugin build issues related to component references
• Fixed logs table creation
• Fixed provider login authentication
• Fixed update email provider functionality
• Fixed side menu scrolling when content requires it (#660)
• Fixed node_modules directory handling during new project generation
• Fixed documentation indentation in config JS examples

New Features

Upload Plugin

• Complete file management system with upload, preview, and delete capabilities
• Support for both local server and AWS S3 storage options
• File search, filtering, and sorting functionality
• Pagination for better browsing of large file collections
• Drag and drop interface for easy file uploads
• Preview capabilities for images with navigation between files
• File type detection with appropriate icon display for non-image files

Polymorphic Associations

• New relationship type allowing content to be associated with multiple content types
• Support for both Bookshelf and Mongoose databases
• Includes morphToOne and morphToMany relationship types
• Enhanced API for managing polymorphic relationships

Internationalization

• Added complete German translation
• Added Polish language support
• Added Turkish language support
• Improved English translations with grammar and spelling corrections

UI Improvements

• New PluginHeader component with enhanced functionality
• ContainerFluid component for consistent plugin layouts
• Improved InputFile component with drag and drop support
• New PageFooter component for pagination controls
• FileIcon component for better file type visualization
• Enhanced side menu with scrolling capability for many content types

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Performance Enhancements

• Improved file handling with optimized upload processes
• Better pagination implementation for handling large collections of files
• Enhanced side menu scrolling for better performance with many content types
• Optimized database queries for polymorphic relationships
• Improved component rendering with refactored SCSS for input libraries

Impact Summary

This release significantly enhances Strapi's content management capabilities with the introduction of the upload plugin, providing a complete file management system directly within the CMS. The addition of polymorphic relations expands the flexibility of content modeling, allowing for more complex data structures.

The internationalization improvements make Strapi more accessible to non-English speaking users with the addition of German, Polish, and Turkish translations. UI enhancements provide a more intuitive and efficient user experience, particularly for content managers working with files and multiple content types.

For developers, the S3 integration offers more deployment options, while the bug fixes address several pain points related to user management and plugin functionality. The improved component architecture provides better building blocks for custom interfaces.

Overall, this alpha release represents a substantial step forward in Strapi's evolution as a comprehensive headless CMS, particularly in the areas of media management and content modeling flexibility.

Full Release Notes