<?php
/**
 * Keeps speed/caching plugins and CDNs from delaying or freezing HTforms, and
 * gives the Troubleshooting screen a real speed check.
 *
 * @package HTform
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Compatibility with optimizers and page caches.
 */
class HTForm_Compat {

	/** Attributes understood by Cloudflare Rocket Loader, LiteSpeed, WP Rocket and others. */
	const SKIP_ATTRS = array(
		'data-cfasync'       => 'false',
		'data-no-optimize'   => '1',
		'data-no-defer'      => '1',
		'data-no-minify'     => '1',
		'data-pagespeed-no-defer' => '',
		'nowprocket'         => '',
	);

	const MATCH = 'htform';

	/**
	 * Hooks.
	 */
	public static function init() {
		add_filter( 'script_loader_tag', array( __CLASS__, 'tag' ), 20, 2 );
		add_filter( 'wp_script_attributes', array( __CLASS__, 'attrs' ) );
		add_filter( 'wp_inline_script_attributes', array( __CLASS__, 'attrs' ) );

		// Optimizer exclusion lists (array-based).
		$array_filters = array(
			'rocket_delay_js_exclusions',
			'rocket_exclude_defer_js',
			'rocket_exclude_js',
			'litespeed_optm_js_defer_exc',
			'litespeed_optimize_js_excludes',
			'perfmatters_delay_js_exclusions',
			'sgo_javascript_combine_exclude',
			'sgo_js_minify_exclude',
			'sgo_js_async_exclude',
			'wp-optimize-minify-default-exclusions',
		);
		foreach ( $array_filters as $filter ) {
			add_filter( $filter, array( __CLASS__, 'exclude_list' ) );
		}
		add_filter( 'autoptimize_filter_js_exclude', array( __CLASS__, 'exclude_string' ) );

		add_action( 'init', array( __CLASS__, 'purge_after_update' ), 99 );
	}

	/**
	 * Add skip attributes to the HTforms script tag (and its config).
	 *
	 * @param string $tag    Tag HTML.
	 * @param string $handle Handle.
	 * @return string
	 */
	public static function tag( $tag, $handle ) {
		if ( 'htform' !== $handle || false !== strpos( $tag, 'data-cfasync' ) ) {
			return $tag;
		}
		$extra = '';
		foreach ( self::SKIP_ATTRS as $k => $v ) {
			$extra .= '' === $v ? ' ' . $k : ' ' . $k . '="' . esc_attr( $v ) . '"';
		}
		return str_replace( '<script ', '<script' . $extra . ' ', $tag );
	}

	/**
	 * WordPress 6.4+ attribute filters.
	 *
	 * @param array $attrs Attributes.
	 * @return array
	 */
	public static function attrs( $attrs ) {
		$id = isset( $attrs['id'] ) ? (string) $attrs['id'] : '';
		if ( 0 !== strpos( $id, 'htform-js' ) ) {
			return $attrs;
		}
		foreach ( self::SKIP_ATTRS as $k => $v ) {
			$attrs[ $k ] = '' === $v ? true : $v;
		}
		return $attrs;
	}

	/**
	 * Append our script to an exclusion list.
	 *
	 * @param mixed $list Existing list.
	 * @return array
	 */
	public static function exclude_list( $list ) {
		$list   = is_array( $list ) ? $list : array();
		$list[] = 'htform';
		$list[] = 'htform/assets/htform.js';
		$list[] = 'HTformConfig';
		$list[] = 'HTformsRenderer';
		return array_values( array_unique( $list ) );
	}

	/**
	 * Autoptimize uses a comma separated string.
	 *
	 * @param string $list Existing list.
	 * @return string
	 */
	public static function exclude_string( $list ) {
		return trim( (string) $list . ', htform/assets/htform.js, HTformConfig', ', ' );
	}

	/**
	 * After installing a new plugin version, clear page caches once so no
	 * visitor keeps getting a page saved with an older form box.
	 */
	public static function purge_after_update() {
		if ( get_option( 'htform_purged_version' ) === HTFORM_VERSION ) {
			return;
		}
		update_option( 'htform_purged_version', HTFORM_VERSION, false );
		self::purge_page_caches();
	}

	/**
	 * Purge every page cache we know how to reach.
	 *
	 * @return string[] Names of caches that were cleared.
	 */
	public static function purge_page_caches() {
		$done = array();
		if ( has_action( 'litespeed_purge_all' ) || defined( 'LSCWP_V' ) ) {
			do_action( 'litespeed_purge_all' );
			$done[] = 'LiteSpeed Cache';
		}
		if ( function_exists( 'rocket_clean_domain' ) ) {
			rocket_clean_domain();
			$done[] = 'WP Rocket';
		}
		if ( function_exists( 'w3tc_flush_all' ) ) {
			w3tc_flush_all();
			$done[] = 'W3 Total Cache';
		}
		if ( function_exists( 'wp_cache_clear_cache' ) ) {
			wp_cache_clear_cache();
			$done[] = 'WP Super Cache';
		}
		if ( function_exists( 'sg_cachepress_purge_cache' ) ) {
			sg_cachepress_purge_cache();
			$done[] = 'SiteGround Optimizer';
		}
		if ( function_exists( 'wpfc_clear_all_cache' ) ) {
			wpfc_clear_all_cache( true );
			$done[] = 'WP Fastest Cache';
		}
		if ( has_action( 'breeze_clear_all_cache' ) ) {
			do_action( 'breeze_clear_all_cache' );
			$done[] = 'Breeze';
		}
		if ( class_exists( 'WPO_Page_Cache' ) && method_exists( 'WPO_Page_Cache', 'delete_cache' ) ) {
			WPO_Page_Cache::delete_cache();
			$done[] = 'WP-Optimize';
		}
		if ( class_exists( '\Elementor\Plugin' ) && isset( \Elementor\Plugin::$instance->files_manager ) ) {
			\Elementor\Plugin::$instance->files_manager->clear_cache();
			$done[] = 'Elementor';
		}
		wp_cache_flush();
		return $done;
	}

	/**
	 * Detected speed tools and what HTforms does about each.
	 *
	 * @return array<int,array{name:string,note:string}>
	 */
	public static function detect() {
		$found = array();
		if ( isset( $_SERVER['HTTP_CF_RAY'] ) ) {
			$found[] = array( 'name' => 'Cloudflare', 'note' => __( 'HTforms tells Rocket Loader to skip its script. After updating the plugin, choose Caching → Purge Everything in Cloudflare once.', 'htforms-builder' ) );
		}
		$plugins = array(
			'LSCWP_V'         => 'LiteSpeed Cache',
			'WP_ROCKET_VERSION' => 'WP Rocket',
			'W3TC'            => 'W3 Total Cache',
			'WPCACHEHOME'     => 'WP Super Cache',
			'AUTOPTIMIZE_PLUGIN_VERSION' => 'Autoptimize',
			'PERFMATTERS_VERSION' => 'Perfmatters',
			'BREEZE_VERSION'  => 'Breeze',
			'WPO_VERSION'     => 'WP-Optimize',
			'FLYING_PRESS_VERSION' => 'FlyingPress',
		);
		foreach ( $plugins as $const => $name ) {
			if ( defined( $const ) ) {
				$found[] = array( 'name' => $name, 'note' => __( 'HTforms is excluded from delayed/combined scripts automatically, and its saved pages are cleared after each plugin update.', 'htforms-builder' ) );
			}
		}
		if ( function_exists( 'sg_cachepress_purge_cache' ) ) {
			$found[] = array( 'name' => 'SiteGround Optimizer', 'note' => __( 'Excluded automatically.', 'htforms-builder' ) );
		}
		if ( defined( 'HOSTINGER_PLUGIN_VERSION' ) || defined( 'HOSTINGER_VERSION' ) ) {
			$found[] = array( 'name' => 'Hostinger Tools', 'note' => __( 'Uses LiteSpeed caching; cleared together with LiteSpeed.', 'htforms-builder' ) );
		}
		return $found;
	}

	/**
	 * Time how long this server takes to get a form from HTforms.
	 *
	 * @return array{ms:int,ok:bool,saved:int,error:string}
	 */
	public static function speed_check() {
		global $wpdb;
		$saved = (int) $wpdb->get_var( "SELECT COUNT(*) FROM {$wpdb->options} WHERE option_name LIKE 'htform\\_form\\_%'" ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery
		$start = microtime( true );
		$r     = HTForm_API::request( 'GET', '/status', array( 'timeout' => 8 ), false );
		return array(
			'ms'    => (int) round( ( microtime( true ) - $start ) * 1000 ),
			'ok'    => (bool) $r['ok'],
			'saved' => $saved,
			'error' => (string) $r['error'],
		);
	}
}