Ghost Release: 5.55.0

TL;DR

Ghost v5.55.0: Collections, Stripe Coupon Imports, and Portal Improvements

This release introduces built-in collections with automatic filtering capabilities, support for importing Stripe coupons as offers, and fixes several portal-related issues including the ability to unsubscribe from hidden plans. The update also includes performance improvements for the beta editor and adds internationalization support with new language translations.

Highlight of the Release

• Added support for importing Stripe coupons as offers automatically
• Introduced built-in collections with automatic filtering capabilities
• Fixed issues with members unable to unsubscribe from hidden plans in Portal
• Added internationalization support with new language translations
• Improved performance for the beta editor when rendering posts

Migration Guide

Collections

If you've been using the experimental collections feature, note that the "index" collection has been renamed to "latest" to match marketing terminology. This change affects internal naming and should be transparent to most users.

Stripe Coupon Import

No migration is needed to use the new Stripe coupon import feature. The system will automatically create offers based on Stripe coupons when importing paid members if the corresponding offer doesn't already exist in your Ghost database.

Development Environment

If you're a developer working with the Ghost codebase:

• The pre-push hook has been removed as pushing to the main branch is no longer allowed
• A new yarn build:clean command is available to reset the Nx build cache
• The VSCode launch configuration has been updated with a new Ghost core + Admin option

Upgrade Recommendations

Recommended for:

• All Ghost users who want to take advantage of the new collections feature
• Sites using Stripe integrations who want to import coupons as offers
• Users experiencing issues with members unable to unsubscribe from hidden plans
• Developers looking for improved performance in the beta editor

This is a standard feature release with important bug fixes and enhancements. We recommend upgrading at your earliest convenience, especially if you're using the Portal feature with hidden plans or importing members from Stripe.

Bug Fixes

Portal and Subscription Issues

• Fixed issue where members were unable to unsubscribe from plans that had been hidden in Portal
• Restored the 'Change' button for members on paid plans even if the plan is hidden
• Modified the 'Change Plan' page to show current active plans even if hidden
• Added message for comped members to contact support if they want to change their plan
• Fixed success state on change password button in user settings

Other Fixes

• Fixed memberlinks returning undefined in autocomplete
• Fixed poor performance when rendering beta editor posts
• Fixed pages API test snapshot having a flaky cache string
• Fixed loading CDN assets via lazy loading
• Fixed visual bug on signup card frontend html
• Fixed timezone configuration in package tests
• Fixed ability to remove posts from automatic collections
• Fixed background color issue with PreviewModal

New Features

Collections

• Added built-in collections ('latest' and 'featured') with automatic population through fixtures
• Implemented collection filtering by tags with automatic post assignment
• Created a new {{#collection}} helper for displaying filtered content
• Added collection handling for post's tag attach/detach events to keep collections updated

Stripe Integration

• Added support for importing Stripe coupons as offers automatically when importing paid members
• Previously, if an offer didn't exist in the database, it wouldn't be created or attached to the subscription

Admin X Improvements

• Added static Newsletter settings to Admin X settings
• Implemented static design for Newsletter settings group with preview modal
• Added static button group for newsletter title alignment
• Created static components for Stripe Connect flow

Frontend Enhancements

• Added base styles for Header Card v2 for creating custom headers
• Configured Admin to use CDN URLs for lazy-loaded assets
• Made lexical rendering async to support dynamic data like collections

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Rendering and Loading Improvements

• Drastically reduced the number of jsdom instantiations when rendering text content in the beta editor
• Made lexical rendering async for improved performance
• Configured Admin to use CDN URLs for lazy-loaded assets for faster loading

Database and Transaction Handling

• Wrapped collection's post adding logic in transactions to prevent race conditions
• Wrapped collection's creation in transactions to avoid stale data issues
• Reworked PostsRepository to use model layer directly for better transaction support
• Optimized collection handling by removing unnecessary API calls

Development Experience

• Configured imported types in tsconfig to speed up builds (roughly 2x faster)
• Added shared tsconfig.json to list of files to build when changed
• Limited lib to es2022 to remove extra files during build
• Added yarn build:clean command to reset the Nx build cache

Impact Summary

Ghost v5.55.0 brings significant improvements to content organization with the introduction of built-in collections and automatic filtering capabilities. The new collections feature allows for more flexible content presentation through the {{#collection}} helper.

For sites using Stripe, the ability to automatically import coupons as offers streamlines the member import process and ensures discount continuity. This addresses a gap where imported members with Stripe coupons would lose their discount information.

Portal users benefit from several fixes, most notably the resolution of an issue where members couldn't unsubscribe from plans that had been hidden in Portal settings. The release also improves internationalization with new language translations and fixes for existing ones.

Performance improvements for the beta editor and the introduction of transaction-based collection handling make the system more robust and responsive. The groundwork for Admin X continues with static designs for Newsletter settings and Stripe Connect flow.

Overall, this release enhances content organization capabilities, fixes critical subscription management issues, and improves the overall stability and performance of the platform.

Full Release Notes