5.127.1

TL;DR

Ghost v5.127.1: Bug Fixes and UI Improvements

This maintenance release addresses several critical bugs affecting the editor and email functionality. Key fixes include resolving copy/cut operations in the editor and eliminating unwanted whitespace in newsletter emails. The update also includes improvements to analytics displays, ActivityPub social features, and fixes for various sorting and display issues in the Stats dashboard.

Highlight of the Release

• Fixed copy/cut functionality in the editor that was preventing normal editing operations
• Eliminated unwanted whitespace at the top of newsletter emails for better appearance
• Added new paid member change chart showing new vs. canceled memberships
• Improved Stats dashboard with fixes for sorting in newsletters and top sources
• Enhanced ActivityPub with new follow/unfollow features

Migration Guide

No migration steps are required for this release. The update primarily consists of bug fixes and enhancements that don't require any action from users or administrators.

Upgrade Recommendations

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

1. Use the editor frequently for content creation, as it fixes critical copy/cut functionality
2. Send newsletters with colored backgrounds, as it fixes the unwanted whitespace issue
3. Rely on analytics data for business decisions, as it includes several fixes for stats displays

The update is a maintenance release with no breaking changes, making it a safe and straightforward upgrade from v5.127.0.

Bug Fixes

Editor Fixes

• Copy/Cut Operations: Fixed copy/cut functionality in the editor by including default node renderers that were previously missing.
• Email Button Rendering: Fixed email button partial erroring on invalid hex colors by adding guards for valid hex before calling color conversion functions.

Stats Dashboard Fixes

• Newsletter Sorting: Fixed sorting by clicks in the Stats > Newsletters top newsletters component.
• Top Sources Sorting: Fixed sorting in Stats > Growth > Top sources by rebuilding the stats endpoint and refactoring source mapping to the backend.
• Top Pages Listing: Fixed Stats > Growth > Top pages listing to properly show dynamic pages like authors, tags, and homepage that don't have a corresponding post record.
• Latest Post Metrics: Fixed display of metrics in the latest post component based on post type.

Email Improvements

• Newsletter Whitespace: Eliminated unwanted whitespace appearing at the top of newsletters by fixing CSS line-height issues that affected open-rate tracking pixels.
• Feedback Display: Updated feedback display logic to always show feedback if the post has it, regardless of newsletter settings.

UI Improvements

• Tab Rendering: Prevented rendering tabs until post data is loaded, avoiding UI flicker when loading email-only posts.

New Features

Analytics Improvements

• Paid Member Change Chart: Added a new bar chart to the Analytics section that displays new and cancelled paid members, providing better visibility into membership changes.

ActivityPub Enhancements

• Unfollow Option in Feed: Added an unfollow option to the feed item menu, allowing users to manage follows without visiting profile pages (behind the unfollow feature flag).
• Inline Follow Button: Implemented a direct follow button beside avatars for non-followed users, enabling one-click following directly from the feed (behind the unfollow feature flag).

Developer Tools

• Post Type Utilities: Added utility functions in post-helpers for determining post types and metrics to display, centralizing logic for handling posts.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

Data Fetching Optimizations

• Reduced Re-renders: Improved data fetching for the Stats > Newsletters component to prevent unnecessary re-rendering of the whole page on sort operations.
• Backend Source Mapping: Moved source mapping to the backend for top referrers, allowing proper application of limits and creating a single source of truth.

Code Cleanup

• Theme Management: Removed unused theme management code from Admin as these functions are now handled in Admin-X-Settings, eliminating redundant code.
• Search Exclusions: Removed snap files from search exclusion, enabling developers to search snapshot files when updating API endpoints or searching for returned fields.

API Query Handling

• Automatic Pagination: Updated Admin to automatically paginate any limit: 'all' queries by intercepting store queries and changing to looped ?limit=100 requests.
• Test Framework: Updated Admin tests to fail if any limit=all request gets through to API, ensuring compatibility with upcoming Ghost 6.0 changes.

Impact Summary

Ghost v5.127.1 delivers important fixes for core functionality while adding subtle but valuable enhancements to the platform. The editor fix restores essential copy/cut operations that directly impact content creators' workflow. Newsletter improvements eliminate visual issues that affected professional appearance of emails. The analytics enhancements provide better business intelligence through improved sorting, display of dynamic pages, and the new paid member change chart.

For developers, the code improvements around API query handling prepare for future Ghost 6.0 compatibility while improving current performance. The ActivityPub social features, though behind feature flags, continue Ghost's evolution as a connected publishing platform.

Overall, this release demonstrates Ghost's commitment to polishing the user experience while maintaining the platform's reliability and performance. The fixes address real user pain points reported through the issue tracking system, showing responsive development based on community feedback.

Full Release Notes