Ghost Release: 4.6.1

TL;DR

Ghost 4.6.1: Bug Fixes for Members & Themes

This patch release addresses critical bugs affecting the members list functionality and theme price display. It fixes issues where the members list would fail to load due to missing Stripe price data and corrects price information displayed in themes. The release also includes several code refactoring improvements and dependency updates to enhance stability and maintainability.

Highlight of the Release

• Fixed members list loading issue when Stripe price data is missing
• Fixed incorrect price data display in themes
• Added Sentry integration properties to the site API
• Improved code organization with refactoring of scheduling components
• Enhanced linting rules to prevent code quality regressions

Migration Guide

No migration steps are required for this patch release. Simply update to v4.6.1 to benefit from the bug fixes and improvements.

Upgrade Recommendations

This is a recommended upgrade for all Ghost users, especially those using the members functionality or displaying pricing information in their themes. The release fixes critical bugs that could prevent the members list from loading and cause incorrect pricing information to be displayed.

To upgrade, follow the standard Ghost update process:

ghost update

If you're using Ghost(Pro), your site will be updated automatically.

Bug Fixes

Fixed Members List Loading

Fixed an issue where the members list would fail to load with a 500 error when Stripe price data was missing in the stripe_prices table. The API now properly guards against attempting to serialize empty price objects for member subscriptions.

Fixed Incorrect Price Data in Themes

Resolved an issue where the @price helper was using outdated logic to determine active monthly/yearly prices. The helper now correctly uses the new settings (members_monthly_price_id, members_yearly_price_id) to determine the current active prices for the site, ensuring accurate price information is displayed in themes.

Fixed Post Scheduler Initialization

Fixed initialization logic in the post scheduler that was simplified but not properly refactored in all places during previous changes.

New Features

Added Sentry Integration Properties

• Added sentry_dsn and sentry_env properties to /canary/site/ API endpoint
• Enables Admin to report unhandled exceptions and API errors when configured
• Improves error tracking and debugging capabilities

Security Updates

No security fixes were included in this release.

Performance Improvements

Code Refactoring and Improvements

• Refactored scheduling index files into class/initializer pattern for better testability
• Fixed no-restricted-require warning for core/shared/url-utils.js to maintain proper code boundaries
• Moved config and site API output generation to a public-config service
• Updated API output serializers to use an allow-list that limits data returned for each API version
• Refactored update check service to use async/await syntax for better readability
• Fixed subdirectory tests with the new boot process

Impact Summary

Ghost 4.6.1 is a patch release that addresses two critical bugs affecting the members list functionality and theme price display. The first bug caused the members list to fail to load when Stripe price data was missing in the database, resulting in a 500 error. The second bug caused incorrect price information to be displayed in themes due to the @price helper using outdated logic.

The release also includes several code refactoring improvements, including a better organization of scheduling components, stricter linting rules, and a new public-config service for site and config APIs. Additionally, Sentry integration properties have been added to the site API to improve error reporting capabilities.

These changes primarily benefit site administrators by ensuring they can access the members list without errors and display correct pricing information in themes. Developers will also benefit from the improved code organization and stricter linting rules.

Full Release Notes