Ghost Release: 5.42.2

TL;DR

Ghost v5.42.2 introduces several key improvements including post selection functionality, signup terms and checkbox requirements for member signups, and expanded internationalization with six new language translations. This release also includes important bug fixes for member imports, link pasting in HTML inputs, and email testing improvements. The update enhances both the user experience and developer workflow with minimal breaking changes.

Highlight of the Release

• Added support for selecting multiple posts with CMD, shift, and CMD+A
• Implemented signup terms and checkbox requirements for member signups
• Added six new Portal translations: Italian, Esperanto, Catalan, Swedish, Brazilian Portuguese, and Vietnamese
• Fixed member import issue with future-dated created_at timestamps
• Fixed link pasting in HTML inputs like image captions and newsletter footers

Migration Guide

No migration steps are required for this release. The changes are backward compatible and should not affect existing functionality.

If you're a developer working with the codebase:

• Note that the email mock receiver has been updated with new methods. The matchPlaintextSnapshot method has been extracted from matchMetadataSnapshot to handle dynamic content in the text part of sent emails.
• The sentEmailCount method has been renamed to the more descriptive assertSentEmailCount and now supports method chaining.

Upgrade Recommendations

This is a minor release with bug fixes and feature enhancements. It's recommended for all Ghost users to upgrade to v5.42.2 to benefit from the improvements and fixes.

The upgrade should be straightforward with no breaking changes to existing functionality. As always, it's recommended to back up your database before upgrading.

Bug Fixes

Member Management

• Fixed member import issue where members with future-dated created_at timestamps wouldn't appear in the members list
• Consolidated duplicate signup logic implementations into a single method

UI and Interaction

• Fixed issue with pasting links in Koenig basic HTML inputs (image captions, newsletter footer text)
  • Previously, pasting a link over selected text would delete the text and insert the link incorrectly
  • Now properly replaces selected text with the linked version
• Fixed Portal checkbox error hover state
• Fixed text not displaying when checkbox is disabled in Portal
• Added option to prevent modals from closing when pressing Enter key

Translation Fixes

• Fixed broken word in Dutch translations (corrected "spam folder" separation)
• Fixed typos in French translations
• Added missing translation strings
• Fixed newline issue in translations

Development and Testing

• Fixed typo in variable name for GeolocationService
• Fixed Portal yarn ship command
• Removed unnecessary mockMail call in tests

New Features

Post Selection and Bulk Editing

• Added support for selecting posts using CMD, shift, and CMD+A keyboard shortcuts
• Implemented a placeholder context menu for selected posts
• Added new bulk edit API endpoint for posts with filtering capabilities

Signup Terms and Requirements

• Added ability to configure signup terms and display a checkbox for acceptance
• Implemented validation to require checkbox acceptance when configured
• Positioned signup terms appropriately based on plan types (above plan selection for non-free plans)
• Added custom checkbox styling with error states when validation fails
• Implemented special handling for links in signup terms to open in new windows

Internationalization

• Added six new Portal translations:
  • Italian
  • Esperanto
  • Catalan
  • Swedish
  • Brazilian Portuguese
  • Vietnamese
• Updated the list of supported locales
• Improved existing Afrikaans and French translations

Security Updates

No significant security fixes were included in this release.

Performance Improvements

Test Stability Improvements

• Added retries to flaky email tests
• Added retries for all known flaky tests
  • For Mocha tests: added this.retries(1) to flaky tests
  • For Playwright tests: added test.describe.configure({ retries: 1}) to flaky describe blocks
• Improved test stability by awaiting jobs and events by default in all tests
  • Prevents issues where background tasks from one test affect subsequent tests
  • Reduces random error logs and test failures

Email Testing Enhancements

• Updated email mock receiver to support dynamic content in email snapshots
• Added email snapshot tests to newsletter suites
• Moved away from using mockManager.assert.sentEmail to more comprehensive testing with emailMockReceiver
• Added capability to make email HTML/text snapshots with dynamic content

Impact Summary

Ghost v5.42.2 delivers several quality-of-life improvements for both administrators and members. The new post selection functionality lays groundwork for more efficient content management through bulk actions. The signup terms and checkbox feature gives site owners more control over the signup process and helps with compliance requirements.

The addition of six new language translations significantly expands Ghost's international reach, making the platform more accessible to non-English speaking users. This continues Ghost's commitment to internationalization.

For developers, the improvements to test stability and email testing capabilities should result in a more reliable development experience with fewer flaky tests.

The bug fixes address several pain points, particularly the issue with member imports having future dates and the problem with pasting links in HTML inputs. These fixes improve the day-to-day experience of using Ghost for content creation and member management.

Full Release Notes