Ghost Release: 5.80.2

TL;DR

Ghost v5.80.2: Bug Fixes and Performance Improvements

This release focuses on fixing several critical bugs affecting the user experience in Ghost CMS. Key improvements include fixing issues with the tiers-only paywall incorrectly showing free tiers, resolving HTML card rendering problems with single-quoted attributes, preventing 500 errors with API tokens, and enhancing the Comments UI with lazy-loading for better performance. The update also addresses UI issues in Portal, Unsplash integration, and the Announcement Bar.

Highlight of the Release

• Fixed incorrect display of free tier in tiers-only paywalls
• Resolved HTML card rendering issues with single-quoted attributes
• Improved performance with lazy-loading of Comments UI admin authentication
• Fixed 500 error responses for premature API token use
• Enhanced error handling for JWT authentication

Migration Guide

This release doesn't require any specific migration steps. It's a maintenance release focused on bug fixes and performance improvements that should work seamlessly when upgrading from v5.80.1.

If you've been experiencing any of the specific issues addressed in this release (such as HTML card rendering problems or issues with the tiers-only paywall), upgrading to v5.80.2 should resolve these without requiring additional configuration.

Upgrade Recommendations

We recommend all Ghost users upgrade to v5.80.2, especially if you're experiencing any of the specific issues addressed in this release. The update includes important bug fixes that improve the stability and user experience of your Ghost installation.

This is a minor patch release with no breaking changes, so upgrading should be straightforward and low-risk. The performance improvements to HTML parsing and Comments UI loading will benefit all users by improving page load times and reducing unnecessary API requests.

Bug Fixes

• Paywall Display: Fixed an issue where the free tier was incorrectly showing in tiers-only paywalls in posts.
• HTML Card Rendering: Resolved a problem where single-quoted attributes in HTML cards were unexpectedly converted to double-quotes, which could break rendering of content with JSON data in data- attributes.
• API Error Handling: Fixed 500 error responses for premature API token use by properly handling NotBeforeError and improving JWT error handling.
• Announcement Bar: Fixed emojis not updating properly in the Announcement Bar by changing the update method from onBlur to a 500ms debounce.
• Portal UI Issues:
  • Fixed spacing problems in the Portal signup page
  • Corrected button spacing in Portal unsubscribe popup footer
  • Fixed TZ dependency in Portal helpers test
• Admin UI Fixes:
  • Fixed various Unsplash design bugs including visibility of buttons, gallery image ratio, search input border style, and more
  • Fixed update banner z-index conflicts in settings
• Preview Stability: Added try/catch to iFrame buffering in Settings to prevent crashes from injected code
• French Translation: Fixed a translation error in portal.json where "save" was incorrectly translated

New Features

This release primarily focuses on bug fixes and performance improvements rather than introducing new features. However, there are some notable enhancements:

• Improved Meta Data Settings: Reorganized and improved meta data settings for easier parsing and management.
• Enhanced Portal Testing: Added comprehensive tests for newsletter subscriptions in Portal, particularly for the previously untested UnsubscribePage.
• Updated Source to v1.2.0: Integrated the latest version of Source.

Security Updates

No specific security fixes were mentioned in this release. The improvements to JWT error handling could be considered security-adjacent as they improve the robustness of the authentication system, but they weren't explicitly labeled as security fixes.

Performance Improvements

• Comments UI Optimization: Implemented lazy-loading of admin authentication in Comments UI, deferring the loading of the admin-auth iframe and API requests until comments are actually visible.

  • This eliminates unnecessary requests for posts with no comments
  • Only loads authentication when comments have been fetched and the count is greater than 0

• HTML Parsing Performance: Replaced Cheerio with html5parser for tokenizing HTML strings when modifying links for member attribution:

  • Achieved a 3x performance improvement in the link replacer implementation
  • Reduced processing overhead by avoiding full parse+serialize steps
  • Preserved original HTML structure more faithfully

Impact Summary

Ghost v5.80.2 is a maintenance release that addresses several important bugs and introduces performance optimizations. The most significant impact comes from fixing rendering issues with HTML cards that use single-quoted attributes, which could previously break content display. The fix for the tiers-only paywall incorrectly showing free tiers ensures that membership access controls work as intended.

Performance improvements in the Comments UI and HTML parsing provide a smoother experience for both site visitors and administrators. The lazy-loading of admin authentication in Comments UI reduces unnecessary API requests, which is particularly beneficial for sites with many posts but few comments.

UI improvements across Portal, Unsplash integration, and the admin interface enhance the overall user experience for both content creators and site administrators. The fixes for the Announcement Bar emoji updates and various spacing issues in Portal ensure a more polished presentation to members.

Overall, while this release doesn't introduce major new features, it significantly improves the reliability and performance of existing functionality, making it a worthwhile upgrade for all Ghost users.

Full Release Notes