Ghost Release: 2.0.3

TL;DR

Ghost 2.0.3: Bug Fixes and Improvements

This minor release focuses on fixing migration issues and improving server announcement handling. It addresses problems with the updated_at and updated_by fields during migrations, optimizes fixture replacement, and fixes editor functionality on Linux. The Casper theme has also been updated to version 2.5.1. This release is primarily maintenance-focused with no major new features.

Highlight of the Release

• Fixed migration issues with updated_at and updated_by fields
• Improved server start/stop announcement handling for Ghost as NPM module
• Optimized fixture replacement migration script with better safeguards
• Fixed Ctrl+Backspace functionality in the editor on Linux systems
• Updated Casper theme to version 2.5.1

Migration Guide

No specific migration steps are required for this update. This is a minor patch release (2.0.2 → 2.0.3) that should be straightforward to install.

If you're using Ghost as an NPM module, this update improves how server start/stop announcements are handled, but no changes to your implementation should be necessary as backwards compatibility has been maintained.

Upgrade Recommendations

This is a recommended upgrade for all Ghost users, especially for:

• Sites that have recently migrated or are planning to migrate from older versions of Ghost
• Developers using Ghost as an NPM module
• Users experiencing issues with post metadata changing during migrations
• Linux users experiencing editor issues with Ctrl+Backspace

As this is a patch release with bug fixes and no breaking changes, upgrading should be straightforward and low-risk. Standard backup procedures are recommended before upgrading as with any software update.

Bug Fixes

• Migration Field Preservation: Added logic to avoid updating the updated_at and updated_by fields when migrating content. This ensures that post metadata remains accurate after migrations.

  • Explicitly resets the previous updated_at field to counter Bookshelf's automatic updates
  • Extended conditions to avoid updating the updated_by field
  • Added detection and respect for options.migrating flag

• Fixture Replacement Improvements: Optimized the fixture replacement migration script to be more reliable.

  • Now only looks for published old fixture posts to prevent replacing draft posts with published ones
  • Ensures all detected old fixture posts are replaced with the correct date preservation
  • Added protections to prevent deletion of custom posts that use the same fixture post slugs

• Editor Fix: Fixed Ctrl+Backspace functionality on Linux systems, resolving a keyboard shortcut issue that affected text editing.

• Server Announcements: Changed where server start/stop announcements are triggered to ensure proper functionality when Ghost is used as an NPM module.

  • Made functions backwards compatible in case announceServerStart or announceServerStopped are called twice
  • Added conditional logic to respect internal maintenance flags

New Features

No significant new features were introduced in this release. This is primarily a maintenance release focused on bug fixes and improvements to existing functionality.

Security Updates

No security fixes were mentioned in this release.

Performance Improvements

No specific performance improvements were highlighted in this release. The changes were primarily focused on bug fixes and functional improvements rather than performance optimizations.

Impact Summary

Ghost 2.0.3 is a maintenance release that addresses several important bugs related to migrations, server announcements, and editor functionality. The most significant impact is for administrators performing migrations, as the fixes ensure post metadata (update timestamps and author information) is properly preserved.

Developers using Ghost as an NPM module will benefit from improved server announcement handling, with better internal logic and backwards compatibility. The optimized fixture replacement script also provides more reliable migrations from older Ghost versions, with additional safeguards to protect custom content.

For content creators, the Linux editor fix resolves an issue with the Ctrl+Backspace keyboard shortcut, improving the editing experience on that platform.

The Casper theme update to 2.5.1 is also included, though specific changes in the theme are not detailed.

Overall, this release focuses on stability and reliability rather than introducing new features.

Full Release Notes