Ghost Release: 4.25.0

TL;DR

Ghost 4.25.0 introduces three new editor cards (GIF, Button, and NFT) that enhance content creation capabilities. The update also includes important bug fixes for webhook errors with multiple-price subscriptions and bookmark embeds with whitespaces. Performance improvements come from code cleanup, test suite optimization, and error handling refinements. This release focuses on expanding content creation tools while improving system stability and performance.

Highlight of the Release

• Three new editor cards: GIF, Button, and NFT
• Fixed webhook errors for subscriptions with multiple prices
• Improved error handling and system stability
• Performance optimizations in test suites
• Updated Casper theme to v4.3.0 with support for new cards

Migration Guide

Theme Developers

If you're a theme developer, you'll need to add CSS support for the new Button and NFT cards. Ghost now includes theme CSS checks for these cards.

For the Button card:

/* Example styling for Button card */
.kg-button-card {
    /* Your styles here */
}

For the NFT card:

/* Example styling for NFT card */
.kg-nft-card {
    /* Your styles here */
}

The Casper theme (v4.3.0) has been updated with support for these new cards, which you can use as a reference.

Alternative Style Blockquotes

This release adds support for alternative style blockquotes:

• When rendering: <aside> sections are now rendered as <blockquote class="kg-blockquote-alt kg-width-wide">
• When creating posts using HTML: <blockquote class="kg-blockquote-alt"> is transformed to an aside section in mobiledoc

Upgrade Recommendations

This is a standard feature release with bug fixes and new content creation capabilities. We recommend all Ghost users upgrade to v4.25.0 to benefit from the new editor cards and important bug fixes.

The upgrade should be straightforward with no breaking changes reported. As always, make a backup of your Ghost installation before upgrading.

Bug Fixes

Fixed Issues

• Fixed 500 webhook errors for subscriptions with multiple prices
• Fixed oembed bookmark handling with whitespaces in URLs
• Fixed broken tiers dropdown on offer screen after Stripe reconnect
• Fixed hidden validation error during frontend reload
• Fixed invalid filename error during settings restore
• Redirected to original image when resizing fails instead of showing an error
• Fixed Toggle card email view
• Fixed stubbing of labs data in tests
• Fixed mock-express test setup

New Features

New Editor Cards

• GIF Card: Add animated GIFs directly in your content
• Button Card: Create customizable call-to-action buttons with alignment options
• NFT Card: Embed NFTs from OpenSea in posts and pages

API Improvements

• Added OpenSea API key configuration for NFT card functionality
• Initial custom embed provider for Twitter with fallback to existing behavior
• Added separate confirmation email for paid signups (behind feature flag)

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Performance and Code Quality

• Removed unnecessary redirects site regression test suite
• Unified RSS frontend tests for faster execution
• Added yarn cache to CI workflows
• Removed v2/v3 regression tests for non-stable endpoints
• Cleaned up code patterns in error handler
• Split theme engine middleware into separate files for better clarity
• Added lint warnings for bad patterns in migrations
• Added lint rules to prevent performance issues in migrations
• Removed unnecessary fixture setup in redirects e2e test
• Removed dead code in redirects test

Impact Summary

Ghost 4.25.0 significantly enhances content creation capabilities with three new editor cards - GIF, Button, and NFT - giving publishers more ways to create engaging content. The NFT card integration with OpenSea opens up new possibilities for web3 content.

The release also addresses several important bugs, particularly fixing webhook errors for subscriptions with multiple prices, which improves the reliability of the membership and payment systems.

Behind the scenes, substantial performance improvements have been made through test suite optimization and code cleanup. The introduction of lint rules for migrations will help prevent performance issues in future database migrations.

For theme developers, there's a need to add CSS support for the new Button and NFT cards, with the updated Casper theme (v4.3.0) providing a reference implementation.

Overall, this release balances new features with system stability and performance improvements, making it a worthwhile upgrade for all Ghost users.

Full Release Notes