Home

>

Tools

>

Ghost

>

Releases

>

4.8.3

Ghost Release: 4.8.3

Tag Name: v4.8.3

Release Date: 6/24/2021

Ghost LogoGhost

Open-source publishing platform specifically designed for professional bloggers and publications. Focuses on clean, minimalist writing and publishing experience.

TL;DR

Ghost v4.8.3 fixes a critical bug in the API fields functionality that was causing incorrect data to be returned. This patch ensures that custom columns from the post model are properly included in API responses, restoring expected behavior for API consumers.

Highlight of the Release

    • Fixed critical bug in API field selection functionality
    • Restored proper inclusion of custom columns from post models
    • Corrected implementation of defaultColumnsToFetch function

Migration Guide

No migration steps are required for this update. This is a straightforward bug fix that restores expected behavior without requiring any changes to existing code or configurations.

Upgrade Recommendations

This release fixes a critical bug affecting API data retrieval. All users are strongly recommended to upgrade to v4.8.3, especially if you:

  • Use the Ghost API to retrieve post data
  • Have third-party integrations that rely on the Ghost API
  • Develop applications that consume Ghost data

The update is backward compatible and requires no configuration changes, making it a safe and straightforward upgrade from v4.8.2.

Bug Fixes

API Field Selection Fix

This release addresses a critical bug in the API field selection functionality that was causing incorrect data to be returned when using API fields. The issue stemmed from an incorrect implementation where the defaultColumnsToFetch function was moved to static class functions instead of remaining on the prototype.

The fix:

  • Moves defaultColumnsToFetch back to the prototype functions
  • Ensures custom columns from the post model are properly included in API responses
  • Reverts a previous commit that incorrectly moved the function from this.prototype

This resolves issues where API responses were missing expected data fields, particularly when working with post models.

New Features

No new features were introduced in this release. This is a bug fix release focused on correcting API behavior.

Security Updates

No security fixes were included in this release.

Performance Improvements

No specific performance improvements were included in this release. The focus was on fixing the API field selection bug.

Impact Summary

This release addresses a significant bug in Ghost's API field selection functionality that was causing incorrect data to be returned. The issue specifically affected how custom columns from post models were being handled, resulting in incomplete data sets when using API field selection.

The fix properly restores the defaultColumnsToFetch function to the prototype, ensuring that all expected data fields are included in API responses. This is particularly important for developers and integrations that rely on complete and accurate data from the Ghost API.

While this is a small patch in terms of code changes, it has a meaningful impact on API reliability and consistency, making it an important update for all Ghost installations, especially those with active API usage or third-party integrations.

Full Release Notes

Statistics:

File Changed3
Line Additions9
Line Deletions9
Line Changes18
Total Commits3

User Affected:

  • API requests using field selection now correctly return all expected data
  • Custom columns from post models are now properly included in responses
  • More reliable data retrieval for applications built on Ghost's API

Contributors:

daniellockyer