=== Thumbnail Remover and Size Manager ===
Contributors: mehdiraized
Donate link: https://www.buymeacoffee.com/mehdiraized
Tags: thumbnails, media management, image optimization, cleanup, regenerate thumbnails
Requires at least: 5.0
Tested up to: 6.9.4
Stable tag: 2.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Safely analyze, preview, trash, restore, regenerate, and manage WordPress thumbnails and image sizes.

== Description ==

Thumbnail Remover and Size Manager 2.0 is a safer and more complete media-maintenance workflow for WordPress.

Instead of deleting thumbnails blindly, the plugin now helps you:

* Preview cleanup results before removing files
* Move thumbnails to plugin Trash instead of deleting permanently
* Restore trashed thumbnails later if needed
* Process large libraries in batches with visible progress
* Detect orphan thumbnails left behind on disk
* Detect probably unused media items across post content, featured images, and common builder data
* Regenerate missing image sizes in batches
* Review per-size analytics including file counts, storage usage, missing sizes, and orphan counts
* Disable selected image sizes for future uploads
* Create zip backups for all uploads or a specific year/month folder

This release is built for site owners, developers, agencies, and anyone trying to reduce thumbnail bloat without risking accidental data loss.

== Features ==

* Dry run / preview before cleanup
* Trash and Restore workflow for safer deletion
* Batch processing with real progress for scan, cleanup, and regeneration
* Unused media detection
* Orphan thumbnail detection
* Regenerate missing sizes
* Per-size analytics dashboard
* Image size disable controls for future uploads
* Media backup export to zip

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/thumbnail-remover` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the `Plugins` screen in WordPress.
3. Go to `Tools > Thumbnail Manager`.
4. Run a full analysis before your first cleanup so you can review thumbnail usage, orphan counts, and unused media signals.

== Frequently Asked Questions ==

= Does the plugin permanently delete thumbnails? =
No. Version 2 moves matching thumbnail files into plugin Trash first so they can be restored later.

= What does Preview do? =
Preview performs a dry run and shows how many files match your current selection, which sizes are involved, how much space can be recovered, and how many orphan thumbnails were found.

= What are orphan thumbnails? =
Orphan thumbnails are files such as `image-300x300.jpg` that still exist on disk but are no longer tracked in WordPress attachment metadata.

= How does unused media detection work? =
The plugin scans image attachments and checks for usage in featured images, parent attachments, post content, and stored builder/meta content. The results are best treated as “probably unused” so you can review them manually.

= Can I regenerate missing sizes after enabling a size again? =
Yes. Use the `Regenerate Missing Sizes` section to rebuild missing image sizes in batches.

= Can I back up my files before cleanup? =
Yes. You can create a zip backup for all uploads or for a selected year/month folder.

== Screenshots ==

1. Library analysis with per-size analytics and unused media results
2. Dry run preview before moving thumbnails to Trash
3. Trash and Restore workflow
4. Batch regeneration of missing image sizes

== Changelog ==

= 2.0.0 =
* Added dry-run preview before cleanup
* Added Trash and Restore workflow for thumbnail removal
* Added batch processing with progress for analysis, cleanup, and regeneration
* Added orphan thumbnail detection
* Added probably unused media detection
* Added missing-size regeneration workflow
* Added per-size analytics dashboard
* Refreshed admin UI for the new v2 workflow
* Updated plugin description and documentation

= 1.1.5 =
* Fixed a fatal error when disabling thumbnail sizes on PHP 8.x
* Hardened settings and AJAX input handling for string-based values
* Updated compatibility metadata for the latest WordPress release

= 1.1.4 =
* Added new feature: Media file backup functionality
* Improved user interface for backup options
* Bug fixes and performance improvements

== Upgrade Notice ==

= 2.0.0 =
This major update introduces preview before cleanup, Trash and Restore, batch processing, unused media detection, orphan thumbnail detection, missing-size regeneration, and per-size analytics.