=== Sifency Bulk Metadata Commander ===
Contributors: sifency
Tags: bulk edit, custom fields, meta, gallery, media
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bulk-apply or bulk-remove custom fields, images, galleries, content and shortcodes across posts, then find and replace media usage site-wide.

== Description ==

Sifency Bulk Metadata Commander lets you update many posts at once instead of editing them one by one.

**Bulk update, in a guided step-by-step tool**

* Filter by post type and any taxonomy/category registered for that type.
* Include only specific posts, or exclude specific posts, using a live title search.
* Add unlimited custom field rows, each with its own data format (text, number, URL, comma list, JSON, or a media picker for single files, video, and image galleries) and its own "replace or keep existing" rule.
* Add or replace post content, with an optional shortcode that can always be pinned to the end of the final content.
* Replace the excerpt.
* Set a featured image across all matching posts, skipping posts that already have one (or forcing a replace).
* Append to or replace a gallery meta field with images picked from the media library.
* Preview how many posts match your filters before running anything.
* Step through the tool one tab at a time with Previous/Next buttons, or jump straight to any tab.
* Runs in small batches over AJAX with a live progress bar, so it won't time out on large sites.
* A separate "Clear Data" mode lets you delete named custom fields, remove the featured image, remove the gallery meta, and/or empty the content or excerpt — using the same post type/category/include/exclude filters, with its own confirmation and progress bar.

**Media Usage — find and replace media across your site**

On its own admin screen, pick any file from the Media Library and instantly see every post (of a chosen post type) that uses it — as a single custom field, inside an image gallery, or as the Featured Image. Check exactly the usages you want to update, choose a replacement file, and Sifency Bulk Metadata Commander swaps it in only for the posts you selected — everything else is left untouched.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/sifency-bulk-metadata-commander`, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Use the "Sifency Bulk Metadata Commander" menu item in the admin sidebar for bulk updates, or its "Media Usage" submenu to find/replace media.

== Frequently Asked Questions ==

= Will this overwrite my existing data? =

Only if you choose "Replace" for that specific field. Every meta field, the featured image, and the gallery each have their own independent replace-or-ignore setting.

= Does this work with any post type? =

Yes, any public, UI-visible post type registered on your site is available, along with its registered taxonomies.

= Can I replace a media file in only some of the posts that use it, not all of them? =

Yes. The Media Usage screen lists every usage individually with a checkbox, so you can select exactly which posts get the replacement.

= Does this plugin store any settings of its own? =

No. Sifency Bulk Metadata Commander doesn't add any options to your database; it only updates the posts, meta, and media assignments you explicitly ask it to.

== Screenshots ==

1. Step-by-step bulk update tool with Previous/Next navigation.
2. Media Usage screen showing every post using a selected file, with checkboxes to choose what gets replaced.

== Changelog ==

= 1.0.0 =
* Initial release.
