=== Media Library Manager ===
Contributors: WPMediaMaster
Tags: media library, media folders, media manager, image seo, media protection
Requires at least: 5.0
Tested up to: 7.0.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

Organize, protect, optimize, rename, and display WordPress Media Library files with folders, galleries, file lists, and document embeds.

== Description ==

Media Library Manager helps you organize and manage the WordPress Media Library from one plugin. Create folder-based media workflows, improve image metadata, replace files without breaking attachment references, control generated image sizes, and publish selected files with shortcode modules.

The plugin is built for site owners, photographers, agencies, content teams, and developers who need a more useful Media Library without custom code.

= Key Free Features =

* **Media folders** - Organize attachments into a nested folder structure from the WordPress admin.
* **Module Builder** - Create reusable shortcode modules and place selected media files or folders in posts, pages, and page builders.
* **File Browser module** - Display selected Media Library files and folders on the front end.
* **Gallery module** - Show images and videos in a responsive gallery with lightbox previews.
* **Embed Documents module** - Embed supported Media Library documents directly in your content.
* **File list module** - List selected files with view and download actions.
* **Inline preview** - Preview supported images and documents without downloading them first.
* **Image SEO fields** - Manage alt text, title, caption, and description fields for attachments.
* **ZIP upload extraction** - Upload a ZIP archive and import extracted files into the Media Library.
* **URL image importer** - Import images from remote URLs, XML feeds, or CSV files.
* **Media replacement** - Replace an existing media file while keeping the original attachment ID.
* **Media rename** - Rename individual files or bulk rename attachments with naming patterns.
* **Image size manager** - Disable selected registered image sizes to reduce unnecessary thumbnail generation.
* **MIME type support** - Enable common additional upload types or register custom MIME types.
* **Quick edit on upload** - Edit title, alt text, caption, and description immediately after upload.
* **Media trash** - Move deleted media to trash before permanent deletion when enabled.
* **Media protection tools** - Block direct access, discourage hotlinking, disable directory browsing, and disable right-click interactions.
* **Responsive output** - Front-end modules adapt to desktop and mobile screens.
* **On-demand assets** - Plugin assets are loaded only where they are needed.
* **Export and import** - Back up and restore plugin settings and module data using JSON.
* **Translation ready** - Includes a text domain and translation template for localization.

= Pro Features =

Media Library Manager also includes a Pro version with additional tools:

* **Review & Approve module** - Let users review, select, and submit file choices.
* **Photo and file proofing** - Collect client selections and manage proofing submissions.
* **File Uploader module** - Allow users to upload files directly to selected Media Library folders.
* **Media Player module** - Publish audio and video playlists from Media Library files.
* **Search Box module** - Add front-end search for selected files and folders.
* **Slider Carousel module** - Display selected media in a touch-friendly carousel.
* **Watermarking** - Apply configurable watermarks to images.
* **Custom image sizes** - Register additional image sizes for theme and workflow needs.
* **Image optimization** - Compress images and convert supported formats to WebP or AVIF when server support is available.
* **Resize after upload** - Resize oversized images during upload based on configured dimensions.
* **Media Cleaner** - Scan for unused, orphaned, or duplicate media before cleanup.
* **Storage analysis** - Review Media Library storage usage by file type, size, and date.
* **Media analytics** - Track views, downloads, searches, and other file activity.
* **Email reports and notifications** - Receive scheduled reports and event-based notifications.
* **Advanced module permissions** - Add password protection, login screens, user rules, and front-end file actions.

= Page Builder Compatibility =

Media Library Manager modules work with WordPress shortcodes, so they can be used in the Block Editor and in shortcode-compatible builders such as Elementor and Divi.

== Installation ==

1. Upload the `media-library-manager` folder to the `/wp-content/plugins/` directory, or install the plugin from **Plugins > Add New** in WordPress.
2. Activate **Media Library Manager** from the **Plugins** screen.
3. Go to **Media Manager > Settings** to review plugin settings.
4. Use **Media Manager > Module Builder** to create file browser, gallery, document embed, or file list modules.
5. Copy the generated shortcode and place it in a post, page, widget, or shortcode-compatible page builder.

== Frequently Asked Questions ==

= 1. Does the free version include folder support? =

Yes. The free version includes Media Library folder management so you can organize attachments into a nested folder structure.

= 2. Which shortcode modules are included in the free version? =

The free version includes File Browser, Gallery, Embed Documents, and List modules. Review & Approve, File Uploader, Media Player, Search Box, and Slider Carousel modules are Pro features.

= 3. Will media replacement break existing links? =

No. Media replacement keeps the original attachment ID, helping existing post, page, widget, and theme references continue to use the updated file.

= 4. Can I import images from a CSV file? =

Yes. The URL image importer can import images from CSV data that contains remote image URLs. It also supports direct URL and XML-based imports.

= 5. Can I edit image SEO fields? =

Yes. You can manage attachment alt text, title, caption, and description fields. These fields can improve accessibility, organization, and search visibility when used accurately.

= 6. Can I disable specific WordPress image sizes? =

Yes. The free image size manager lets you disable selected registered image sizes to reduce unnecessary thumbnail generation. Registering new custom image sizes is a Pro feature.

= 7. Does the plugin work with Elementor, Divi, and the Block Editor? =

Yes. The plugin outputs shortcode modules, so modules can be used in the Block Editor and in page builders that support WordPress shortcodes.

== Screenshots ==

1. Media Folders
2. Module Builder
3. Frontend Upload
4. Image SEO
5. Media Rename
6. Image Optimization
7. File Proofing
8. Storage Analysis
9. Lightbox Gallery
10. Media Player

== Third-Party Services ==

This plugin connects to or links users to the following third-party services for specific features:

* **Freemius** - Used for optional account connection, licensing, premium upgrades, update delivery for paid versions, billing, and support-related services. When a site administrator opts in or uses premium licensing features, data required for those services may be sent securely to Freemius. This can include site URL, plugin version, WordPress version, PHP version, administrator contact details, license status, and diagnostic information needed to provide the service.
  * Terms of Service: https://freemius.com/terms/
  * Privacy Policy: https://freemius.com/privacy-policy/

* **Gravatar / WordPress.com avatar services** - Used through WordPress avatar functions such as `get_avatar()`, `get_avatar_url()`, and compatible avatar plugins to display user avatars in reports, analytics, and selection views. The user email hash or user avatar request may be sent to the configured avatar provider.
  * Terms of Service: https://wordpress.com/tos/
  * Privacy Policy: https://automattic.com/privacy/

== Documentation and Support ==

* Documentation: https://managewpmedia.com/docs/
* Support: https://wpmediamaster.com/support
* Website: https://managewpmedia.com/

== Changelog ==

= 1.0.0 =
* Initial release.
