=== Media Bulk Download ===
Contributors: devmizan
Tags: media, download, bulk, zip, backup
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://www.devmizan.com/donate

Adds bulk download functionality to WordPress Media Library. Download selected files or entire library as ZIP archives with one click.

== Description ==

Media Bulk Download is a professional WordPress plugin developed by Dev Mizan that revolutionizes how you manage your media files. This powerful tool extends the Media Library's functionality with advanced bulk download capabilities, making it easy to backup, export, or share your media files.

= Key Features =

* **Smart Download Options**: Download selected media files or entire media library
* **Seamless Integration**: Works perfectly with existing WordPress Media Library interface
* **Intelligent Button Management**: Smart visibility based on current mode (bulk select vs normal)
* **Universal File Support**: Supports all media types (images, videos, audio, documents, PDFs)
* **Professional ZIP Creation**: Creates optimized ZIP archives with unique filename handling
* **Advanced Security**: Comprehensive nonce verification and capability checks
* **Automatic Cleanup**: Temporary files are automatically removed after download
* **Memory Efficient**: Handles large media libraries without performance issues
* **Developer Friendly**: Clean, well-documented code following WordPress standards

= Professional Benefits =

* **Time Saving**: Download hundreds of files with a single click
* **Backup Solution**: Create complete media library backups instantly
* **Client Delivery**: Easily package and deliver media files to clients
* **Site Migration**: Export all media files for site transfers
* **File Organization**: Maintain original filenames and folder structure

= How it works =

1. Go to Media > Library in your WordPress admin
2. Select one or more media files using the checkboxes
3. Choose "Download Selected" from the bulk actions dropdown
4. Click "Apply"
5. The selected files will be downloaded as a ZIP archive

= Requirements =

* WordPress 5.0 or higher
* PHP 7.4 or higher
* ZipArchive PHP extension

== Installation ==

1. **Upload**: Upload the plugin files to the `/wp-content/plugins/media-bulk-download` directory, or install through the WordPress plugins screen
2. **Activate**: Activate the plugin through the 'Plugins' screen in WordPress
3. **Ready**: The plugin automatically integrates with your Media Library - no configuration needed!

== Frequently Asked Questions ==

= Does this plugin require any special server configuration? =

The plugin requires the ZipArchive PHP extension, which is included by default on most modern hosting providers. The plugin will check for this requirement during activation.

= What file types are supported? =

The plugin supports ALL media types including:
* Images (JPG, PNG, GIF, WebP, SVG, etc.)
* Videos (MP4, AVI, MOV, etc.)
* Audio files (MP3, WAV, etc.)
* Documents (PDF, Word, Excel, PowerPoint, etc.)
* Archives (ZIP, RAR, etc.)

= Are there any security restrictions? =

Yes, the plugin includes enterprise-level security measures:
* WordPress nonce verification for all requests
* Capability checks (users need 'upload_files' or 'delete_posts' capability)
* File validation before adding to ZIP archives
* Automatic cleanup of temporary files
* Prevention of direct file access

= Will the original files be deleted after download? =

No, the original files remain completely untouched in your Media Library. Only temporary ZIP files are created and automatically cleaned up after download.

= Can I download my entire media library? =

Yes! The plugin offers two modes:
* **Download Selected**: Select specific files and download them
* **Download All Media**: Download your entire media library with one click

= Is there a file size limit? =

The plugin is designed to handle large media libraries efficiently. File size limits depend on your server's PHP configuration (memory_limit, max_execution_time, etc.).

= Does this work with multisite installations? =

Yes, the plugin works perfectly with WordPress multisite installations and respects site-specific media files.

== Screenshots ==

1. Media Library with bulk actions dropdown showing "Download Selected" option
2. Selected media files ready for bulk download
3. ZIP file download in progress

== Changelog ==

= 1.0.0 =
* **Initial Release** - Professional WordPress Media Bulk Download Plugin
* Added intelligent bulk download functionality to Media Library
* Implemented smart button visibility (Download Selected vs Download All Media)
* Advanced ZIP file generation with unique filename handling
* Comprehensive security with nonce verification and capability checks
* Support for all media file types (images, videos, audio, documents)
* Automatic cleanup of temporary files
* Memory-efficient processing for large media libraries
* Seamless integration with existing WordPress Media Library interface
* Professional code following WordPress coding standards

== Support ==

**Professional Support Available**

* **Website**: [www.devmizan.com](https://www.devmizan.com)
* **Email**: support@devmizan.com
* **Documentation**: [www.devmizan.com/media-bulk-download-docs](https://www.devmizan.com/media-bulk-download-docs)
* **Custom Development**: Available for enterprise clients

**Free Support**
* WordPress.org Support Forums
* GitHub Issues (for bug reports)

== Upgrade Notice ==

= 1.0.0 =
🎉 **Initial Release** - Professional Media Bulk Download Plugin by Dev Mizan. Download selected media files or entire media library as ZIP archives with one click. Features smart button management, advanced security, and seamless WordPress integration.
