Ghost Release: 2.13.2

TL;DR

Ghost 2.13.2 is a maintenance release that focuses on fixing several bugs related to file handling, authentication, and template helpers. It also introduces new Admin API endpoints for members and images, improves model event handling, and recommends Node v10 for better compatibility. This release enhances stability and performance while laying groundwork for future features.

Highlight of the Release

• Fixed file cleanup issues for uploads and imports
• Added new Admin API endpoints for members and images
• Improved model event handling with better change detection
• Fixed {{get}} helper access to globals
• Recommended Node v10 for better compatibility

Migration Guide

Node.js Version

Ghost now recommends using Node v10 for better compatibility. While not strictly required for this release, upgrading to Node v10 is recommended for optimal performance and stability.

See the Node.js versions FAQ for more information.

Admin API Changes

If you're using the Admin API:

• The /images/ endpoints are now available in Admin API v2 alongside the existing /uploads/ endpoints
• Paths returned for uploads are now absolute URLs
• The author field has been removed from Admin API v2 output as single author is deprecated and will be completely dropped in v3
• When creating posts via API keys, authors must be explicitly specified

Upgrade Recommendations

This is a maintenance release with important bug fixes and enhancements. Upgrading is recommended for all users, especially those who:

1. Have experienced issues with temporary files not being cleaned up after uploads or imports
2. Use the {{get}} helper with globals in theme templates
3. Rely on the Admin API for integrations
4. Have encountered errors related to missing sharp installations

The upgrade process should be straightforward with no breaking changes for most users. As always, it's recommended to backup your Ghost installation before upgrading.

Bug Fixes

File Handling Fixes

• Fixed files staying in temp directory after upload is done
• Fixed removal of temp files left behind by importer
• Improved importer cleanUp method to handle errors during import stages
• Simplified file cleanup tracking with new uploader middleware

Template Helper Fixes

• Fixed {{get}} helper filters access to globals
• Updated messaging around {{get}} helper access limitations
• Provided access to @site.lang and other globals in get helper filters

Other Fixes

• Fixed 500 errors when sending wrong mobiledoc structure
• Fixed error messages when admin API keys create posts without authors
• Fixed errors for missing sharp install
• Fixed acceptance test suite and various test issues
• Avoided storing empty plaintext if HTML doesn't contain any text

New Features

New Admin API Endpoints

• Added read and browse admin API endpoints for members
• Added /images/ endpoints to Admin API v2 (alongside existing /uploads/ endpoints)
• Changed path returned for uploads to absolute URLs in Admin API
• Enabled Admin API key authentication for various endpoints
• Allowed subscribers access via admin API v2 with API key authentication (needed for Zapier integration)

Other Improvements

• Added notImplemented middleware for integrations
• Added v2 theme controller
• Added base model debug logging for events
• Introduced model._changed to better track changes in models

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Test Performance Improvements

• Reduced and moved acceptance tests for admin API and content API
• Reduced duplicated and slow regression tests
• Optimized slow tests and cleaned up imports
• Consistent naming pattern for tests

Model Performance Improvements

• Added condition to not trigger events if nothing has changed in models
• Improved model change detection to avoid unnecessary processing
• Moved allowed options for findPage and filter to base model to reduce duplication

Impact Summary

Ghost 2.13.2 is primarily a maintenance release that addresses several important bugs while adding some new API capabilities. The most significant fixes relate to file handling, ensuring temporary files are properly cleaned up after uploads and imports, which improves system stability and prevents disk space issues over time.

For developers, the addition of new Admin API endpoints for members and images expands integration possibilities, while improvements to model event handling enhance performance by reducing unnecessary processing. Theme developers will benefit from fixes to the {{get}} helper, allowing proper access to globals like @site.lang.

The recommendation to use Node v10 aligns Ghost with modern Node.js practices and prepares users for future compatibility. Overall, this release enhances stability and performance while laying groundwork for future features, particularly around the Admin API.

Full Release Notes