Add filter to control proxy speed module auto-installation (#46719)

* Add filter to control proxy speed module auto-installation

This adds a `woocommerce_analytics_auto_install_proxy_speed_module` filter
that allows environments to opt out of automatic mu-plugin file creation.

This is the first step toward addressing concerns about the proxy speed
module causing issues on certain environments (e.g., CIAB garden sites).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add @SInCE tag

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: chihsuan

projects/packages/woocommerce-analytics/changelog/add-woocommerce-analytics-proxy-speed-module-filter

@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+Add woocommerce_analytics_auto_install_proxy_speed_module filter to control auto-installation of proxy speed module mu-plugin.

projects/packages/woocommerce-analytics/src/class-woocommerce-analytics.php

@@ -174,6 +174,19 @@ public static function register_rest_routes() {
 	 * Maybe add proxy speed module.
 	 */
 	public static function maybe_add_proxy_speed_module() {
+		/**
+		 * Filter to control auto-installation of the proxy speed module mu-plugin.
+		 *
+		 * When this filter returns false, the mu-plugin file can't be added automatically.
+		 *
+		 * @since 0.15.0
+		 *
+		 * @param bool $auto_install Whether to auto-install the mu-plugin. Default true.
+		 */
+		if ( ! apply_filters( 'woocommerce_analytics_auto_install_proxy_speed_module', true ) ) {
+			return;
+		}
+
 		if ( ! self::init_filesystem() ) {
 			return;
 		}