WP Manifestindependent plugin directory
manifest / media / wp-stateless-thumbnail-fix

WP Stateless CLI Image Thumbnail Fix

Fixes broken WordPress thumbnails when using Google Cloud Storage with WP Stateless plugin. Regenerates thumbnails locally for URLs/streams, cleans temp files, and optionally purges Cloudflare. Handles last 30 days or specific attachments. See: https://scarff.id.au/blog/2020/wordpress-gcs-plugin-broken-thumbnails/

by Your Name · github.com/leadstartorg/wp-stateless-thumbnail-fix

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/leadstartorg/wp-stateless-thumbnail-fix/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/leadstartorg/wp-stateless-thumbnail-fix ↗

Fixes broken WordPress thumbnails when using Google Cloud Storage with WP Stateless plugin. Regenerates thumbnails locally for URLs/streams, cleans temp files, and optionally purges Cloudflare. Handles last 30 days or specific attachments. See: https://scarff.id.au/blog/2020/wordpress-gcs-plugin-broken-thumbnails/

WP Stateless CLI Image Thumbnail Fix

Contributors: Jessica Kafor Tags: mu-plugin, stateless, GCS, thumbnails, wp-cli Requires at least: 5.0 Tested up to: 6.4 Requires PHP: 7.4 Stable tag: 1.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Fix broken thumbnails in WordPress when using GCS/Stateless Media.
Regenerates thumbnails using CDN or GCS URLs without requiring local files. Optionally purges Cloudflare cache.
Reference: Scarff blog on broken thumbnails

Description

The GCS/Stateless Media plugin allows storing WordPress media in Google Cloud Storage (GCS) for stateless environments like App Engine. By default, WordPress cannot generate thumbnails for URLs/streams.

This MU-plugin provides a WP-CLI command to safely regenerate thumbnails by:

  1. Temporarily downloading the image from CDN/GCS.
  2. Replacing the local file for regeneration.
  3. Restoring the local file and optionally purging Cloudflare cache.
  4. Supports fallback URLs in priority:
    • sm_cloud['fileLink'] → Primary CDN URL (fastest, ephemeral).
    • _wp_attached_file + CDN constant → Reliable default for any attachment.
    • sm_cloud['mediaLink'] → Last resort, direct GCS URL.

Installation

  1. Copy wp-stateless-cli-image-thumbnail-fix.php into wp-content/mu-plugins/.
  2. Optional: define WP_STATELESS_CDN_DOMAIN in wp-config.php.
  3. Optional: add Cloudflare API keys in wp-config.php if using --purge-cf.

Usage

Default: regenerate thumbnails from last 30 days:


wp stateless-cli-image-thumbnail-fix

Specific attachment ID:
wp stateless-cli-image-thumbnail-fix --id=297355

Regnerate last 7 days:
wp stateless-cli-image-thumbnail-fix --days=7

Force Cloudflare purge:
wp stateless-cli-image-thumbnail-fix --purge-cf

Single attachment with Cloudflare purge:
wp stateless-cli-image-thumbnail-fix --id=297355 --purge-cf

Override CDN domain for this run:
wp stateless-cli-image-thumbnail-fix --cdn-domain=https://cdn.example.com

## Frequently Asked Questions

### Why are thumbnails missing?
WordPress image editor functions like Imagick::readImage and realpath() do not work with URLs or PHP streams, which breaks thumbnail generation in stateless environments.

### Will this delete my local media?
No. Temporary files are created for regeneration and automatically removed after processing.

## Changelog

### 1.0
Initial release
Supports CDN/GCS fallback URLs
Adds WP-CLI command for regenerating thumbnails
Optional Cloudflare cache purge
Supports attachments by date range or specific ID