Clarvity Media Replace
| 开发者 | onemorekrishna |
|---|---|
| 更新时间 | 2026年10月8日 22:58 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- A "Replace Image" button in the Attachment details sidebar (grid view), the Edit Media screen and the list-view row actions.
- Pick an existing library image or upload a new one, using the familiar media window.
- A confirmation prompt showing the current and new images side by side, where the image is used, and a required "I understand" checkbox.
- Keep the current filename (links stay identical) or use the new file's name.
- Changing file type (for example JPG to PNG or WebP) is supported; links are updated for you.
- Serialization-safe URL updates in post content, excerpts, custom fields, term meta and settings, including Elementor's JSON data.
- Automatic rollback: if anything fails, the original files and data are restored.
- Optional clean-up of the replacement's own library entry when it isn't used anywhere.
- Loads nothing on the front end, and in wp-admin only on screens that already load the media window.
安装:
- In wp-admin go to Plugins → Add New → Upload Plugin, choose
clarvity-media-replace.zipand click Install Now. (Or unzip it into/wp-content/plugins/.) - Click Activate.
- There are no settings. Go to Media → Library to use it.
常见问题:
Will this break my links?
No. With "Keep the current filename" and the same file type, the image's URL doesn't change at all. When the URL must change (a new file type or filename, or new thumbnail dimensions because the aspect ratio differs), every stored copy of the old URL is rewritten to the new one.
How are featured images, galleries and custom fields handled?
They store the image's ID, and the ID never changes, so they show the new image automatically. This covers featured images, WordPress and WooCommerce galleries, ACF and other custom fields that store IDs, the site logo, site icon and header image, and Elementor image widgets. Custom fields and page-builder data that store URLs are updated by the URL rewrite.
What if the new image has a different shape or is smaller?
All thumbnail sizes are regenerated from the new image. Each old size URL is mapped to the same size of the new image. If the new image is too small to have that size, the full-size image is used instead.
What if something goes wrong halfway?
The current files are moved to a temporary folder first. If copying or processing the new image fails, the new files are deleted, the originals are moved back, and the attachment data is restored. Nothing is left half-changed.
Can I undo a replacement?
Not with one click. The old file is permanently replaced, which is why the confirmation prompt asks you to acknowledge that. Keep a backup, or replace the image again with the old file.
Does it work with images stored in the cloud (S3, etc.)?
The image file must be on the server's disk. If an offload plugin removed the local copy, the plugin stops with a clear message and changes nothing.
Why is some data left unchanged?
If a setting stores PHP objects, rewriting it could corrupt it, so it is skipped and the result message tells you how many entries were skipped. This is rare for image URLs.
Can developers extend it?
Yes:
clarvity_mr_required_capability(filter): the capability needed to replace images. Defaultedit_others_posts.clarvity_mr_url_pairs(filter): the old => new URL paths about to be applied.clarvity_mr_replacement_targets(filter): the tables and columns searched for URLs.clarvity_mr_image_replaced(action): fires after a replacement, with the attachment ID, the replacement's ID and the URL pairs. Useful for purging caches.
更新日志:
- First release.