=== Pixloade Image Manager – Bulk Download Media Library Images as ZIP ===
Contributors: arif547, mahabubulalam
Tags: media library, bulk download, download images, export images, zip
Requires at least: 5.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bulk download Media Library images as a ZIP. Filter by JPEG, PNG, WebP or SVG, sort by size or date, and edit alt text, titles and captions fast.

== Description ==

**Pixloade Image Manager** is the fastest way to browse, export and tidy up the images in your WordPress Media Library.

Need to download every image from your site? Move a client's photos to a new host? Grab only the PNG files? Find the heaviest images that slow your pages down? Fix missing alt text on dozens of images? Pixloade does all of this from one clean screen under **Media → Image Manager**.

= Bulk download Media Library images as ZIP =

* Download **all images** in your Media Library as a single ZIP file with one click.
* Download only one format: **JPEG, PNG, GIF, WebP, SVG** or any other image type on your site.
* The ZIP contains your **original uploads**, not the resized thumbnails or "-scaled" copies WordPress creates.
* Duplicate file names are renamed automatically, so nothing gets overwritten.

= Filter and sort images =

* Format tabs with live counts show how many images of each type you have.
* Sort by **name**, **upload date**, or **file size** (smallest or largest first) to find heavy images quickly.
* Large libraries load in pages with a "Load more" button, so the screen stays fast.

= Preview and edit image details =

* Click any image to open a detail view with file name, type, size, dimensions, upload date and author.
* Edit the **title, caption, alt text and description** in place and save without leaving the screen. Great for fixing missing alt text and improving image SEO and accessibility.
* Move between images with the arrow buttons or the **← →** keys.
* Copy the image URL with one click, or download a single image.
* See extra data other plugins store on an image (for example Rank Math, Yoast SEO or Elementor).

= Safe for teams =

* Uses the same permissions as the WordPress Media Library: Authors, Editors and Administrators can browse and download, and people can only edit images they are allowed to edit.
* Lightweight: no extra database tables, no tracking and no external services.

== Installation ==

1. Install the plugin from **Plugins → Add New** by searching for "Pixloade Image Manager", or upload the `pixloade-image-manager` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Media → Image Manager**.

== Frequently Asked Questions ==

= How do I download all images from my WordPress Media Library? =

Go to **Media → Image Manager**, keep the **All Images** tab selected and click **Download ZIP**. Every image is added to one ZIP file.

= Can I download only PNG or only JPEG images? =

Yes. Click the format tab you want (for example **PNG**) and then click **Download ZIP**. Only images of that format are included.

= Does the ZIP include all thumbnail sizes? =

No. The ZIP contains only the original uploaded files, not the resized thumbnails WordPress generates.

= Can I find the largest images on my site? =

Yes. Choose **Size: Largest First** in the sort menu to see your heaviest images at the top.

= Can I edit alt text for many images quickly? =

Yes. Open an image, edit its alt text (and title, caption or description), click **Save Changes**, then press the → key to move to the next image.

= What image formats are supported? =

Every image format stored in your Media Library, including JPEG, PNG, GIF, WebP, AVIF and SVG. Any format found on your site gets its own tab automatically.

= Is the PHP ZipArchive extension required? =

Yes, for the ZIP download. ZipArchive is enabled by default on most hosting providers. Browsing, previewing and editing work without it.

= Who can use the Image Manager? =

Users with the `upload_files` capability (Authors, Editors and Administrators by default) can browse and download images. Editing an image's title, caption, alt text or description additionally requires permission to edit that image, the same rule the Media Library uses. Developers can change the base capability with the `pixloade_capability` filter.

= Does it change or compress my images? =

No. Pixloade never modifies your image files. It only reads them, and saves the text fields you edit.

== Screenshots ==

1. Image Manager grid with format tabs, live counts, sorting and one-click ZIP download.
2. Image detail view: file info, copy URL, and inline editing of title, caption, alt text and description.
3. Filter by format and sort by file size to find the heaviest images.

== Changelog ==

= 1.0.2 =
* New: plugin logo in the page header.
* New: a one-time, dismissible review request on the Image Manager page after one week of use.
* Fix: admin notices from other plugins no longer break the Image Manager page header.
* Tweak: clean up the plugin's saved data on uninstall.
* Docs: improved description, FAQ and screenshots.

= 1.0.1 =
* Security: editing and viewing details now only works on image attachments the current user is allowed to edit, matching core Media Library permissions.
* Security: base capability changed from `edit_posts` to `upload_files`; format filter now only accepts image MIME types.
* Fix: arrow keys and Escape no longer discard edits while typing in a field; unsaved changes now ask before closing.
* Fix: saving no longer strips HTML from caption/description or backslashes from text.
* Fix: saving an image without a title no longer stores "Untitled" as its title.
* Fix: ZIP download now contains original uploads, cleans up its temporary files and handles duplicate file names safely.
* Fix: upload date now respects the site timezone.
* Fix: sort menu and Download ZIP button now have the same height.
* Performance: format counts use a single query and the grid loads in pages with a "Load more" button.

= 1.0 =
* Initial release with image format filtering, sorting, bulk ZIP download, and detailed image modal with inline editing.

== Upgrade Notice ==

= 1.0.2 =
New logo and a fix for the page header layout when other plugins show notices.

= 1.0.1 =
Security and reliability fixes. Recommended for all users.

= 1.0 =
Initial release.
