Ghost Release: 3.13.1

TL;DR

Ghost 3.13.1: Custom Storage Adapter Fix & Improved oEmbed Requests

This patch release fixes a critical issue with custom storage adapters that were inheriting from older versions of ghost-storage-base. It also improves oEmbed requests by implementing consistent timeout and user-agent headers. The release includes updates to the adapter manager and adds files to .npmignore for cleaner npm packages.

Highlight of the Release

• Fixed critical error when using custom storage adapters
• Improved oEmbed requests with consistent timeout and user-agent headers
• Updated @tryghost/adapter-manager to version 0.1.2
• Added changelog.md to .npmignore for cleaner npm packages

Migration Guide

No migration steps are required for this patch release. The update can be applied directly without any additional configuration changes.

Upgrade Recommendations

This patch release is recommended for all users, especially those using custom storage adapters or frequently embedding external content. The update addresses compatibility issues that could cause errors in production environments.

To upgrade:

• Follow the standard Ghost update procedure for your installation method
• No configuration changes are required after upgrading

Bug Fixes

Custom Storage Adapter Fix

Fixed an issue where custom storage adapters were inheriting from an older version of ghost-storage-base, causing errors when using these adapters. This was resolved by:

• Updating @tryghost/adapter-manager to version 0.1.1 and then to 0.1.2
• Ensuring proper inheritance chain for storage adapters
• Fixing compatibility issues with older ghost-storage-base versions

NPM Package Improvements

• Added changelog.md to .npmignore to keep the npm package cleaner
• Updated the GitHub Action for npm releases with proper login

New Features

Improved oEmbed Requests

Added consistent handling for oEmbed requests:

• Implemented a standard 2-second timeout for rel="alternate" oEmbed requests
• Added consistent Ghost user-agent header to match the initial HTML page request
• This ensures more reliable and predictable behavior when embedding external content

Security Updates

No specific security fixes were included in this release.

Performance Improvements

oEmbed Request Optimization

The standardization of oEmbed requests with a consistent 2-second timeout helps prevent hanging requests that could potentially slow down page rendering. This change ensures that embedded content doesn't negatively impact site performance by imposing reasonable time limits on external resource fetching.

Impact Summary

Ghost 3.13.1 is a targeted patch release that addresses specific issues with custom storage adapters and improves the reliability of oEmbed requests. The primary impact is on developers using custom storage adapters who may have experienced errors due to inheritance issues with older versions of ghost-storage-base.

The oEmbed improvements provide more consistent behavior when embedding external content, benefiting both developers and content creators. By standardizing timeouts and user-agent headers, the platform now handles embedded content more predictably.

This release demonstrates Ghost's commitment to maintaining compatibility with custom extensions and ensuring reliable content embedding capabilities. While the changes are relatively small in scope, they address important reliability issues that could affect production sites.

Full Release Notes