Cloudflare Extra Purge Addon

A simple WordPress plugin that automatically purges the entire Cloudflare cache when content is published or updated. Works as an addon to the official Cloudflare WordPress plugin.

Description

This plugin extends the functionality of the official Cloudflare plugin by automatically purging the entire Cloudflare cache (not just specific URLs) whenever:

• A post or page is published (new or scheduled)
• A post or page is updated
• Any content transitions to the "publish" status
• The full WP Rocket cache is cleared

Features

• ✅ Automatically purges entire Cloudflare cache on content publish/update
• ✅ Works with scheduled posts
• ✅ Triggers full Cloudflare purge when WP Rocket full cache is cleared
• ✅ Compatible with the official Cloudflare plugin
• ✅ Uses Cloudflare plugin's API directly (no fallbacks)
• ✅ Forces Cloudflare plugin_specific_cache option to on at runtime
• ✅ Debug logging support
• ✅ Follows WordPress coding standards
• ✅ Simple namespace-based architecture

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Cloudflare WordPress plugin installed and configured

Installation

1. Download or clone this repository into your WordPress plugins directory:

   cd wp-content/plugins
   git clone https://github.com/beapi/cloudflare-extra-purge-addon.git

2. Make sure the official Cloudflare plugin is installed and configured with your API credentials.

3. Activate the plugin through the 'Plugins' menu in WordPress.

How It Works

The plugin hooks into WordPress post lifecycle events:

• transition_post_status - Detects when posts transition to "publish" status
• save_post - Detects when published posts are updated
• publish_future_post - Handles scheduled post publications
• after_rocket_clean_domain - Triggers a Cloudflare full purge when WP Rocket clears domain cache
• pre_option_plugin_specific_cache - Forces plugin_specific_cache to on when read by WordPress

When any of these events occur, the plugin:

1. Checks if the Cloudflare plugin is active and its API is available
2. Uses the Cloudflare plugin's Hooks class to call purgeCacheEverything()
3. Purges the entire cache using purge_everything: true

Note: If the Cloudflare plugin is not active or its API is not available, this plugin does nothing (no fallbacks).

Configuration

No configuration needed! The plugin automatically uses the Cloudflare plugin's API. Make sure the official Cloudflare plugin is installed, activated, and properly configured.

Runtime Option Override

Some Cloudflare plugin internals only allow full cache purge when plugin_specific_cache is set to on.

This addon forces the value at runtime using the pre_option_plugin_specific_cache filter.
That means:

• The value can remain off in the database
• The Cloudflare plugin still receives on during execution
• No manual database update is required

Debugging

To enable debug logging, add this to your wp-config.php:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

Purge operations will be logged to /wp-content/debug.log with the prefix [Cloudflare Extra Purge].

Development

Code Standards

This plugin follows:

• WordPress Coding Standards (WPCS)
• WordPress VIP coding requirements
• PSR-12 for PHP formatting
• Uses PHP namespaces for code organization

Testing

Test the plugin by:

1. Publishing a new post
2. Updating an existing published post
3. Scheduling a post for future publication
4. Clicking "Clear and preload cache" (or full cache clear) in WP Rocket
5. Checking Cloudflare dashboard or debug logs to verify cache purge

License

GPL v2 or later

Support

For issues, feature requests, or contributions, please open an issue on GitHub.

Changelog

1.1.0

• Added runtime override for Cloudflare plugin_specific_cache option (on)
• Added WP Rocket integration: full Cloudflare purge on after_rocket_clean_domain

1.0.0

• Initial release
• Automatic cache purge on post publish/update
• Support for scheduled posts
• Integration with official Cloudflare plugin
• Namespace-based architecture
• No fallbacks - uses Cloudflare plugin API exclusively