Changeset 3458942
- Timestamp:
- 02/11/2026 12:02:00 PM (7 weeks ago)
- File:
-
- 1 edited
-
orphanix-media-cleanup/trunk/readme.txt (modified) (1 diff)
Legend:
- Unmodified
- Added
- Removed
-
orphanix-media-cleanup/trunk/readme.txt
r3458841 r3458942 9 9 License URI: https://www.gnu.org/licenses/gpl-2.0.html 10 10 11 Clean, optimize, and manage your WordPress media library by detecting unused, broken, and dynamically used media files.11 Smart WordPress media library cleanup. Detect unused, orphaned & broken media safely with advanced live scanning. 12 12 13 13 == Description == 14 14 15 **Orphanix Media Cleanup** is the all-in-one solution to clean, organize, and optimize your WordPress media library. It scans your site for unused, orphaned, broken, and dynamically loaded media files - including images, videos, and documents - so you can safely remove them and improve performance. 16 17 **Core Features:** 18 * **Media Scan:** Detect unused or orphaned media files in the library and uploads folder. 19 * **Broken Media Scan:** Identify missing, corrupted, or unreachable files that could break layouts or SEO. 20 * **Live Site Scan:** Analyze frontend usage to see which media is actually displayed to visitors. 21 * **Analytics:** Track scan summaries, usage trends, and storage impact. 22 * **Page Builder & Plugin Compatibility:** Works with Gutenberg, Elementor, ACF, WooCommerce, widgets, menus, and theme files (Deep Scan). 23 * **Safe Deletion Workflow:** Move files to trash before permanent deletion; delete all sizes & versions. 24 * **Bulk Actions & Filters:** Easily manage large media libraries with filters for unused, orphaned, or broken files. 25 26 **Benefits:** 27 * Free up storage space and reduce server load 28 * Prevent broken images and improve site reliability 29 * Keep media library organized and clean 30 * Ensure no live or builder-used media is accidentally deleted 31 32 **How it Works:** 33 1. Run a **Media Scan** to detect unused files. 34 2. Use **Broken Media Scan** to detect missing or corrupted files. 35 3. Perform a **Live Site Scan** to verify actual frontend usage. 36 4. Review **Analytics** for scan history and cleanup actions. 37 5. Delete safely using the built-in trash workflow - all file sizes and versions included. 38 39 **Why Orphanix Media Cleanup?** 40 It's designed for site owners, developers, and agencies who need a fast, safe, and comprehensive tool to keep WordPress media libraries clean, optimized, and error-free - all from one dashboard. 15 == The Intelligent Way to Clean & Optimize Your WordPress Media Library == 16 17 Orphanix Media Cleanup is a powerful WordPress media management plugin designed to detect unused files, identify broken media references, and safely reclaim valuable server space. 18 19 Unlike basic cleanup tools, Orphanix performs both database-level analysis and live frontend verification — ensuring accurate detection without risking important content used by themes, page builders, or plugins. 20 21 Whether you manage a blog, WooCommerce store, agency website, or a large media-heavy platform, Orphanix helps you maintain a clean, optimized, and reliable media library. 22 23 --- 24 25 == Key Benefits == 26 27 ✔ Free up server storage by removing unused media 28 ✔ Prevent broken images and layout issues 29 ✔ Improve website performance and reliability 30 ✔ Protect dynamically loaded media from accidental deletion 31 ✔ Clean large media libraries safely and efficiently 32 33 --- 34 35 == Core Features == 36 37 🔍 Media Library Scan 38 • Detect unused and orphaned media files 39 • Identify unattached media items 40 • Scan uploads directory for unmatched assets 41 • Filter by file type (images, videos, PDFs, documents) 42 43 🛠 Broken Media Detection 44 • Find missing image references in content 45 • Detect corrupted or unreachable media files 46 • Identify broken URLs affecting layout or SEO 47 48 🌐 Live Site Scan (Advanced) 49 • Scan actual frontend output 50 • Detect dynamically loaded images 51 • Verify usage across templates and builders 52 • Prevent accidental deletion of active media 53 54 ⚡ Deep Compatibility Detection 55 • Analyze post content and metadata 56 • Scan custom fields (ACF supported) 57 • Detect WooCommerce product image usage 58 • Identify references in widgets and menus 59 60 🛡 Safe Trash & Restore System 61 • Move files to a secure plugin trash folder 62 • Restore deleted files anytime 63 • Permanent deletion only after confirmation 64 65 📊 Analytics & Reporting 66 • View scan summaries 67 • Track storage savings 68 • Review categorized results 69 • Monitor cleanup history 70 71 🚀 Performance Optimized 72 • Batch-based scanning engine 73 • Designed for large websites 74 • Memory-efficient processing 75 • No server overload during scans 76 77 --- 78 79 == Easy 3-Step Cleanup Process == 80 81 1. Run a Media Scan, Broken Media Scan, or Live Site Scan. 82 2. Review detailed scan results and verify usage. 83 3. Safely delete or restore files using the built-in trash system. 84 85 Simple. Safe. Accurate. 86 87 --- 88 89 == Why Choose Orphanix Media Cleanup? == 90 91 • Dual Scan Engine (Database + Live Verification) 92 • Advanced builder compatibility detection 93 • Safe trash workflow before permanent deletion 94 • Designed for small blogs to large enterprise sites 95 • Clean interface with real-time scan tracking 96 97 Orphanix goes beyond simple "unused file detection" by validating real usage across your entire website. 98 99 --- 100 101 == Perfect For == 102 103 • Bloggers and content creators 104 • WooCommerce store owners 105 • Agencies managing multiple sites 106 • Developers handling large media libraries 107 • Portfolio and media-rich websites 108 109 --- 110 111 == Privacy == 112 113 Orphanix Media Cleanup runs entirely on your server. 114 115 No data is sent to external services. 116 No tracking. No telemetry. 117 Full control and privacy. 118 119 --- 41 120 42 121 == Installation == 43 122 44 1. Upload the `orphanix-media-cleanup` folder to the `/wp-content/plugins/` directory. 45 2. Activate the plugin through the **Plugins** menu in WordPress. 46 3. Navigate to **Orphanix** in the WordPress admin menu to start scanning your library. 47 4. Use the dashboard boxes to run scans and clean media safely. 123 1. Upload the `orphanix-media-cleanup` folder to `/wp-content/plugins/` 124 2. Activate the plugin via the WordPress Plugins menu 125 3. Navigate to **Orphanix** in your WordPress admin dashboard 126 4. Run your first scan and clean safely 127 128 --- 48 129 49 130 == Frequently Asked Questions == 50 131 51 = How is Media Scan different from Broken Media Scan? = 52 Media Scan finds unused or orphaned files. Broken Media Scan finds missing or corrupted files that are referenced but not present on your site. 53 54 = What does Live Site Scan do? = 55 Live Site Scan checks the actual frontend of your site to detect media that is dynamically loaded or used by page builders and plugins. 56 57 = Are deleted files recoverable? = 58 Yes. Files first go to a plugin-managed trash folder. You can restore them before permanent deletion. 59 60 = Does it delete all image sizes? = 61 Yes. When deleting a media file, all registered sizes and thumbnails are deleted along with the original file. 62 63 = Which page builders and plugins are supported? = 64 Gutenberg, Elementor, ACF, WooCommerce, widgets, navigation menus, and theme files (Deep Scan only). 132 = Is Orphanix Media Cleanup safe to use? = 133 Yes. Files are first moved to a secure trash folder before permanent deletion. 134 135 = What is an orphaned media file? = 136 An orphaned media file exists in your uploads folder but is not used anywhere on your site. 137 138 = What is the difference between unused and broken media? = 139 Unused media is stored but not referenced. Broken media is referenced but the actual file is missing or inaccessible. 140 141 = Does it delete image thumbnails as well? = 142 Yes. All associated image sizes are removed when a media item is permanently deleted. 143 144 = Will it work with Elementor or page builders? = 145 Yes. It supports Gutenberg, Elementor, ACF, WooCommerce, widgets, menus, and theme file detection. 146 147 = Can I restore deleted files? = 148 Yes. Files moved to trash can be restored before final deletion. 149 150 = Does it slow down my website? = 151 No. The plugin uses a batch-based scanning system optimized for performance. 152 153 = Is my data sent to external servers? = 154 No. All processing runs locally on your server. 155 156 = Can it handle large media libraries? = 157 Yes. The scanning engine is optimized for high-volume sites. 158 159 = Does it support custom post types? = 160 Yes. Media references inside custom post types are detected. 161 162 = What happens if I uninstall the plugin? = 163 If delete-on-uninstall is enabled, plugin data will be removed. Media files are only deleted when you confirm deletion. 164 165 --- 65 166 66 167 == Screenshots == 67 168 68 1. Dashboard overview with Media Scan, Broken Media Scan, Live Site Scan, and Analytics. 69 2. Media Scan Wizard with Regular and Deep scan steps. 70 3. Broken Media Scan results table. 71 4. Live Site Scan results and dynamic media usage detection. 72 5. Analytics summary showing scan history and results. 169 1. Orphanix Media Cleanup Dashboard – Overview of the media management panel with quick access to orphan file scans and cleanup tools. 170 171 2. Media Scan Wizard – Step 1: Choose Scan Type for detecting unused media files, orphan attachments, or broken media references. 172 173 3. Media Scan Wizard – Step 2: Configure advanced scan settings including deep file usage detection and database analysis. 174 175 4. Media Scan Wizard – Step 4: Real-time scanning process with live progress indicators and background media analysis. 176 177 5. Media Scan Wizard – Step 5: Final scan results summary showing detected orphan files and unused media items. 178 179 6. Detailed Scan Results – Complete list of unused media files with usage references and safe deletion options. 180 181 7. Broken Media Scan Wizard – Step 1: Select scan type to detect broken image links and missing attachments in WordPress. 182 183 8. Broken Media Scan Wizard – Step 2: Configure broken media detection settings for accurate file validation. 184 185 9. Live Site Scan – Perform secure media usage analysis on production WordPress environments. 186 187 10. Analytics Dashboard – Scan summaries, file usage reports, media storage insights, and space savings visualization. 188 189 11. Orphanix Media Cleanup Settings – Configure scan behavior, safety options, and advanced cleanup controls. 190 191 --- 73 192 74 193 == Changelog == 75 194 76 195 = 1.0.0 = 77 * Initial release with full Media Scan, Broken Media Scan, Live Site Scan, and Analytics. 78 * Safe deletion workflow with trash & restore. 79 * Core page builder and plugin compatibility detection. 80 * Bulk actions, filters, and detailed scan reporting. 196 * Initial stable release 197 * Media Scan, Broken Media Scan, Live Site Scan 198 * Safe trash and restore workflow 199 * Builder compatibility detection 200 * Bulk actions and filtering system 81 201 82 202 == Upgrade Notice == 83 203 84 204 = 1.0.0 = 85 Initial release - all core features included in a single plugin version. 86 87 == License == 88 89 GPLv2 or later 205 Initial release with full scanning and safe cleanup system.
Note: See TracChangeset
for help on using the changeset viewer.