Ghost Release: 5.49.3

TL;DR

Ghost 5.49.3 brings significant improvements to the Admin X interface, adds internationalization support for the signup form, and introduces several new components to the Admin Design System. This release also includes fixes for dark mode in the Lexical editor, updates to the embeddable signup form with customization options, and adds several new language translations including Finnish, Albanian, and Traditional Chinese.

Highlight of the Release

• Enhanced Admin X interface with new components and improved user management
• Added internationalization support for the signup form with multiple language options
• Improved embeddable signup form with customization options for colors and responsive design
• Added several new language translations including Finnish, Albanian, and Traditional Chinese
• Fixed dark mode for the Lexical editor
• Added new components to Admin Design System including DropdownMenu, TextArea, and Avatar

Migration Guide

No migration steps are required for this release. The update is backward compatible and should not affect existing functionality.

If you're using the embeddable signup form, you'll now have access to new customization options including background and button colors. These can be configured through data attributes in the script tag.

For developers working with the Admin X Design System, several new components are now available for use in your custom themes or extensions.

Upgrade Recommendations

This is a minor release with enhancements to the Admin X interface, improvements to the signup form, and several bug fixes. It's recommended for all users to upgrade to benefit from these improvements.

The update is particularly valuable for:

• Sites using multiple languages, as it adds several new translations
• Admins who work extensively with the user management interface
• Sites using the embeddable signup form, which now has more customization options
• Content creators using the Lexical editor, which now has fixed dark mode support

There are no breaking changes in this release, making it a safe upgrade for all Ghost installations.

Bug Fixes

UI and Functionality Fixes

• Fixed both text and loading indicator showing on the subscribe button
• Fixed duplicate key errors in admin-x
• Fixed dark mode for the Lexical editor
• Fixed modal scroll bug in AdminX Design System
• Fixed list item clickarea bug in AdminX
• Fixed linter failing due to Tailwind class ordering
• Fixed signup-form-tests GitHub workflow
• Fixed ResizeOptions type case
• Fixed labels for signup form
• Fixed product card image stretching issue
• Fixed position issues in AdminX components
• Fixed signup form E2E tests for removed email on success page

API and Data Handling Fixes

• Fixed description editing in collections service
• Fixed fromDTO collection mapping to avoid unintentional empty assignments
• Fixed encoded HTML character in signup form success message translation
• Handled serialization for settings data properly, especially for Twitter and Facebook URLs

New Features

Admin X Enhancements

• Added several new components to the Admin X Design System:
  • TextArea component for multi-line text input
  • DropdownMenu component for dropdown navigation
  • Avatar component with support for images and fallback icons
  • ImageUpload and FileUpload components for media management
  • MultiSelect component for selecting multiple options
  • Confirmation modal for critical actions

Signup Form Improvements

• Added internationalization (i18n) support for the signup form
• Enhanced embeddable signup form with customization options:
  • Background and button color configuration
  • Automatic text color calculation based on background/button color
  • Responsive design for better mobile experience
  • Automatic height adjustment
  • Fixed logo height for consistent branding
• Added attribution tracking to signup form submissions
• Moved signup form embed to a modal in membership settings

Language Support

• Added new language translations:
  • Finnish locale
  • Albanian locale
  • Traditional Chinese translations
• Updated existing translations:
  • Turkish Portal and Ghost translations
  • Chinese translations
  • French translations
  • Spanish translations
  • Bahasa Indonesia translations

Collections API Enhancements

• Added POST /collections/:id/posts to Admin API for appending posts to collections
• Added DEL /collections/:id/posts/:post_id to Admin API for removing posts from collections
• Added Posts relation support to collections package

Security Updates

No significant security fixes were mentioned in this release.

Performance Improvements

Font and Asset Optimization

• Optimized Inter font in the Admin:
  • Replaced TTF with WOFF2 for better compression
  • Added specific font file for italic style for consistent rendering across browsers

Development Workflow Improvements

• Added support for yarn dev --signup to serve the signup form preview server
• Configured Portal's dev output to be quieter for better development experience
• Added VS Code workspace settings file with reasonable defaults
• Enabled quicker autocomplete in VS Code for Tailwind

API and Data Access Improvements

• Cleaned up API and data access for admin-x:
  • Updated data providers to include roles with cleaner API syntax
  • Updated API methods with cleaner syntax and added roles API
  • Added useRoles hook for access to roles data for admin
  • Added currentUser to the staff provider

Impact Summary

Ghost 5.49.3 focuses on enhancing the Admin X interface and improving the embeddable signup form with new customization options and internationalization support. The release adds several new components to the Admin Design System, including TextArea, DropdownMenu, Avatar, and file upload components, which improve the overall admin experience.

The signup form now supports customization of background and button colors, with automatic text color calculation, and includes attribution tracking for better analytics. It also features responsive design and automatic height adjustment for better display across devices.

Internationalization has been significantly improved with new language translations for Finnish, Albanian, and Traditional Chinese, along with updates to existing translations for Turkish, Chinese, Spanish, French, and Bahasa Indonesia. The signup form now also supports i18n.

For content creators, the dark mode in the Lexical editor has been fixed, and post history functionality now works for all Lexical posts regardless of flags. The 'L' label next to Lexical posts in the post list has been removed for a cleaner interface.

This release also includes several bug fixes and performance improvements, making it a recommended upgrade for all Ghost users.

Full Release Notes