MediaPrune – Media Cleaner & Unused Image Remover
| 开发者 | sandcircuit |
|---|---|
| 更新时间 | 2026年11月2日 13:49 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Safe by default. Files go to a quarantine first, not straight to the bin. If a page turns out to need one, restore it in one click. Quarantined files are deleted for good after 30 days.
- Careful scan. When in doubt, MediaPrune keeps the file. Each file is checked again right before it's removed, in case something started using it after the scan.
- Thorough clean-up. Removes the original and every copy: all the sizes WordPress made, plus the extra crops and WebP versions other plugins create.
- Works on large libraries. Scans in small steps, so it doesn't time out, and an interrupted scan picks up where it left off.
- Lightweight and private. Runs only on its own admin screen, adds nothing to your site's front end, and sends no data anywhere.
- the content of all posts, pages and custom post types, including drafts, scheduled and private posts: images, galleries, covers, videos and file links in blocks, classic content and shortcodes;
- featured images;
- custom fields on posts, categories, tags and users, which covers ACF, WooCommerce product galleries and page builders;
- site settings: the site logo and icon, Customizer settings and widgets.
- Move to quarantine takes the selected files offline. They disappear from the media library and their URLs stop working, so if a page still used one, you'll notice straight away. Restore any file from the Quarantine tab.
- Clean selected deletes the selected files permanently, after you confirm. Use it for files you're sure about.
third-party-licenses.txt.
安装:
- In your WordPress admin, go to Plugins → Add New, search for "MediaPrune", then install and activate it.
- Go to Media → MediaPrune and click "Scan media library".
- Review the list of unused files, untick anything you want to keep, then click "Move to quarantine".
屏幕截图:
常见问题:
How do I delete unused images in WordPress?
Install MediaPrune, go to Media → MediaPrune and run a scan. It lists every image and file nothing on your site uses. Review the list, then move the files to quarantine. They're deleted for good after 30 days, or straight away if you choose "Delete now".
Is it safe? Can it delete an image that is still in use?
MediaPrune checks your posts, pages, custom fields and site settings, and keeps any file it isn't sure about. It can't see files referenced from outside the database, such as an image hard-coded in a theme's CSS or PHP, or linked from another website. That's why cleaned files go to quarantine first: look over your site after cleaning, and restore anything that's missing.
Developers can mark such files as used with the mediaprune_used_attachment_ids filter.
Does it work with WooCommerce, ACF and page builders?
Yes. MediaPrune reads custom fields, which is where WooCommerce stores product galleries and where ACF and page builders store images, so files used there are kept.
Does it work with images served from a CDN, or with WebP copies?
Yes. Files are matched by their path, so CDN URLs, resized copies, -scaled originals and WebP versions all count as uses of the original file.
Will it free up disk space?
Yes. It removes each file from the server along with every resized copy, not just the media library entry. The review screen shows how much space your selection will free.
Where do quarantined files go?
Into a folder inside your uploads directory, named mediaprune-quarantine- plus a random suffix, protected by an index.php and an .htaccess file that blocks web access. While a file is in quarantine, it's hidden from the media library.
Does it slow down my site or send data anywhere?
No. MediaPrune loads only on its own admin screen, adds nothing to your site's front end, and makes no outside requests.
What does it need from the server?
PHP must be able to write to the uploads folder directly, which is the case on most hosts.
更新日志:
- First release.