Strapi Release: 3.0.0-alpha.11.2

TL;DR

Strapi v3.0.0-alpha.11.2 brings significant improvements to MongoDB connectivity, user management, and content management. This release adds authentication options for MongoDB, introduces Array type support, and enhances the user experience with customizable roles and improved UI elements. Several critical bugs have been fixed, including issues with content manager layout, relationship handling, and path management.

Highlight of the Release

• Added authentication options for MongoDB with authSource and SSL support
• Introduced Array type support in the backend
• Added customizable default roles for better user management
• Fixed critical issues in content manager including layout problems and relationship handling
• Added staging environment configuration
• Improved error handling and user interface elements

Migration Guide

Migrating from v3.0.0-alpha.11 to v3.0.0-alpha.11.2

MongoDB Users

If you're using MongoDB, you can now configure authentication options:

// config/environments/*/database.json
{
  "defaultConnection": "default",
  "connections": {
    "default": {
      "connector": "strapi-hook-mongoose",
      "settings": {
        "client": "mongo",
        "host": "localhost",
        "port": 27017,
        "database": "strapi",
        "username": "",
        "password": "",
        "authenticationDatabase": "admin", // New option
        "ssl": false // New option
      },
      "options": {
        "ssl": false // New option
      }
    }
  }
}

You can also use environment variables:

DATABASE_AUTHENTICATION_DATABASE=admin
DATABASE_SSL=true

Role Changes

The "Guest" role has been renamed to "Public" and a new "authenticated" role (previously "registered") has been added. Check your permissions configuration if you've customized roles.

Node.js Version

This alpha version requires Node.js >= 9. Make sure to update your Node.js version if you're running an older version.

Upgrade Recommendations

This release contains important bug fixes and new features that enhance MongoDB connectivity, user management, and content management. It's recommended for all Strapi alpha users to upgrade, especially if you:

1. Use MongoDB as your database
2. Work with relationship fields in the content manager
3. Have experienced issues with the content-type builder
4. Run Strapi on Windows systems

The upgrade process should be straightforward with minimal breaking changes. Make sure to back up your data before upgrading, particularly your database and configuration files.

For MongoDB users, review the new authentication options to take advantage of improved security features.

If you've customized roles and permissions, note that role names have changed ("Guest" is now "Public" and "registered" is now "authenticated").

Bug Fixes

Content Manager Fixes

• Fixed layout issues in the content-manager plugin
• Fixed user update functionality in content-manager
• Fixed dominant field handling when updating relationships
• Fixed sorting and limit options persistence in content-manager
• Fixed edit relation field functionality (issue #828)
• Prevented the content-type builder from breaking when editing unsupported attribute types

Path and Build Issues

• Fixed spaces in path issues when running npm run build --plugins
• Fixed spaces in path issues with databases

Other Fixes

• Fixed version command to correctly display Strapi version
• Fixed CSS overflow issues for Windows users
• Limited SSL options to MongoDB connections to prevent conflicts

New Features

MongoDB Authentication Options

Added support for authSource and SSL options to the MongoDB connector, allowing for more secure and flexible database connections. This addresses issues #758 and #759, providing better authentication capabilities for MongoDB deployments.

Array Type Support

The backend now supports Array type, expanding the data modeling capabilities of Strapi. This allows developers to create and manage array fields directly in the backend.

Customizable Default Roles

Added the ability to customize default roles in the Users & Permissions plugin. The system now includes an "authenticated" role (renamed from "registered") that can be configured in advanced settings and is used during user registration.

Staging Environment Configuration

Added a dedicated staging environment configuration similar to production, providing a more complete development workflow with proper environment separation.

Security Updates

MongoDB Security Enhancements

The addition of SSL options to the MongoDB connector significantly improves security by enabling encrypted connections to the database. This is particularly important for production deployments where data security is critical.

Authentication Improvements

The enhanced role management system with customizable default roles provides better security control over user permissions and access rights.

Performance Improvements

Mongoose Performance Improvements

Updated mongoose pre/post functions to use async/await syntax, which provides better performance and error handling for database operations.

Error Handling

Improved error messages when port is already in use, making it easier to diagnose startup issues.

UI Performance

Several UI enhancements were made to improve the overall performance and responsiveness of the admin interface, including fixes to CSS overflow issues that were causing performance problems on Windows.

Impact Summary

Strapi v3.0.0-alpha.11.2 delivers significant improvements to database connectivity, content management, and user experience. The addition of MongoDB authentication options enhances security for database connections, while Array type support expands data modeling capabilities.

The release addresses several critical bugs in the content manager, fixing issues with layouts, relationships, and user management. Windows users will benefit from fixes to path handling and CSS overflow problems.

User management has been enhanced with customizable default roles and an improved registration process. The addition of staging environment configuration provides better support for development workflows.

Overall, this release improves stability, security, and developer experience while expanding Strapi's feature set. The changes are particularly beneficial for MongoDB users, content managers, and developers working with complex data relationships.

Full Release Notes