=== OctoSize Media Scanner ===
Contributors: gasmark8
Tags: media, attachments, filesize, admin
Requires at least: 6.1
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find oversized images, large uploads, and heavy media in your WordPress media library.

== Description ==
OctoSize Media Scanner helps site owners find oversized images, large uploads, and other heavy media library files quickly.

Features:

* Adds Media > OctoSize Media Scanner in wp-admin
* Scans attachment file sizes from the uploads directory
* Sorts largest files first by default
* Supports sorting by size, title, type, or path
* Filters by minimum size in 5 MB increments
* Searches by filename, title, or MIME type
* Supports optional nightly WP-Cron scans
* Uses caching and a scan lock to reduce repeated heavy work

Performance notes:

* Attachment scanning runs in batches
* Results are cached to avoid repeated full scans
* Cache is invalidated when attachments are added, edited, or deleted

Security notes:

* The admin page is restricted to users with the `upload_files` capability
* Manual actions are protected with nonces
* Input is sanitized and output is escaped
* File reads are restricted to uploads-based attachment paths

== Installation ==
1. Upload the plugin to `/wp-content/plugins/octosize-media-scanner/`.
2. Activate through the Plugins screen.
3. Open Media > OctoSize Media Scanner.

== Frequently Asked Questions ==

= How do I refresh the results? =

Click "Rescan Now" on the plugin screen to run a fresh scan immediately.

= Why are nightly scans not running? =

Nightly scans depend on WP-Cron. If your host disables or delays WP-Cron, scheduled scans may not run on time.

= Why are no results shown? =

Confirm your media items still point to readable files inside the uploads directory.

== Upgrade Notice ==
= 1.0.0 =
Initial public release.

== Changelog ==
= 1.0.0 =
* Added sortable columns.
* Added 5 MB incremental size filters.
* Added filename, title, and MIME type search.
* Added nightly scan scheduling settings.
* Added scan lock and cache behavior improvements.
