Anti-Cache Emergency Kit is the ultimate tool for WordPress developers and designers who need to bypass all caching mechanisms during development, testing, or troubleshooting.

⚠️ Development Tool Only – Do NOT leave active on production sites!

Key Features

🔧 Comprehensive Cache Management
* Automatically detects and flushes major cache plugins
* Temporarily deactivates cache plugins during development (user can easily reactivate)
* Clears object cache (Redis, Memcached)
* Clears OPcache and hosting-specific caches
* Prevents browser caching for administrators

🛠 Debug Mode Activation
* Creates automatic backup of wp-config.php before any changes
* Safely modifies wp-config.php using WordPress Filesystem API
* Automatically enables WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY
* Disables WordPress cache (WP_CACHE = false)
* Shows PHP errors and warnings for troubleshooting
* Automatically restores original wp-config.php on deactivation

🛠️ Maintenance Mode
* Optional simple maintenance screen for non-logged users
* Prevents visitors from seeing development errors
* Quick toggle from admin bar
* Customizable maintenance message

Admin-Only Impact
* All anti-cache measures only affect logged-in administrators
* Regular visitors see the normal cached site (unless maintenance mode is enabled)
* Perfect for live site development

Smart Management Panel
* View current status and active features
* Easy one-click reactivation of cache plugins
* Manual cache clearing options
* Clear overview of what was changed

Supported Cache Plugins

WP Rocket
W3 Total Cache
WP Super Cache
WP Fastest Cache
LiteSpeed Cache
SiteGround Optimizer
WP Optimize
Hummingbird (WPMU DEV)
Breeze (Cloudways)
Autoptimize
Cache Enabler
Surge
Redis Object Cache

Supported Hosting Caches

SiteGround hosting cache
Cloudflare (when plugin is active)
Generic hosting cache systems

How It Works

Backup: Creates automatic backup of wp-config.php
Activation: Automatically flushes and deactivates all detected cache plugins
Debug Mode: Enables WordPress debug mode and disables WP_CACHE in wp-config.php
Anti-Cache Headers: Sends no-cache headers to admin users
Asset Versioning: Adds random versions to CSS/JS files for admins
Maintenance Mode: Optional simple screen for non-logged users
Deactivation: Restores original wp-config.php from backup

Use Cases

Testing theme or plugin updates
Troubleshooting white screens or errors
Developing new features without cache interference
Checking design changes in real-time
Debugging PHP errors and warnings
Safe development on live sites

Security & Safety

Automatic backup of wp-config.php before modifications
All changes only affect administrator users
Automatic restoration of original configuration on deactivation
Secure nonce verification for all actions
No database modifications beyond options
Compatible with WordPress multisite

How to Test Plugin Features

After activating the plugin, verify each feature is working correctly:

Debug Mode Testing

Check wp-config.php: Look for the debug constants added by the plugin
Verify backup: Check /wp-content/plugins/anticache/backup/wp-config-backup.php exists
Trigger a PHP error: Add to a theme file
Verify error display: You should see PHP errors on the frontend (admin only)
Check debug log: Look for /wp-content/debug.log file creation
Test error logging: Errors should be logged to the debug.log file
Check WP_CACHE: Verify WP_CACHE is set to false in wp-config.php

Cache Plugin Deactivation Testing

Before activation: Note which cache plugins are active in Plugins page
After activation: Verify cache plugins are deactivated
Check admin notice: Should list which plugins were deactivated
Visit settings page: Go to Tools > Anti-Cache Kit to see deactivated plugins list
Test reactivation: Use the “Reactivate All Cache Plugins” button

Browser Cache Prevention Testing

Make a CSS change: Modify your theme’s style.css
Hard refresh: Ctrl+F5 or Cmd+Shift+R should show changes immediately
Check page source: Look for random version numbers on CSS/JS files
Verify headers: Use browser dev tools to check for no-cache headers
Test as visitor: Log out – visitors should still see cached version

Object Cache Testing

Install Redis/Memcached: If using object caching
Check cache status: Use Redis CLI or monitoring tools
Verify clearing: Cache should be flushed when plugin activates
Manual clear: Test the “Manual Cache Clear” button in settings

Maintenance Mode Testing

Enable maintenance: Go to Tools > Anti-Cache Kit and enable maintenance mode
Test as visitor: Open an incognito/private window and visit your site
Verify maintenance page: Should see the maintenance screen
Test as admin: Logged-in admins should bypass maintenance mode
Quick toggle: Use the admin bar toggle for quick on/off

Hosting Cache Testing

SiteGround users: Check SG Optimizer cache is cleared
Cloudflare users: Verify Cloudflare cache is purged (if plugin installed)
Manual verification: Check your hosting control panel for cache status
Performance testing: Use GTmetrix or similar to verify cache clearing

Overall Functionality Testing

Make theme changes: Modify CSS, PHP, or JavaScript files
Check immediate visibility: Changes should be visible without hard refresh
Test error display: Broken code should show errors immediately
Verify admin-only: Log out to confirm visitors see normal cached site
Check HTML comments: Look for “AyudaWP Anti-Cache Kit” comment in page source

Backup and Restoration Testing

Check backup creation: Verify backup file exists after activation
Note original wp-config.php: Take note of original configuration
Deactivate plugin: Deactivate Anti-Cache Kit
Verify restoration: Check that wp-config.php is restored to original state
Backup cleanup: Verify backup file is removed after successful restoration

Testing Checklist

wp-config.php backup is created automatically
Cache plugins are deactivated and listed in admin
Debug mode is enabled (WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY)
WP_CACHE is set to false in wp-config.php
CSS/JS changes are immediately visible to admins
Random versions are added to asset URLs for admins
PHP errors are displayed to admins only
Maintenance mode works for non-logged users
Admin bar toggle functions correctly
Settings page is accessible at Tools > Anti-Cache Kit
Manual cache clear button works
Plugin reactivation feature works
HTML comment appears in page source for admins
No-cache headers are sent to admin users only
Original wp-config.php is restored on deactivation

If any feature isn’t working, check the debug.log file for error messages or contact support.

Developer Information

Hooks and Filters

ayudawp_anticache_maintenance_data – Filter to customize maintenance page data
ayudawp_anticache_cache_plugins – Filter to modify the list of supported cache plugins

Constants

AYUDAWP_ANTICACHE_VERSION – Plugin version
AYUDAWP_ANTICACHE_PLUGIN_DIR – Plugin directory path
AYUDAWP_ANTICACHE_PLUGIN_URL – Plugin directory URL

Code Example

Customize maintenance page:

add_filter( 'ayudawp_anticache_maintenance_data', function( $data ) {
    $data['heading'] = 'Custom Maintenance Message';
    $data['message'] = 'We are updating our awesome website!';
    $data['accent_color'] = '#ff6b6b';
    return $data;
});Support

For support, feature requests, or bug reports, please visit:
* Official website
* WordPress support forum
* YouTube channel
* Documentation and tutorials

Contributing

This plugin is developed following WordPress coding standards and best practices. Contributions are welcome via the WordPress.org plugin repository.

Anti-Cache Emergency Kit