Home

>

Tools

>

Ghost

>

Releases

>

5.100.1

Ghost Release: 5.100.1

Tag Name: v5.100.1

Release Date: 11/7/2024

Ghost LogoGhost

Open-source publishing platform specifically designed for professional bloggers and publications. Focuses on clean, minimalist writing and publishing experience.

TL;DR

Ghost v5.100.1 fixes a critical bug that prevented newsletters from sending when a user had set an invalid locale. The fix ensures newsletters will always send by validating locales and falling back to en-gb when necessary, while also moving newsletter date localization behind a labs flag for safer rollout management.

Highlight of the Release

    • Fixed critical bug preventing newsletters from sending when invalid locales were configured
    • Added fallback to en-gb locale when invalid locales are detected
    • Moved newsletter date localization behind a labs flag for safer management

Migration Guide

No migration steps are required for this patch release. The update will automatically fix the newsletter sending functionality for installations experiencing issues with invalid locales.

Upgrade Recommendations

This patch release is highly recommended for all Ghost installations, especially for those using the newsletter functionality. The fix addresses a critical issue that could prevent newsletters from sending when invalid locales are configured.

The update is backward compatible and requires no configuration changes or migration steps. Users who rely on newsletter functionality should prioritize this upgrade to ensure reliable delivery.

Bug Fixes

Newsletter Sending Fix

Fixed a critical bug that prevented newsletters from sending when a user had configured an invalid locale. The issue occurred because:

  • User-input locales were being passed directly to Luxon for date formatting
  • Invalid locales caused Luxon to throw a RangeError: Incorrect locale information provided error
  • This error interrupted the newsletter sending process

The fix implements proper locale validation before passing values to Luxon, with an automatic fallback to en-gb when an invalid locale is detected, ensuring newsletters will always send regardless of locale configuration.

New Features

No new features were added in this patch release. This update focuses on bug fixes and stability improvements for the newsletter sending functionality.

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 critical bug affecting newsletter delivery functionality.

Impact Summary

This patch release addresses a critical bug in Ghost's newsletter sending functionality. Previously, if a user had configured an invalid locale, newsletters would fail to send due to errors in date formatting. The fix ensures that newsletters will always send by validating locales and falling back to en-gb when necessary.

Additionally, the newsletter date localization feature has been moved behind a labs flag, providing better control over this functionality and making it easier to revert if needed. This change improves the stability of the newsletter system while maintaining the ability to support localized dates for international users.

The impact is primarily positive for users who may have been experiencing newsletter sending failures due to locale configuration issues. After upgrading, these users will see their newsletters sending successfully, though dates may appear in the en-gb format rather than their preferred locale if their configured locale is invalid.

Full Release Notes

  • 🐛 Fixed newsletter not sending if locale is invalid (#21573) - Hannah Wolfe

View the changelog for full details: v5.100.0...v5.100.1

Statistics:

File Changed4
Line Additions135
Line Deletions18
Line Changes153
Total Commits3

User Affected:

  • Can now send newsletters successfully even when invalid locales are configured
  • Will see dates formatted in en-gb locale when their configured locale is invalid
  • Newsletter date localization is now controlled by a labs flag

Contributors:

ErisDSgithub-actions[bot]