Ghost Release: 4.38.1

TL;DR

Ghost v4.38.1: Theme Activation Fix

What's new: This patch release fixes an issue with theme activation when theme names contain capital letters.

Why it matters: Previously, themes with capitalized names couldn't be properly activated due to a regex issue in the API handling, which was introduced after implementing non-versioned API URLs.

Who should care: Ghost site administrators and theme developers who work with themes that have capitalized names in their directory structure.

Highlight of the Release

• Fixed theme activation for themes with capitalized directory names
• Updated regex pattern for API URL detection to support non-versioned API URLs

Migration Guide

No migration steps are required for this patch release. Simply update to v4.38.1 to benefit from the bug fix.

Upgrade Recommendations

This is a minor patch release that fixes an issue with theme activation for themes with capitalized names. We recommend all users upgrade to v4.38.1, especially if you:

• Use themes with capitalized names in their directory structure
• Have experienced issues activating certain themes
• Manage multiple themes on your Ghost installation

The update process is standard and should not cause any disruption to your site.

Bug Fixes

Fixed Theme Activation with Capitalized Names

This release addresses an issue where themes with capitalized names in their directory structure couldn't be properly activated. The problem occurred after the introduction of non-versioned API URLs, which caused the isAPI regex to fail as it was expecting a canary/vX pattern in the API URL. This failure prevented the "uncapitalization" process from working correctly for API requests.

The fix updates the regex pattern to properly handle API URLs in both versioned and non-versioned formats, ensuring that theme activation works consistently regardless of capitalization in theme names.

References:

• Team issue #1420
• Toolbox issue #169

New Features

No new features were added in this patch release.

Security Updates

No security fixes were included in this patch release.

Performance Improvements

No specific performance improvements were included in this patch release.

Impact Summary

This patch release has a targeted impact, primarily affecting theme management functionality. It resolves an edge case where themes with capitalized names in their directory structure couldn't be properly activated after the introduction of non-versioned API URLs. The fix ensures that the API URL detection works correctly with both versioned and non-versioned formats, allowing the theme activation process to handle capitalization properly. This change improves compatibility and reduces friction for site administrators and theme developers who work with themes that don't follow lowercase naming conventions.

Full Release Notes