Merge pull request #445 from rtCamp/try/woocommerce-purge-option

Feat: Add Purge Option For WooCommerce Plugin[develop]

Author: im3dabasia

README.md

@@ -113,6 +113,20 @@ To purge a page immediately, follow these instructions:
 
 Yes. When setting the URL structure in Nginx configuration file a trailing slash should always be added.
 
+**Q. How can I automatically purge cache when WooCommerce product stock reduces after purchase?**
+
+Nginx Helper now includes optional WooCommerce integration.
+If enabled, cache for purchased products will be purged automatically whenever stock is reduced after an order.
+
+To use it:
+
+1. Go to Nginx Helper → Settings → WooCommerce Options.
+2. Tick “Purge product cache on stock change or purchase”.
+
+This ensures customers always see up-to-date stock status without stale cache.
+
+Note: This option will only be visible if WooCommerce is active.
+
 ### FAQ - Nginx Redis Cache ###
 
 **Q. Can I override the redis hostname, port and prefix?**

admin/class-nginx-helper-admin.php

@@ -294,7 +294,8 @@ public function nginx_helper_default_settings() {
 			'redis_acl_enabled_by_constant'    => 0,
 			'preload_cache'                    => 0,
 			'is_cache_preloaded'               => 0,
-			'roles_with_purge_cap'             => array()
+			'roles_with_purge_cap'             => array(),
+			'purge_woo_products'               => 0,
 		);
 
 	}
@@ -1048,4 +1049,55 @@ public function dismiss_suggest_purge_after_update() {
 			exit;
 		}
 	}
+
+	/**
+	 * Initialize WooCommerce hooks if enabled.
+	 *
+	 * @since 2.3.5
+	 */
+	public function init_woocommerce_hooks() {
+		if ( ! is_plugin_active( 'woocommerce/woocommerce.php' )  || empty( $this->options['purge_woo_products'] ) ) {
+			return;
+		}
+
+		add_action( 'woocommerce_reduce_order_stock', array( $this, 'purge_product_cache_on_purchase' ), 10, 1 );
+	}
+
+	/**
+	 * Purge product cache when order stock is reduced (purchase).
+	 *
+	 * @since  2.3.5
+	 * @global object $nginx_purger Nginx purger object.
+	 * @param  object $order Order object.
+	 */
+	public function purge_product_cache_on_purchase( $order ) {
+
+		global $nginx_purger;
+
+		if ( ! $order instanceof WC_Order ) {
+			return;
+		}
+
+		if ( ! $this->options['enable_purge'] ) {
+			return;
+		}
+
+		$nginx_purger->log( 'WooCommerce order stock reduction - purging product caches' );
+
+		foreach ( $order->get_items() as $item ) {
+			$product = $item->get_product();
+			if ( ! $product ) {
+				continue;
+			}
+
+			$product_id = $product->get_id();
+			$nginx_purger->log( 'Purging cache for product ID: ' . $product_id . ' due to purchase' );
+
+			$product_url = get_permalink( $product_id );
+
+			if ( $product_url ) {
+				$nginx_purger->purge_url( $product_url );
+			}
+		}
+	}
 }

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

@@ -49,6 +49,7 @@
 	'purge_amp_urls',
 	'preload_cache',
 	'roles_with_purge_cap',
+	'purge_woo_products'
 );
 
 $all_inputs = array();
@@ -1050,6 +1051,25 @@
 			</table>
 		</div> <!-- End of .inside -->
 	</div>
+	<?php if ( is_plugin_active( 'woocommerce/woocommerce.php' ) ) : ?>
+		<div class="postbox enable_purge"<?php echo empty( $nginx_helper_settings['enable_purge'] ) ? ' style="display: none;"' : ''; ?>>
+			<h3 class="hndle">
+				<span><?php esc_html_e( 'WooCommerce Options', 'nginx-helper' ); ?></span>
+			</h3>
+			<div class="inside">
+				<table class="form-table">
+					<tr valign="top">
+						<td>
+							<input type="checkbox" value="1" id="purge_woo_products" name="purge_woo_products" <?php checked( $nginx_helper_settings['purge_woo_products'] ?? 0, 1 ); ?> />
+							<label for="purge_woo_products">
+								<?php esc_html_e( 'Purge product cache on stock change or purchase', 'nginx-helper' ); ?>
+							</label>
+						</td>
+					</tr>
+				</table>
+			</div> <!-- End of .inside -->
+		</div>
+	<?php endif; ?>
 	<input type="hidden" name="smart_http_expire_form_nonce" value="<?php echo esc_attr( wp_create_nonce( 'smart-http-expire-form-nonce' ) ); ?>" />
 	<?php
 		submit_button( __( 'Save All Changes', 'nginx-helper' ), 'primary large', 'smart_http_expire_save', true );

includes/class-nginx-helper.php

@@ -249,6 +249,10 @@ private function define_admin_hooks() {
 		$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' );
+
 	}
 
 	/**

readme.txt

@@ -107,6 +107,20 @@ To purge a page immediately, follow these instructions:
 
 Yes. When setting the URL structure in Nginx configuration file a trailing slash should always be added.
 
+**Q. How can I automatically purge cache when WooCommerce product stock reduces after purchase?**
+
+Nginx Helper now includes optional WooCommerce integration.
+If enabled, cache for purchased products will be purged automatically whenever stock is reduced after an order.
+
+To use it:
+
+1. Go to Nginx Helper → Settings → WooCommerce Options.
+2. Tick “Purge product cache on stock change or purchase”.
+
+This ensures customers always see up-to-date stock status without stale cache.
+
+Note: This option will only be visible if WooCommerce is active.
+
 = FAQ - Nginx Redis Cache =
 
 **Q. Can I override the redis hostname, port and prefix?**