{"id":324445,"date":"2026-06-23T20:59:15","date_gmt":"2026-06-23T20:59:15","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/gw-smart-orphan-media-cleaner\/"},"modified":"2026-06-23T21:04:39","modified_gmt":"2026-06-23T21:04:39","slug":"gerdoo-orphan-media-cleaner","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/gerdoo-orphan-media-cleaner\/","author":20875104,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Gerdoo Orphan Media Cleaner","header_author":"MohammadReza Maghsoudipour","header_description":"Deep database and filesystem scanner to find and safely remove orphaned images and ghost files. Features a physical trash bin for safe recovery.","assets_banners_color":"578d9f","last_updated":"2026-06-23 21:04:39","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":19,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"maghsoudi","date":"2026-06-23 21:04:39"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3583767,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3583767,"resolution":"772x250","location":"assets","locale":"","width":1544,"height":500}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3583767,"resolution":"1","location":"assets","locale":"","width":3559,"height":1726},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3583767,"resolution":"2","location":"assets","locale":"","width":3559,"height":1726},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3583767,"resolution":"3","location":"assets","locale":"","width":3559,"height":1726}},"screenshots":{"1":"Database Scanner (Orphans) with smart batch processing.","2":"Deep Host Scanner finding unregistered ghost files.","3":"The Physical Trash Bin with 1-click restore functionality."}},"plugin_section":[],"plugin_tags":[4654,268614,227565,268613,268615],"plugin_category":[],"plugin_contributors":[222287],"plugin_business_model":[],"class_list":["post-324445","plugin","type-plugin","status-publish","hentry","plugin_tags-database-cleaner","plugin_tags-ghost-files","plugin_tags-media-cleaner","plugin_tags-orphan-images","plugin_tags-uploads-cleaner","plugin_contributors-maghsoudi","plugin_committers-maghsoudi"],"banners":{"banner":"https:\/\/ps.w.org\/gerdoo-orphan-media-cleaner\/assets\/banner-772x250.jpg?rev=3583767","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/gerdoo-orphan-media-cleaner\/assets\/icon-256x256.png?rev=3583767","icon_2x":"https:\/\/ps.w.org\/gerdoo-orphan-media-cleaner\/assets\/icon-256x256.png?rev=3583767","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/gerdoo-orphan-media-cleaner\/assets\/screenshot-1.png?rev=3583767","caption":"Database Scanner (Orphans) with smart batch processing."},{"src":"https:\/\/ps.w.org\/gerdoo-orphan-media-cleaner\/assets\/screenshot-2.png?rev=3583767","caption":"Deep Host Scanner finding unregistered ghost files."},{"src":"https:\/\/ps.w.org\/gerdoo-orphan-media-cleaner\/assets\/screenshot-3.png?rev=3583767","caption":"The Physical Trash Bin with 1-click restore functionality."}],"raw_content":"<!--section=description-->\n<p><strong>Is your server storage full of unused images and leftover thumbnails?<\/strong>\nGerdoo Orphan Media Cleaner is a tool designed to clean your WordPress media library and physical <code>\/uploads\/<\/code> directory.<\/p>\n\n<h3>\ud83d\ude80 Key Features<\/h3>\n\n<ul>\n<li><strong>Deep Database Scanner (Orphans):<\/strong> Finds images that are registered in your Media Library but are unused in posts, pages, WooCommerce products, Elementor, or ACF fields.<\/li>\n<li><strong>Deep Filesystem Scanner (Ghost Files):<\/strong> Directly scans your physical <code>\/uploads\/<\/code> folders to find leftover thumbnails and images that the WordPress database doesn't know exist.<\/li>\n<li><strong>Safe Physical Trash Bin:<\/strong> Files deleted from the host are sent to a secure, physical Trash Bin (<code>\/gw-trash-bin\/<\/code>). You can restore them to their exact original location with a single click!<\/li>\n<li><strong>Optimized Processing:<\/strong> Built with OOP architecture and Cursor-based Pagination. It processes files in smart batches via AJAX, allowing it to scan databases with many images on shared hosts smoothly.<\/li>\n<li><strong>Deep Parser Engine:<\/strong> Smart analysis of JSON strings (Elementor), serialized arrays, and shortcodes to effectively identify used media.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>gw-smart-media-cleaner<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Go to Tools -&gt; Gerdoo Media Cleaner to start scanning your site.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20the%20host%20scanner%20completely%20free%3F\"><h3>Is the host scanner completely free?<\/h3><\/dt>\n<dd><p>Yes! Finding physical \"Ghost Files\" on your server is 100% free in this plugin.<\/p><\/dd>\n<dt id=\"will%20this%20plugin%20crash%20my%20shared%20host%3F\"><h3>Will this plugin crash my shared host?<\/h3><\/dt>\n<dd><p>No. The plugin uses Smart Batching and Cursor Pagination to process images 20 at a time. It uses minimal CPU and RAM, making it perfectly safe for huge websites on shared hosting.<\/p><\/dd>\n<dt id=\"if%20i%20delete%20an%20image%20by%20mistake%2C%20can%20i%20recover%20it%3F\"><h3>If I delete an image by mistake, can I recover it?<\/h3><\/dt>\n<dd><p>Yes! If you delete a physical file from the Host Scanner tab, it goes to the \"Physical Trash Bin\" tab. You can easily click \"Restore\" to put it back exactly where it was.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial Release.<\/li>\n<li>Added Database Orphan Scanner.<\/li>\n<li>Added Deep Host Scanner.<\/li>\n<li>Added Physical Trash Bin &amp; Recovery System.<\/li>\n<\/ul>","raw_excerpt":"Deeply scans both your database (orphans) and filesystem (ghost files) with a safe physical trash bin.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/324445","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=324445"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/maghsoudi"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=324445"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=324445"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=324445"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=324445"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=324445"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=324445"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}