Requirements & Compatibility
Understand compatibility checks, supported environments, and graceful fallback behavior.
Vacuum is built to degrade safely. Missing AVIF support does not block WebP, missing frontend delivery support does not modify stored URLs, and skipped files are reported rather than processed blindly.
Compatibility matrix
| Qualification environment | Result |
|---|---|
| WordPress 7.1.4 with PHP 8.3.36 and MariaDB 10.11 | Primary stable qualification passed |
| WordPress 7.1.4 with PHP 8.1.34 | Integration qualification passed |
| WordPress 7.1.4 with PHP 8.2.35 | Integration qualification passed |
| WordPress 7.0.8 with PHP 8.3.36 | Previous stable branch qualification passed |
| WordPress 7.2 Beta 4 with PHP 8.3.36 | Separate forward-compatibility preview passed; not a stable target |
The plugin header declares Tested up to WordPress 7.1. WordPress 7.2 Beta 4 is preview coverage only and is not used as the public compatibility value. The plugin requires WordPress 6.2 or newer and PHP 8.1 or newer.
Image-engine requirements
| Capability | Required for | Fallback |
|---|---|---|
| Imagick WebP write | WebP generation and WebP source optimization | GD WebP when available |
| GD WebP write | WebP generation | Imagick WebP when available |
| AVIF read/write | Optional AVIF generation | WebP and originals continue |
| Writable uploads | All generated file output | Optimization is blocked |
| Writable backups | Backup-first restore | Keep backups enabled for source-changing work |
| WP-Cron | Scheduled backup cleanup | Manual cleanup may be needed |
WordPress media processing
Both WordPress's browser-side upload processing and an isolated server-side fallback path were qualified. WordPress can create an attachment before its final registered sizes are ready; Vacuum reconciles the later metadata update and keeps automatic processing idempotent across repeated events.
Browser and cache behavior
Frontend delivery keeps original fallback markup available. Visitors whose browsers support AVIF or WebP can receive a valid modern format; other requests receive the original. Responses vary by Accept and include Vary: Accept. Configure page caches and CDNs to respect that header or vary their cache key by Accept.
Multisite notes
The plugin follows WordPress upload paths and table prefixes. Test each site in a multisite network separately before enabling upload automation broadly.
WooCommerce and gallery plugins
Vacuum integrates through WordPress image functions and media metadata. It works best with themes and plugins that use WordPress attachment APIs rather than hard-coded image URLs.