Ghost Release: 2.25.8

TL;DR

Ghost 2.25.8: Bug Fixes for Tag Imports and Theme Cache Invalidation

This minor release addresses two important bugs in Ghost CMS. It fixes an issue with importing tags that don't have slugs but belong to posts, ensuring consistent behavior with Ghost's automatic slug generation. Additionally, it resolves a cache invalidation header problem for theme overrides. The release also includes refactoring of the authentication controller to prepare for future improvements.

Highlight of the Release

• Fixed tag import functionality to handle tags without slugs that belong to posts
• Corrected cache invalidation header for theme overrides
• Refactored authentication controller to prepare for future improvements

Migration Guide

No migration steps are required for this release. The update addresses bug fixes and internal refactoring that don't require any action from users.

Upgrade Recommendations

This release contains important bug fixes for tag imports and theme cache invalidation.

• Who should upgrade immediately:

  • Users who frequently import content with tags
  • Theme developers who work with theme overrides
  • Sites experiencing issues with theme cache invalidation

• Upgrade priority: Medium

  • While not critical for all users, this release fixes specific functionality that may impact content management workflows and theme development

The upgrade process follows the standard Ghost update procedure and should be straightforward with no breaking changes.

Bug Fixes

Fixed Tag Import Without Slugs

The import functionality now properly handles tags that don't have slugs but belong to posts. Previously, the importer assumed that all imported objects would have a slug property, which caused issues when importing tags without slugs. This fix ensures that Ghost automatically generates slugs for tags during import, consistent with the documented behavior for posts:

"The only strictly required field when importing posts is the title. Ghost will automatically generate slugs and set every other field to the default or empty."

The fix includes:

• Added originalIdMap to the importer base class to track ID substitution for relational resource updates
• Removed explicit use of this.stripProperties(['id']); in the beforeImport method of the base class
• Only calling this.stripProperties(['id']); in settings/trusted_domain imports
• Expanded regression tests with new supported import cases

Fixed Cache Invalidation Header on Theme Override

Fixed an incorrect property name that was preventing the proper setting of cache invalidation headers when theme overrides were applied. This ensures that theme changes are properly reflected without requiring manual cache clearing.

New Features

No new features were introduced in this release. The changes focus on bug fixes and internal refactoring.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release. The changes focus on bug fixes and internal code refactoring.

Impact Summary

Ghost 2.25.8 is a maintenance release that addresses two specific bugs: one related to importing tags without slugs that belong to posts, and another fixing cache invalidation headers for theme overrides.

The tag import fix ensures that Ghost properly handles tags without slugs during import, maintaining consistency with Ghost's documented behavior of automatically generating slugs for content. This is particularly important for content managers who import data from other platforms or backup files.

The theme cache invalidation fix ensures that when theme overrides are applied, the changes are properly reflected without requiring manual cache clearing. This improves the development experience for theme creators and administrators.

Additionally, the release includes internal refactoring of the authentication controller to prepare for future improvements, though these changes don't directly impact current functionality.

Overall, this is a targeted bug fix release that improves reliability without introducing breaking changes.

Full Release Notes