=== Webangon Image Optimizer ===
Contributors: webangon
Tags: image optimization, webp, avif, thumbnails, media cleaner, wp-cli
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Clean unused images, regenerate thumbnails, and convert Media Library files to WebP or AVIF from one WordPress plugin.

== Description ==

Webangon Image Optimizer gives WordPress users one place to manage heavy image maintenance tasks. It helps reduce storage, improve image delivery, rebuild thumbnails after theme or migration changes, and run large jobs from WP-CLI.

Benefits for WordPress users:

* Find unused Media Library images with a safe dry scan before deletion.
* Protect images used in Elementor, post content, featured images, WooCommerce galleries, widgets, theme/plugin options, SEO fields, and more.
* Regenerate thumbnails after theme changes, imports, migrations, or image-size updates.
* Remove old generated thumbnail files while keeping original/main images.
* Convert images to WebP or AVIF for better performance.
* Rewrite image URLs across posts, post meta, Elementor data, and options after conversion.
* Run image cleanup, thumbnail, and conversion tasks from WP-CLI.

The admin screen is available under Media > Image Optimizer.

== WP-CLI Commands ==

Image cleaner:

`wp webangon-image-optimizer clean`
`wp webangon-image-optimizer clean --older-than=30`
`wp webangon-image-optimizer clean --deep-meta`
`wp webangon-image-optimizer clean --include-revisions`
`wp webangon-image-optimizer clean --skip-options`
`wp webangon-image-optimizer clean --batch=200`
`wp webangon-image-optimizer clean --delete`
`wp webangon-image-optimizer clean --delete --yes`

Thumbnail regeneration:

`wp webangon-image-optimizer thumbnails regenerate`
`wp webangon-image-optimizer thumbnails regenerate --sizes=thumbnail,medium,large`
`wp webangon-image-optimizer thumbnails regenerate --delete-old`
`wp webangon-image-optimizer thumbnails regenerate --from-original`
`wp webangon-image-optimizer thumbnails regenerate --ids=12,34,56`
`wp webangon-image-optimizer thumbnails regenerate --dry-run`

Thumbnail purge:

`wp webangon-image-optimizer thumbnails purge`
`wp webangon-image-optimizer thumbnails purge --backups`
`wp webangon-image-optimizer thumbnails purge --ids=12,34,56`
`wp webangon-image-optimizer thumbnails purge --dry-run`
`wp webangon-image-optimizer thumbnails purge --yes`

WebP / AVIF conversion:

`wp webangon-image-optimizer convert --format=webp --quality=82`
`wp webangon-image-optimizer convert --format=avif --quality=70`
`wp webangon-image-optimizer convert --format=webp --quality=82 --delete-old`
`wp webangon-image-optimizer convert --format=webp --regen`
`wp webangon-image-optimizer convert --ids=12,34,56 --format=webp`
`wp webangon-image-optimizer convert --format=webp --skip-rewrite`
`wp webangon-image-optimizer convert --format=webp --rewrite-only`
`wp webangon-image-optimizer convert --format=webp --dry-run`
`wp webangon-image-optimizer convert --format=webp --quality=82 --yes`

Recommended Workflow 

1. Take a full file and database backup.
2. Run Image Cleaner in dry scan mode before deleting anything.
3. Regenerate thumbnails after changing theme image sizes or after imports/migrations.
4. Convert to WebP first for broad compatibility, or AVIF when the hosting stack supports it.
5. Test important pages, Elementor templates, product galleries, and image-heavy pages after conversion.

== Installation ==

1. Upload the `webangon-image-optimizer` folder to `/wp-content/plugins/`.
2. Activate Webangon Image Optimizer from the Plugins screen.
3. Go to Media > Image Optimizer.

== Frequently Asked Questions ==

= Does this replace the three separate image plugins? =

Yes. It combines image cleanup, thumbnail regeneration, and WebP/AVIF conversion into one plugin.

= Should I delete files immediately? =

No. Run dry scans first and keep a full backup before using destructive actions.

= Does AVIF work on every server? =

No. AVIF conversion requires PHP GD support for `imageavif()`.

== Changelog ==

= 1.0.0 =
* Initial merged plugin release.
