Ghost Release: 2.14.1

TL;DR

Ghost 2.14.1 is a maintenance release that fixes several important bugs affecting the admin interface and content management. Key improvements include fixing clickable code injection fields, correcting image URL storage in mobiledoc, and ensuring proper data handling for static pages. This release also includes significant under-the-hood improvements to the model and API layer to ensure consistent data handling and webhook functionality.

Highlight of the Release

• Fixed Code Injection input fields not being clickable in the admin interface
• Fixed Chrome remembering wrong username when signing up from invitation
• Improved model & API layer to ensure consistent data handling with proper defaults
• Enhanced webhook functionality with new events and improved payload formats
• Added JSON Schema validation for the /posts endpoint

Migration Guide

No migration steps are required for this release. This is a maintenance release that fixes bugs and improves existing functionality without introducing breaking changes.

For developers working with webhooks, note that this release maintains backward compatibility by keeping both payload formats for subscribers events, but further breaking changes may occur in the future as part of ongoing webhook improvements (referenced in issue #10438).

Upgrade Recommendations

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

1. Use Code Injection features regularly
2. Work with image-heavy content
3. Rely on static pages with custom data
4. Use Chrome for admin user management
5. Develop integrations using the Ghost API and webhooks

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

Bug Fixes

Admin Interface Fixes

• Fixed Code Injection input fields not being clickable
• Fixed Chrome remembering wrong username when signing up from invitation
• Fixed image URL to be stored as relative in mobiledoc, improving content portability
• Allowed data to be read from root of specified key for static pages

API and Model Layer Fixes

• Ensured defaults when creating resources to provide complete model data
• Fixed validation error when creating new tag from Post Settings Menu
• Fixed post.tags validation schema by changing oneOf to anyOf to allow any of the required fields
• Fixed JSON Schema validation error message format
• Avoided triggering site.changed event if nothing has changed
• Fixed triggering bookshelf event twice by bumping bookshelf-relations

New Features

Enhanced Model and API Layer

• Added model.wasChanged helper to check if a model was modified
• Added ability to receive toJSON format of previous attributes with model.toJSON({previous: true})
• Enhanced webhook functionality with new events and improved payload formats
• Added JSON Schema validation for the /posts endpoint
• Allowed POST & DELETE webhooks endpoints for integrations

Developer Experience Improvements

• Added yarn fixmodulenotdefined dev task to help resolve module errors in Ghost-Admin builds
• Updated oembed providers list with latest version
• Moved from grunt-eslint to npm script executing eslint directly

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Performance Optimizations

• Avoided inserting actions if nothing has changed in the database
• Optimized model updates to prevent unnecessary database operations
• Improved resource creation with proper default field handling
• Enhanced webhook delivery by only triggering events when actual changes occur

The model layer now properly checks if a model was changed before triggering events or performing updates, reducing unnecessary database operations and improving overall system performance.

Impact Summary

Ghost 2.14.1 delivers important bug fixes and enhancements that improve the stability and functionality of the platform. Content creators will benefit from fixed UI elements like clickable Code Injection fields and proper image URL handling. Developers gain access to improved model helpers, webhook functionality, and validation tools. The release also includes significant under-the-hood improvements to the model and API layer that ensure consistent data handling.

The default Casper theme has been upgraded to version 2.9.2, and several developer experience improvements have been made including better tooling and dependency management.

This release represents an important maintenance update that addresses several pain points reported by users while laying groundwork for future improvements to the webhook system.

Full Release Notes