Linux 软件免费装
Banner图

StaticQ Media

开发者 goonydev
philooo
更新时间 2026年10月2日 02:31
PHP版本: 7.4 及以上
WordPress版本: 7.0
版权: GPLv2 or later
版权网址: 版权信息

标签

media library webp cloudflare r2 media offload orphan files

下载

3.4.0 3.3.4 3.4.1

详情介绍:

StaticQ Media is a complete image processing pipeline for WordPress. Upload once. StaticQ handles resizing, WebP conversion, cloud offloading, and front-end delivery in the background via WordPress cron. No required external API (the optional Cloudflare Image Resizing integration is the only external service, used only if you enable it). No per-image fees. Processing runs on your server, files live in your own cloud bucket. Actively maintained in 2026. Latest release: v3.4.1. What makes StaticQ different Most image optimization plugins compress and deliver. StaticQ Media also audits and cleans up. Three scanners catch what other plugins miss: All three are free in StaticQ Media. No competing image optimization plugin offers this combination. Common use cases How It Works
  1. Upload: image enters the processing queue
  2. WordPress cron generates all registered sizes + WebP variants
  3. Processed files are uploaded to your Cloudflare R2 bucket
  4. Front-end delivery rewrites <img> tags to <picture> elements with CDN URLs and WebP sources
Media Library Scanner Change your image sizes, switch themes, enable WebP: your media library drifts out of sync. The Media Library Scanner realigns everything in one pass across local disk and cloud bucket. Acts as a free regenerate thumbnails alternative when your theme's image sizes change. Post Content Scanner Switched CDN providers, migrated domains, cloned a site for staging, changed image sizes: your post content may still reference old URLs or outdated filenames, leaving broken images scattered across your site. The Post Content Scanner inspects every post for stale image references baked into your database and fixes broken images automatically. Handles post-migration URL rewriting that other offload plugins leave behind. Orphan Detection Deleted posts, removed theme sizes, failed uploads: files pile up with no attachment record. The Orphan Detection tool finds them across local disk and cloud bucket. No false-positive deletion: every candidate is reviewed and quarantined before anything is permanently removed. Run the Media Library Scanner first to fix metadata issues, then the Post Content Scanner to clean up stale references in your posts, then Orphan Detection to catch leftover files. Nothing is deleted without your review. Processing Storage Front-End Delivery Cloudflare Worker Deployment Deploy a Cloudflare Worker to serve media directly from your R2 bucket with automatic fallback to your origin server. The built-in wizard handles deployment, testing, and configuration. Developer Configuration Key wp-config.php constants for fine-tuning:

安装:

  1. Install and activate from Plugins > Add New, or upload the staticq-media folder to /wp-content/plugins/.
  2. Go to StaticQ > Settings.
Cloudflare R2 setup:
  1. Create an R2 bucket in the Cloudflare dashboard.
  2. Create an API token with R2 read/write permissions.
  3. Add credentials to wp-config.php (recommended) or the settings page.
  4. Set a custom domain or enable the R2.dev public URL.
  5. Click "Test Connection."
After storage is configured:
  1. Use Media Manager > Register to index your existing media library.
  2. New uploads are registered automatically.
  3. Run the Media Library Scanner to detect and repair any issues.

屏幕截图:

  • Drill into any attachment to see exactly which sizes, WebP variants, and storage locations need attention.
  • Post Content Scanner finds stale image URLs baked into your posts (wrong domains, deleted attachments, broken references) and rewrites them safely.
  • Orphan Detection walks your uploads directory and bucket for files that no longer belong to any attachment in your media library. Safe scan, then review before cleaning anything up.
  • Review orphan files before touching anything. Exclude folders, quarantine the rest, restore with one click if needed.
  • Choose how your media is stored: local only, cloud only, or both. Cloudflare R2 included free. No monthly fees.
  • Configure WebP conversion, picture-tag delivery, and per-size handling. Every option works without a paid tier.
  • One-click Cloudflare Worker deployment: no Wrangler CLI, no JavaScript. The wizard generates the script, deploys it, sets up routes, binds the R2 bucket, and verifies the result.
  • Register your existing media library in one read-only pass. New uploads register automatically.

升级注意事项:

3.4.1 Recommended on WordPress 7.1: fixes editor uploads losing their thumbnails in Cloud-only mode. Cloudflare JPEG thumbnails now follow the Image quality setting, and the Media Library column no longer shows false Drift. 3.4.0 Post Content Scanner no longer trusts the wp-image class over the file: mismatches are flagged in a new tab and never rewritten. Block-attribute URLs are now fixed with the HTML. July security and safety fixes included. Recommended for all sites. 3.3.4 Critical fix: prevents post_content corruption on save when StaticQ runs in Worker mode (the default) with the CDN host equal to the WordPress site host. Upgrade immediately if you've been on 3.3.0 to 3.3.3 with Worker-mode delivery on the same host. 3.3.3 Security hardening: late output escaping applied to admin UI render paths per WordPress.org review guidelines. 3.3.2 Bug fixes for the Move to /originals/ mode (now also moves locally), Media Library Scanner badge accuracy, and quieter debug.log output. 3.3.1 Renames the remaining STATICQ_* wp-config.php constants to the SQMEDIA_* prefix. If you set R2 credentials or the Cloudflare token via wp-config.php, update those constant names after upgrade. 3.3.0 Upgrading from a pre-3.3 dev build: settings will be reset. Reconfigure storage credentials and re-run the Worker wizard after upgrade. 3.2.0 Post Content Scanner, all features unlocked, table backup for scanner repairs. 3.1.0 Media Library Scanner, orphan detection, and Cloudflare Worker deployment. 3.0.0 New queue-based architecture. Existing media can be registered for reprocessing.

常见问题:

How does the processing queue work?

Images are not processed on upload. They enter a queue and are processed in batches by WordPress cron. Batch size and time budget are configurable. This avoids CPU spikes and timeouts, especially on shared hosting.

Is this an alternative to Smush, Imagify, or WP Offload Media?

StaticQ Media overlaps with all three but isn't a drop-in replacement for any of them. The pipeline (resize, WebP, offload, deliver) covers what Smush and Imagify do for image optimization, plus what WP Offload Media does for cloud storage, but only for Cloudflare R2. Where StaticQ Media adds something none of those offer is the three media library scanners (Media Library Scanner, Post Content Scanner, Orphan Detection). If you're on Cloudflare and want the full pipeline in one plugin with no monthly fees, StaticQ Media is a fit. If you're locked into AWS or use a different optimization workflow, those plugins may serve you better.

Do I need a Cloudflare account?

No, Cloudflare is optional. The plugin is optimized for Cloudflare workflows (R2 offload, Cloudflare Image Resizing, and the optional Worker fallback), but it runs fully on your own server without any cloud account. In local-only mode, StaticQ uses WordPress's native image editor (GD or Imagick) for resizing and WebP generation, files stay in your uploads directory, and the Media Library Scanner, Post Content Scanner, and Orphan Detection all work as a pure audit-and-cleanup toolkit. Cloudflare comes in when you want offsite storage, edge-based image resizing, or CDN fallback. R2's free tier (10 GB storage, 10 million reads/month) is generous for most WordPress sites if you decide to enable it.

Will it slow down uploads?

No, your upload completes instantly. Processing happens in the background via WordPress cron, fully decoupled from the upload request.

Can I process my existing media library?

Yes. The Media Manager registration tool indexes your entire existing library. Then run the Media Library Scanner to detect issues and repair them: missing sizes, WebP variants, and cloud sync gaps are all handled.

What happens if I deactivate the plugin?

Your original files remain untouched. Cloud copies stay in your bucket. Front-end delivery stops. WordPress falls back to local URLs. No data is deleted on deactivation.

Does it work with page builders?

Yes. Front-end delivery uses output buffering, so it works with Elementor, Divi, Gutenberg, Bricks, and any caching plugin that outputs standard HTML.

How do I monitor processing progress?

The Media Manager page shows queue status, processed counts, and per-attachment state. Scanner results show issue breakdowns by category.

What does the Media Library Scanner do?

It checks every attachment against your current settings in one pass. Metadata is validated for missing sizes, wrong dimensions, deprecated entries, and missing WebP variants. Files are verified across local disk and cloud bucket to ensure they exist in the correct storage location. Issues are categorized by type and severity. You can repair individual attachments with one click, or use Batch Fix All to resolve everything at once. After a theme change with new image sizes, it acts as a free regenerate thumbnails replacement.

What does the Post Content Scanner do?

It inspects every post, page, and custom post type for image references baked into the content. It detects URLs pointing to wrong domains (e.g. old CDN or migration leftovers), stale size references that no longer match current attachment metadata, deleted attachments still referenced in content, and broken URLs that cannot be resolved. Wrong domain and stale size issues can be fixed automatically: the scanner rewrites the URLs directly in the database. Deleted attachment and broken URL issues are reported for manual review.

How does Orphan Detection work?

Orphan Detection lists all files in your local uploads directory and cloud bucket, then compares them against the WordPress database. Any file with no matching attachment record is flagged as an orphan. You can exclude specific folders to avoid false positives. Orphans can be quarantined for safe review before permanent deletion. Run the Media Library Scanner first to fix metadata issues, then Orphan Detection to catch leftover files.

Does it strip EXIF data?

Yes. EXIF metadata (GPS coordinates, camera info, timestamps) is stripped during processing. This reduces file size and removes potentially sensitive location data.

Is StaticQ useful if I don't use cloud storage?

Absolutely. Cloud offloading is just one part of the pipeline. The Media Library Scanner audits your entire library and lets you repair everything in one pass. Orphan Detection cleans up leftover files. The Post Content Scanner fixes stale image references in your posts. And the queue-based processing prevents CPU spikes on upload, all without moving a single file off your server.

更新日志:

3.4.1 3.4.0 Post Content Scanner 3.3.4 3.3.3 3.3.2 3.3.1 3.3.0 3.2.0 3.1.0 3.0.0