Ghost Release: 5.110.4

TL;DR

Ghost v5.110.4 fixes a critical bug in the Portal component where error messages weren't properly displaying to users during form submissions. This patch ensures that error messages are correctly shown when users encounter issues with member forms, improving the overall user experience and site reliability.

Highlight of the Release

• Fixed critical bug where error messages weren't displaying to users in the Portal component
• Improved error handling for membership forms
• Enhanced test coverage for various error scenarios

Migration Guide

No migration steps are required for this release. The fix is automatically applied when updating to v5.110.4.

Upgrade Recommendations

This update is recommended for all Ghost users, especially those who rely on membership forms and the Portal component. The bug fix ensures that users receive proper error feedback when form submissions fail, which is essential for a good user experience.

To upgrade:

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

Bug Fixes

Portal Error Message Display Fix

This release addresses an issue where the Portal component wasn't properly updating DOM elements with the data-members-error attribute when errors occurred during form submissions. The fix ensures that:

• Error messages are now correctly displayed when form submissions fail
• DOM updates properly occur for elements with the data-members-error attribute
• Users receive appropriate feedback when errors happen during member-related actions

The fix resolves a support escalation issue (ONC-802) where error messages stopped appearing for users.

New Features

No new features were introduced in this release. This is a bug fix release focused on improving the existing functionality of the Portal component.

Security Updates

This release does not contain any security fixes.

Performance Improvements

While this release doesn't include specific performance improvements, the refactoring of the formSubmitHandler and introduction of the displayErrorIfElementExists function contributes to more efficient and reliable error handling, which may indirectly improve the responsiveness of the Portal component during error conditions.

Impact Summary

This release fixes a critical user experience issue where error messages weren't displaying properly in the Portal component. The impact is primarily positive for both site owners and visitors:

• Improved user experience: Visitors now receive clear feedback when their form submissions encounter errors
• Enhanced reliability: The Portal component now correctly handles and displays error states
• Better code quality: The refactored error handling improves maintainability and reliability
• Expanded test coverage: New tests ensure the error handling remains robust in future updates

The fix addresses a support escalation issue and ensures that the Portal component behaves as expected when errors occur during member-related actions.

Full Release Notes