Ghost Release: 4.6.2

TL;DR

Ghost v4.6.2 fixes a critical bug affecting the @price.currency value in themes. This patch ensures that currency information is correctly pulled from the new settings introduced in v4.6, rather than from non-zero prices. The fix is essential for theme developers and site owners using membership features, as it ensures accurate currency display in theme templates.

Highlight of the Release

• Fixed a bug where @price.currency was displaying incorrect values in themes
• Updated the currency data source to use the new settings values introduced in Ghost 4.6
• Enhanced test coverage to specifically check price currency values

Migration Guide

No migration steps are required for this patch release. The fix is automatically applied when updating to Ghost v4.6.2.

Theme developers do not need to make any changes to their themes to benefit from this fix - the @price.currency value will now correctly reflect the currency set in the Ghost admin settings.

Upgrade Recommendations

This update is recommended for all users running Ghost 4.6 or 4.6.1, especially those using membership features with custom themes that display pricing information.

The upgrade process is straightforward:

1. Back up your Ghost installation
2. Follow the standard Ghost update procedure
3. No additional configuration changes are required

If you're using the @price.currency helper in your theme templates, you should verify that currency values are displaying correctly after the update.

Bug Fixes

Fixed incorrect @price.currency value in themes

This release fixes an issue where the @price.currency value in themes was pulling data from incorrect sources. The bug was introduced in Ghost 4.6, which changed how price IDs are stored and managed.

In Ghost 4.6, new settings were introduced (members_monthly_price_id and members_yearly_price_id) to determine active prices for a site. While the price values were updated to use these new settings, the currency information was still being pulled from non-zero prices instead of the new settings values.

This patch ensures that currency information is correctly sourced from the same settings as the price values, providing consistent and accurate pricing information in theme templates.

The fix also includes updated tests to specifically check price currency values, ensuring this issue won't recur in future releases.

New Features

No new features were introduced in this patch release. This is a bug fix release focused on correcting the @price.currency value in themes.

Security Updates

No security fixes were included in this patch release.

Performance Improvements

No specific performance improvements were included in this patch release. The focus was on fixing the currency value bug.

Impact Summary

This patch release fixes a specific bug related to currency display in themes. While not affecting core functionality, it ensures that membership pricing information is displayed with the correct currency symbol and code throughout the site.

The issue was introduced in Ghost 4.6 when changes were made to how price IDs are stored and managed. This release ensures that currency information is pulled from the same source as price values, maintaining consistency in pricing displays.

The fix is particularly important for sites using membership features with custom themes that display pricing information. Without this fix, themes might display incorrect currency information to potential members, potentially causing confusion or mistrust.

No other changes or features are included in this release, making it a focused bug fix update that should be safe to apply without risk of introducing new issues.

Full Release Notes