Beschreibung

Media Cleaner cleans your Media Library from the media entries (and files) which aren’t used in your website, as well as broken entries. An internal trash allows you to make sure everything works properly before deleting the media entries (and files) permanently. It uses a smart analysis powered by many implementations for specific plugins and themes.

Before using this plugin, make sure you have a proper backup of your install. This step is not optional; it is required. You cannot trust any tools modifying or deleting your files. I recommend using the excellent service called BlogVault.

For compatibility, Pro version and important information, please read this until the end. Last but not least, it is necessary to read the tutorial. It is available on the official website, here: Media Cleaner.

IMPORTANT

This tool is a knife. Do not use it if you don’t have any backup, or if you don’t know what it does. Such a plugin is difficult to create and to maintain. If you understand WordPress, you probably know why. This plugin does its best to help you. Learn how to use it and you will get awesome results. I recommend using the excellent service called BlogVault to backup your website.

DASHBOARD

The files detected as not used will be listed in a specific dashboard. At this point, it will be up to you to delete them. They will be then moved to a trash internal to the plugin. After more testing, you can retrieve those files from the trash, or you can delete them permanently.

COMPATIBILITY

It works with any kind of media entries, including their retina and/or WebP versions. It is tested on modern WordPress installs (with Gutenberg) as well as older ones, with various themes and by a community of thousands of users. It does support WooCommerce. Support for specific plugins is being added little by little. As it requires meticulous a lot of work and testing, the Pro version might be required if you are using complex plugins to handle the content of your website.

PRO VERSION

The Pro version adds Filesystem Analysis, extra support for complex plugins, Live Site option and WP-CLI support.

Media Cleaner Pro can scan your physical /uploads directory, and match it against the Media Library.

It has extra support for complex plugins, such as:

ACF (+ ACF Widgets)
Divi Builder
Fusion Builder (Avada)
Visual Composer (WPBakery)
Elementor
Beaver Builder
And others (Theme X, ZipList Recipe, …)

The Live Site option will analyze the online version of your website, which might enhance the accuracy of the Cleaner in edge-cases.

Last but not least, Media Cleaner Pro has support for WP-CLI. If you have direct access (SSH) to your server, you will be able to run the plugin at a much higher speed, have it ran automatically, etc.

AGAIN, BE CAREFUL

Last but not least, and… again: this plugin deletes files. Be careful! Backup is not only important, it is necessary. Don’t use this plugin if you don’t understand what it does and how WordPress works.

SPECIAL THANKS

Mike Meinz, an amazing developer from the US who made a thorough debugging of the whole process, load lot of corrections and optimizations, and added support for more plugins.
Satoshi Soma, an excellent Japanese developer who helped me when I needed it the most.

Screenshots

Media -> Media Cleaner

Installation

Upload media-file-cleaner-pro to the /wp-content/plugins/ directory
Activate the plugin through the ‚Plugins‘ menu in WordPress
Go in the Settings -> Media Cleaner and check the appropriate options
Go in Media -> Media Cleaner

Rezensionen

Good but dangerous

andrebell82

The free version is good for getting a listing of missing files and (supposedly) unused media files. Do NOT trust this free version to 'delete all!' The missing files portion of the scan is correct. Years ago I migrated my databases from one host to another before the original host went out of business. Somehow the migrated database was corrupt. So I used an older backup of my database and crossed my fingers. This plugin shows six JPG files I missed. (will need to track those later). Useful and accurate for that. However the 'unused' media scan produces incorrect results. There are images, videos, and audio files I use in HTML/PHP landing pages, squeeze pages, custom 404 pages, etc. Those files are reported by this plugin as 'seems to be unused'. Wrong. So I do not recommend nor trust this this free version to 'delete all.' Use this free version for reporting only...otherwise you might delete files that are used outside of your WordPress installation...or perhaps even inside :\

I get it, I need the Pro version.

Temerity Studios

Fully 2/3rds of my screen are notices telling me why I need to upgrade to the pro version of this plugin. I have ACF, get pro. Beaver Builder? Get pro. Don't have Pro? You should get Pro. Giving 4 stars instead of 3 because I'm sure it all works very well, but with the overwhelming "Get Pro" notifications, I'll be moving on to other plugins.

Great time saving app, cleaning based on file system!

zegklitzm

It seems like a great app to me. Mainly because of scanning and cleaning based on your filesystem and because of compatibility with Elementor builder. I have on my websites thousands of photos, that I do not use and I cant imagine to delete them throuh FTP one by one. So it is the great time saving app.

Fantastic maintenance plugin, definitely a must

Jonathan

This plugin is fantastic! My job uses WordPress in a higher education setting with a large multisite install. Some of our users get a little carried away uploading multiple versions of files and tons of images that never end up getting used. This plugin is perfect for helping us keep the media libraries and server storage under control. Don't forget to do backups before and you should be good to go. If you use ACF fields to handle media items at all, I would recommend getting the Pro version of this plugin. I found the Pro version worked perfectly with ACF related media library items.

This plugin is magical

cindeevandijk

Your plugin is magical and a huge lifesaver. I very seldom give reviews unless the plugin is complete crap or wonderful. Your plugin falls in the wonderful category. I had done a completely rookie mistake and should have known better - but it's one of the situations that I was moving too fast and didn't think through everything. I had a ton of images that I needed to delete from my server, so I had deleted the images off FTP - big mistake. The problem it created was that when I tried to insert an image in a post or page, I would get a 503 error. I searched a ton of forums, but people didn't have the answer that would solve my issue until I came across some post that mentioned your plugin. Your plugin completed fixed the issue!!!!

Great Tool – Intuitive, Efficient, Safe

jadccnc45

Media Cleaner is an excellent tool to clean up unused and orphaned media. I have been thinking about doing this for several months but always deferred. I couldn't find a plugin that would safely remove unused and orphaned media while providing a recovery capability in case I removed something that was actually being used by the website. I installed the free version on a test website and tried it - it looked good and offered the safety features I was looking for. I then bought a 1 year subscription so I could scan for and delete orphaned media. I installed the Pro version on my live website and went to work. The documentation has two critically important prerequisites. 1. Back up your website. Any time you're doing something that is global and fundamental to your website you should have a backup as the ultimate "disaster recovery" safe guard. 2. Be sure to modify your website's wp-config.php file to include the code line define( 'MEDIA_TRASH', true ); With this in place "deletes" are temporary (they are moved to a Trash folder and can be undone easily). Without it "deletes" are permanent (no Trash folder). Media Cleaner provides a great UI along with a straight forward, intuitive approach that provides absolute safety as long as you follow the instructions in the tutorial. 1. In Settings you set the criteria for the type of media you're looking for (unused, orphaned, or thumbnails). 2. Perform a Scan and then Refresh the page. A list of all the media that matches your Settings criteria is displayed. 3. You can "delete" individual items or in bulk (it is a temporary deletion into a Trash folder - provided you included the code line in wp-config.php). 4. Review your website. If it is missing any media you can display the Trash folder and easily recover any/all items - they are "un-deleted" and back on your website. If your website is fine you can leave items in Trash as long as you want to allow any issues to be discovered through normal use. 5. Once you are certain everything is o.k. you can empty the Trash folder making the temporary deletions permanent - the files are no longer taking up space on your WP website. My website is pretty small - a non-profit club with read-only pages with lots of pictures and a few documents. Pictures are regularly updated with new ones so over 8 years we've created a lot of junk. Media Cleaner found 129 unused items and 169 orphaned items. I was careful deleting (temporary deletion) the 129 unused because the website has a couple of media plugins (a slide show gallery and a photo gallery). Media Cleaner correctly identified the pictures in the photo gallery as being used but thought all the slide show gallery pictures were not used. I deleted 20 items at a time and then reviewed my website, if anything was missing I "undid" the last deletion to recover the pictures and then carefully deleted them to avoid deleting the ones that were in use (in the slide show gallery). The slide show pictures I marked as "Ignore" so that Media Cleaner would skip over them on any subsequent scan. Very intuitive, very easy, very safe. The whole process took me about 2 hours and, the best part, I knew I wasn't going to accidentally trash my website. I haven't done the thumbnails yet but it is the same safe process so I'm not intimidated by it.

Lies alle 182 Rezensionen

Mitwirkende & Entwickler

„Media Cleaner“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Jordy Meow

„Media Cleaner“ wurde in 4 Sprachen übersetzt. Danke an die Übersetzerinnen und Übersetzer für ihre Mitwirkung.

Übersetze „Media Cleaner“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.

Änderungsprotokoll

5.4.0

Add: Support for Uber, Easy Real Estate.
Update: Admin CSS and texts.
Fix: A rare but wrong call to the log() function was causing the plugin to fail.
Update: Clean the options. Now, the Content option replaces Posts/Meta/Widgets (they were useless in a way).
Add: Support for WP-CLI (have a look at the how-it-works.txt) in the Pro. Now, scanning can be 100x times faster.
Add: Option Live Site in the Pro.

5.2.4

Add: Lot of refactoring and optimizations.
Add: Support for Theme X, ZipList, and better support for standard websites as well.
Add: Yes/No dialog for Reset button.

5.2.3

Add: Support for Recent Blog Posts.
Add: Additional support for images used by the theme.

5.2.1

Add: Support for My Calendar (thanks to Mike Meinz).
Add: Support for iFrames (thanks to Mike Meinz).
Update: Code cleaning, reorganization and optimization.

5.2.0

Update: Many optimizations, modules and big sections of the code are now only loaded when really needed.
Fix: Filenames with spaces weren’t detected correctly and other.
Fix: Make sure that the shortcodes are resolved.
Add: Compatibility with more plugins (ACF Widgets, Attachments, Metaslider).

5.1.3

Add: Support for WebP.
Update: Avoid removing tables when plugin is only disabled.
Fix: For some, the tables couldn’t be reset.

5.1.2

Update: Admin style update and common framework updated.
Update: Compatibility with WordPress 5.1.

5.1.0

Add: Filters for Filesystem scan. Please have a look at the tutorial (https://meowapps.com/media-cleaner-tutorial/), there is now a section about those filters.
Fix: Query for metakey.
Fix: Thumbnails matching.
Update: Compatibility for WordPress 5 and Gutenberg.

5.0.1

Update: Slight code cleaning.
Update: Checkboxes are updated dynamically.
Info: Media Cleaner is better than ever by going through so many improvements and optimizations this year. The plugin has also been perfectly stable for a few weeks, so I have decided to change its version number. Please help this plugin survive by giving me a nice review, here: https://wordpress.org/support/plugin/meow-lightbox/reviews/?rate=5#new-post. Thank you 🙂

4.8.4

Fix: Issue with ACF Repeater.
Fix: Trash and Ignore features resulted in a weird behavior when used together.
Add: Now can delete the results of a search.
Update: Many UI improvements.

4.8.0

Update: Many parts of the UI were rewritten for a better experience. Buttons have a nicer logic.
Add: Enhanced error control. From now, when an error occurs during the scan, a popup will appear (asking to try again, or to skip the current item), and errors will be logged to the console.

4.6.3

Add: Added an option to only scan the thumbnails and ignore the base files.
Add: ACF Repeater support.
Update: Improved the code and the performance. Scan is now done differently, using the DB.
Fix: Debug logs weren’t logging (and enhanced them a bit).

4.5.5

Fix: Doesn’t remove the Media entry if the files cannot be deleted.
Update: Displays a warning if the log file cannot be created.

4.5.4

Update: Streamlined the plugin, tutorial has also been rewritten.
Update: Simplified the Settings. Removed the Gallery option, as it is part of the Posts or Post Meta.
Update: Support for UTF8, Background CSS, and Shortcodes have been moved to the Free version, and are now always enabled. Easier for everyone.
Add: Extra support for Page Builders is being added into the Pro version.

4.5.0

Add: Support for WooCommerce Short Description.
Add: Support for Divi Background.
Add: Support for Custom Fields Pro (ACF gallery).
Fix: Better support for CSS background.
Fix: Avoid detected file to be re-added if already there.
Update: Removed UTF-8 option (became useless).

4.4.7

Fix: Divi Single Image wasn’t always properly detected.
Add: Option for CSS background.
Update: Code cleaning, slighlty faster now.
Info: This plugin is hard work, don’t hesitate to review it 🙂 Thank you.

4.4.6

Update: Support for ACF (Image Field as Object, URL and ID).
Info: This plugin is hard work, don’t hesitate to review it 🙂 Thank you.

4.4.4

Update: Check DIVI Galleries and Single Images in Beaver Builder.
Update: Support for files which aren’t images and links (href’s).

4.4.2

Fix: Too many files were detected as used if WooCommerce was installed.

4.4.0

Info: This is a MAJOR UPDATE both in term of optimization and detection. Keep my motivation up and give a good review to the plugin here: https://wordpress.org/support/plugin/media-cleaner/reviews/?rate=5#new-post. That helps me a lot.
Update: Meta Data analysis is now cached, so much faster.
Update: URL detections became a bit more safer.
Update: Detect the images used by the themes more than before.
Fix: Images in widgets weren’t detected in many cases.

4.2.5

Update: Support for WP 4.9.
Fix: Could not empty trash if Media was already removed.

4.2.3

Fix: Meta search issue.
Fix: SQL typo for WooCommerce detection.
Fix: Avoid checking the empty arrays.

4.2.0

Info: This is a MAJOR UPDATE both in term of optimization and detection. Keep my motivation up and give a good review to the plugin here: https://wordpress.org/support/plugin/media-cleaner/reviews/?rate=5#new-post. That helps me a lot.
Add: Support for Fusion Builder (Avada).
Add: Cache the results found in posts to analyze them much faster later.
Add: Debugging log file (option).

4.1.0

Add: Support for WooCommerce Gallery.
Add: Support for Visual Composer (Single Image and Gallery).

4.0.7

Update: Bulk analyze/prepare galleries, avoid the first request to time out.
Add: Many option to make the processing faster or slower depending on the server.
Fix: Handle server timeout.
Add: Pause button and Retry button.

4.0.4

Update: Safest default values.

4.0.2

Add: Information about how a certain media is used (Edit Media screen).
Fix: Check / Create DB process.
Fix: Plugin was not working well with themes using Background/Header.
Update: A bit of cleaning.

4.0.0

Update: Core was re-organized and cleaned. Ready for nice updates.

3.7.0

Fix: Little issue when inserting the serial key for the first time.
Update: Compliance with the WordPress.org rules, new licensing system.
Update: Moved assets.
Info: There will be an important warning showing up during this update. It is an important annoucement.

3.6.4

Fix: Plugin was not working properly with broken Media metadata. It now handles it properly.
Info: If you want to give me a bit of motivation, write a review on https://wordpress.org/support/plugin/media-cleaner/reviews/?rate=5#new-post.

3.6.2

Fix: When over 1 GO, was displaying a lower size value.
Fix: Counting wasn’t exact with a Filesystem scan.
Info: Please read the previous changelog as it didn’t appear in WP for some reason.
Add: Check Posts also look for the Media ID in the classes (more secure).
Info: If you want to give me a bit of motivation, write a review on https://wordpress.org/support/plugin/media-cleaner/reviews/?rate=5#new-post.

3.6.0

Add: Now the Media can be recovered! You can remove your Media through the plugin, make sure they are not in use (by testing your website thoroughly) and later delete them definitely from the trash. I think you will find it awesome.
Update: Nicer internal icons rather than the old images for the UI.
Update: Faster and safer for post_content checks.
Update: This is a big one. The plugin is more clear about what it does. You need to choose either to scan the Media or the Filesystem, and also against what exactly. There has also been a few fixes and it will work on more big installs. If it fails, you can remove a few scanning options, and I will continue to work on making it perfect to support huge installs with all the options on.

3.2.8

Update: Show a better edit media screen.
Update: Will show the same number of items as in the Media Library (before it was fixed to 15 items per page).
Fix: Was displaying warning if the number of items per page in the Media page is not set.

3.2.0

Fix: HTML adapted to WP 4.5.1.
Fix: Doesn’t break if there is an error on the server-side. Display an alert and continue.
Update: Can select more than one file for non-Pro.
Fix: Issue with PHP 7.

3.0.0

Add: Option for resolving shortcode during analysis.
Update: French translation. Big thanks to Guillaume (and also for all his testing!).
Info: New name, fresh start. This plugin changed completely since it very first release 🙂

2.5.0

Add: Delete the unused directories.
Add: Doesn’t break when there are too many files in the system.
Add: Pro version with better support.
Update: Improved detection of unused files.
Fix: UTF8 filenames skipped by default but can be scanned through an option.
Fix: Really many fixes 🙂
Info: Contact me if you have been using the plugin for a long time and love it.

2.4.2

Add: Inclusion of gallery post format images.
Fix: Better gallery URL matching.
Info: Thanks to syntax53 for those improvements via GitHub (https://github.com/tigroumeow/media-file-cleaner/pull/3). Please review Media Cleaner if you like it. The plugin needs reviews to live. Thank you 🙂 (https://wordpress.org/support/view/plugin-reviews/media-file-cleaner)

2.4.0

Fix: Cross site scripting vulnerability fixes.
Change: Many enhancements and fixes made by Matt (http://www.twistedtek.net/). Please thanks him 🙂
Info: Please perform a „Reset“ in the plugin dashboard after installing this new version.

2.2.6

Fix: Scan for multisite.
Change: options are now all enabled by default.
Fix: DB issue avoided trashed files from being deleted permanently.

2.0.2

Works with WP 4.
Gallery support.
Fix: IGNORE function was… ignored by the scanning process.

1.9.0

Add: thumbnails.
Add: IGNORE function.
Change: cosmetic changes.
Add: now detects the custom header and custom background.
Change: the CSS was updated to fit the new Admin theme.

1.7.0

Change: the MEDIA files are now going to the trash but the MEDIA reference in the DB is still removed permanently.
Stable release.
Change: Readme.txt.

1.4.0

Add: check the meta properties.
Add: check the ‚featured image‘ properties.
Fix: keep the trash information when a new scan is started.
Fix: remove the DB on uninstall, not on desactivate.

1.2.2

Add: progress %.
Fix: issues with apostrophes in filenames.
Change: UI cleaning.

1.2.0

Add: options (scan files / scan media).
Fix: mkdir issues.
Change: operations are buffered by 5 (faster).

0.1.0

First release.