Home

>

Tools

>

Strapi

>

Releases

>

3.0.0-alpha.12.5

Strapi Release: 3.0.0-alpha.12.5

Tag Name: v3.0.0-alpha.12.5

Release Date: 6/18/2018

Strapi LogoStrapi

Open-source headless CMS built with Node.js. Provides developers with complete freedom in choosing their favorite tools and frameworks for frontend development.

TL;DR

Strapi v3.0.0-alpha.12.5 introduces significant email plugin enhancements with Mailgun and Sendgrid support, fixes critical bugs in the admin interface and GraphQL implementation, and improves internationalization with Arabic language support. This release focuses on enhancing developer experience through better email configuration options and fixing several database and UI-related issues.

Highlight of the Release

    • Added support for Mailgun and Sendgrid in the email plugin with dynamic configuration UI
    • Fixed critical admin interface startup issues
    • Added Arabic language support
    • Fixed GraphQL schema implementation with proper ID types
    • Improved MongoDB array type handling
    • Enhanced documentation with authentication provider examples

Migration Guide

Email Plugin Configuration Changes

If you were previously using the email plugin with custom configuration:

  1. Your existing configuration in plugins/email/config/settings.json will still work
  2. For a better experience, consider using the new UI-based configuration:
    • Navigate to the Plugins page in the admin interface
    • Click the settings cog for the Email plugin
    • Configure your preferred provider and settings

GraphQL Schema Changes

If you were relying on the specific type of primary keys in GraphQL queries:

  • Update any client code that expected String types for IDs to work with the standard GraphQL ID type
  • This change improves compatibility with GraphQL clients but may require updates to your queries

Upgrade Recommendations

This alpha release contains important bug fixes and new features that improve the overall stability and functionality of Strapi. We recommend upgrading if:

  1. You're using the email functionality and want to use Mailgun or Sendgrid
  2. You're experiencing any of the specific bugs addressed in this release, particularly:
    • Admin startup issues
    • MongoDB array type problems
    • GraphQL enumeration detection issues
    • SQL password reset functionality

As this is an alpha release, remember to test thoroughly in a development environment before deploying to production.

Bug Fixes

Admin Interface Fixes

  • Fixed admin startup issues that were preventing proper initialization
  • Improved WYSIWYG editor performance by preventing unnecessary state updates when content hasn't changed
  • Fixed various UI and interaction issues

Database and API Fixes

  • Fixed MongoDB array type handling to properly store and retrieve array data
  • Fixed SQL database password reset functionality
  • Improved GraphQL schema implementation:
    • Fixed enumeration detection for proper type handling
    • Changed primary key type from String to ID for better GraphQL schema compliance

Other Fixes

  • Fixed various documentation links and paths
  • Resolved minor UI and interaction issues throughout the application

New Features

Email Plugin Enhancements

The email plugin now supports Mailgun and Sendgrid as alternatives to the default Sendmail provider. This implementation follows a similar pattern to the upload plugin with a dynamic settings interface:

  • Users can switch between email providers through the plugins settings page
  • Default provider remains strapi-email-sendmail
  • Additional providers can be added by installing strapi-email-mailgun or strapi-email-sendgrid
  • Configuration is managed through the admin UI or in plugins/email/config/settings.json

Arabic Language Support

Full Arabic language support (ar_SA) has been added to the admin interface, expanding Strapi's internationalization capabilities.

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

WYSIWYG Editor Optimization

The WYSIWYG editor now checks if content has actually changed before updating the form state, preventing unnecessary re-renders and improving editor responsiveness.

GraphQL Schema Improvements

The GraphQL implementation now uses the proper ID type for primary keys instead of String, which improves compatibility with GraphQL clients and follows best practices for schema design.

Impact Summary

This release significantly enhances Strapi's email capabilities by adding support for popular email service providers (Mailgun and Sendgrid) with a user-friendly configuration interface. It addresses several critical bugs affecting the admin interface, database operations, and GraphQL implementation.

The addition of Arabic language support expands Strapi's accessibility to Arabic-speaking users and teams. Documentation improvements, particularly around authentication providers, make it easier for developers to implement these features correctly.

For developers, the GraphQL schema improvements and MongoDB array type fixes resolve important technical issues that could affect application functionality. The WYSIWYG editor optimization improves the content editing experience by making the interface more responsive.

Overall, this release focuses on improving developer experience, fixing critical bugs, and enhancing internationalization support, making Strapi more robust and accessible to a wider audience.

Full Release Notes

🚀 New feature

🐛 Bug fix

💅 Enhancement

  • [Admin] Add Arabic language ar_SA - إضافة اللغة العربية (#1403) @runbb
  • [Documentation] Fix CONTRIBUTING.md path (#1402) @maturano
  • [Documentation] Add examples in the "Authentication with providers" section (#1400) @Aurelsicoko
  • [Documentation] Update contributing guide (#1379) @lauriejim
  • [Plugin] Update polish language (#1391) @Redni

Statistics:

File Changed102
Line Additions3,662
Line Deletions258
Line Changes3,920
Total Commits73

User Affected:

  • Can now use Mailgun and Sendgrid as email providers
  • Benefit from fixed GraphQL schema implementations with proper ID types
  • Experience improved MongoDB array type handling
  • Can access better documentation for authentication providers

Contributors:

AustinBratcherrunbblauriejimDaanDDjohanbaathjohannpinsonoritwoenAurelsicokomaturano