=== Quick Media Inspect ===
Contributors: themelooper
Tags: media, images usage, cleanup, optimization, alt text
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Detect unused images, clean up your Media Library safely, and generate alt text from filenames.

== Description ==
Quick Media Inspect helps you find unused images, review where images are used, and safely clean up your Media Library. It also lets you quickly generate alt text from file names to improve accessibility and SEO.

Free (MVP) features:
- Scan Media Library for usage in post content and featured images
- Show where each image is used (with edit links)
- Mark images as Used / Unused / Trashed
- Bulk move to Trash and Restore from Trash
- Generate alt text from filenames (bulk)
- Dashboard with real counts: total images, unused, missing alt text

What it does NOT include (available in Pro):
- Auto delete unused images after X days
- Email notifications
- Advanced scanning (shortcodes, widgets, meta fields, builders)
- AI alt text generation

= How it works =
- Usage detection checks post_content (full URL, resized variants, Gutenberg ids, classic `wp-image-ID`) and featured images (`_thumbnail_id`).
- Trashed attachments are included, so you can restore them from the Scan Results.
- No permanent deletions are performed unless you explicitly choose "Delete Permanently" in bulk actions.

= Security =
- All admin actions require `manage_options` capability.
- Nonces on all forms and AJAX endpoints.

== Installation ==
1. Upload the plugin folder to `/wp-content/plugins/` or install via the Plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to Quick Media Inspect > Dashboard and click Run Scan.

== Frequently Asked Questions ==
= Will this delete my images automatically? =
No. The free version will never delete permanently unless you pick "Delete Permanently" from bulk actions. Moving to Trash is the default.

= My trashed images disappear on my local site =
Enable WordPress Media Trash or use the plugin's built-in fallback. Add to `wp-config.php`:
`define('MEDIA_TRASH', true);`

= Does it detect images in custom fields or page builders? =
The free version detects post content and featured images. Pro adds more sources.

== Screenshots ==
1. Dashboard with summary cards
2. Scan results with Used/Unused/Trashed status and usage links
3. Alt text generator for images missing alt text

== Changelog ==
= 1.0.2 =
- Fix CSS Issues
- Scan results with usage tracking and bulk actions
- Alt text generator from filenames
- Dashboard with live counts

== Upgrade Notice ==
= 1.0.0 =
First release. Please back up before bulk actions on production.