OliveroDev Media Audit – Media Library Cleaner & Optimizer
| 开发者 |
oliverodev
alexis-olivero |
|---|---|
| 更新时间 | 2026年6月1日 11:13 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Media library scan — Identify unused images, documents, videos, and audio files in your WordPress uploads.
- Dashboard overview — See used vs. unused file counts and the total storage you can recover at a glance.
- Safe, controlled cleanup — Review every file before deleting. No surprises, no bulk wipes you didn't authorize.
- Batch scanning — Scans run in configurable batches to avoid server timeouts, even on large libraries.
- Automatic background scans — Schedule recurring WP-Cron scans (hourly, daily, weekly) to keep your library clean over time.
- File type filtering — Focus on images, documents, videos, audio, or archives depending on what you need to clean.
- Image format support — JPEG, PNG, GIF, WebP, and SVG all covered.
- Zero configuration required — Install, run a scan, and start recovering space.
- Go to Tools → OliveroDev Media Audit in your WordPress admin.
- Click Start New Scan. The plugin checks every attachment in your library against all content on your site.
- Review the results. Files marked Unused are not referenced anywhere on your site.
- Delete unused files individually — or switch to the Unused Files tab to work through the full cleanup list.
- Posts, pages, and custom post types (including draft and private)
- Post meta and serialized data (including Gutenberg block attributes)
- Theme options and customizer settings (logo, header image, background image)
- Widget data and sidebar configurations
- Term meta and user meta
- WordPress options table
- Featured images (post thumbnails)
- Site icon setting
- All registered image sizes (thumbnails, medium, large)
- Deep Detection for Advanced Custom Fields (ACF), Divi Builder, Elementor, WooCommerce product images, and more.
- Storage Analysis with visual charts — see MB/GB breakdown by file type, identify your heaviest content.
- Intelligent Trash System — move files to trash before permanent deletion for an extra safety layer.
- One-click Bulk Cleanup — delete all unused files in a single operation.
- Extended file type support — full coverage for documents (PDF, DOC, XLS), video, audio, and archive files.
- Advanced automation — fine-grained scheduling and cleanup triggers.
- Site owners who want to free up hosting disk space without hiring a developer.
- Agencies managing multiple WordPress sites that accumulate unused uploads over time.
- Developers who need a reliable way to audit a client's media library before a migration.
- WooCommerce stores where product images are frequently updated or deleted from the catalog.
- Bloggers and content creators who upload many images and want to keep their library organized.
安装:
- Search for "OliveroDev Media Audit" in Plugins → Add New.
- Click Install Now, then Activate.
- Open Tools → OliveroDev Media Audit and run your first scan.
- Download the plugin ZIP from WordPress.org.
- Upload the contents to
/wp-content/plugins/oliverodev-media-audit/. - Activate from Plugins in your WordPress admin.
- Open Tools → OliveroDev Media Audit and run your first scan.
屏幕截图:
常见问题:
Is it safe to use on a live production site?
Yes. The plugin reads content to determine whether a file is in use; it never deletes anything automatically. You review the results first and choose which files to remove one at a time.
Will it detect media used in Elementor or Divi?
The free version searches all post content, including raw Elementor and Divi data stored in post meta. The PRO version adds dedicated deep-detection integrations for these builders to catch edge cases in their proprietary storage formats.
Can it detect images used in ACF (Advanced Custom Fields)?
The free version scans post meta values and will find most ACF image references stored as attachment IDs or URLs. The PRO version includes a dedicated ACF integration for complete coverage of repeaters and flexible content fields.
How do I find unused images in WordPress?
Install the plugin, go to Tools → OliveroDev Media Audit, click Start New Scan, and open the Unused Files tab when the scan finishes. Every file listed there was not found in any post, page, or site setting.
How long does a scan take?
It depends on your library size. The scan runs in batches (configurable from 1 to 200 files per batch) directly in your browser via AJAX, so it won't time out even on large libraries with thousands of files.
What happens when I delete a file?
The plugin calls WordPress's native wp_delete_attachment() function, which removes the attachment post, all registered image sizes, and the original file from your server. This is the same process WordPress uses in the media library.
Can I recover a deleted file?
No. Deletion is permanent. If you need a safety net before bulk cleanup, the PRO version includes an intelligent Trash System that lets you move files to a staging area before committing to deletion.
Does it work with WooCommerce?
The free version scans product descriptions, product gallery meta, and variation image meta. The PRO version adds dedicated WooCommerce detection to cover featured product images and gallery references more reliably.
Will deleting unused media affect my SEO?
Only if those files were indexed by search engines and linked from external sites. For files that are truly unused (not referenced in any post or page on your site), there is no SEO impact. If you are unsure, review each file individually before deleting.
Where does the plugin appear in the WordPress admin?
Go to Tools → OliveroDev Media Audit.
Does it support multisite?
The plugin is designed for single-site installations. Multisite compatibility is on the roadmap.
Can I schedule automatic scans?
Yes. Go to Tools → OliveroDev Media Audit → Settings and choose a scan frequency: hourly, twice daily, daily, or weekly. The scan runs in the background via WP-Cron.
What file types does the free version support?
Images: JPEG, PNG, GIF, WebP, SVG. The PRO version extends this to PDF, DOC, DOCX, XLS, XLSX, MP4, MP3, ZIP, RAR, and more.
I found a false positive — a file shown as "unused" that I know is in use. What should I do?
Do not delete it. The free version covers the most common storage locations. If you are using a plugin or theme with a custom database structure, the file may be referenced in a table the free version does not scan. The PRO version covers the most popular third-party tools. You can also filter the detection using the oliverodev_media_audit_is_media_used WordPress filter hook.
更新日志:
- Fix: Fatal error on activation —
oliverodev_media_audit_get_filesystem()calledincludes()which is not a valid PHP or WordPress function. Replaced with a directfilesize()call; WP_Filesystem is unnecessary for reading file sizes.
- New: CSS background-image detection — now detects media files used in inline styles and custom CSS (parallax backgrounds, hero sections, etc). Fixes issue where background images were incorrectly marked as unused and deleted.
- New: Private method
check_css_background_usage()searches forurl()patterns in post_content and postmeta. - Fix: RevSlider table check was using undefined
$termsvariable — changed to$search_terms.
- Fix: "Where is it used?" now correctly finds Gutenberg block references. Previously returned "No specific location found" for images inserted via Gutenberg blocks because the search only used the full URL. Now also searches for
wp-image-{id}CSS class and"id":NJSON block patterns — matching all detection methods used by the scanner.
- Improved: PRO upgrade banner completely redesigned with benefit-focused messaging, risk-oriented copy, and trial-first CTA ("Try PRO Free — 3 Days"). Dynamic unused file count shown in the banner copy.
- New: "Where is it used?" button on every Used file — shows the exact posts, pages, or theme settings referencing each file.
- New: Real-time scan counter — displays "Scanning X of Y files · Z remaining" during active scans.
- New: Delete confirmation modal — shows file thumbnail, name, and size before permanent deletion instead of a plain browser dialog.
- New: Export CSV — download a spreadsheet of all unused files directly from the Unused Files tab.
- Fix: Removed false positive detections caused by overly broad serialized-integer patterns (
i:N;,,N,,,N") being matched in postmeta, usermeta, termmeta, and options tables. - Fix: Removed unreliable exact-integer postmeta match that incorrectly flagged files as used when unrelated meta keys (e.g.
_edit_last, counters) happened to store the same number as a media ID. - Improvement: JSON and HTML id-based patterns (
"id":N,data-id="N", etc.) are now scoped exclusively to post_content where Gutenberg blocks live, eliminating false positives in meta tables.
- Hide the "Get PRO" banner when PRO is already active via license integration.
- Maintenance release for WordPress.org package compliance and metadata alignment.
- Fixed PRO upgrade link to Freemius checkout.
- Added animated PRO upgrade banner in dashboard.
- Added link to upgrade to PRO version.
- Improved WordPress.org submission compatibility and plugin metadata.
- Added plugin text domain loading.
- Refreshed compatibility metadata.
- Refactored scanning architecture for improved performance.
- Updated compatibility metadata.