media-cleaner
Last commit date
app
1 month ago
classes
1 month ago
common
1 month ago
languages
1 year ago
logs
6 years ago
media-cleaner.php
1 month ago
readme.txt
1 month ago
uninstall.php
1 month ago
readme.txt
354 lines
| 1 | === Media Cleaner: Clean your WordPress! === |
| 2 | Contributors: TigrouMeow |
| 3 | Tags: clean, media, files, images, library |
| 4 | Donate link: https://www.patreon.com/meowapps |
| 5 | Requires at least: 6.0 |
| 6 | Tested up to: 7.0 |
| 7 | Requires PHP: 7.4 |
| 8 | Stable tag: 7.2.1 |
| 9 | License: GPLv2 or later |
| 10 | License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 11 | |
| 12 | Clean your WordPress! Eliminate unused and broken media files. For a faster, and better website. |
| 13 | |
| 14 | == Description == |
| 15 | |
| 16 | Media Cleaner is a powerful plugin that helps you clean up your WordPress media library by deleting unused media entries and files, as well as fixing broken entries. With an internal trash feature, you can preview and confirm changes before permanently deleting anything. Plus, Media Cleaner uses smart analysis to ensure compatibility with specific plugins and themes. |
| 17 | |
| 18 | Use it alongside [Database Cleaner](https://wordpress.org/plugins/database-cleaner/) for the ultimate clean-up experience. |
| 19 | |
| 20 | Media Cleaner is like a ninja assassin for your Media Library - it'll stealthily take out all the unnecessary media and broken entries that are cluttering up the place. Just make sure you have a **solid backup plan** in place before you let this bad boy loose. |
| 21 | |
| 22 | To learn more about compatibility, features, and the Pro version, check out the [tutorial](https://meowapps.com/media-cleaner/tutorial/) on the [official website](https://meowapps.com/media-cleaner/). |
| 23 | |
| 24 | [youtube https://www.youtube.com/watch?v=qmDSgWZWnSw] |
| 25 | |
| 26 | === COMPATIBILITY === |
| 27 | |
| 28 | This plugin is compatible with all media types, including retina and WebP versions. It has been tested on a wide range of WordPress versions, including the latest version with Gutenberg, as well as on various themes with a large community of users. It also supports WooCommerce. For users with more complex plugins for handling website content, the Pro version may be necessary for optimal compatibility. We are constantly working to increase compatibility with other plugins. |
| 29 | |
| 30 | === PRO VERSION === |
| 31 | |
| 32 | [Media Cleaner Pro](https://meowapps.com/media-cleaner/) adds extra features to the free version of Media Cleaner: |
| 33 | |
| 34 | * Filesystem Analysis: Scans your physical /uploads directory and matches it against the Media Library. |
| 35 | * Extra support for complex plugins, such as ACF, Metabox, Divi Builder, Fusion Builder (Avada), WPBakery Page Builder, Visual Composer, Elementor, Beaver Builder, Brizy Builder, Oxygen Builder, Slider Revolution, Justified Image Grid, Avia Framework, and many more! |
| 36 | * Live Site Scan: Analyzes the online version of your website, potentially improving accuracy in some cases. |
| 37 | * WP-CLI support: Allows you to run the plugin at a higher speed or automatically with direct server access (via SSH). |
| 38 | |
| 39 | == Installation == |
| 40 | |
| 41 | 1. Upload the plugin to WordPress. |
| 42 | 2. Activate the plugin through the 'Plugins' menu in WordPress |
| 43 | 3. Go to Meow Apps -> Cleaner in the sidebar and check the appropriate options. |
| 44 | 4. Go to Media -> Cleaner. |
| 45 | |
| 46 | == Screenshots == |
| 47 | |
| 48 | 1. Media -> Media Cleaner |
| 49 | |
| 50 | == Changelog == |
| 51 | |
| 52 | = 7.2.1 (2026/07/13) = |
| 53 | * Fix: Hotfix — Restored shortcode analysis and lenient upload URL matching to fix false positives introduced in 7.2.0. |
| 54 | * 🎵 Discuss with others about Media Cleaner on [the Discord](https://discord.gg/bHDGh38). |
| 55 | * 🌴 Keep us motivated with [a little review here](https://wordpress.org/support/plugin/media-cleaner/reviews/). Thank you! |
| 56 | * 🥰 If you want to help us, check our [Patreon](https://www.patreon.com/meowapps). Thank you! |
| 57 | |
| 58 | = 7.2.0 (2026/07/12) = |
| 59 | * Add: Resumable, checkpointed scan runs with staged results that publish only after complete analysis. |
| 60 | * Add: Private quarantine storage, file identity validation, and idempotent cleanup operations. |
| 61 | * Fix: Graceful handling of timeouts, transient server failures, stalled cursors, and parser compatibility queries. |
| 62 | * Fix: Durable keyset pagination for large compatibility-parser datasets. |
| 63 | |
| 64 | = 7.1.1 (2026/05/30) = |
| 65 | * Update: Full Cornerstone Parser coverage with URL references and improved data parsing. |
| 66 | * Update: Refactored URL detection to work with relative URLs. |
| 67 | * Add: Confirmation prompt before deleting the Cleaner database. |
| 68 | * Fix: Sped up file deletion by replacing directory scanning with a lazy emptiness check. |
| 69 | * Update: Made it clearer when viewing settings versus the dashboard. |
| 70 | |
| 71 | = 7.1.0 (2026/05/17) = |
| 72 | * Add: In-results banner and tooltip clarifying that files marked as "not found in content" may still be used dynamically by builders, templates, or external sites. |
| 73 | * Fix: Memory overflow on large sites (1M+ media) by replacing in-memory array counting with SQL count queries. |
| 74 | * Fix: Added check for existing table before deleting attachment-related data. |
| 75 | |
| 76 | = 7.0.9 (2026/05/09) = |
| 77 | * Fix: Meow Gallery parser now correctly applies WPLR filters on galleries and parses JSON HTML format. |
| 78 | * Add: Support for Meow Gallery's collections with WPLR integration. |
| 79 | * Add: Support for WP Download Manager plugin. |
| 80 | * Add: Filter "wpmc_affect_html_from_builder" for page builders that store their own content, allowing other parsers to still work alongside them. |
| 81 | * Update: Search now works across all reference fields. |
| 82 | * 🎵 Discuss with others about Media Cleaner on [the Discord](https://discord.gg/bHDGh38). |
| 83 | * 🌴 Keep us motivated with [a little review here](https://wordpress.org/support/plugin/media-cleaner/reviews/). Thank you! |
| 84 | * 🥰 If you want to help us, check our [Patreon](https://www.patreon.com/meowapps). Thank you! |
| 85 | |
| 86 | = 7.0.8 (2026/04/25) = |
| 87 | * Update: Renamed internal origin references for clarity. |
| 88 | * Update: Path descriptions now use 'thumbnails' instead of 'files' for clarity. |
| 89 | * Fix: Image URLs in the metabox are now only added when actually present. |
| 90 | * Update: Improved UI/UX for better user experience. We hope you'll love it! 🥰 |
| 91 | |
| 92 | = 7.0.7 (2026/04/15) = |
| 93 | * Add: New "References Buffer" option to split and flush reference processing to reduce memory errors on large datasets. |
| 94 | * Fix: Improved base64 handling to better cope with malformed edge cases and prevent related issues. |
| 95 | * Add: More detailed timeout debugging for reference extraction to make diagnosing performance issues easier. |
| 96 | * Fix: Removed base64 content from HTML before URL parsing to prevent regex timeouts on complex pages. |
| 97 | * Update: Replaced cached references with a unique hash-based system and limited media ID lookups to multilingual URLs for faster and cleaner reference handling. |
| 98 | |
| 99 | = 7.0.6 (2026/03/27) = |
| 100 | * Fix: Hotfix to resolve a security issue that could allow SSRF attacks through embedded iframes. |
| 101 | |
| 102 | = 7.0.5 (2026/03/09) = |
| 103 | * Fix: Ensure plugin checks run after all required options are initialized. |
| 104 | * Add: Introduce LayerSlider compatibility and update Enfold theme integration. |
| 105 | * Update: Improve origin handling so the plugin can work with sources that don't use numeric IDs. |
| 106 | * Add: Include more direct documentation links in error popups. |
| 107 | * Add: Provide ACF-specific filters for URLs and IDs to give developers more precise control over field handling. |
| 108 | |
| 109 | = 7.0.4 (2026/02/25) = |
| 110 | * Fix: Improve how issue names are displayed. |
| 111 | * Add: Allow selecting specific thumbnail sizes (to avoid the unnecessary ones). |
| 112 | * Fix: Ensure media scans always use ID-based URL references (improving compatibility with WPML). |
| 113 | * Update: Improve compatibility with multisite and network site. |
| 114 | * Update: Apply better default settings on fresh installs. |
| 115 | * 🎵 Discuss with others about Media Cleaner on [the Discord](https://discord.gg/bHDGh38). |
| 116 | * 🌴 Keep us motivated with [a little review here](https://wordpress.org/support/plugin/media-cleaner/reviews/). Thank you! |
| 117 | * 🥰 If you want to help us, check our [Patreon](https://www.patreon.com/meowapps). Thank you! |
| 118 | |
| 119 | = 7.0.3 (2026/01/27) = |
| 120 | * Add: Added full support for newer versions of the Oxygen builder. |
| 121 | * Fix: Updated the Divi integration so URLs with direct UR patterns are no longer incorrectly marked as safe. |
| 122 | * Update: Extended Divi 5 support by recognizing mp4 and webm keys for background videos and the new "linkUrl" key in Divi blocks. |
| 123 | * Update: Improved Elementor compatibility by having the parser also check page settings for relevant data. |
| 124 | * Update: Made excluded directories easier to customize by turning them into a configurable setting that developers can filter. |
| 125 | |
| 126 | = 7.0.2 (2026/01/05) = |
| 127 | * Fix: Prevent warnings and errors caused by empty HTML output and broken shortcodes. |
| 128 | * Add: Support FooGallery album shortcodes for better gallery integration. |
| 129 | * Add: Display icons for reference tags including SAFE, CACHE, OG_THUMB, and GEN_THUMB. |
| 130 | * Update: Improve FooGallery handling by supporting non-HTML shortcode output and flagging cached media items. |
| 131 | * Update: Remove the transient cache for post types and include the post ID in reference data. |
| 132 | * Fix: Correct the JetEngine parser to ensure dynamic content is detected and rendered properly. |
| 133 | |
| 134 | = 7.0.1 (2025/12/16) = |
| 135 | * Add: Introduced scan resume support for both Thumbnails and Duplicates scans. |
| 136 | * Fix: Prevented an error in the Metabox parser caused by treating text values like lists. |
| 137 | * Fix: Ensured the “Repair x Entries” notice only appears while repair mode is active. |
| 138 | * Add: Added a new “Optimize Thumbnails” feature. |
| 139 | * Add: Added support for Toolset. |
| 140 | |
| 141 | = 7.0.0 (2025/12/03) = |
| 142 | * Fix: Prevent the plugin from loading on pages where it is not needed. |
| 143 | * Add: CSV export option for scan results to make it easier to review. |
| 144 | * Add: Support for pagination in FooGalleries so all gallery items are properly scanned. |
| 145 | * Add: Recursive scanning for ACF Blocks to ensure nested blocks are fully detected. |
| 146 | * Add: FooGallery parser support for block shortcodes. |
| 147 | * 🎵 Discuss with others about Media Cleaner on [the Discord](https://discord.gg/bHDGh38). |
| 148 | * 🌴 Keep us motivated with [a little review here](https://wordpress.org/support/plugin/media-cleaner/reviews/). Thank you! |
| 149 | * 🥰 If you want to help us, check our [Patreon](https://www.patreon.com/meowapps). Thank you! |
| 150 | |
| 151 | = 6.9.8 (2025/11/13) = |
| 152 | * Update: Enhanced UI and UX. |
| 153 | * Fix: Fixed the Smart Slider 3 parser to load correctly and function as expected. |
| 154 | * Add: Parsed "href" and "src" attributes in Enfold HTML to accurately extract URLs. |
| 155 | * Refactor: Enhanced caching to store IDs and URLs in the DB. |
| 156 | * Add: Support for the "value" attribute in Divi 5 blocks to facilitate ID extraction. |
| 157 | * Update: Refined Divi parser to support both Divi 4 and Divi 5 simultaneously. |
| 158 | * Fix: Hotfix for handling null values with substr, avoiding deprecated functions. |
| 159 | * Fix: Fixed the Scan confirmation prompt to show only once. |
| 160 | * Fix: Restricted scope of the "substr" function to prevent deprecation issues. |
| 161 | * Update: Optimized database checks and CLI commands for faster performance. |
| 162 | |
| 163 | = 6.9.7 (2025/09/30) = |
| 164 | * Add: Timeout mechanism to avoid a stalled scan. |
| 165 | * Add: New Duplicates scan type (beta). |
| 166 | * Update: Confirmation before restarting a scan to prevent accidental restarts. |
| 167 | * Update: Better support for Kadence Theme. |
| 168 | * Add: "Deleted At" column and filters. |
| 169 | * Update: Optimized the WooCommerce parser for better performance. |
| 170 | * Fix: Remove a few minor bugs. |
| 171 | |
| 172 | = 6.9.5 (2025/08/27) = |
| 173 | * Add: A clear message guiding users on how to disable the pop-up. |
| 174 | |
| 175 | = 6.9.4 (2025/08/16) = |
| 176 | * Fix: Added check for WP_Error in ACF after database calls to improve stability. |
| 177 | * Fix: Resuming process now properly continues from step 3. |
| 178 | * Add: Support for Meow Gallery. |
| 179 | * Add: Warning modal; Sorry guys, but it looks like we need to warn you better about the risks. |
| 180 | * Update: Header included for Filesystem + Content-Type for better handling. |
| 181 | * Comments: Clarified handling of WebP images for improved compatibility. |
| 182 | |
| 183 | = 6.9.3 (2025/07/23) = |
| 184 | * Add: Enhanced the resume functionality. |
| 185 | * Fix: Hotfix for errorCounts modal display to ensure proper visibility. |
| 186 | * Update: Show incompatible plugins message only in the free version for clarity. |
| 187 | * Update: Improved memory management by replacing in-memory references with direct processing and transients. |
| 188 | * Update: Refreshed common libraries for better performance and stability. |
| 189 | |
| 190 | = 6.9.2 (2025/07/01) = |
| 191 | * Add: Added support for Fluent Forms. |
| 192 | * Fix: Fixed NekoTable display issues. |
| 193 | * Update: Streamlined Divi parser for better image URL extraction and improved filesystem handling. |
| 194 | * Update: Enhanced thumbnail URL extraction and added new function to retrieve attachment sizes. |
| 195 | |
| 196 | = 6.9.1 (2025/06/29) = |
| 197 | * Add: Support for Kadence Blocks. |
| 198 | * Add: Support for Salient Theme Elements. |
| 199 | * Add: Support for Houzez Theme. |
| 200 | * Add: Support for WooCommerce variation galleries. |
| 201 | * Update: Improved Enfold parser with better handling of nested shortcodes and enhanced ID/URL extraction. |
| 202 | |
| 203 | = 6.9.0 (2025/05/11) = |
| 204 | * Update: Removed unused code for live content checks in CLI commands to improve plugin performance and maintainability. |
| 205 | |
| 206 | = 6.8.9 (2025/05/04) = |
| 207 | * Fix: Ensure the "Disable Shortcode Analysis" setting is now respected in all content parsers. |
| 208 | * Add: Support for ACF 'file' fields now includes returning the file URL when using ID references. |
| 209 | |
| 210 | = 6.8.8 (2025/05/01) = |
| 211 | * Add: Introduced SAFE support for URLs from srcset in WooCommerce galleries. |
| 212 | * Add: Added a function to extract thumbnail URLs from srcset for better detection. |
| 213 | * Fix: Prevented warning messages when URLs are empty. |
| 214 | * Fix: Corrected countdown end event behavior. |
| 215 | * Update: Enhanced the W3 parser with array_to_ids_or_urls and added recursive support. |
| 216 | * Add: Added a parser for W3 Total Cache to handle media attachments. |
| 217 | * Add: Introduced a force trash option for cases when trash isn’t emptied automatically. |
| 218 | * Update: Temporarily disabled live content scanning to prevent issues. |
| 219 | * Fix: Corrected a typo in iframe handling comments. |
| 220 | * Update: Improved shortcode scanning by retrieving all common attributes for IDs and URLs. |
| 221 | * Fix: Prevented recursion in ACF field scanning with flexible content. |
| 222 | * Update: Reworked the ACF Parser to fully support flexible content structures. |
| 223 | * Update: Added an index on mediaId in the references table to optimize step 4 performance. |
| 224 | |
| 225 | = 6.8.7 (2025/03/12) = |
| 226 | * Update: Improved type handling and updated the Divi parser for better compatibility. |
| 227 | * Fix: Added a recursion limit to ACF field scanning functions to prevent infinite loops. |
| 228 | |
| 229 | = 6.8.6 (2025/02/17) = |
| 230 | * Add: Added a SAFE tag to Foo Gallery full sizes to mark certain media as in use. |
| 231 | * Update: Moved SAFE tag logic from JavaScript to PHP for better efficiency. |
| 232 | * Fix: Corrected featured image thumbnails and improved SAFE tag detection. |
| 233 | * Update: Improved UI by replacing the timer component with a countdown version. |
| 234 | * Update: Added an error modal with auto-retry functionality for better user experience. |
| 235 | * Update: Reworked compatibility for Avada builder. |
| 236 | |
| 237 | = 6.8.5 (2024/12/25) = |
| 238 | * Fix: HTML needs to be well-decoded before being sent to DOMDocument. |
| 239 | * Fix: Avoid an issue related to logos. |
| 240 | * Info: Merry Christmas and Happy New Year! 🎄🎉 |
| 241 | |
| 242 | = 6.8.4 (2024/12/06) = |
| 243 | * Add: Support for Spectra. |
| 244 | * Add: Support for Tutor LMS. |
| 245 | * Add: Support for Foo Gallery. |
| 246 | * Info: We are working hard on Media Cleaner. If you want to share some love, write a simple and nice review [here](https://wordpress.org/support/plugin/media-cleaner/reviews/?rate=5#new-post). Thank you so much! 💖 |
| 247 | |
| 248 | = 6.8.3 (2024/11/27) = |
| 249 | * Fix: MetaBox parser was not working properly. |
| 250 | * Fix: The free version of Media Cleaner was not properly displaying the incompatible plugins. |
| 251 | |
| 252 | = 6.8.2 (2024/11/14) = |
| 253 | * Update: Enhanced the UI in many little ways. |
| 254 | * Update: Don't show the thumbnails for non-image files. |
| 255 | * Fix: Better parser for Avada. |
| 256 | |
| 257 | = 6.8.1 (2024/11/04) = |
| 258 | * Add: Check for empty path in repair mode. |
| 259 | * Add: Introduction tutorial. |
| 260 | |
| 261 | = 6.8.0 (2024/10/17) = |
| 262 | * Fix: Search in References (Cleaner Dashboard). |
| 263 | |
| 264 | = 6.7.9 (2024/09/24) = |
| 265 | * Update: Internal improvements to avoid some errors with low-quality servers such as OVH, GoDaddy, etc. |
| 266 | |
| 267 | = 6.7.8 (2024/08/01) = |
| 268 | * Fix: Elementor parser was not working properly. |
| 269 | * Add: Video Block support. |
| 270 | |
| 271 | = 6.7.7 (2024/06/28) = |
| 272 | * Fix: Warnings with ACF. |
| 273 | * Fix: Base folder for the Filesystem Scan. |
| 274 | * Update: Cleaned the UI a bit more. |
| 275 | |
| 276 | = 6.7.6 (2024/06/05) = |
| 277 | * Update: Better References section. |
| 278 | * Add: Support for Bricks Builder. |
| 279 | * Update: Refreshed the UI, updated to the latest common librairies. |
| 280 | |
| 281 | = 6.7.5 (2024/05/24) = |
| 282 | * Fix: Logging system. |
| 283 | |
| 284 | = 6.7.4 (2024/04/27) = |
| 285 | * Update: Updated description for OB cleaning to enhance clarity. |
| 286 | * Add: Support for Breakdance Builder, extending compatibility. |
| 287 | * Update: Added shortcode checking for Oxygen Builder. |
| 288 | * Fix: Updated readme file to comply with the latest WordPress guidelines. |
| 289 | |
| 290 | = 6.7.3 (2024/03/01) = |
| 291 | * Update: Better translations. |
| 292 | * Update: Safer logs system. |
| 293 | |
| 294 | = 6.7.2 (2024/02/02) = |
| 295 | * Add: "Create Batch" feature for Filesystem scans, streamlining the scanning process. |
| 296 | * Add: "Delete Permanently" option in trash tab for targeted item management. |
| 297 | * Add: Tooltip for repair mode to enhance user understanding and interaction. |
| 298 | * Fix: Option to disable OB Cleaning. |
| 299 | * Fix: Corrected dashboard media link functionality for subdirectories. |
| 300 | * Fix: Resolved issues with backslash replacement on multiple occurrences for more accurate processing. |
| 301 | |
| 302 | = 6.7.0 (2024/01/13) = |
| 303 | * Add: New 'check-live' argument for WP-CLI. |
| 304 | * Add: Import and Export of the settings. |
| 305 | |
| 306 | = 6.6.9 (2023/12/05) = |
| 307 | * Add: Expert Mode for advanced users. |
| 308 | |
| 309 | = 6.6.8 (2023/11/18) = |
| 310 | * Add: Support for ACF File Field based on IDs. |
| 311 | * Add: Repair Mode for Filesystem Scan (use this carefully, still in beta). |
| 312 | * Update: Much better "References" section in the Dashboard, with additional filters. |
| 313 | * Update: Various additional enhancements, maybe you'll notice! 😊 |
| 314 | * Add: Support for Academy LMS. |
| 315 | |
| 316 | = 6.6.7 (2023/09/21) = |
| 317 | * Update: Enhanced the get_references_for_post_id function. |
| 318 | * Update: Code cleaning. |
| 319 | |
| 320 | = 6.6.6 (2023/09/14) = |
| 321 | * Add: The get_reference_for_media_id and get_references_for_post_id functions are now accessible through the global $wpmc_core variable. Those functions will return where a specific media entry is used, or which media entries are used in a specific post. |
| 322 | |
| 323 | = 6.6.5 (2023/07/25) = |
| 324 | * Update: Better checkboxes. |
| 325 | * Update: Link to the posts in the References section. |
| 326 | * Add: Support for Mailpoet. |
| 327 | |
| 328 | = 6.6.4 (2023/05/30) = |
| 329 | * Update: Improved the UI and its elements. |
| 330 | |
| 331 | = 6.6.3 (2023/04/09) = |
| 332 | * Add: New filter to see the found references. This will improve a lot. |
| 333 | * Fix: Tiny fixes, retrieved the main dashboard, and lighter bundles. |
| 334 | * Info: The new version of WordPress (6.2) came with what is seemingly a bug with the $wpdb->prepare. There are workaround, and I fixed an issue I was aware of. If you find any others, please kindly report it [here](https://wordpress.org/support/plugin/media-cleaner/). |
| 335 | |
| 336 | = 6.6.0 (2023/02/21) = |
| 337 | = Fix: Avoid certain errors related to ACF and fields which were created with former versions. |
| 338 | |
| 339 | = 6.5.8 (2023/02/09) = |
| 340 | * Update: Slightly cleaner UI (and it will get better and better). |
| 341 | * Update: Better support for Avada. |
| 342 | |
| 343 | = 6.5.7 (2023/02/01) = |
| 344 | * Fix: Little issue with the nekoFetch. |
| 345 | * Add: Timer on the Scan button. |
| 346 | |
| 347 | = 6.5.6 (2023/01/30) = |
| 348 | * Update: Optimization and better handling of Divi. |
| 349 | |
| 350 | = 6.5.5 (2023/01/09) = |
| 351 | * Add: Support for Uncode Theme. |
| 352 | * Add: Reset settings button. |
| 353 | * Update: Smaller package, better performance. |
| 354 |