Media Sweep – WordPress Media Cleaner

Media Sweep: The Ultimate WordPress Media Library Cleaner Media Sweep is a powerful WordPress plugin designed to help you reclaim valuable server space by identifying and safely removing unused media files from your WordPress site. Whether you're dealing with orphaned attachments, forgotten uploads, or files left behind by themes and plugins, Media Sweep provides a comprehensive solution to keep your media library clean and organized. Perfect for bloggers, agencies, e-commerce sites, and any WordPress website looking to optimize storage space and improve site performance. 🚀 Key Benefits: ✅ Reclaim Server Space – Remove unused files and free up valuable storage ✅ Improve Site Performance – Faster backups and reduced server load ✅ Safe & Reversible – Files moved to trash folder, not permanently deleted ✅ Smart Detection – Advanced algorithms identify truly unused files ✅ Batch Operations – Process multiple files efficiently ✅ Detailed Analytics – Comprehensive scan reports and file insights 🎯 Core Features 🔍 Dual Scan Modes Media Library Scan

• Scans all media attachments in your WordPress library
• Checks for usage in posts, pages, and custom fields
• Detects thumbnail and size variations
• Identifies gallery shortcodes and blocks
• Fast and efficient for large media libraries
• Recommended for most WordPress sites File System Scan
• Deep scan of your uploads directory
• Finds orphaned files not in the media library
• Detects cache and temporary files
• Identifies theme and plugin generated files
• Comprehensive but may take longer to complete
• Best for sites with file management plugins

📊 Smart File Detection

• Usage Analysis – Checks posts, pages, custom fields, and widgets
• Database Scanning – Searches content for file references
• Shortcode Detection – Identifies gallery and media shortcodes
• Block Analysis – Scans Gutenberg blocks for media usage
• Plugin Integration – Detects files used by popular plugins
• Theme Assets – Identifies theme-related media files

🗂️ Advanced File Management

• Status Classification – Files categorized as In Use, Unused, or Orphaned
• Bulk Actions – Select and process multiple files at once
• Smart Filtering – Filter by file type, status, date, and directory
• Search Functionality – Quickly find specific files
• Preview Mode – View files before taking action
• Detailed File Info – Size, type, usage locations, and more

🛡️ Safety Features

• Trash System – Files moved to secure trash folder, not deleted
• Restore Capability – Easily restore accidentally removed files
• Backup Integration – Works with popular backup plugins
• Progress Monitoring – Real-time scan progress with pause/resume
• System Resources – Intelligent resource management prevents timeouts
• Rollback Protection – Safe operations with detailed logging

📈 Comprehensive Analytics

• Scan History – Track all previous scans and results
• Storage Statistics – See exactly how much space you've reclaimed
• File Breakdown – Detailed analysis by file type and status
• Usage Patterns – Understand your media library usage
• Performance Metrics – Scan duration and processing statistics

🚀 Easy 3-Step Process Step 1: Choose Scan Type

• Select Media Library or File System scan based on your needs
• Configure advanced options for thorough analysis Step 2: Run the Scan
• Watch real-time progress as Media Sweep analyzes your files
• Pause and resume scans as needed without losing progress Step 3: Review & Clean
• Browse detected files with detailed information
• Use bulk actions to efficiently process multiple files
• Restore files from trash if needed

🔧 Advanced Configuration

• Scan Options – Deep scan, thumbnail inclusion, custom field checking
• File Type Filters – Focus on specific file types (images, documents, etc.)
• Directory Exclusions – Skip specific folders during scans
• Performance Settings – Adjust batch sizes and resource limits
• Automation Rules – Set up automatic cleanup schedules (planned for future versions)

💡 Perfect For

• Content Creators – Bloggers and publishers with large media libraries
• Web Agencies – Managing multiple client sites efficiently
• E-commerce Sites – Cleaning up product images and assets
• Membership Sites – Optimizing user-generated content
• Portfolio Sites – Managing large image collections
• News Sites – Handling high-volume media uploads

Automatic Installation (Recommended)

1. Go to Plugins > Add New in your WordPress admin
2. Search for "Media Sweep"
3. Click "Install Now" and then "Activate"
4. Navigate to Media Sweep in your admin menu to get started

Manual Installation

1. Download the plugin ZIP file
2. Upload to /wp-content/plugins/media-sweep/
3. Activate through the Plugins menu in WordPress
4. Access Media Sweep from your admin dashboard

Getting Started

1. Visit Media Sweep > Dashboard
2. Click "Start New Scan"
3. Choose your scan type and options
4. Let Media Sweep analyze your files
5. Review results and clean up unused files

1.0.1

• Fixed file status not being reactivated when previously trashed/deleted files are found again during new scans
• Improved file record management to automatically restore files that were moved back to original locations

1.0.0 - Initial Release 🎉 Launch Features:

• Dual Scan Modes – Media Library and File System scanning capabilities
• Smart Detection Engine – Advanced algorithms for accurate unused file identification
• Safe Trash System – Secure file removal with restore capabilities
• Comprehensive Analytics – Detailed scan reports and file insights
• Bulk Operations – Efficient processing of multiple files
• Real-time Progress – Live scan monitoring with pause/resume functionality
• Advanced Filtering – Filter by status, file type, date, and directory
• Search Functionality – Quick file location and identification
• Resource Management – Intelligent system monitoring prevents timeouts
• Modern UI/UX – Clean, responsive interface optimized for all devices
• Translation Ready – Full internationalization support
• Developer Friendly – Extensive hooks and filters for customization

🔧 Technical Highlights:

• Built with modern React components and WordPress REST API
• Optimized database queries for large media libraries
• Memory-efficient processing with batch operations
• Compatible with popular caching and optimization plugins
• Follows WordPress coding standards and security best practices
• Extensive error handling and logging capabilities

🛡️ Security & Performance:

• Secure file operations with proper capability checks
• Nonce verification for all AJAX requests
• Sanitized input/output throughout the application
• Optimized for sites with thousands of media files
• Minimal server resource usage during scans