Automatically Purge the Cache on Updates via Nginx Helper Hooks

2 min read

The code in this article was contributed by a GridPane client and made public over in the GridPane Community Forum in this thread:

 It’s not something that we can provide support for, however, we have tested it and found that it all works as expected, as have many other GridPane clients. You can also sign up for the community here and ask any questions you may have in the above thread.

Adding the code to your website

You can add this snippet to your site in a few different ways:

  1. Theme functions.php
  2. Custom plugin
  3. Code snippets plugin

If you’re interested in the custom plugin route, Sridhar Katakam has a free starter plugin you could use here:

The code

					//* Nginx Helper Enhancement
function nhpcau_upgrader_process_complete() {

  global $nginx_purger;

// After plugins have been updated
add_action( 'upgrader_process_complete', 'nhpcau_upgrader_process_complete', 10, 0 );

// After a plugin has been activated
add_action( 'activated_plugin', 'nhpcau_upgrader_process_complete', 10, 0);

// After a plugin has been deactivated
add_action( 'deactivated_plugin', 'nhpcau_upgrader_process_complete', 10, 0);

// After a theme has been changed
add_action( 'switch_theme', 'nhpcau_upgrader_process_complete', 10, 0);

Once active, this will automatically purge the cache when:

  • Core, theme, or plugin updates complete
  • A plugin is activated or deactivated
  • A plugin is installed or uninstalled
  • A new theme is installed or activated

Verify it’s working

To verify that the code is working as expected, you can do the above actions while checking the website’s response headers for a HIT and MISS response. To learn how to do this, please see the first part of our Diagnosing Caching Issues article:

Diagnosing Caching Issues

Or, alternatively, check out (and bookmark) this website by Hubert Nguyen (who’s also a member of the GridPane community):