Ghost Release: 4.16.0

TL;DR

Ghost v4.16.0: Member Analytics & Custom Theme Settings

Ghost v4.16.0 introduces two significant alpha features: Member Analytics for tracking member activity and Custom Theme Settings for enhanced theme customization. This release also includes important email delivery fixes for SES and SMTP configurations, along with substantial code refactoring to improve maintainability. Site owners can now collect more detailed member interaction data and theme developers gain new customization capabilities, all while benefiting from a more stable email delivery system.

Highlight of the Release

• Introduction of Member Analytics as an alpha feature for tracking member activity
• Added Custom Theme Settings functionality for enhanced theme customization
• Fixed critical email delivery issues with SES and non-standard SMTP configurations
• Significant code refactoring to improve maintainability and reduce complexity

Migration Guide

For Theme Developers

If you're developing themes for Ghost, you should be aware of the new Custom Theme Settings functionality:

1. Custom theme settings are now stored in a dedicated database table
2. Values are synced with themes upon activation
3. The system tracks the type of each setting for proper value handling
4. Settings are cached to improve performance

No specific migration steps are required for existing themes, but you may want to explore implementing custom theme settings in your themes to take advantage of this new feature.

For Site Owners

The new Member Analytics and Offers features are currently behind alpha flags in Labs. To try them:

1. Go to your Ghost Admin settings
2. Navigate to Labs
3. Enable the "Member Activity" flag to start tracking member events
4. Enable the "Offers" flag to access the new Offers feature

Note that these are alpha features and may change in future releases.

Upgrade Recommendations

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

• Use SES or non-standard SMTP configurations for email delivery
• Want to track member activity on their site
• Are interested in theme customization capabilities

The email delivery fixes alone make this update valuable for most Ghost installations. The upgrade process follows the standard Ghost update procedure and should be straightforward with no breaking changes reported.

For self-hosted Ghost installations:

ghost update

For Ghost(Pro) users, the update will be automatically applied.

Bug Fixes

Email Delivery Fixes

• Fixed sending emails via SES by correcting the authentication mechanism
• Fixed issues with non-standard SMTP configurations by ensuring options are properly applied
• Updated @tryghost/nodemailer package to incorporate these fixes

Other Fixes

• Fixed typos in various parts of the codebase
• Corrected type declarations in ThemeStorage

New Features

Member Analytics (Alpha)

• Added new member analytics capabilities behind the membersActivity labs flag
• Implemented a new ghost analytics meta tag that captures page/post data for member events
• Created a new ingress endpoint for client-side events
• Added comprehensive member analytics events handling system
• Introduced member-analytics packages and supporting code

Custom Theme Settings

• Added custom_theme_settings table and model for storing theme setting values
• Implemented syncing of custom theme settings upon theme activation
• Created a caching system to avoid database roundtrips
• Added type tracking for custom theme settings to enable proper value coercion

Other Features

• Added Offers feature behind an Alpha flag

Security Updates

• Included security patch from v4.15.1 via updated @tryghost/members-api dependency

Performance Improvements

Caching Improvements

• Implemented a caching system for custom theme settings to reduce database queries
• Optimized settings handling through refactored code structure

Dependency Updates

• Updated multiple dependencies to their latest versions, including:
  • @sentry/node to v6.13.2
  • postcss to v8.3.7
  • glob to v7.2.0
  • Various @tryghost packages

Impact Summary

Ghost v4.16.0 delivers significant improvements in three key areas:

1. Member Engagement Tracking: The new Member Analytics feature (alpha) provides site owners with deeper insights into how members interact with their content, enabling more data-driven decisions about content strategy and member engagement.

2. Theme Customization: Custom Theme Settings introduces a flexible system for theme developers to create more customizable themes without requiring code changes, making Ghost more adaptable to various design needs.

3. Email Reliability: The fixes for SES and SMTP configurations ensure more reliable email delivery, which is critical for newsletters, member communications, and other email-dependent features.

Additionally, the extensive code refactoring improves the maintainability of Ghost's codebase, which should lead to more stable and efficient future releases. While most changes are behind-the-scenes, the new alpha features signal Ghost's continued evolution toward more powerful membership and customization capabilities.

Full Release Notes