feat: add auto purge on update feature

Author: sarthaknagoshe2002

admin/class-nginx-helper-admin.php

@@ -223,8 +223,9 @@ public function nginx_helper_toolbar_purge_link( $wp_admin_bar ) {
 
 $purge_url = add_query_arg(
 array(
-'nginx_helper_action' => 'purge',
-'nginx_helper_urls' => $nginx_helper_urls,
+'nginx_helper_action' => 'purge',
+'nginx_helper_urls' => $nginx_helper_urls,
+'nginx_helper_dismiss' => get_transient( 'nginx_helper_suggest_purge_notice' ),
 )
 );
 
@@ -975,6 +976,80 @@ public function nginx_helper_update_role_caps() {
 }
 }
 
+/**
+ * Automatically purges Nginx cache on any WordPress core, plugin, or theme update if enabled.
+ *
+ * @param WP_Upgrader $upgrader_object WP_Upgrader instance.
+ * @param array $options Array of bulk item update data..
+ */
+public function nginx_helper_auto_purge_on_any_update( $upgrader_object, $options ) {
+
+if ( ! isset( $options['action'], $options['type'] )
+|| 'update' !== $options['action']
+|| ! in_array( $options['type'], array( 'core', 'plugin', 'theme' ), true ) ) {
+return;
+}
+if ( ! defined( 'NGINX_HELPER_AUTO_PURGE_ON_ANY_UPDATE' ) || ! NGINX_HELPER_AUTO_PURGE_ON_ANY_UPDATE ) {
+set_transient( 'nginx_helper_suggest_purge_notice', true, HOUR_IN_SECONDS );
+return;
+}
+global $nginx_purger;
+
+$nginx_purger->purge_all();
+}
+
+/**
+ * Displays an admin notice suggesting the user to purge cache after a WordPress update.
+ */
+public function suggest_purge_after_update() {
+
+if ( ! get_transient( 'nginx_helper_suggest_purge_notice' ) ) {
+return;
+}
+
+$setting_page = is_network_admin() ? 'settings.php' : 'options-general.php';
+$settings_link = network_admin_url( $setting_page . '?page=nginx' );
+$dismiss_url = wp_nonce_url( add_query_arg( 'nginx_helper_dismiss', 'true' ), 'nginx_helper_dismiss_notice' );
+?>
+<div class="notice notice-info">
+<p>
+<?php
+echo esc_html__( 'A WordPress update was detected. It is recommended to purge the cache to ensure your site displays the latest changes.', 'nginx-helper' );
+?>
+<a href="<?php echo esc_url( $settings_link ); ?>"><?php esc_html_e( 'Go & Purge Cache', 'nginx-helper' ); ?></a>
+|
+<a href="<?php echo esc_url( $dismiss_url ); ?>">
+<?php esc_html_e( 'Dismiss', 'nginx-helper' ); ?>
+</a>
+</p>
+</div>
+<?php
+}
+
+/**
+ * Dismisses the "suggest purge" admin notice when the user clicks the dismiss link.
+ */
+public function dismiss_suggest_purge_after_update() {
+
+if ( ! isset( $_GET['nginx_helper_dismiss'] ) || ! isset( $_GET['_wpnonce'] ) ) {
+return;
+}
+
+$dismiss = sanitize_text_field( wp_unslash( $_GET['nginx_helper_dismiss'] ) );
+$nonce = sanitize_text_field( wp_unslash( $_GET['_wpnonce'] ) );
+
+// Verify the correct nonce depending on whether this is a purge+dismiss or dismiss-only request.
+$has_purge_params = isset( $_GET['nginx_helper_action'], $_GET['nginx_helper_urls'] );
+$nonce_verified = $has_purge_params ? wp_verify_nonce( $nonce, 'nginx_helper-purge_all' ) : wp_verify_nonce( $nonce, 'nginx_helper_dismiss_notice' );
+
+if ( $dismiss && $nonce_verified ) {
+
+delete_transient( 'nginx_helper_suggest_purge_notice' );
+wp_safe_redirect( remove_query_arg( array( 'nginx_helper_dismiss', '_wpnonce' ) ) );
+exit;
+}
+}
+
 /**
  * Initialize WooCommerce hooks if enabled.
  *

admin/partials/nginx-helper-general-options.php

@@ -766,6 +766,33 @@
 </td>
 </tr>
 </table>
+<table class="form-table rtnginx-table">
+<tr valign="top">
+<th scope="row">
+<h4><?php esc_html_e( 'Advance conditions:', 'nginx-helper' ); ?></h4>
+</th>
+<td>
+<label for="enable_auto_purge">
+<input
+disabled
+type="checkbox" value="1" id="enable_auto_purge" name="enable_auto_purge" <?php checked( NGINX_HELPER_AUTO_PURGE_ON_ANY_UPDATE, 1 ); ?> />
+&nbsp;
+<?php
+esc_html_e( 'Auto Purge when Core, Plugin or Theme updates.', 'nginx-helper' );
+?>
+</label>
+<p>
+<?php
+if ( NGINX_HELPER_AUTO_PURGE_ON_ANY_UPDATE ) {
+echo wp_kses_post( __( '(NOTE: This feature is enabled via the <strong>rt_wp_nginx_helper_enable_auto_purge_on_any_update</strong> filter. To disable, remove this filter from your code.)', 'nginx-helper' ) );
+} else {
+echo wp_kses_post( __( '(NOTE: To enable, return true in the <strong>rt_wp_nginx_helper_enable_auto_purge_on_any_update</strong> filter.)', 'nginx-helper' ) );
+}
+?>
+</p>
+</td>
+</tr>
+</table>
 </div> <!-- End of .inside -->
 </div>
 <div class="postbox">

admin/partials/nginx-helper-sidebar-display.php

@@ -12,8 +12,9 @@
 
 $purge_url = add_query_arg(
 array(
-'nginx_helper_action' => 'purge',
-'nginx_helper_urls' => 'all',
+'nginx_helper_action' => 'purge',
+'nginx_helper_urls' => 'all',
+'nginx_helper_dismiss' => get_transient( 'nginx_helper_suggest_purge_notice' ),
 )
 );
 $nonced_url = wp_nonce_url( $purge_url, 'nginx_helper-purge_all' );

includes/class-nginx-helper.php

@@ -89,6 +89,15 @@ public function __construct() {
 define( 'RT_WP_NGINX_HELPER_CACHE_PATH', $cache_path );
 }
 
+/**
+ * Flag to automatically purge Nginx cache on any WordPress update (core, plugin, theme).
+ * Set to true to enable auto-purge; false to disable.
+ */
+if ( ! defined( 'NGINX_HELPER_AUTO_PURGE_ON_ANY_UPDATE' ) ) {
+$enabled = (bool) apply_filters( 'rt_wp_nginx_helper_enable_auto_purge_on_any_update', false );
+define( 'NGINX_HELPER_AUTO_PURGE_ON_ANY_UPDATE', $enabled );
+}
+
 $this->load_dependencies();
 $this->set_locale();
 $this->define_admin_hooks();
@@ -236,6 +245,11 @@ private function define_admin_hooks() {
 // add action to update purge caps.
 $this->loader->add_action( 'update_site_option_rt_wp_nginx_helper_options', $nginx_helper_admin, 'nginx_helper_update_role_caps' );
 
+// advance purge settings.
+$this->loader->add_action( 'upgrader_process_complete', $nginx_helper_admin, 'nginx_helper_auto_purge_on_any_update', 10, 2 );
+$this->loader->add_action( 'admin_notices', $nginx_helper_admin, 'suggest_purge_after_update' );
+$this->loader->add_action( 'admin_init', $nginx_helper_admin, 'dismiss_suggest_purge_after_update' );
+
 // WooCommerce integration.
 $this->loader->add_action( 'plugins_loaded', $nginx_helper_admin, 'init_woocommerce_hooks' );