Ghost Release: 1.8.4

TL;DR

Ghost 1.8.4 brings several improvements to error handling and debugging capabilities, particularly for the ghost_head helper and image size utilities. This release also removes wishlist links as part of simplifying the user feedback process, introduces a new request utility that wraps the got library, and includes updates to the Casper theme and Ghost Admin. The focus is on stability, better error handling, and improved debugging tools for developers.

Highlight of the Release

• Improved error handling for ghost_head helper to ensure content renders despite errors
• Added comprehensive debug logging for image size utilities
• Introduced new request utility wrapping the got library
• Removed wishlist links as part of simplifying the user feedback process
• Updated Casper theme to version 2.1.1

Migration Guide

No migration steps are required for this release. The update can be applied directly without any additional configuration changes.

Upgrade Recommendations

This release focuses on stability improvements and developer tools rather than end-user features. While not critical, upgrading is recommended for all Ghost installations to benefit from the improved error handling and stability enhancements.

For developers working with Ghost themes or extensions, this update provides valuable debugging tools that can help identify and resolve issues more efficiently.

Bug Fixes

• Fixed issues with draft/scheduled/published dates in content list
• Fixed double scrollbar in PSM code injection editors
• Added error handling for ghost_head helper to ensure content renders despite errors
• Restored accidentally removed redirect test for image-size functionality

New Features

New Request Utility

A new utility has been introduced that wraps the got HTTP request library. This utility:

• Returns Bluebird promises for better performance and features
• Validates URLs before initiating requests
• Provides a standardized way to make HTTP requests throughout the codebase
• Is fully tested but not yet implemented across the codebase

Enhanced Debugging

• Added debug statements to ghost_head helper to measure render time performance
• Implemented comprehensive debug logging for image size utilities:
  • When images are fetched via network requests
  • When images are fetched from storage
  • When images are added to cache
  • When images are read from cache

Security Updates

No specific security fixes were included in this release.

Performance Improvements

• Improved ghost_head helper implementation:
  • Made promises more readable
  • Used join instead of props for more efficient code
  • Added debug statements to help identify performance bottlenecks
• The new request utility wrapping the got library provides a foundation for more efficient HTTP requests throughout the codebase

Impact Summary

Ghost 1.8.4 is primarily a maintenance release that improves stability and developer experience. The most significant changes include better error handling for the ghost_head helper, which now logs errors properly and continues to render content even when errors occur. This prevents blank pages or broken layouts that might have occurred previously.

The addition of debug logging for image size utilities will help developers troubleshoot image-related issues more effectively. The new request utility, while not yet implemented across the codebase, lays groundwork for more robust HTTP requests in future updates.

The removal of wishlist links represents a strategic shift in how Ghost collects user feedback, simplifying the process while still maintaining commitment to user-driven development.

For content creators, fixes to the content list date display and PSM code injection editor improve the day-to-day editing experience.

Full Release Notes