Compress My A$$ (CMA) 🗜️🖼️

Zero-Bloat, Zero-SaaS Local Image Compression & Next-Gen Format Hyper-Optimizer for WordPress
The 5th Pillar of the Whole A$$ Security Suite by securemyass.com.
Direct open-architecture, privacy-first alternative to ShortPixel, Imagify, and Smush.

⚡ Key Highlights

• 100% On-Server Execution: Zero external cloud queues, zero recurring monthly API subscription fees, zero privacy leaks, and zero monthly image quota throttles.
• Multi-Driver Local Engine: Automatic environmental driver detection prioritizing PHP Imagick, PHP GD, and CLI binaries (cwebp, avifenc).
• Next-Gen WebP & AVIF Generation: Automatically compiles companion .webp and .avif assets for master images and all registered WordPress sub-sizes (thumbnails, medium, large).
• Non-Destructive Master Media Vault: Safely archives untouched master images into /wp-content/uploads/cma-vault/ fortified by Triple Execution Barriers (.htaccess, .user.ini, index.php) with 1-click rollback.
• Dynamic <picture> Tag Delivery: Injects modern <picture><source type="image/webp" ...><img ...></picture> on frontend page render for 100% browser compatibility and instant LCP optimization.
• Chunked Bulk Recompressor: Asynchronous batch processor with real-time AJAX streaming, pause/resume capability, and zero PHP execution timeout risk.
• Media Library Integration: Adds granular compression metrics, WebP indicators, and inline optimize/restore actions directly to WordPress upload.php list view.
• Full WP-CLI Suite: Headless server control via wp cma status, wp cma compress, wp cma restore, wp cma generate-webp, and wp cma benchmark.
• Whole A$$ Suite Synergy: Natively recognized by Speed My A$$ Up (SMAU); CMA WebP images are prioritized by SMAU's SMAU_Media_Engine as high-priority LCP targets.

🥊 Head-to-Head: Compress My A$$ vs. Cloud SaaS Plugins

💻 WP-CLI Command Reference

🏗️ Architecture & Pipeline

                     Incoming Media Upload (or Bulk Scan)
                                      │
                                      ▼
             ┌─────────────────────────────────────────────────┐
             │       CMA Non-Destructive Vault Backup          │
             │   Stores original master into /cma-vault/       │
             │   Enforces Triple Barrier (.htaccess/.user.ini) │
             └────────────────────────┬────────────────────────┘
                                      │
                                      ▼
             ┌─────────────────────────────────────────────────┐
             │         Multi-Driver Compression Engine         │
             │   • Driver Priority: Imagick > GD > CLI         │
             │   • Auto-Downscale (e.g. >2560px)               │
             │   • EXIF / Metadata Stripping                   │
             │   • Quality Optimization (Lossless/Balanced)    │
             └────────────────────────┬────────────────────────┘
                                      │
                                      ▼
             ┌─────────────────────────────────────────────────┐
             │          Next-Gen WebP & AVIF Compiler          │
             │   Generates companion .webp for master & sizes  │
             └────────────────────────┬────────────────────────┘
                                      │
                                      ▼
             ┌─────────────────────────────────────────────────┐
             │            Frontend <picture> Rewriter          │
             │   Transparently serves WebP to modern browsers  │
             │   Coordinates with Speed My A$$ Up (LCP Turbo)  │
             └─────────────────────────────────────────────────┘

🔒 Whole A$$ Security Suite Interoperability

Compress My A$$ coordinates natively with companion products in the Whole A$$ Security Suite:

• Speed My A$$ Up: CMA WebP and AVIF assets are recognized and prioritized by SMAU as high-priority LCP targets.
• Guard My A$$: Pre-boot entropy filtering protects media uploads and REST endpoints from exploit payloads.
• Back My A$$ Up: Securely vaults untouched master images in /cma-vault/ before cloud replication.
• Secure My A$$: Enforces execution barriers (.htaccess, .user.ini, index.php) inside media vault directories.
• Doc My A$$: High-velocity developer documentation system, Cmd+K search, Docs-as-Code, and zero-bloat standalone reader.

📄 License & Attribution

Developed by Cynthia Schomp as part of the Whole A$$ Security Suite for securemyass.com.
Licensed under the GNU General Public License v3.0.