Title: Devenia Replace Media
Author: Bjorn Solstad
Published: <strong>2025 年 12 月 18 日</strong>
Last modified: 2026 年 5 月 31 日

---

搜索插件

![](https://ps.w.org/devenia-replace-media/assets/banner-772x250.png?rev=3423056)

![](https://ps.w.org/devenia-replace-media/assets/icon-256x256.png?rev=3423056)

# Devenia Replace Media

 作者：[Bjorn Solstad](https://profiles.wordpress.org/basicus/)

[下载](https://downloads.wordpress.org/plugin/devenia-replace-media.1.8.0.zip)

 * [详情](https://cn.wordpress.org/plugins/devenia-replace-media/#description)
 * [评价](https://cn.wordpress.org/plugins/devenia-replace-media/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/devenia-replace-media/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/devenia-replace-media/#developers)

 [支持](https://wordpress.org/support/plugin/devenia-replace-media/)

## 描述

**Devenia Replace Media** lets you replace any media file in WordPress while keeping
the original URL intact. Useful for updating images without changing links.

#### Key Features

 * **Keep Your URLs** – Replace the file while keeping the URL, helping avoid broken
   links.
 * **Works Everywhere** – Media Library list view, Elementor gallery editor, and
   standard WordPress media modals.
 * **Preserves Metadata** – Captions, alt text, titles, and descriptions stay intact.
 * **Automatic Cache Busting** – Appends a version parameter after replacement, 
   which can help browsers and CDNs fetch the updated file.
 * **Regenerates Thumbnails** – All image sizes are automatically regenerated after
   replacement.
 * **MCP/Abilities Support** – Agents and automation can replace an existing attachment
   directly instead of uploading duplicates.
 * **Simple Interface** – Just click “Replace File”, upload your new file, done.

#### Where It Works

 * **Media Library** – “Replace File” link appears in the list view actions
 * **Elementor Gallery Editor** – Blue “Replace File” button in attachment details
 * **WordPress Media Modal** – Works in the standard media selector used by Gutenberg
   and Classic Editor

#### Use Cases

 * Update product images without changing URLs
 * Fix typos in PDFs or documents
 * Replace outdated screenshots
 * Update seasonal images across your site
 * Swap placeholder images for final versions

#### Why Cache Busting Matters

When you replace an image, browsers may show an older cached version. This plugin
appends a version parameter to image URLs after replacement to help caches fetch
the updated file.

## 安装

 1. Upload the `devenia-replace-media` folder to `/wp-content/plugins/`
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. That’s it! Look for “Replace File” links in your Media Library

## 常见问题

### Will this break my existing links?

The file URL stays the same; only the file content changes.

### Does it work with CDNs?

Often, yes. The cache-busting version parameter can help CDNs serve the updated 
file, but behavior depends on your CDN configuration.

### What file types can I replace?

Any file type that WordPress allows in the Media Library: images (JPG, PNG, GIF,
WebP), documents (PDF, DOC), audio, video, and more.

### Can I replace an image with a different file type?

Yes. For example, you can replace a JPG with a PNG. The URL path stays the same,
but the MIME type is updated.

### Does it preserve my captions and alt text?

Yes. All attachment metadata (title, caption, alt text, description) is preserved.

### I replaced an image but still see the old one. What do I do?

Try a hard refresh (Ctrl+Shift+R or Cmd+Shift+R). The plugin adds cache-busting 
parameters, but your browser may have a very aggressive cache. For images replaced
before installing this plugin, the cache-busting won’t apply.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Devenia Replace Media」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Bjorn Solstad ](https://profiles.wordpress.org/basicus/)

「Devenia Replace Media」插件已被翻译至 1 种本地化语言。 感谢[所有译者](https://translate.wordpress.org/projects/wp-plugins/devenia-replace-media/contributors)
为本插件所做的贡献。

[帮助将「Devenia Replace Media」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/devenia-replace-media)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/devenia-replace-media/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/devenia-replace-media/)，或通过[RSS](https://plugins.trac.wordpress.org/log/devenia-replace-media/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/devenia-replace-media/)。

## 更新日志

#### 1.8.0

 * Added: `media/replace-from-url` and `media/replace-base64` abilities for MCP/
   Abilities clients.
 * Improved: Admin replacement flow and automation replacement flow now share the
   same safer staged replace logic.

#### 1.7.5

 * Fixed: Replace File button injection in Media Library grid/details view on newer
   WordPress admin markup
 * Improved: More robust attachment ID detection across WP media frames and DOM
 * Fixed: Media Library grid view details modal now detects attachment ID via `?
   item=<ID>`
 * Improved: Cache busting now also applies to responsive image `srcset` and works
   across repeated replacements
 * Improved: After replacement, Media Library refresh behavior is more reliable
 * Improved: Safer file replacement flow (staged write + rollback) and stricter 
   permissions check

#### 1.7.4

 * Added: Replace File button on Edit Media screen

#### 1.7.3

 * Fixed: Use wp_add_inline_script() and wp_print_inline_script_tag() instead of
   raw script tags
 * Fixed: Added nonce verification for GET requests to replacement page
 * Fixed: Wrapped require_once calls with function_exists checks
 * Fixed: Improved file upload validation with is_uploaded_file(), sanitize_file_name(),
   and sanitize_mime_type()
 * Added: User capability check (upload_files) in replacement function
 * Improved: Better code documentation and WordPress Coding Standards compliance

#### 1.7.2

 * Changed slug to devenia-replace-media (WordPress.org requirement)

#### 1.7.1

 * Fixed text domain to match plugin slug

#### 1.7

 * Fixed nonce verification warnings in file upload handling
 * Improved input validation for WordPress.org Plugin Check compliance
 * Shortened short description to meet 150 character limit

#### 1.6

 * Uses WordPress Filesystem API for all file operations
 * Improved security and WordPress.org compatibility

#### 1.5

 * Added automatic cache busting – URLs now include version parameter after replacement
 * Helps caches fetch updated files without manual cache clearing

#### 1.4

 * Added support for Elementor gallery editor
 * Uses `elementor/editor/footer` hook for proper script loading

#### 1.3

 * Changed script loading method for better compatibility

#### 1.2

 * Improved attachment ID detection in media modals

#### 1.1

 * Added JavaScript injection for media modal support

#### 1.0

 * Initial release
 * Replace files from Media Library list view
 * Preserve metadata and regenerate thumbnails

## 额外信息

 *  版本 **1.8.0**
 *  最后更新：**1 周前**
 *  活跃安装数量 **50+**
 *  WordPress 版本 ** 5.7 或更高版本 **
 *  已测试的最高版本为 **7.0**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/devenia-replace-media/) 和 [Norwegian (Bokmål)](https://nb.wordpress.org/plugins/devenia-replace-media/).
 *  [翻译成简体中文](https://translate.wordpress.org/projects/wp-plugins/devenia-replace-media)
 * 标签
 * [cache busting](https://cn.wordpress.org/plugins/tags/cache-busting/)[elementor](https://cn.wordpress.org/plugins/tags/elementor/)
   [media library](https://cn.wordpress.org/plugins/tags/media-library/)[replace image](https://cn.wordpress.org/plugins/tags/replace-image/)
   [replace media](https://cn.wordpress.org/plugins/tags/replace-media/)
 *  [高级视图](https://cn.wordpress.org/plugins/devenia-replace-media/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/devenia-replace-media/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/devenia-replace-media/reviews/)

## 贡献者

 *   [ Bjorn Solstad ](https://profiles.wordpress.org/basicus/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/devenia-replace-media/)