=== Media Library Folders ===
Contributors: snehalpancholi
Tags: media, folders, library, organize, taxonomy
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Organise the WordPress media library with virtual folders using a native taxonomy, filterable sidebar, and AJAX folder management.

== Description ==

Media Library Folders adds a virtual folder system to the WordPress media library using a native WordPress taxonomy. No custom tables, no page reload on folder switch — just a clean sidebar on the Upload screen with instant filtering.

**Features:**

* Native WordPress taxonomy (`media_folder`) — data survives deactivation
* Folder sidebar on the Media Library screen with click-to-filter navigation
* Create, rename, and delete folders via AJAX — no page reload
* Filter by folder in both Grid view (AJAX) and List view (URL query)
* "Uncategorized" filter to find files not yet assigned to any folder
* Folder column on the media list table
* Assign folder from within the media attachment detail modal
* Automatic updates from AddonLogic update server

== Installation ==

1. Upload the `media-library-folders` folder to `/wp-content/plugins/`
2. Activate the plugin through the **Plugins** menu
3. Go to **Media → Library** and use the folder sidebar on the left

== Frequently Asked Questions ==

= Will my media files be deleted if I deactivate the plugin? =
No. Media files are never touched. Folder assignments (taxonomy terms) will remain in the database even when the plugin is inactive.

= Does this create custom database tables? =
No. It uses WordPress's built-in term/taxonomy system, which means full compatibility with WordPress core tools, importers, and exporters.

= Can I assign one file to multiple folders? =
Yes. Select multiple folders in the assignment dropdown in the attachment detail pane.

= What happens when I delete a folder? =
Only the folder (taxonomy term) is deleted. All media files previously in that folder become "Uncategorized" — no files are modified.

== Changelog ==

= 1.0.0 =
* Initial release.

== Screenshots ==

1. Media Library with folder sidebar, showing folder creation and filtering.
2. Folder assignment dropdown inside the attachment detail panel.
