=== Dustorage - Media Library Cleanup ===
Contributors: ztwpdeveloper
Tags: media library, cleanup, unused files, storage, optimization
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically removes unused media files to keep your WordPress library light, organized, and clutter-free

== Description ==

Dustorage scans your entire WordPress site to find media files that are no longer used anywhere — not attached to any post, page, featured image, custom field, or site setting. Instead of deleting files immediately, Dustorage places them in a **quarantine period**, giving you time to review and restore anything deleted by mistake before it's permanently removed.

**Key Features**

* Scans the full media library and detects unused files
* Checks featured images, post content, post meta, custom fields, and site options (logo, site icon)
* Quarantine system: files are held for a configurable number of days before permanent deletion
* Scheduled automatic scans (daily or weekly)
* Activity log to track what was quarantined or deleted
* Excluded folders setting to protect specific directories from being scanned

**How It Works**

1. Dustorage scans your media library and checks each file against multiple usage rules.
2. Files found unused are placed in quarantine (not deleted immediately).
3. After the quarantine period ends (default: 7 days), files are permanently deleted.
4. You can review and restore quarantined files at any time before that.

== Installation ==

1. Upload the `dustorage-media-library-cleanup` folder to the `/wp-content/plugins/` directory, or install the plugin directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to **Dustorage Cleaner** in your admin menu to run your first scan and configure settings.

== Frequently Asked Questions ==

= Will this delete my files immediately? =

No. Files are first placed in a quarantine period (configurable, default 7 days) before permanent deletion, so you have time to review and restore anything if needed.

= What counts as "used"? =

Dustorage checks featured images, content inside posts and pages, post meta (including custom fields), attachment relationships, and site options such as the custom logo and site icon.

= Can I exclude certain folders from scanning? =

Yes, under Settings you can list folder paths that should never be scanned or touched by the plugin.

== Screenshots ==

1. The main dashboard showing scan results.
2. Settings page with quarantine and scan frequency options.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.