HEX
Server: Apache
System: Linux eisbus 6.8.12-9-pve #1 SMP PREEMPT_DYNAMIC PMX 6.8.12-9 (2025-03-16T19:18Z) x86_64
User: www-data (33)
PHP: 8.2.29
Disabled: NONE
Upload Files
File: /var/www/wordpress/wp-content/plugins/jetpack-boost/app/lib/class-environment-change-detector.php
<?php
/**
 * Environment Change Detector class.
 *
 * @link       https://automattic.com
 * @since      1.0.0
 * @package    automattic/jetpack-boost
 */

namespace Automattic\Jetpack_Boost\Lib;

use Automattic\Jetpack_Boost\Lib\Cornerstone\Cornerstone_Utils;

/**
 * Class Environment_Change_Detector
 */
class Environment_Change_Detector {

	const ENV_CHANGE_LEGACY                         = '1';
	const ENV_CHANGE_PAGE_SAVED                     = 'page_saved';
	const ENV_CHANGE_POST_SAVED                     = 'post_saved';
	const ENV_CHANGE_SWITCHED_THEME                 = 'switched_theme';
	const ENV_CHANGE_PLUGIN_CHANGE                  = 'plugin_change';
	const ENV_CHANGE_CORNERSTONE_PAGE_SAVED         = 'cornerstone_page_saved';
	const ENV_CHANGE_CORNERSTONE_PAGES_LIST_UPDATED = 'cornerstone_pages_list_updated';

	/**
	 * Initialize the change detection hooks.
	 */
	public static function init() {
		$object = new self();
		$object->register_hooks();
	}

	public function register_hooks() {
		add_action( 'after_switch_theme', array( $this, 'handle_theme_change' ) );
		add_action( 'save_post', array( $this, 'handle_post_change' ), 10, 2 );
		add_action( 'activated_plugin', array( $this, 'handle_plugin_change' ) );
		add_action( 'deactivated_plugin', array( $this, 'handle_plugin_change' ) );
	}

	public function handle_post_change( $post_id, $post ) {
		// Ignore changes to any post which is not published.
		if ( 'publish' !== $post->post_status ) {
			return;
		}

		// Ignore changes to post types which do not affect the front-end UI
		if ( ! $this->is_post_type_invalidating( $post->post_type ) ) {
			return;
		}

		$this->do_action( false, $this->get_post_change_type( $post ) );
	}

	public function handle_theme_change() {
		$this->do_action( true, $this::ENV_CHANGE_SWITCHED_THEME );
	}

	public function handle_plugin_change() {
		$this->do_action( false, $this::ENV_CHANGE_PLUGIN_CHANGE );
	}

	public function handle_cornerstone_pages_list_update() {
		$this->do_action( false, $this::ENV_CHANGE_CORNERSTONE_PAGES_LIST_UPDATED );
	}

	/**
	 * Fire the environment change action.
	 *
	 * @param bool   $is_major_change Whether the change is such that we should stop serving existing critical CSS immediately unless refreshed.
	 * @param string $change_type The change type.
	 */
	public function do_action( $is_major_change, $change_type ) {
		do_action_deprecated(
			'jetpack_boost_critical_css_environment_changed',
			array( $is_major_change, $change_type ),
			'3.20.0',
			'jetpack_boost_environment_changed'
		);

		do_action( 'jetpack_boost_environment_changed', $is_major_change, $change_type );
	}

	public static function get_available_env_change_statuses() {
		return array(
			self::ENV_CHANGE_PAGE_SAVED,
			self::ENV_CHANGE_POST_SAVED,
			self::ENV_CHANGE_SWITCHED_THEME,
			self::ENV_CHANGE_PLUGIN_CHANGE,
			self::ENV_CHANGE_CORNERSTONE_PAGE_SAVED,
			self::ENV_CHANGE_CORNERSTONE_PAGES_LIST_UPDATED,
		);
	}

	/**
	 * Given a post_type, return true if this post type affects the front end of
	 * the site - i.e.: should cause cached optimizations to be invalidated.
	 *
	 * @param string $post_type The post type to check
	 * @return bool             True if this post type affects the front end of the site.
	 */
	private function is_post_type_invalidating( $post_type ) {
		// Special cases: items which are not viewable, but affect the UI.
		if ( in_array( $post_type, array( 'wp_template', 'wp_template_part' ), true ) ) {
			return true;
		}

		if ( is_post_type_viewable( $post_type ) ) {
			return true;
		}
	}

	/**
	 * Get the type of change for a specific post.
	 *
	 * @param \WP_Post $post The post object.
	 * @return string The change type.
	 */
	private function get_post_change_type( $post ) {
		if ( Cornerstone_Utils::is_cornerstone_page( $post->ID ) ) {
			return $this::ENV_CHANGE_CORNERSTONE_PAGE_SAVED;
		}

		if ( 'page' === $post->post_type ) {
			$change_type = $this::ENV_CHANGE_PAGE_SAVED;
		} else {
			$change_type = $this::ENV_CHANGE_POST_SAVED;
		}

		return $change_type;
	}
}