Ghost Release: 3.28.0

TL;DR

Ghost 3.28.0 Release

This release stabilizes the Webhooks API, fixes several critical bugs affecting member access, installation on Windows, and improves the editor experience. The update includes important fixes for member gating on custom static pages, webhook error handling, and installation compatibility for Windows users. Casper theme has been updated to version 3.1.0 with various improvements.

Highlight of the Release

• Webhooks API promoted to stable status in Admin API v3
• Fixed member gating on custom static page routes
• Fixed installation compatibility issues on Windows
• Updated Casper theme to version 3.1.0
• Improved error handling for webhooks API

Migration Guide

No specific migration steps are required for this update. The release maintains backward compatibility with previous 3.x versions.

For Windows users who previously had installation issues, you can now successfully install Ghost by:

1. Running PowerShell as administrator
2. Using the standard installation commands

git clone https://github.com/TryGhost/Ghost.git
cd Ghost
yarn setup

Upgrade Recommendations

This release is recommended for all Ghost users, especially those:

• Running Ghost on Windows systems
• Using member-gated content on custom static page routes
• Working with the Webhooks API
• Experiencing issues with the editor autosave indicator

The update contains important bug fixes and stability improvements with no breaking changes. Follow the standard upgrade process for your installation method (Git, Docker, or managed service).

Bug Fixes

Member Access Fixes

• Fixed incorrect member gating on custom static page routes: Resolved an issue where the member context was incorrectly set as members instead of member on custom static page routes. This bug was preventing logged-in members from accessing content they should have permission to view.

Installation and Integration Fixes

• Fixed installation on Windows: Resolved compatibility issues for Windows users by using platform-agnostic exit 0 command in setup scripts. Windows users can now install Ghost without errors, though administrator privileges in PowerShell are still required.

• Fixed integration_id assignment for webhooks: Corrected a bug where webhooks created through API key authentication were not properly associated with the correct integration.

Editor and UI Improvements

• Fixed missing autosave indicator in editor: Restored the autosave indicator that had disappeared in a previous update, providing better feedback to content creators during the editing process.

• Fixed incorrect scheduled date in toast notifications: Corrected the display of scheduled post dates in toast notifications.

• Fixed bookmark card image size in Fastmail: Resolved an issue where bookmark card images were displaying outside the bounds of the card in Fastmail by adding a max-height property.

API Error Handling

• Fixed 500 error in webhooks API: Improved error handling when attempting to modify non-existing webhooks, now returning a proper 404 response instead of a 500 server error.

• Reduced error level for not found post errors: Changed the error level from "critical" to the default level for post not found errors, as these are expected in certain scenarios and don't represent critical system failures.

New Features

Webhooks API Stabilization

The Webhooks API has been promoted from "canary/v3" to "stable" status. This change reflects that the API has been thoroughly tested and no breaking changes are planned for the v3 series. This provides developers with a reliable integration point for building external services that respond to events within Ghost.

Updated Casper Theme

Casper, the default Ghost theme, has been updated to version 3.1.0 with various improvements and refinements.

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Database Query Optimization

• Removed DISTINCT from member labels association query: Bookshelf ORM was adding DISTINCT to relation queries without explicit columns statements, causing performance issues. Removing this can result in 2-4x faster queries when listing members with their associated labels, depending on database indexing.

Impact Summary

Ghost 3.28.0 is primarily a maintenance release that stabilizes the Webhooks API and fixes several important bugs. The most significant impacts are:

1. Improved developer experience with the Webhooks API now being stable, providing a reliable integration point for external services.

2. Better Windows compatibility allowing more developers to install and run Ghost on Windows systems.

3. Fixed member access issues ensuring that paying members can properly access content they're entitled to on custom static page routes.

4. Enhanced editor experience with the restoration of the autosave indicator and improved scheduled post notifications.

These changes collectively improve the reliability and user experience of Ghost for content creators, developers, and members without introducing breaking changes.

Full Release Notes