Ghost Release: 2.28.1

TL;DR

Ghost 2.28.1 is a maintenance release that fixes a critical import bug where pages were incorrectly converted to posts during imports created before version 2.28.0. This release also includes several model improvements, URL utility fixes, and internal code optimizations that enhance the platform's stability and maintainability.

Highlight of the Release

• Fixed critical import bug that was converting pages to posts
• Updated URL utilities to preserve HTML formatting and quote styles
• Improved model architecture with standardized action support
• Fixed npm package issues for developers

Migration Guide

No migration steps are required for this release. The update addresses bugs and makes internal improvements that don't require any action from users or developers.

Upgrade Recommendations

This update is recommended for all users, especially those who:

• Use the import/export functionality in Ghost
• Have imported content prior to Ghost 2.28.0
• Are npm users developing with Ghost

The update fixes a critical issue with content imports that could result in pages being incorrectly converted to posts, which could disrupt your site structure. The release also includes important fixes for npm users and improvements to the model architecture.

Bug Fixes

Import/Export Fixes

• Fixed critical issue where pages were incorrectly converted to posts during imports created before Ghost 2.28.0
• Updated the attribute sanitiser of the posts importer to properly convert post.page=true/false to post.type='page'/'post'
• Added logic to give precedence to post.type if an imported post has both post.page and post.type attributes

Developer Experience Fixes

• Fixed local package issue for npm users
• Updated @tryghost/url-utils to v0.3.0, fixing urlUtils.htmlRelativeToAbsolute which was mangling attribute quote styles and removing indentation

New Features

Model Architecture Improvements

• Updated Tag model to support actions
• Updated User model to support actions
• Simplified canary actions endpoint to allow for filtering and querying of all types of actions across separate resources and actors

Security Updates

No security fixes were included in this release.

Performance Improvements

Code Optimizations

• Simplified model event handler attachment for better readability and maintenance
• Removed redundant options from permittedOptions as the column option is already permitted at the Base model level
• Removed defaultColumnsToFetch from Base model and Post model
• Standardized require calls to use relative paths
• Removed dynamic generation of static resource_type

Impact Summary

Ghost 2.28.1 is primarily a bug fix release that addresses a critical issue with the import functionality. The fix ensures that pages remain properly categorized during imports, preventing potential disruption to site structure and navigation.

The release also includes several internal improvements to Ghost's model architecture, standardizing how actions are supported across different resources like Tags and Users. These changes lay groundwork for more consistent API behavior and developer experience.

For developers, the update to @tryghost/url-utils fixes HTML processing issues that were affecting content formatting, and the npm package fix resolves installation problems for those working with Ghost as a dependency.

Overall, this release enhances stability and reliability without introducing breaking changes or requiring migration steps.

Full Release Notes