TL;DR
Ghost 1.24.2: Bug Fix Release
This release addresses several critical bugs affecting template rendering, post publishing, and error handling. The update fixes issues with template ordering, default theme context, post publishing failures related to Slack integration, and improves error handling. The Koenig editor beta also received Night Shift support for better editing in low-light environments.
Highlight of the Release
- Fixed critical bug preventing post publishing when Slack integration was misconfigured
- Restored proper template ordering after page refreshes
- Corrected default theme context handling for collections
- Added Night Shift support to the Koenig editor beta
- Improved error handling for admin area access
Migration Guide
No migration steps are required for this update. This is a patch release that fixes bugs without introducing breaking changes.
Note that a future minor release will include a migration script to correct any incorrect Slack settings values that may have been affected by the bug fixed in this release.
Upgrade Recommendations
This update is highly recommended for all Ghost users, especially those:
- Using the Slack integration for publishing notifications
- Experiencing issues with template ordering or theme context
- Encountering errors when accessing the admin area
As this is a patch release (1.24.2), the upgrade should be straightforward with minimal risk. The fixes address critical functionality issues that could impact content publishing and site rendering.
Bug Fixes
Fixed Template Order Not Being Respected After Refresh
Template ordering was being reversed multiple times after page refreshes, causing Ghost to randomly select between the first and second template. This issue has been resolved by ensuring the template array is only reversed once during initialization, maintaining consistent template selection.
Fixed Default Theme Context
The collection router had a hardcoded default context of "home" which was causing incorrect context application. This has been fixed to ensure the context array is automatically populated correctly:
- When serving the homepage (
/), the context is properly set to "home"
- When serving paginated pages (e.g.,
/page/2/), the context is correctly set to "paged"
This fix maintains the same behavior as in Ghost 1.23.x for {{body_class}} which outputs "home-template" on the homepage.
Fixed Unable to Publish Posts with Slack Integration Issues
A critical bug was fixed that prevented users from publishing posts when the Slack webhook integration was misconfigured. The error "can not find property url of undefined" was occurring due to incorrect Slack settings values introduced in 1.24.1. This update:
- Adds protection against invalid Slack settings values
- Implements the correct code to handle these scenarios
- Future minor releases will include a migration script to correct any affected incorrect Slack settings values
Fixed "No Default Engine Was Specified" Error
Added protection against the "No default engine was specified and no extension was provided" error that could occur when accessing the admin area. The fix ensures that the Express engine is properly initialized in the error handler when the first request to /ghost produces an error (such as a 503). This prevents the underlying error message from being hidden and allows Ghost to render error HTML templates correctly.
New Features
Night Shift Support for Koenig Editor Beta
The Koenig editor beta now includes Night Shift support, making it more comfortable to write and edit content in low-light environments. This enhancement improves the overall editing experience for content creators working at night or in darker settings.
For more information about the Koenig editor beta, check out the release announcement.
Security Updates
No security fixes were included in this release.
Performance Improvements
No specific performance improvements were included in this release. The focus was on fixing critical bugs affecting template rendering, post publishing, and error handling.
Impact Summary
Ghost 1.24.2 is a targeted bug fix release that addresses several critical issues affecting core functionality. The most significant impact is the resolution of a bug that prevented post publishing when Slack integration was misconfigured, which was introduced in 1.24.1.
The fixes for template ordering and default theme context restore expected behavior for theme developers and ensure consistent rendering of content. The improved error handling for the admin area provides better stability when encountering server issues.
The addition of Night Shift support to the Koenig editor beta enhances the editing experience for content creators working in low-light environments.
Overall, this release improves stability and reliability without introducing breaking changes, making it a recommended update for all Ghost installations.
Full Release Notes
- 🐛 Fixed "No default engine was specified and no extension was provided"
- 🐛 Fixed unable to publish a post with incorrect slack structure
- 🐛 Fixed default theme context
- 🐛 Fixed template order not being respected after refresh
Updates to the Koenig editor beta (release announcement):
You can see the full change log for the details of every change included in this release.