=== Media Bulk Download ===
Contributors: quintaphon
Donate link: https://buymeacoffee.com/quintaphon
Tags: media library, download, zip, bulk download, backup
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Download your media files in bulk as ZIP archives: pick items in the Media Library or filter by type, month and uploader.

== Description ==

WordPress lets you upload many files at once, but you can only download them one by one. Media Bulk Download packs any part of your Media Library into ZIP archives you can save with one click.

* **From the Media Library.** In the list view, tick items and choose "Download as ZIP" under Bulk actions. In the grid view, click Bulk select, pick items and click "Download as ZIP".
* **Or by filter.** Download everything, or only images, video, audio or documents, uploads from a range of months, attached or unattached items, one uploader's files or files whose name contains a word.
* **Choose the files.** The file the Media Library shows, the original upload before WordPress scaled it, or every file of the item including all image sizes and WebP copies.
* **Choose the folders.** Keep the year and month folders of your uploads, put everything in one folder, or sort by type or by the post each file is attached to. Files with the same name are never overwritten.
* **A file list.** Optionally adds media-list.csv with the ID, title, alt text, caption, description, uploader, date, attached post and web address of every file.

= Built for big libraries =

* **Short steps.** Items are listed in batches and files are packed in batches, so no request hits a PHP time limit, even with tens of thousands of files.
* **Parts.** An archive larger than the part size (1000 MB by default) is split into several ZIP files that each open on their own.
* **Fast.** Photos, video, audio and other compressed formats are stored as they are instead of being compressed again.
* **Works without the PHP zip extension.** When ZipArchive is missing, the plugin uses the ZIP library that ships with WordPress.

= Private and tidy =

* **Your own media.** Authors and other users who can upload but not edit others' posts only see and download their own uploads (an administrator can change this). Editors and administrators reach the whole library.
* **No public links.** Archives are handed out only after a login and permission check, never as a public file address.
* **Cleaned up.** Archives are removed automatically 24 hours after they are built (you can change this), or when you delete them under Archives.
* **Read only.** The plugin never changes, moves or deletes a media file.

The plugin adds a screen under Media > Bulk Download. It adds nothing to the front end of your site, sends no data anywhere and loads no external files.

Plugin site: [quintaphon.com/wordpress/media-bulk-download](https://quintaphon.com/wordpress/media-bulk-download/)

== Installation ==

1. Install the plugin from Plugins > Add New, or upload the `media-bulk-download` folder to `/wp-content/plugins/`.
2. Activate it.
3. Select items in the Media Library and choose "Download as ZIP", or go to Media > Bulk Download.

== Frequently Asked Questions ==

= Where are the archives stored? =

In `wp-content/uploads/media-bulk-download/`, in folders with long random names. The folder blocks direct access on Apache and IIS; on any server the archives are only handed out by the plugin after a permission check.

= How much disk space does it need? =

About the size of the files you download, until the archive is removed. Photos and video do not shrink in a ZIP.

= My download is split into parts. Why? =

The archive was larger than the part size. Download every part and unzip each one; together they hold all the files. An administrator can change the part size under Media > Bulk Download > Settings.

= Can authors download other people's files? =

Not by default. Users who can not edit other people's posts only see and download media they uploaded themselves.

= What happens if I close the tab while an archive is being built? =

The work stops. The unfinished archive is listed under Archives and removed automatically after a few hours. Build it again to get a complete one.

= Does it download files that are offloaded to cloud storage? =

It packs the files on this server. Items whose file is only on remote storage are listed as skipped.

= What happens when I delete the plugin? =

Its settings and every archive it built are removed. Your media files are never touched.

== Screenshots ==

1. Overview of your media and the ready archives.
2. Download: choose the media, the files and the folder layout.
3. An archive being built, then ready to download in parts.
4. "Download as ZIP" in the Media Library.
5. Archives, ready to download again.

== Changelog ==

= 1.0.0 =
* First release.
