University of Michigan: Cloudflare Cache WP Registry grade D+. High-severity findings · 2 findingsWP RegistryHigh-severity findings · 2 findingsOpen the reportD+ #4 in Performance & Caching
Wordpress Cloudflare plugin
Install
Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/its-cloudflare/umich-cloudflare/releases/download/1.1.0/umich-cloudflare-1.1.0.zipU-M Cloudflare Cache Purge Manager
Provides easy and automatic ability to purge cloudflare cache for your whole site, section, or a page. Also adds metabox to override TTL and Disable cache for a specific page/post/cpt.
This requires that you have an existing CloudFlare API key.
Install
WP Admin/Dashboard Method
This requires that your site has write access to the plugins folder.
- Download the latest package (e.g. umich-cloudflare-x.x.x.zip)
- Go to WP Admin/Dashboard -> Plugins -> Add New -> Upload Plugin
- Select the downloaded zip file and Upload
- Activate Plugin
- Configure plugin settings (WP Admin/Dashboard -> Settings -> U-M: Cloudlfare
- Add your API Key (Provided by ITS or your units Cloudflare manager)
Manual Method
- Download the latest package (e.g. umich-cloudflare-x.x.x.zip)
- Extract zip
- Upload the umich-cloudflare folder to wp-content/plugins/ folder in your site
- Activate Plugin
- Configure plugin settings (WP Admin/Dashboard -> Settings -> U-M: Cloudlfare
- Add your API Key (Provided by ITS or your units Cloudflare manager)
Custom Integrations
Filters
umich_cloudflare_settings
Override the plugins saved API settings.
add_filter( 'umich_cloudflare_settings', function( $settings ){
// your code here to modify settings as necessary
return $settings;
});umich_cloudflare_menu_purge_page
Ability to disable the Admin Menu Page Purge menu item.
add_filter( 'umich_cloudflare_menu_purge_page', '__return_false' );umich_cloudflare_menu_purge_section
Ability to disable the Admin Menu Section Purge menu item.
add_filter( 'umich_cloudflare_menu_purge_section', '__return_false' );umich_cloudflare_admin_form_settings
Customize which settings should be available for management. Useful in complex wordpress environments.
add_filter('umich_cloudflare_admin_form_settings', function( $settings ){
$settings['apikey'] = false;
$settings['zone'] = false;
$settings['ttl'] = false;
$settings['ttl_browser'] = false;
$settings['ttl_static'] = false;
$settings['ttl_static_browser'] = false;
return $settings;
});Pantheon Filters
umich_cloudflare_pantheon_surrogate_keys
Adjust which surrogate keys are issued in the request.
add_filter( 'umich_cloudflare_pantheon_surrogate_keys', function( $keys ){
$keys[] = 'my-custom-key';
return $keys;
});Actions
umich_cloudflare_purge_page
Called before cloudflare purge page request.
$paths: paths to be purged
add_action( 'umich_cloudflare_purge_page', function( $paths ){
// do something
});umich_cloudflare_purge_all
Called before cloudflare purge all request
$paths: paths to be purged
add_action( 'umich_cloudflare_purge_all', function( $paths ){
// do something
});umich_cloudflare_admin_settings_save
Called after settings validation and before settings save.
$settings: reference of the form settings
$hasErrors: reference of the forms boolean error flag
add_action( 'umich_cloudflare_admin_settings_save', function( $settings, $hasErrors ){
// custom action code here
if( !$hasErrors ) {
if( $settings['apikey'] ) {
// do something
}
}
});Custom Purge Integration
There are some public functions that can be called to perform custom cache purging integrations.
UMCloudflare::purgePage( $path ) Purge a specific url from the cache.
// RETURNS: true on success, false on failure
UMCloudflare::purgePage( '/path-to-my-page/' );UMCloudflare::purgeAll( $paths ) Purge everything that starts with a path
// RETURNS: true on success, false on failure
UMCloudflare::purgeAll('/');Releases
16 releases. Each count is every asset in that release; expand a row for the breakdown.
Active-site estimate ≈140 comes from the median of recent superseded releases. Method.