Deflato for WordPress

Settings Reference

<strong>Settings → Deflato</strong> — all plugin options:

• <strong>API Key</strong> — your Deflato API key.
• <strong>Compression Mode</strong> — three presets.
• <strong>Output Format</strong> — Keep Original, JPEG, PNG, WebP, or AVIF.
• <strong>Max Dimension</strong> — resize images larger than this.
• <strong>Strip EXIF</strong> — removes metadata.
• <strong>Compress Thumbnails</strong> — optimizes all thumbnail sizes.
• <strong>Backup Originals</strong> — saves originals for restore.
• <strong>Lazy Loading</strong> — adds loading=lazy to images.
• <strong>Picture Tags</strong> — wraps img in picture with WebP/AVIF.
• <strong>Generate WebP</strong> — creates .webp alongside originals.
• <strong>Smart PNG → JPEG</strong> — auto-detects and converts.

WP-CLI Commands

For developers and server administrators. Requires WP-CLI installed.

# Optimize all uncompressed images
wp deflato optimize --all

# Optimize with limit
wp deflato optimize --all --limit=100

# Re-optimize already compressed
wp deflato optimize --all --force

# Optimize a specific image by ID
wp deflato optimize --id=123

# View compression statistics
wp deflato stats

# Restore a specific image
wp deflato restore --id=123

# Restore all images
wp deflato restore --all

Folder Scanner

Go to Media → Deflato Bulk and scroll down to Folder Scanner. Select folders to scan:

• <strong>Active Theme</strong> — images in theme directory
• <strong>Parent Theme</strong> — if using a child theme
• <strong>Plugins</strong> — images bundled with plugins
• <strong>Other Uploads</strong> — files outside Media Library

Click Scan — the scanner finds all images, sorted by size. Then click Optimize.

How Smart PNG → JPEG Works

When you upload a PNG, the plugin:

1. Reads the PNG header to detect color type
2. For RGB without alpha — converts immediately
3. For indexed — checks for tRNS chunk
4. For RGBA — scans ~500 pixels checking alpha
5. If opaque → converts to JPEG with white background
6. If transparent → keeps as PNG

Result: opaque PNGs converted to JPEG, saving 60-80% before API compression.

Hooks & Filters for Developers

// Skip lazy loading for specific images
<img src="hero.jpg" class="no-lazy">

// Skip picture wrapping for specific images
<img src="logo.svg" class="no-picture">

// Plugin uses these WordPress hooks:
wp_handle_upload        // Smart PNG→JPEG (priority 5)
wp_generate_attachment_metadata  // Auto-compress (priority 10)
the_content             // Lazy loading (99), Picture tags (100)

AI Image Generator NEW

Generate images directly from text descriptions. Go to <strong>Media → AI Generate</strong>.

4 AI Models:

AI Generation Limits:

Each generation uses 1 API request from your AI limit (separate from compression). Powered by Deflato AI.

File Structure

deflato-image-optimizer/
  deflato-image-optimizer.php    # Main plugin file
  uninstall.php                  # Cleanup on delete
  readme.txt                     # WordPress.org format
  includes/
    class-deflato-api.php        # API client
    class-deflato-settings.php   # Settings page
    class-deflato-media.php      # Upload hooks, Media column
    class-deflato-bulk.php       # Bulk optimize page
    class-deflato-frontend.php   # Lazy loading, picture tags
    class-deflato-smartconvert.php # PNG→JPEG detection
    class-deflato-scanner.php    # Folder scanner
    class-deflato-cli.php        # WP-CLI commands
  admin/
    css/deflato-admin.css        # Admin styles
    js/deflato-admin.js          # AJAX handlers