Home

>

Tools

>

Ghost

>

Releases

>

1.8.2

Ghost Release: 1.8.2

Tag Name: 1.8.2

Release Date: 9/5/2017

Ghost LogoGhost

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

TL;DR

Ghost 1.8.2 Release

This minor release fixes an important bug in the import/export functionality that was causing post IDs to be overwritten during sequential imports. It also includes a significant refactoring of how Ghost handles image dimension fetching, making the process more efficient by using local file storage when possible instead of relying on external URL requests. The Ghost Admin interface has also been updated to version 1.8.2.

Highlight of the Release

    • Fixed bug in import/export functionality that was overwriting post IDs during sequential imports
    • Refactored image dimension handling to use local file storage when possible
    • Improved performance by making blog logo image size detection synchronous
    • Updated Ghost Admin to version 1.8.2

Migration Guide

No migration steps are required for this update. This is a minor release that can be installed directly over version 1.8.1 without any special considerations.

Upgrade Recommendations

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

  • Regularly use the import/export functionality to migrate content between Ghost instances
  • Have previously imported content from LTS versions of Ghost
  • Manage sites with many images where performance improvements would be beneficial

The update is backward compatible and can be applied using your standard update process.

Bug Fixes

Import/Export Functionality Fix

  • Fixed a critical bug where post IDs from LTS (Long Term Support) exports were being overwritten during sequential imports
  • The system now only saves imported post IDs if the AMP field is empty, preventing data loss when:
    1. An LTS export is imported into a 1.0 blog
    2. That 1.0 blog is exported
    3. The export is re-imported into another 1.0 blog

This ensures proper preservation of post history and relationships across multiple import/export operations.

New Features

Enhanced Image Dimension Handling

The image dimension handling system has been significantly refactored to improve performance and reliability:

  • Added new function getImageSizeFromFilePath that reads dimensions directly from local file storage
  • Added intelligent routing that checks if images should be on local storage before attempting URL-based dimension fetching
  • Implemented fetchDimensionsFromBuffer utility that processes file buffers to extract image dimensions
  • Added new utilities in adapters/storage for streamlined file storage path handling

Security Updates

No specific security fixes were included in this release.

Performance Improvements

Image Processing Performance Improvements

  • Made blog logo image size detection synchronous, eliminating unnecessary async operations
  • Optimized image dimension fetching by using local file storage when possible instead of URL requests
  • Reduced external dependencies by consolidating image processing functions
  • Improved code organization by renaming image-size-from-url.js to the more generic image-size.js

Impact Summary

Ghost 1.8.2 delivers important fixes and improvements to the core platform. The bug fix for import/export functionality ensures content integrity when migrating between Ghost instances, particularly when dealing with content that originated in LTS versions. This is crucial for preserving post history and relationships.

The refactoring of image dimension handling represents a significant architectural improvement, making the system more efficient by leveraging local file storage when possible rather than making external URL requests. This change improves performance and reliability, especially for sites with many images.

While this is a minor release, the changes address important functionality that affects content migration workflows and overall system performance, making it a recommended update for all Ghost installations.

Full Release Notes

  • 🐛 Fixed only save imported post ids if amp field is empty (#8967)

You can see the full change log for the details of every change included in this release.

Statistics:

File Changed19
Line Additions2,357
Line Deletions641
Line Changes2,998
Total Commits4

User Affected:

  • Fixed issue where post IDs from LTS exports were being overwritten during sequential imports
  • More reliable preservation of content history when migrating between Ghost instances

Contributors:

acburdineaileenkirrg001