Ghost Release: 5.82.9

TL;DR

Ghost v5.82.9: Enhanced Search, Internal Linking, and Error Handling

This release significantly improves the Admin search experience with faster indexing and better result ordering. It introduces internal linking capabilities for standard links, enhancing content connectivity. The update also includes numerous error handling improvements to prevent HTTP 500 errors when dealing with user-submitted content, file uploads, and API requests. Several bug fixes address issues with offer codes, payment methods, and search functionality.

Highlight of the Release

• Added internal linking capabilities for standard links with metadata display on hover
• Improved Admin search with reduced re-indexing, better result ordering, and fixed stalling issues
• Enhanced error handling for user-submitted content, file uploads, and API requests
• Added Redis via Docker for improved local development capabilities
• Fixed payment method updating when using dynamic payment methods in Stripe

Migration Guide

No breaking changes were introduced in this release that would require migration steps. The improvements and bug fixes should work seamlessly with existing Ghost installations.

Upgrade Recommendations

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

1. Use the Admin search functionality frequently
2. Create internal links between content
3. Have experienced HTTP 500 errors when uploading files or handling user-submitted content
4. Use Stripe for payment processing with dynamic payment methods

The update includes significant improvements to search functionality, internal linking, and error handling that will enhance the overall user experience and system stability.

Bug Fixes

Error Handling Improvements

• Fixed handling of invalid Accept-Version header to prevent HTTP 500 errors
• Improved handling of malformed image and media upload requests
• Added proper error handling for cutoff boundary data in image and media uploads
• Added missing error messages for members uploader
• Fixed handling of uploads with invalid form bodies
• Added handling for parsing errors with user-submitted HTML
• Handled invalid timestamp format in filters
• Fixed handling of empty zip file uploads
• Added extra validation for reset_password endpoint

UI and Functionality Fixes

• Fixed error rendering when using a duplicate offer code
• Fixed Admin search sometimes stalling on first query
• Fixed empty groups in internal link searches
• Updated lock icon to use currentColor instead of hardcoded black
• Fixed updating payment method when beta flag is on
• Fixed subscription currency handling for setup sessions

New Features

Internal Linking for Standard Links

Ghost now supports internal linking capabilities for standard links, making it easier to connect content within your site. When creating links, you'll see search results for posts, pages, authors, and tags with additional metadata displayed on hover, including access status and publish date.

Improved Admin Search

The search functionality has been significantly enhanced with:

• Reduced re-indexing for better performance
• Explicit content expiry instead of time-based expiry
• Pre-fetching of search content when using the editor
• Better ordering of search results (authors and tags now appear before posts)
• Fixed issues with empty groups in search results

Redis via Docker

Redis has been added to the docker-compose file, allowing for easier local development when Redis is required for caching purposes within Ghost.

HTTPSignature Service

A new module has been added to handle signing and validating HTTP signatures, which is a core part of interfacing with ActivityPub-enabled servers. This will allow for generating signed requests for Activities.

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Search Performance Enhancements

The 30-second search content expiry has been replaced with explicit expiry, which reduces unnecessary delays and server load. Content is now:

• Fetched on query if not already loaded or marked as stale
• Pre-fetched when entering the editor if not already loaded
• Explicitly expired when relevant content changes (post save/delete, tag changes, user updates)

This results in faster search operations, especially when first using internal linking search inside the editor.

Code Optimizations

• Simplified Nx dev config for AdminX ActivityPub package
• Refactored Sentry beforeSend code for better efficiency
• Condensed logic for determining whether to send Sentry events

Impact Summary

Ghost v5.82.9 focuses on enhancing the content creation experience through improved internal linking and search capabilities. The addition of metadata display on hover for internal links makes it easier for content creators to select the right content to link to.

The search improvements are substantial, with better result ordering, reduced re-indexing, and fixes for stalling issues. This makes the search experience faster and more intuitive, especially within the editor.

The extensive error handling improvements address multiple scenarios where users previously encountered HTTP 500 errors, making the system more robust when dealing with user-submitted content, file uploads, and API requests.

For developers, the addition of Redis via Docker, improved JSDoc typing, and various code optimizations make the development experience smoother and more efficient.

Overall, this release enhances both the user experience and system stability without introducing breaking changes, making it a recommended upgrade for all Ghost users.

Full Release Notes