=== WP MediaPilot - Media Library Folders, Smart Filters & Organizer ===
Contributors: kontackt
Tags: media library, folders, media organizer, natural language search, media cleanup, woocommerce
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.9.9
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Code and integrated HTML are GPLv2 or later. Other marketplace assets are covered by the purchased Envato Market license; see README_License.txt.

Smart WordPress Media Library Manager with folders, smart filters, media audits, natural-language search, WooCommerce checks, activity logs, and safe bulk tools.

== Description ==

MediaPilot helps WordPress site owners, agencies, bloggers, shops, and content teams organize and audit large Media Libraries from a clean WordPress admin interface.

The plugin uses native WordPress attachments and does not replace the WordPress attachment system. Folders are virtual, safe, and stored in custom plugin tables. Media files remain in their original WordPress upload locations.

Main features:

* Folder and subfolder organization for WordPress Media Library attachments.
* Smart views for images, videos, audio, PDFs, documents, archives, unused files, missing ALT text, large files, duplicate groups, and uncategorized media.
* Safe AJAX media indexing with batch processing.
* Automatic index updates when attachments are added, edited, or deleted.
* Grid and list views with file size, dimensions, usage state, ALT state, edit/view links, and usage count.
* Bulk assign and remove attachments from virtual folders.
* Natural-language media search with a local safe parser by default.
* Optional external AI provider support controlled by the site administrator and disabled by default.
* Browser speech-to-text search when supported by the browser.
* Media preview modal for images, video, audio, PDFs, and generic files.
* Context menus for folders, smart views, media items, and empty library areas.
* WooCommerce product media checks.
* Cleanup reports and activity log.
* Import/export for folder structures.

Privacy and safety notes:

* MediaPilot does not delete physical media files by default.
* Folders are virtual and do not move files on disk.
* External AI/API usage is disabled by default and only runs after an administrator enables it and saves provider credentials.
* AI output is validated into safe filters; MediaPilot never runs AI-generated SQL.
* The native WordPress Media Library replacement option is disabled by default and can be enabled from settings.

== Installation ==

1. Upload `mediapilot.zip` from Plugins > Add New > Upload Plugin.
2. Activate MediaPilot.
3. Go to Media > MediaPilot.
4. Click Sync Index to build the initial media index.
5. Create folders or use Smart Views to audit the library.

== Frequently Asked Questions ==

= Does MediaPilot move files on the server? =

No. Folders are virtual and attachments remain in the normal WordPress uploads structure.

= Does MediaPilot delete media files? =

No. The included cleanup tools generate reports and safe previews. Physical deletion is not performed automatically.

= Is external AI required? =

No. The local natural-language parser works without an external API key. External AI providers are optional and disabled by default.

= What data is sent to external AI providers? =

Nothing is sent to external AI providers unless an administrator enables External AI API and saves provider credentials. When enabled, MediaPilot sends only the administrator's natural-language search prompt and the minimal provider request needed to parse that prompt. It does not send media files by default and does not run AI-generated SQL.

= Does the plugin replace the native Media Library? =

Not by default. You can enable the replacement option from MediaPilot settings after testing it with your theme and plugins.

= Is WooCommerce required? =

No. WooCommerce checks appear only when WooCommerce is active.

== Changelog ==

= 1.0.0 =
* Prepared a marketplace-ready package with local documentation and clearer Envato policy/licensing notes.
* Changed the installable plugin folder to `mediapilot`.
* Removed generated language-pack bloat and added a translation template.
* Made the full-feature build usable immediately after installation.
* Disabled native Media Library replacement by default for safer first-run behavior.
* Removed legacy hotfix deactivation behavior.
* Improved readme, packaging, privacy notes, and first-run instructions.

== Upgrade Notice ==

= 1.0.0 =
Marketplace-ready build. Back up your site and test on staging before using on production.


== Compatibility Notes ==

Tested with WordPress 7.0 and WooCommerce 10.9 compatibility declarations for HPOS/custom order tables and cart/checkout blocks. WooCommerce is optional and media checks are shown only when WooCommerce is active.
