🎉 What's New in Version 2.2.0

Download Safe Media as ZIP (v2.2.0)
🆕 New Feature: Download all safe-to-delete media files as a ZIP backup before deletion
📁 Organized folder structure matching WordPress uploads directory
⚡ Option to automatically download backup before bulk deletion
📊 Progress feedback and file count information
🗑️ Automatic cleanup of ZIP files after 1 hour
🛡️ Enhanced user workflow with backup-first approach
WooCommerce False Positive Fix (v2.1.4)
  • WooCommerce False Positives: Resolved critical issue where attachment IDs were incorrectly matched against WooCommerce configuration values
  • Coincidental Matches: Fixed numeric matches (e.g., attachment 300 vs thumbnail_image_width=300)
  • Color Code Detection: Fixed attachment IDs matching color values (#111111)
  • Detection Accuracy: Now only checks actual media-related WooCommerce options
  • Performance Enhancement: Reduced false database matches and improved scan accuracy
Previous Release: Critical Fatal Error Hotfix (v2.1.1)
  • Fatal Error Fix: Resolved critical fatal error when ACF plugin is missing during activation
  • Activation Reliability: Fixed "Call to a member function acf_missing_notice() on null" error
  • Enhanced User Experience: Self-contained ACF missing notice with direct installation link
  • Production Stability: Improved plugin activation process and dependency handling
  • Error Prevention: Plugin now gracefully handles missing ACF plugin without crashing

🔧 Installation

Download the plugin zip file
Click the download button above to get the latest version
Upload to your /wp-content/plugins/ directory
Extract the ZIP file and upload the folder to your plugins directory
Activate through WordPress admin
Go to Plugins → Installed Plugins and activate "CitCom. Media Cleanup for ACF"
Ensure ACF plugin is active
The Advanced Custom Fields plugin must be installed and activated
Start cleaning your media library
Navigate to Media → CitCom. Media Cleanup for ACF and begin scanning!
⚠️ Important Backup Warning
Although this plugin includes comprehensive safety checks and multiple layers of protection, we strongly recommend creating a complete backup of your website (including files and database) before performing any media deletion operations.

📖 About CitCom. Media Cleanup for ACF

CitCom. Media Cleanup for ACF is a comprehensive WordPress plugin that helps you identify and safely remove media files that are not used in any Advanced Custom Fields (ACF) fields. Perfect for cleaning up your WordPress media library and freeing up valuable server storage space.

� Performance Optimized
Comprehensive wp_cache implementation with 5-minute caching for all database queries. Significantly improved performance for large media libraries with intelligent caching strategies.
�🛡️ Comprehensive Safety System
Multi-layered safety checks across 10+ usage areas with real-time verification before each deletion and detailed usage analysis.
🔍 Advanced Filtering & Search
Server-side filtering by file type and safety status with consistent results across all paginated pages and real-time application.
📊 Intelligent Pagination
Efficient handling of large media libraries (1000+ files) with customizable display options and smart caching system.
⚡ Bulk Operations
Download safe files as ZIP backup before deletion, select and delete multiple files with progress tracking, detailed reporting, and batch processing for server-friendly operations.
💻 Professional Interface
Clean, responsive WordPress admin design with mobile-friendly interface and accessibility features.
🎯 Perfect Integration
Seamlessly integrates with WordPress core, ACF plugin, and follows all WordPress coding standards and best practices.
🏗️ Oxygen Builder 6 & Classic Support
Enhanced integration with both Oxygen Builder 6 (Breakdance-based) and classic versions. Includes templates, reusable parts, custom CSS/JS, global settings, and comprehensive Breakdance meta field detection.
🛒 WooCommerce E-commerce Integration
Comprehensive protection for WooCommerce stores including product galleries, featured images, category thumbnails, variation images, shop customizer settings, and all e-commerce content. Prevents accidental deletion of critical store media.

🛡️ Comprehensive Safety Checks

The plugin performs comprehensive safety checks across multiple areas to ensure no files are accidentally deleted:

ACF Field Usage
Standard fields, repeaters, flexible content, options pages
WordPress Core
Featured images, post content, page content
Widgets & Menus
Widget content, navigation menu items
Theme Customization
Customizer settings, site icons, custom headers
Advanced Detection
Serialized data, gallery relationships, custom fields
Database References
All meta tables, user profiles, options
Oxygen Builder 6 & Classic
Breakdance-based v6 (_breakdance_data), classic templates, reusable parts, CSS/JS, global settings
WooCommerce E-commerce
Product galleries, featured images, category thumbnails, variations, shop settings

📋 Requirements

📱
WordPress 5.0+
Tested up to 6.4
🔧
PHP 7.4+
Optimized for PHP 8.x
🎯
ACF Plugin
Advanced Custom Fields
👤
Admin Access
Administrator capabilities

💬 Support & Resources

Need help with the plugin? Choose from our comprehensive support options:

📚
Documentation

Comprehensive guides, FAQ, and usage examples to get you started quickly.

View Docs
💬
Community Support

WordPress.org plugin forums with community-driven help and solutions.

Join Community
🐛
Bug Reports

Report technical issues, suggest features, and contribute to development.

Report Issue
🎯
Premium Support

Priority support, custom implementation, and WordPress consultation services.

Get Premium Support