Ghost Release: 1.24.3

TL;DR

Ghost 1.24.3: Bug fixes for subdirectory installations and custom templates, plus Koenig editor improvements

This minor release fixes critical issues with Ghost running on subdirectories, restores custom template functionality for tags and authors, and enhances the Koenig editor beta with a new embed card feature. The update also includes improvements to error messages and private mode notifications, making Ghost more user-friendly and consistent.

Highlight of the Release

• Fixed critical issue with preview URLs and Zapier integration on subdirectory installations
• Restored custom template functionality for tags and authors
• Added new embed card to the Koenig editor beta
• Fixed high CPU usage in Koenig editor caused by Grammarly
• Added new /oembed API endpoint for embedding external content

Migration Guide

No specific migration steps are required for this release. This is a minor update that fixes bugs and adds features without breaking changes.

If you're running Ghost on a subdirectory installation and experienced issues with preview functionality or Zapier integration after updating to 1.24.0, updating to 1.24.3 will resolve these problems automatically.

Upgrade Recommendations

This update is highly recommended for all Ghost users, especially for:

• Sites running Ghost on a subdirectory
• Users of the Koenig editor beta
• Anyone using custom templates for tags or authors

The release contains important bug fixes that restore functionality broken in previous versions, particularly for subdirectory installations. The update process should be straightforward with no breaking changes introduced.

As always, it's recommended to backup your database before upgrading.

Bug Fixes

Critical Fixes

• Subdirectory Installation Issues: Fixed a breaking change introduced in 1.24.0 where Ghost returned resource URLs including the subdirectory, causing problems with:
  • Preview functionality in the admin client
  • Zapier integration
  • The fix ensures Ghost only exposes resource URLs without the subdirectory

Template Rendering

• Custom Templates for Tags and Authors: Fixed slug template forwarding for tags and authors that was broken in the 1.24.0 dynamic routing beta. This restores the ability to render custom templates like tag-news.hbs for specific tags or authors.

Koenig Editor

• High CPU Usage: Disabled Grammarly integration in the Koenig editor to fix high CPU usage issues reported by users.

Error Handling

• Improved Error Messages: Enhanced error messaging for URL Service 503 errors with simplified language and better consistency with other similar messages throughout the platform.

Minor Fixes

• Fixed a typo in a comment in core/server/services/apps/index.js

New Features

Koenig Editor Enhancements

• New Embed Card: Added a new embed card renderer to the Koenig editor beta, allowing content creators to easily embed external content into their posts.

API Improvements

• New /oembed API Endpoint: Added an authenticated endpoint that takes a ?url= query parameter to match against known providers. This endpoint:
  • Uses the oembed-parser module to check provider availability and fetch data
  • Includes safeguards against oembed-parser's providers list not recognizing http+https and www+non-www variations
  • Returns a validation error if no provider is found
  • Returns the oembed response from the matched provider if a match is found

UI Improvements

• Updated Private Mode Message: Changed terminology from "blog" to "site" in private mode messaging and now uses the blog title for meta title description, providing a more consistent user experience.

Security Updates

No security fixes were included in this release.

Performance Improvements

• Koenig Editor Optimization: Disabled Grammarly integration in the Koenig editor beta, which significantly reduces CPU usage when editing content. This change improves the overall editing experience, especially on less powerful devices.

• Embed Handling: The new oembed implementation provides a more efficient way to embed external content compared to previous methods.

Impact Summary

Ghost 1.24.3 is primarily a bug fix release that addresses several issues introduced in the 1.24.0 dynamic routing beta. The most significant impact is for users running Ghost on subdirectories, who will see restored functionality for preview URLs and Zapier integration.

Content creators using the Koenig editor beta will benefit from the new embed card feature and improved performance due to the Grammarly fix. Developers will appreciate the fixed custom template functionality for tags and authors, as well as the new oembed API endpoint.

The changes to error messages and private mode notifications are minor but contribute to a more consistent user experience across the platform. Overall, this release enhances stability and usability without introducing breaking changes.

Full Release Notes