oont-contents/plugins/jetpack-boost/app/modules/optimizations/cloud-css/Cloud_CSS.php
2025-02-08 15:10:23 +01:00

210 lines
6.8 KiB
PHP

<?php
namespace Automattic\Jetpack_Boost\Modules\Optimizations\Cloud_CSS;
use Automattic\Jetpack\Boost_Core\Lib\Boost_API;
use Automattic\Jetpack_Boost\Contracts\Changes_Page_Output;
use Automattic\Jetpack_Boost\Contracts\Optimization;
use Automattic\Jetpack_Boost\Contracts\Pluggable;
use Automattic\Jetpack_Boost\Lib\Critical_CSS\Admin_Bar_Compatibility;
use Automattic\Jetpack_Boost\Lib\Critical_CSS\Critical_CSS_Invalidator;
use Automattic\Jetpack_Boost\Lib\Critical_CSS\Critical_CSS_State;
use Automattic\Jetpack_Boost\Lib\Critical_CSS\Critical_CSS_Storage;
use Automattic\Jetpack_Boost\Lib\Critical_CSS\Display_Critical_CSS;
use Automattic\Jetpack_Boost\Lib\Critical_CSS\Generator;
use Automattic\Jetpack_Boost\Lib\Critical_CSS\Source_Providers\Source_Providers;
use Automattic\Jetpack_Boost\Lib\Premium_Features;
use Automattic\Jetpack_Boost\REST_API\Contracts\Has_Always_Available_Endpoints;
use Automattic\Jetpack_Boost\REST_API\Endpoints\Update_Cloud_CSS;
class Cloud_CSS implements Pluggable, Has_Always_Available_Endpoints, Changes_Page_Output, Optimization {
/** User has requested regeneration manually or through activating the module. */
const REGENERATE_REASON_USER_REQUEST = 'user_request';
/** A post was updated/created. */
const REGENERATE_REASON_SAVE_POST = 'save_post';
/** Existing critical CSS invalidated because of a significant change, e.g. Theme changed. */
const REGENERATE_REASON_INVALIDATED = 'invalidated';
/** Requesting a regeneration because the previous request had failed and this is a followup attempt to regenerate Critical CSS. */
const REGENERATE_REASON_FOLLOWUP = 'followup';
/**
* Critical CSS storage class instance.
*
* @var Critical_CSS_Storage
*/
protected $storage;
/**
* Critical CSS Provider Paths.
*
* @var Source_Providers
*/
protected $paths;
public function __construct() {
$this->storage = new Critical_CSS_Storage();
$this->paths = new Source_Providers();
}
public function setup() {
add_action( 'wp', array( $this, 'display_critical_css' ) );
add_action( 'save_post', array( $this, 'handle_save_post' ), 10, 2 );
add_action( 'jetpack_boost_critical_css_invalidated', array( $this, 'handle_critical_css_invalidated' ) );
add_filter( 'jetpack_boost_total_problem_count', array( $this, 'update_total_problem_count' ) );
Generator::init();
Critical_CSS_Invalidator::init();
Cloud_CSS_Followup::init();
return true;
}
/**
* Check if the module is ready and already serving critical CSS.
*
* @return bool
*/
public function is_ready() {
return ( new Critical_CSS_State() )->is_generated();
}
public static function is_available() {
return true === Premium_Features::has_feature( Premium_Features::CLOUD_CSS );
}
public static function get_slug() {
return 'cloud_css';
}
public function get_always_available_endpoints() {
return array(
new Update_Cloud_CSS(),
);
}
public function display_critical_css() {
// Don't look for Critical CSS in the dashboard.
if ( is_admin() ) {
return;
}
// Don't show Critical CSS in customizer previews.
if ( is_customize_preview() ) {
return;
}
// Don't display Critical CSS, if current page load is by the Critical CSS generator.
if ( Generator::is_generating_critical_css() ) {
return;
}
// Get the Critical CSS to show.
$critical_css = $this->paths->get_current_request_css();
if ( ! $critical_css ) {
$keys = $this->paths->get_current_request_css_keys();
$pending = ( new Critical_CSS_State() )->has_pending_provider( $keys );
// If Cloud CSS is still generating and the user is logged in, render the status information in a comment.
if ( $pending && is_user_logged_in() ) {
$display = new Display_Critical_CSS( '/* ' . __( 'Jetpack Boost is currently generating critical css for this page', 'jetpack-boost' ) . ' */' );
add_action( 'wp_head', array( $display, 'display_critical_css' ), 0 );
}
return;
}
if ( defined( 'WP_DEBUG' ) && WP_DEBUG === true ) {
$critical_css = "/* Critical CSS Key: {$this->paths->get_current_critical_css_key()} */\n" . $critical_css;
}
$display = new Display_Critical_CSS( $critical_css );
add_action( 'wp_head', array( $display, 'display_critical_css' ), 0 );
add_filter( 'style_loader_tag', array( $display, 'asynchronize_stylesheets' ), 10, 4 );
add_action( 'wp_footer', array( $display, 'onload_flip_stylesheets' ) );
// Ensure admin bar compatibility.
Admin_Bar_Compatibility::init();
}
/**
* Create a Cloud CSS requests for provider groups.
*
* Initialize the Cloud CSS request. Provide $post parameter to limit generating to provider groups only associated
* with a specific post.
*/
public function generate_cloud_css( $reason, $providers = array() ) {
$grouped_urls = array();
foreach ( $providers as $source ) {
$provider = $source['key'];
$grouped_urls[ $provider ] = $source['urls'];
}
// Send the request to the Cloud.
$payload = array( 'providers' => $grouped_urls );
$payload['requestId'] = md5( wp_json_encode( $payload ) . time() );
$payload['reason'] = $reason;
return Boost_API::post( 'cloud-css', $payload );
}
/**
* Handle regeneration of Cloud CSS when a post is saved.
*/
public function handle_save_post( $post_id, $post ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
if ( ! $post || ! isset( $post->post_type ) || ! is_post_publicly_viewable( $post ) ) {
return;
}
$this->regenerate_cloud_css( self::REGENERATE_REASON_SAVE_POST, $this->get_all_providers( array( $post ) ) );
}
public function regenerate_cloud_css( $reason, $providers ) {
$result = $this->generate_cloud_css( $reason, $providers );
if ( is_wp_error( $result ) ) {
$state = new Critical_CSS_State();
$state->set_error( $result->get_error_message() )->save();
}
return $result;
}
/**
* Called when stored Critical CSS has been invalidated. Triggers a new Cloud CSS request.
*/
public function handle_critical_css_invalidated() {
$this->regenerate_cloud_css( self::REGENERATE_REASON_INVALIDATED, $this->get_all_providers() );
Cloud_CSS_Followup::schedule();
}
public function get_all_providers( $context_posts = array() ) {
$source_providers = new Source_Providers();
return $source_providers->get_provider_sources( $context_posts );
}
public function get_existing_sources() {
$state = new Critical_CSS_State();
$data = $state->get();
if ( ! empty( $data['providers'] ) ) {
$providers = $data['providers'];
} else {
$providers = $this->get_all_providers();
}
return $providers;
}
/**
* Updates the total problem count for Boost if something's
* wrong with Cloud CSS.
*
* @param int $count The current problem count.
*
* @return int
*/
public function update_total_problem_count( $count ) {
return ( new Critical_CSS_State() )->has_errors() ? ++$count : $count;
}
}