內容簡介
Smart Media Replacement 外掛可讓使用者輕鬆替換媒體檔案而不改變其 URL，確保網站內部連結不受影響，並提供完整的版本歷史記錄，讓使用者能夠隨時恢復先前的檔案版本。
【主要功能】
• 替換檔案但保持 URL 不變
• 自動快照與一鍵恢復功能
• 媒體庫及區塊編輯器內替換
• 預設安全性檢查檔名與類型
• 媒體審核功能顯示檔案使用情況
外掛標籤
開發者團隊
原文外掛簡介
Ever updated a PDF and realized half your site links to the old version? Or replaced a hero image and watched your carefully-tuned page layout collapse? Smart Media Replacement solves both problems — and adds a safety net you’ll wish you had earlier.
Replace the file, keep the URL. When you swap an attachment with this plugin, the file’s URL never changes. Every existing link, every email that points to it, every page that embeds it, every SEO ranking — all of it keeps working. No 404s, no broken references, no scrambling to update old content.
Full revision history, one-click restore. Every replacement automatically snapshots the previous version. Made a mistake? Roll back instantly. Want to see what the file looked like three months ago? Download it. Each revision is timestamped, attributed to the user who made it, and can carry an optional note describing what changed.
Works where you work. Replace from the Media Library, or from inside any block’s Replace toolbar in the block editor — image, cover, video, audio, file, gallery, and more. The editor refreshes in place, no page reload, no lost work.
Safe by default. The plugin validates filenames, file types, and image dimensions to keep your URLs intact and your layouts unbroken. WordPress’s auto-scaled images are handled transparently. Revisions land in a database table that’s self-healing on every admin load, and the plugin’s settings page gives you control over how many revisions to keep, how long to retain them, and which file types are tracked.
Know what’s actually being used. The Media Audit screen builds an index of every post, page and template that references each file in your library. See at a glance which files are used and where, which are unused and safe to delete, and which images are embedded without alt text. Bulk-delete unused files with confidence — the delete controls only appear for files nothing references.
Use cases
Monthly reports and newsletters — Update PDFs linked from past emails without breaking any of those links.
Brand refreshes — Replace logos, headers, and brand imagery once; everywhere they’re used updates automatically.
Legal documents — Keep current versions of terms of service, privacy policy, and contracts live, with older versions preserved as revisions for compliance.
Image updates — Refresh product photos, blog hero images, and marketing assets without breaking responsive sizes or SEO.
Typo fixes in published assets — Fix errors in infographics, downloadable guides, or e-books without scrambling to update references across your site.
Versioned downloads — White papers, e-books, technical docs that need to stay at a stable URL while preserving older versions on demand.
Media library cleanup — Find the files nothing references and reclaim disk space, without guessing whether something is still in use.
Accessibility sweeps — Surface every image embedded in content without alt text, in one filterable list.
Features
Replacement and URL preservation
Replace any media file while keeping its URL, ID, and metadata intact
Existing internal and external links keep working — no 404s, no SEO impact
Automatic regeneration of image size variants (thumbnails, medium, large, etc.)
Transparent handling of WordPress’s -scaled large images
Revision history
Every replacement automatically snapshots the previous file
Major/minor version numbering (e.g. v1.0 → v1.1 → v2.0)
Optional replacement note per revision, attributed to the user
One-click restore of any past version
Download individual revisions, or download a ZIP archive of an attachment’s full history
Configurable: maximum revisions per file, age-based retention with daily cleanup, per-file-type opt-in
Block editor integration
“Update existing file” in every block’s Replace toolbar dropdown (image, cover, video, audio, file, gallery, media-text, post-featured-image)
In-place editor refresh after replacement — no page reload, no lost work
Accessibility-friendly notifications via WordPress’s native screen reader announcements
Validation safeguards
Filename matching to keep URLs stable
Image dimension matching to prevent layout breakage
MIME-type matching to prevent file corruption
Clear, actionable error messages when something doesn’t match
Built-in admin
Settings page at Settings → Smart Media Replacement
Storage stats: total revisions, total disk usage, database table status
Optional deactivation cleanup (files and/or database)
Multisite-ready
Network-activate only on multisite — one consistent configuration across every site
Settings live at Network Admin → Settings → Smart Media Replacement and apply network-wide
Revisions are stored per-site under each site’s uploads directory; metadata lives in a single shared network table
Daily retention cleanup runs across every site in the network
Automatic row and file cleanup when a site is deleted
Single-site installs work exactly as before — settings and storage stay per-site, no network behavior involved
WP-CLI
wp smr db check — verify the revisions table exists (non-zero exit code if missing, safe for CI pipelines)
wp smr db repair — recreate the table if missing; idempotent, safe to run when the table already exists
wp smr db status — revision counts and storage usage; --network for a per-site breakdown on multisite
wp smr db cleanup — delete expired revisions immediately, with --dry-run to preview and --network for all sites
Other
Self-healing database tables via configurable scheduled check (hourly, daily, weekly, or disabled); use wp smr db repair for on-demand recovery
Media Audit dashboard listing every file with its usage count, type, size, alt text and upload date
Filter by where a file is used (block, featured image, content, post meta), by media type, by used/unused, and by missing alt text
“Used In” popover listing the exact posts referencing a file, with edit links
Bulk delete restricted to unused files only
Index stays current as you edit — saving, trashing or deleting a post updates it without a rescan
Developer hooks throughout for custom integrations
Privacy
This plugin is fully self-contained and respects your privacy:
Does not collect or transmit any user data
Does not use cookies or third-party tracking
Only processes files locally on your server
Does not communicate with external services or APIs
Usage
From the Media Library
Navigate to the WordPress Media Library
Open the file you want to replace (click on it, or use the row actions in list view)
Click Replace File
Choose your new file — if revisions are enabled, you’ll be prompted for an optional note and version type (minor/major)
The replacement happens immediately, preserving the file’s URL
From the block editor
Click on any media block (image, cover, video, audio, file, gallery, etc.)
Open the Replace toolbar dropdown
Choose Update existing file
Pick your new file — the editor refreshes in place
Viewing and managing revisions
In the Media Library list view, the Revisions row action opens the full revision history for that file
On the attachment edit screen, the View Revisions button opens the same panel
From either, you can download any past version individually or as a ZIP, and restore any revision with one click
Auditing your media library
Go to Media → Media Audit
Click Scan Now and let the index build — progress is shown in place
Use the filter chips to narrow to unused files, a media type, a usage location, or images missing alt text
Click a usage count to see exactly which posts reference that file
Select unused files and delete them in bulk — the delete controls only appear for files nothing references
On multisite, run the scan on each site, or use wp smr audit scan --network to build every site’s index at once.
