Ghost Release: 1.20.1

TL;DR

Ghost 1.20.1 is a maintenance release that fixes several bugs and improves the backup endpoint functionality. This update addresses issues with keyboard input in Unsplash search, theme translation reloading, and improves error handling for authentication requests. It also includes performance enhancements for asset caching and several dependency updates to keep the platform secure and stable.

Highlight of the Release

• Fixed keyboard input issues in Unsplash search when adding tag covers
• Improved backup endpoint functionality with JSON responses and custom filenames
• Enhanced editor with highlighting of non-breaking spaces
• Increased cache-control for static assets to improve performance
• Fixed theme translation reloading when themes are overridden

Migration Guide

No migration steps are required for this release. This is a maintenance release that can be installed as a direct update from version 1.20.0.

Upgrade Recommendations

This is a recommended upgrade for all Ghost users currently on version 1.20.0. The release contains important bug fixes and performance improvements that enhance the stability and user experience of your Ghost installation.

The update process should be straightforward with no breaking changes or special migration steps required. As always, it's recommended to backup your Ghost installation before upgrading.

Bug Fixes

Fixed Keyboard Input Issues

• Fixed an issue where the 'c' and 'k' characters weren't working in Unsplash search when adding tag covers

Theme Translation Reloading

• Fixed a bug where theme translations weren't being reloaded when an active theme was overridden
• This issue occurred during the theme modification workflow (activate → download → modify → upload → override)
• Removed unused events in the theme API layer
• Added proper event triggering from the theme service

Authentication Error Handling

• Fixed incorrect status code (500) being returned for authentication requests with empty username/password
• Now properly returns a 400 status code for these requests
• Error messages remain accurate and helpful

New Features

Backup Endpoint Improvements

The backup endpoint has been enhanced with several improvements:

• Now returns responses in JSON format for better integration
• Allows setting custom export filenames
• Code has been refactored for better maintainability

Editor Enhancements

• Non-breaking spaces are now highlighted as special characters in the editor, making them more visible and helping content creators avoid formatting issues

Security Updates

No specific security fixes were mentioned in this release. However, the dependency updates included in this release may contain security patches from the respective packages.

Performance Improvements

Improved Asset Caching

• Increased cache-control duration for ghost-sdk.min.js and ghost.min.css in production environments
• This improves client-side performance while maintaining automatic cache invalidation when new releases are deployed
• Future plans include moving from query parameter-based cache busting (e.g., ghost-sdk.min.js?v=1234) to filename-based cache busting (e.g., ghost-sdk-1234.min.js) for better performance and more selective cache invalidation

Dependency Updates

Several dependencies have been updated to improve performance and security:

• [email protected]
• [email protected]
• [email protected]
• [email protected]
• [email protected]
• [email protected]
• brute-knex (updated to latest)
• [email protected]
• [email protected]

Impact Summary

Ghost 1.20.1 is primarily a maintenance release that addresses several bugs and introduces quality-of-life improvements for both users and developers. Content creators will benefit from fixed keyboard input issues in Unsplash search and better visibility of non-breaking spaces in the editor. Developers will appreciate the improved backup endpoint functionality and updated dependencies. Site administrators will see performance benefits from improved asset caching and more reliable theme handling.

While this release doesn't introduce major new features, it strengthens Ghost's foundation by fixing several issues that could impact the content creation workflow and site performance. The improvements to error handling and theme translation reloading demonstrate Ghost's commitment to providing a smooth and reliable publishing experience.

Full Release Notes