Ghost Release: 3.42.8

TL;DR

Ghost 3.42.8: Bug Fix Release

This minor release addresses several critical bugs affecting URL handling, image resizing, and oEmbed functionality. It fixes issues with malformed URLs that were previously causing crashes, improves handling of blank images during resize operations, and resolves problems with whitespace in oEmbed bookmarks. These fixes enhance stability and prevent potential crashes in production environments.

Highlight of the Release

• Fixed URL helper crashes caused by malformed URLs with special characters
• Improved image resizing with fallback to original images when resizing fails
• Fixed oEmbed bookmark handling with whitespace characters
• Enhanced stability for production environments

Migration Guide

No migration steps are required for this release. This is a drop-in replacement that fixes bugs without introducing breaking changes or requiring configuration updates.

Upgrade Recommendations

This release contains important bug fixes that prevent crashes and improve stability. All Ghost users are recommended to upgrade to version 3.42.8, especially if you:

• Use the URL helper extensively in your themes
• Have content with embedded URLs or bookmarks
• Rely on image resizing functionality

The upgrade process is straightforward with no breaking changes or special steps required.

Bug Fixes

URL Helper Fixes

• Fixed an issue where malformed URLs containing characters like %% or %80 would crash the URL helper
• The system now properly identifies these as invalid URLs where percentages haven't been properly escaped

Image Handling Improvements

• Added a guard for empty buffers when reading files from storage for resizing
• When a blank image is loaded, the system now redirects to the original file instead of throwing an error
• Implemented a fallback to original images when Sharp/libvips fails during image resizing operations
• Resizing is now treated as an optimization rather than a requirement, preventing errors from affecting the user experience

oEmbed Enhancements

• Fixed issues with oEmbed bookmarks containing leading or trailing whitespaces
• Implemented trimming of URLs to handle edge cases that were previously causing failures in metascraper

New Features

No new features were introduced in this release as it focuses on bug fixes and stability improvements.

Security Updates

No security fixes were explicitly mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release. The changes focus on bug fixes and stability rather than performance enhancements.

Impact Summary

Ghost 3.42.8 is a stability-focused release that addresses several important bugs that could cause crashes or unexpected behavior in production environments.

The fixes for malformed URL handling prevent the URL helper from crashing when encountering certain special characters, making template rendering more robust. The improvements to image resizing add graceful fallbacks when processing fails, ensuring users always see images rather than errors. The oEmbed bookmark fix ensures that content with URLs containing whitespace will render correctly.

For developers, the hardcoding of Ghost-CLI to a supported version ensures compatibility with Node 10 environments, which is important for testing and certain deployment scenarios.

Overall, this release enhances the reliability of Ghost installations without introducing any breaking changes or requiring configuration updates. It's a recommended upgrade for all users to ensure stable operation.

Full Release Notes