=== MA Smart Image Cleaner ===

Contributors: moheebarif786
Tags: media library, unused images, image cleaner, media cleanup, performance
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Safely find and clean unused images in your WordPress Media Library without breaking your website.

== Description ==

MA Smart Image Cleaner helps WordPress site owners **identify unused images** in their Media Library and clean storage safely.

Over time, WordPress sites accumulate hundreds of unused images from deleted pages, design changes, and testing uploads. These unused files increase storage usage, slow down backups, and clutter the admin area.

This plugin focuses on **analysis first, deletion last** — giving you full control before removing anything.

### 🔍 Key Features

- Detect unused images in the Media Library
- Analyze image usage across:
  - Posts and Pages
  - Custom Post Types
  - Featured Images
  - Gutenberg blocks
  - Elementor content
- Safe preview before deleting
- Move images to Trash (no forced permanent deletion)
- Bulk actions with confirmation
- Estimated storage savings
- Background scanning using WordPress Cron
- Clean and lightweight admin interface
- Beginner-friendly and open-source

🚫 No auto-delete
🚫 No ads
🚫 No tracking
🚫 No upsells

Perfect for bloggers, agencies, businesses, NGOs, and developers who want a clean and optimized WordPress site.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate **MA Smart Image Cleaner** from the Plugins menu
3. Go to **Media → Image Cleaner**
4. Run a scan and review results before deleting anything

== How It Works ==

1. The plugin scans all image attachments
2. It checks where images are used across your site
3. Images are marked as:
   - Used
   - Unused
4. You review the results and decide what to delete

Nothing is removed automatically.

== Screenshots ==

1. Image Cleaner dashboard overview
2. Scan results showing used and unused images
3. Safe preview before deletion
4. Bulk action confirmation dialog
5. Settings page

== Frequently Asked Questions ==

= Will this plugin delete images automatically? =

No. MA Smart Image Cleaner never deletes files automatically. You are always in control.

= Is this plugin safe to use on live websites? =

Yes. Images are first analyzed and then moved to Trash instead of being permanently deleted.

= Does it work with Elementor and Gutenberg? =

Yes. The plugin detects images used in both Elementor and Gutenberg content.

= Can I restore deleted images? =

Yes. Images moved to Trash can be restored using WordPress's default recovery system.

= Does it work with WooCommerce? =

Basic image detection works. Advanced WooCommerce scanning may be added in future versions.

== Changelog ==

= 1.0.0 =
- Initial release
- Media Library image scanner
- Usage detection for posts, pages, Elementor, and featured images
- Safe delete with Trash support
- Bulk actions and filters
- Settings panel
- Activity logs

== Upgrade Notice ==

= 1.0.0 =
First stable release of MA Smart Image Cleaner.

== Contributing ==

This is an open-source plugin. Contributions, suggestions, and bug reports are welcome.

== License ==

This plugin is licensed under the GPLv2 or later.
