=== Advanced Media Library Filters ===
Contributors: nicola.loglisci
Tags: media library, media filters, media search, admin
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.5
Requires PHP: 7.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Extends the native WordPress Media Library with advanced filtering capabilities (Grid/Modal and List views).

== Description ==

Advanced Media Library Filters extends the native WordPress Media Library (both List View and Grid/Modal View) with advanced filtering capabilities to help you find and manage media assets quickly.

Features:
* File Format/Extension Filter (Core): Quickly group images, documents, and videos.
* File Size Filter (Core): Filter by size (<100KB, 100KB-500KB, 500KB-1MB, >1MB).
* Image Dimensions & Orientation (Optional): Filter images by aspect ratio (Landscape, Portrait, Square).
* Usage Status / Orphaned Media (Optional): Identify media attached to posts vs unused media.
* Uploaded By / Author (Optional): Filter media by the uploading user.
* Alt Text Status (Optional): Find images missing Alt Text for SEO and accessibility improvements.

== Installation ==

1. Upload the `advanced-media-filters` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to Settings -> Media Filters to configure the optional features.
4. **Important**: Remember to run the "Sync Media Data" tool from the plugin settings page to generate size and orientation metadata for files you uploaded *before* installing this plugin.

== Changelog ==

= 1.0.5 =
* Security improvements: Ensured thorough sanitization, escaping and unslashing of superglobals across the codebase.
* Filter queries improvements: Properly merged meta_query to prevent overwriting existing queries.

= 1.0.4 =
* Added sizes > 2 MB and > 5 MB to the size filter.

= 1.0.3 =
* Repositioned "Bulk Select" (Selezione Multipla) to properly stay at the end of the filters.

= 1.0.2 =
* Added Audio, Excel and TXT options to the Format Filter.
* Restructured Media Library toolbar to group all dropdowns sequentially, ensuring the "Bulk Select" button always appears last.
* Hid the redundant native WordPress media types filter when the plugin is active to prevent duplication.
* Emphasized and redesigned the "Sync Existing Media" notice in the backend to ensure users don't miss running it.

= 1.0.1 =
* Fixed size and dimensions filters for previously uploaded media. Implemented a "Sync Media Data" tool on the settings page to process existing attachments.
* Added a convenient "Settings" link in the Plugins page.

= 1.0.0 =
* Initial release.
