class.jetpack.php: 16.3-a.5 vs 13.0.2 · Jetpack – WP Security, Backup, Speed, & Growth

← All changes | class.jetpack.php +942 -1171 13.0.2 → 16.3-a.5 View file →

		@@ -7,32 +7,38 @@
7	7	* @package automattic/jetpack
8	8	*/
9	9
10	10	use Automattic\Jetpack\Assets;
11		-use Automattic\Jetpack\Assets\Logo as Jetpack_Logo;
12	11	use Automattic\Jetpack\Boost_Speed_Score\Speed_Score;
13	12	use Automattic\Jetpack\Config;
	13	+use Automattic\Jetpack\Connection\Authorize_Json_Api;
14	14	use Automattic\Jetpack\Connection\Client;
15		-use Automattic\Jetpack\Connection\Initial_State as Connection_Initial_State;
16	15	use Automattic\Jetpack\Connection\Manager as Connection_Manager;
17		-use Automattic\Jetpack\Connection\Nonce_Handler;
18	16	use Automattic\Jetpack\Connection\Rest_Authentication as Connection_Rest_Authentication;
19	17	use Automattic\Jetpack\Connection\Secrets;
20	18	use Automattic\Jetpack\Connection\Tokens;
21		-use Automattic\Jetpack\Connection\Utils as Connection_Utils;
	19	+use Automattic\Jetpack\Connection\Webhooks\Authorize_Redirect;
22	20	use Automattic\Jetpack\Constants;
23	21	use Automattic\Jetpack\CookieState;
24	22	use Automattic\Jetpack\Current_Plan as Jetpack_Plan;
25	23	use Automattic\Jetpack\Device_Detection\User_Agent_Info;
26	24	use Automattic\Jetpack\Errors;
	25	+use Automattic\Jetpack\Feature_Policy;
27	26	use Automattic\Jetpack\Files;
	27	+use Automattic\Jetpack\Heartbeat;
28	28	use Automattic\Jetpack\Identity_Crisis;
	29	+use Automattic\Jetpack\Import\Main as Import_Main;
29	30	use Automattic\Jetpack\Licensing;
30	31	use Automattic\Jetpack\Modules;
31	32	use Automattic\Jetpack\My_Jetpack\Initializer as My_Jetpack_Initializer;
	33	+use Automattic\Jetpack\Newsletter\Reader_Link;
32	34	use Automattic\Jetpack\Paths;
	35	+use Automattic\Jetpack\Plugin\Deprecate;
33	36	use Automattic\Jetpack\Plugin\Tracking as Plugin_Tracking;
	37	+use Automattic\Jetpack\Podcast\Podcast;
34	38	use Automattic\Jetpack\Redirect;
	39	+use Automattic\Jetpack\Scan_Page\Jetpack_Scan as Scan_Page_Init;
	40	+use Automattic\Jetpack\SEO\Initializer as Jetpack_SEO_Initializer;
35	41	use Automattic\Jetpack\Status;
36	42	use Automattic\Jetpack\Status\Host;
37	43	use Automattic\Jetpack\Status\Visitor;
38	44	use Automattic\Jetpack\Sync\Actions as Sync_Actions;
		@@ -39,9 +45,14 @@
39	45	use Automattic\Jetpack\Sync\Health;
40	46	use Automattic\Jetpack\Sync\Sender;
41	47	use Automattic\Jetpack\Terms_Of_Service;
42	48	use Automattic\Jetpack\Tracking;
	49	+use Automattic\Woocommerce_Analytics;
43	50
	51	+if ( ! defined( 'ABSPATH' ) ) {
	52	+ exit( 0 );
	53	+}
	54	+
44	55	/*
45	56	Options:
46	57	jetpack_options (array)
47	58	An array of options.
		@@ -76,74 +87,8 @@
76	87	*/
77	88	public $xmlrpc_server = null;
78	89
79	90	/**
80		- * List of Jetpack modules that have CSS that gets concatenated into jetpack.css.
81		- *
82		- * See $concatenated_style_handles for the list of handles,
83		- * and the implode_frontend_css method for more details.
84		- *
85		- * When updating this list, make sure to update $concatenated_style_handles as well.
86		- *
87		- * @var array List of Jetpack modules.
88		- */
89		- public $modules_with_concatenated_css = array(
90		- 'carousel',
91		- 'contact-form',
92		- 'infinite-scroll',
93		- 'likes',
94		- 'related-posts',
95		- 'sharedaddy',
96		- 'shortcodes',
97		- 'subscriptions',
98		- 'tiled-gallery',
99		- 'widgets',
100		- );
101		-
102		- /**
103		- * The handles of styles that are concatenated into jetpack.css.
104		- *
105		- * When making changes to that list,
106		- * you must also update concat_list in tools/webpack.config.css.js,
107		- * and to $modules_with_concatenated_css if necessary.
108		- *
109		- * @var array The handles of styles that are concatenated into jetpack.css.
110		- */
111		- public $concatenated_style_handles = array(
112		- 'jetpack-carousel-swiper-css',
113		- 'jetpack-carousel',
114		- 'grunion.css',
115		- 'the-neverending-homepage',
116		- 'jetpack_likes',
117		- 'jetpack_related-posts',
118		- 'sharedaddy',
119		- 'jetpack-slideshow',
120		- 'presentations',
121		- 'quiz',
122		- 'jetpack-subscriptions',
123		- 'jetpack-responsive-videos',
124		- 'jetpack-social-menu',
125		- 'tiled-gallery',
126		- 'jetpack_display_posts_widget',
127		- 'gravatar-profile-widget',
128		- 'goodreads-widget',
129		- 'jetpack_social_media_icons_widget',
130		- 'jetpack-top-posts-widget',
131		- 'jetpack_image_widget',
132		- 'jetpack-my-community-widget',
133		- 'jetpack-authors-widget',
134		- 'wordads',
135		- 'eu-cookie-law-style',
136		- 'flickr-widget-style',
137		- 'jetpack-search-widget',
138		- 'jetpack-simple-payments-widget-style',
139		- 'jetpack-widget-social-icons-styles',
140		- 'wpcom_instagram_widget',
141		- 'milestone-widget',
142		- 'subscribe-modal-css',
143		- );
144		-
145		- /**
146	91	* Contains all assets that have had their URL rewritten to minified versions.
147	92	*
148	93	* @var array
149	94	*/
		@@ -158,11 +103,8 @@
158	103	'contact-form' => array(
159	104	array( 'grunion-contact-form/grunion-contact-form.php', 'Grunion Contact Form' ),
160	105	array( 'mullet/mullet-contact-form.php', 'Mullet Contact Form' ),
161	106	),
162		- 'custom-css' => array(
163		- array( 'safecss/safecss.php', 'WordPress.com Custom CSS' ),
164		- ),
165	107	'gravatar-hovercards' => array(
166	108	array( 'jetpack-gravatar-hovercards/gravatar-hovercards.php', 'Jetpack Gravatar Hovercards' ),
167	109	),
168	110	'latex' => array(
		@@ -333,9 +275,8 @@
333	275	* Graph tags via filter when their Social Meta modules are active:
334	276	*
335	277	* - All in One SEO Pack, All in one SEO Pack Pro
336	278	* - WordPress SEO by Yoast, WordPress SEO Premium by Yoast
337		- * - SEOPress, SEOPress Pro
338	279	*
339	280	* Plugin authors: If you'd like to prevent Jetpack's Open Graph tag generation in your plugin, you can do so via this filter:
340	281	* add_filter( 'jetpack_enable_open_graph', '__return_false' );
341	282	*
		@@ -378,8 +319,10 @@
378	319	'wp-caregiver/wp-caregiver.php', // WP Caregiver.
379	320	'wp-facebook-like-send-open-graph-meta/wp-facebook-like-send-open-graph-meta.php', // WP Facebook Like Send & Open Graph Meta.
380	321	'wp-facebook-open-graph-protocol/wp-facebook-ogp.php', // WP Facebook Open Graph protocol.
381	322	'wp-ogp/wp-ogp.php', // WP-OGP.
	323	+ 'wp-seopress/seopress.php', // SEOPress.
	324	+ 'wp-seopress-pro/seopress-pro.php', // SEOPress Pro.
382	325	'zoltonorg-social-plugin/zosp.php', // Zolton.org Social Plugin.
383	326	'wp-fb-share-like-button/wp_fb_share-like_widget.php', // WP Facebook Like Button.
384	327	'open-graph-metabox/open-graph-metabox.php', // Open Graph Metabox.
385	328	'seo-by-rank-math/rank-math.php', // Rank Math.
		@@ -446,8 +389,10 @@
446	389
447	390	/**
448	391	* Verified data for JSON authorization request
449	392	*
	393	+ * @deprecated 13.4
	394	+ *
450	395	* @var array
451	396	*/
452	397	public $json_api_authorization_request = array();
453	398
		@@ -488,8 +433,16 @@
488	433	*/
489	434	public static $instance = false;
490	435
491	436	/**
	437	+ * Resolved answer for `is_premium_analytics_enabled()`, or null before the first call.
	438	+ *
	439	+ * @since 16.1
	440	+ * @var bool\|null
	441	+ */
	442	+ private static $premium_analytics_enabled = null;
	443	+
	444	+ /**
492	445	* Singleton
493	446	*
494	447	* @static
495	448	*/
		@@ -529,9 +482,9 @@
529	482	if ( array_diff( $unfiltered_modules, $modules ) ) {
530	483	self::update_active_modules( $modules );
531	484	}
532	485
533		- add_action( 'init', array( __CLASS__, 'activate_new_modules' ) );
	486	+ self::register_upgrade_init_hooks();
534	487
535	488	// Upgrade to 4.3.0.
536	489	if ( Jetpack_Options::get_option( 'identity_crisis_whitelist' ) ) {
537	490	Jetpack_Options::delete_option( 'identity_crisis_whitelist' );
		@@ -586,8 +539,16 @@
586	539	Jetpack_Options::delete_option( 'autoupdate_plugins' );
587	540	} // Should we have some type of fallback if something fails here?
588	541	}
589	542
	543	+ // Set the newsletter send default option for existing sites.
	544	+ if ( false === get_option( 'wpcom_newsletter_send_default' ) ) {
	545	+ add_option( 'wpcom_newsletter_send_default', 1 );
	546	+ }
	547	+
	548	+ // Its handler went with the Recommendations assistant.
	549	+ wp_clear_scheduled_hook( 'jetpack_recommend_videopress' );
	550	+
590	551	if ( did_action( 'wp_loaded' ) ) {
591	552	self::upgrade_on_load();
592	553	} else {
593	554	add_action(
		@@ -621,9 +582,8 @@
621	582	}
622	583
623	584	if (
624	585	class_exists( 'Jetpack_Sitemap_Manager' )
625		- && version_compare( JETPACK__VERSION, '5.3', '>=' )
626	586	) {
627	587	do_action( 'jetpack_sitemaps_purge_data' );
628	588	}
629	589
		@@ -638,9 +598,9 @@
638	598	* Also fires Action hooks for each newly activated and deactivated module.
639	599	*
640	600	* @param array $modules Array of active modules to be saved in options.
641	601	*
642		- * @return $success bool true for success, false for failure.
	602	+ * @return bool $success true for success, false for failure.
643	603	*/
644	604	public static function update_active_modules( $modules ) {
645	605	return ( new Modules() )->update_active( $modules );
646	606	}
		@@ -694,41 +654,17 @@
694	654	add_action( 'network_plugin_loaded', array( $this, 'add_configure_hook' ), 90 );
695	655	add_action( 'mu_plugin_loaded', array( $this, 'add_configure_hook' ), 90 );
696	656	add_action( 'plugins_loaded', array( $this, 'late_initialization' ), 90 );
697	657
698		- add_action( 'jetpack_verify_signature_error', array( $this, 'track_xmlrpc_error' ) );
699		-
700		- add_filter(
701		- 'jetpack_signature_check_token',
702		- array( __CLASS__, 'verify_onboarding_token' ),
703		- 10,
704		- 3
705		- );
706		-
707	658	/**
708	659	* Prepare Gutenberg Editor functionality
	660	+ *
	661	+ * The hooks previously here have been moved to modules/blocks.php but leaving this here pending
	662	+ * a longer investigation to see if code is expecting the Gutenberg class to always be available.
709	663	*/
710	664	require_once JETPACK__PLUGIN_DIR . 'class.jetpack-gutenberg.php';
711		- add_action( 'plugins_loaded', array( 'Jetpack_Gutenberg', 'load_independent_blocks' ) );
712		- add_action( 'plugins_loaded', array( 'Jetpack_Gutenberg', 'load_block_editor_extensions' ), 9 );
713		- /**
714		- * We've switched from enqueue_block_editor_assets to enqueue_block_assets in WP-Admin because the assets with the former are loaded on the main site-editor.php.
715		- *
716		- * With the latter, the assets are now loaded in the SE iframe; the implementation is now faster because Gutenberg doesn't need to inject the assets in the iframe on client-side.
717		- */
718		- if ( is_admin() ) {
719		- add_action( 'enqueue_block_assets', array( 'Jetpack_Gutenberg', 'enqueue_block_editor_assets' ) );
720		- } else {
721		- add_action( 'enqueue_block_editor_assets', array( 'Jetpack_Gutenberg', 'enqueue_block_editor_assets' ) );
722		- }
723		- add_filter( 'render_block', array( 'Jetpack_Gutenberg', 'display_deprecated_block_message' ), 10, 2 );
724		-
725	665	add_action( 'set_user_role', array( $this, 'maybe_clear_other_linked_admins_transient' ), 10, 3 );
726	666
727		- // Unlink user before deleting the user from WP.com.
728		- add_action( 'deleted_user', array( $this, 'disconnect_user' ), 10, 1 );
729		- add_action( 'remove_user_from_blog', array( $this, 'disconnect_user' ), 10, 1 );
730		-
731	667	add_action( 'jetpack_event_log', array( 'Jetpack', 'log' ), 10, 2 );
732	668
733	669	add_filter( 'login_url', array( $this, 'login_url' ), 10, 2 );
734	670	add_action( 'login_init', array( $this, 'login_init' ) );
		@@ -735,8 +671,13 @@
735	671
736	672	// Set up the REST authentication hooks.
737	673	Connection_Rest_Authentication::init();
738	674
	675	+ // Register Jetpack-specific connection tests (sync health, etc.) with the connection
	676	+ // package's health test suite. This runs on all requests (not just admin), because
	677	+ // the connection/test REST endpoint can be called outside admin context.
	678	+ add_action( 'jetpack_connection_tests_loaded', array( $this, 'register_jetpack_connection_tests' ) );
	679	+
739	680	add_action( 'admin_init', array( $this, 'admin_init' ) );
740	681	add_action( 'admin_init', array( $this, 'dismiss_jetpack_notice' ) );
741	682
742	683	add_filter( 'admin_body_class', array( $this, 'admin_body_class' ), 20 );
		@@ -750,11 +691,8 @@
750	691
751	692	// Returns HTTPS support status.
752	693	add_action( 'wp_ajax_jetpack-recheck-ssl', array( $this, 'ajax_recheck_ssl' ) );
753	694
754		- // TODO: the conneciton banner has been deprecated - this can be removed in 13.1+
755		- add_action( 'wp_ajax_jetpack_connection_banner', array( $this, 'jetpack_connection_banner_callback' ) );
756		-
757	695	add_action( 'wp_loaded', array( $this, 'register_assets' ) );
758	696
759	697	/**
760	698	* These actions run checks to load additional files.
		@@ -772,29 +710,8 @@
772	710
773	711	add_filter( 'jetpack_get_default_modules', array( $this, 'filter_default_modules' ) );
774	712	add_filter( 'jetpack_get_default_modules', array( $this, 'handle_deprecated_modules' ), 99 );
775	713
776		- require_once JETPACK__PLUGIN_DIR . 'class-jetpack-pre-connection-jitms.php';
777		- $jetpack_jitm_messages = ( new Jetpack_Pre_Connection_JITMs() );
778		- add_filter( 'jetpack_pre_connection_jitms', array( $jetpack_jitm_messages, 'add_pre_connection_jitms' ) );
779		-
780		- /*
781		- * If enabled, point edit post, page, and comment links to Calypso instead of WP-Admin.
782		- * We should make sure to only do this for front end links.
783		- */
784		- if ( self::get_option( 'edit_links_calypso_redirect' ) && ! is_admin() ) {
785		- add_filter( 'get_edit_post_link', array( $this, 'point_edit_post_links_to_calypso' ), 1, 2 );
786		- add_filter( 'get_edit_comment_link', array( $this, 'point_edit_comment_links_to_calypso' ), 1 );
787		-
788		- /*
789		- * We'll shortcircuit wp_notify_postauthor and wp_notify_moderator pluggable functions
790		- * so they point moderation links on emails to Calypso.
791		- */
792		- require_once JETPACK__PLUGIN_DIR . '_inc/lib/functions.wp-notify.php';
793		- add_filter( 'comment_notification_recipients', 'jetpack_notify_postauthor', 1, 2 );
794		- add_filter( 'notify_moderator', 'jetpack_notify_moderator', 1, 2 );
795		- }
796		-
797	714	add_action(
798	715	'plugins_loaded',
799	716	function () {
800	717	if ( User_Agent_Info::is_mobile_app() ) {
		@@ -805,18 +722,10 @@
805	722
806	723	// Update the site's Jetpack plan and products from API on heartbeats.
807	724	add_action( 'jetpack_heartbeat', array( Jetpack_Plan::class, 'refresh_from_wpcom' ) );
808	725
809		- /**
810		- * This is the hack to concatenate all css files into one.
811		- * For description and reasoning see the implode_frontend_css method.
812		- *
813		- * Super late priority so we catch all the registered styles.
814		- */
815		- if ( ! is_admin() ) {
816		- add_action( 'wp_print_styles', array( $this, 'implode_frontend_css' ), -1 ); // Run first.
817		- add_action( 'wp_print_footer_scripts', array( $this, 'implode_frontend_css' ), -1 ); // Run first to trigger before `print_late_styles`.
818		- }
	726	+ // The Connection package fetches the site record for `jetpack/v4/site`; reuse it to refresh the plan.
	727	+ add_action( 'jetpack_site_data_fetched', array( Jetpack_Plan::class, 'update_from_site_record' ) );
819	728
820	729	// Actually push the stats on shutdown.
821	730	if ( ! has_action( 'shutdown', array( $this, 'push_stats' ) ) ) {
822	731	add_action( 'shutdown', array( $this, 'push_stats' ) );
		@@ -824,8 +733,10 @@
824	733
825	734	// After a successful connection.
826	735	add_action( 'jetpack_site_registered', array( $this, 'activate_default_modules_on_site_register' ) );
827	736	add_action( 'jetpack_site_registered', array( $this, 'handle_unique_registrations_stats' ) );
	737	+ add_action( 'jetpack_site_registered', array( Reader_Link::class, 'activate_on_connection' ), 9 );
	738	+ add_action( 'jetpack_site_registered', array( \Automattic\Jetpack\Reprint_Export\Reprint_Exporter::class, 'discard_credentials' ) );
828	739
829	740	// Actions for Manager::authorize().
830	741	add_action( 'jetpack_authorize_starting', array( $this, 'authorize_starting' ) );
831	742	add_action( 'jetpack_authorize_ending_linked', array( $this, 'authorize_ending_linked' ) );
		@@ -830,8 +741,9 @@
830	741	add_action( 'jetpack_authorize_starting', array( $this, 'authorize_starting' ) );
831	742	add_action( 'jetpack_authorize_ending_linked', array( $this, 'authorize_ending_linked' ) );
832	743	add_action( 'jetpack_authorize_ending_authorized', array( $this, 'authorize_ending_authorized' ) );
833	744
	745	+ Jetpack_Client_Server::init();
834	746	add_action( 'jetpack_client_authorize_error', array( Jetpack_Client_Server::class, 'client_authorize_error' ) );
835	747	add_filter( 'jetpack_client_authorize_already_authorized_url', array( Jetpack_Client_Server::class, 'client_authorize_already_authorized_url' ) );
836	748	add_action( 'jetpack_client_authorize_processing', array( Jetpack_Client_Server::class, 'client_authorize_processing' ) );
837	749	add_filter( 'jetpack_client_authorize_fallback_url', array( Jetpack_Client_Server::class, 'client_authorize_fallback_url' ) );
		@@ -836,9 +748,9 @@
836	748	add_action( 'jetpack_client_authorize_processing', array( Jetpack_Client_Server::class, 'client_authorize_processing' ) );
837	749	add_filter( 'jetpack_client_authorize_fallback_url', array( Jetpack_Client_Server::class, 'client_authorize_fallback_url' ) );
838	750
839	751	// Filters for the Manager::get_token() urls and request body.
840		- add_filter( 'jetpack_token_redirect_url', array( __CLASS__, 'filter_connect_redirect_url' ) );
	752	+ add_filter( 'jetpack_token_redirect_url', array( Authorize_Redirect::class, 'filter_connect_redirect_url' ) );
841	753	add_filter( 'jetpack_token_request_body', array( __CLASS__, 'filter_token_request_body' ) );
842	754
843	755	// Filter for the `jetpack/v4/connection/data` API response.
844	756	add_filter( 'jetpack_current_user_connection_data', array( __CLASS__, 'filter_jetpack_current_user_connection_data' ) );
		@@ -864,13 +776,142 @@
864	776
865	777	// Register product descriptions for partner coupon usage.
866	778	add_filter( 'jetpack_partner_coupon_products', array( $this, 'get_partner_coupon_product_descriptions' ) );
867	779
868		- // Actions for conditional recommendations.
869		- add_action( 'plugins_loaded', array( 'Jetpack_Recommendations', 'init_conditional_recommendation_actions' ) );
	780	+ // Add 5-star
	781	+ add_filter( 'plugin_row_meta', array( $this, 'add_5_star_review_link' ), 10, 2 );
	782	+ add_action( 'init', array( Deprecate::class, 'instance' ) );
	783	+
	784	+ // Register Jetpack module management abilities (WordPress Abilities API, WP 6.9+).
	785	+ \Automattic\Jetpack\Plugin\Abilities\Modules_Abilities::init();
	786	+
	787	+ // Register Connection abilities (WordPress Abilities API, WP 6.9+). Scoped to the
	788	+ // Jetpack plugin for now: the Connection package no longer auto-wires these, so
	789	+ // connection-only consumers (Boost, Protect, Search, etc.) do not register them yet.
	790	+ \Automattic\Jetpack\Connection\Abilities\Connection_Abilities::init();
870	791	}
871	792
872	793	/**
	794	+ * Whether the current request should eagerly initialize the admin/REST-only
	795	+ * packages (the Import package and My Jetpack) now, at `plugins_loaded` time.
	796	+ *
	797	+ * Returns true for admin, cron, POST, and WP-CLI requests — the contexts,
	798	+ * knowable this early, where those packages have work to do. Returns false
	799	+ * for a plain front-end GET and for a REST request: the two can't be told
	800	+ * apart yet (this runs before `rest_api_init`), so callers defer the REST
	801	+ * case by initializing the package on `rest_api_init` instead, while a plain
	802	+ * page view never fires that hook and so loads nothing. This keeps
	803	+ * admin/REST-only PHP out of opcache on the front-end GET hot path.
	804	+ *
	805	+ * No in-repo code depends on the deferral. The one externally observable
	806	+ * change is timing: the packages' documented init hooks
	807	+ * (`jetpack_import_initialized`, `jetpack_feature_import_enabled`, and
	808	+ * `my_jetpack_init`) no longer fire on a plain front-end GET — they fire on
	809	+ * the admin, cron, POST, WP-CLI, and REST requests where the packages load.
	810	+ *
	811	+ * @return bool
	812	+ */
	813	+ private static function should_eager_load_packages() {
	814	+ $is_post_request = isset( $_SERVER['REQUEST_METHOD'] ) && 'POST' === strtoupper( sanitize_text_field( wp_unslash( $_SERVER['REQUEST_METHOD'] ) ) );
	815	+ $is_wp_cli = Constants::is_true( 'WP_CLI' );
	816	+
	817	+ return is_admin() \|\| wp_doing_cron() \|\| $is_post_request \|\| $is_wp_cli;
	818	+ }
	819	+
	820	+ /**
	821	+ * Configure the Import package from a deferred hook.
	822	+ *
	823	+ * The eager path uses Config::ensure( 'import' ), but the deferred REST path
	824	+ * runs after Config::on_plugins_loaded() has already processed its feature
	825	+ * flags, so it needs a hookable bootstrap callback. Preserve Config's
	826	+ * feature-enabled action for hook consumers.
	827	+ *
	828	+ * @since 16.0
	829	+ *
	830	+ * @return void
	831	+ */
	832	+ public static function configure_import_package() {
	833	+ if ( class_exists( Import_Main::class ) ) {
	834	+ Import_Main::configure();
	835	+
	836	+ if ( ! did_action( 'jetpack_feature_import_enabled' ) ) {
	837	+ do_action( 'jetpack_feature_import_enabled' );
	838	+ }
	839	+ }
	840	+ }
	841	+
	842	+ /**
	843	+ * Whether the bundled Stats v2 dashboard is enabled.
	844	+ *
	845	+ * Stats v2 (formerly "Premium Analytics") ships with the plugin behind this
	846	+ * flag while it rolls out (WOOA7S-1595). When enabled it adds its own admin
	847	+ * menu alongside the existing Stats UI; it never replaces or hides the
	848	+ * legacy Stats menu, admin-bar entries, post-list column, or WP dashboard
	849	+ * widget. The Stats module's tracking is unaffected either way, and Stats v2
	850	+ * reads what that module collects, so while the module is off the plugin
	851	+ * answers false here before even reading the flag.
	852	+ *
	853	+ * The package has to be loadable for this to be true, so a site with the
	854	+ * flag on but a missing package answers false here and never adds the
	855	+ * Stats v2 menu (a warning is logged instead).
	856	+ *
	857	+ * @since 16.1
	858	+ *
	859	+ * @return bool
	860	+ */
	861	+ public static function is_premium_analytics_enabled() {
	862	+ if ( null !== self::$premium_analytics_enabled ) {
	863	+ return self::$premium_analytics_enabled;
	864	+ }
	865	+
	866	+ if ( ! self::is_module_active( 'stats' ) ) {
	867	+ self::$premium_analytics_enabled = false;
	868	+ return false;
	869	+ }
	870	+
	871	+ /**
	872	+ * Filters whether the bundled Premium Analytics dashboard is enabled.
	873	+ *
	874	+ * Resolved once, from `Jetpack::configure()` on `plugins_loaded`, and only
	875	+ * while the Stats module is active. Register this from a mu-plugin or a
	876	+ * plugin's main file — a callback added on `plugins_loaded` or later runs
	877	+ * too late to be seen.
	878	+ *
	879	+ * @since 16.1
	880	+ *
	881	+ * @param bool $enabled Defaults to the `jetpack_premium_analytics_enabled` option (false).
	882	+ */
	883	+ $flag = (bool) apply_filters( 'jetpack_premium_analytics_enabled', (bool) get_option( 'jetpack_premium_analytics_enabled' ) );
	884	+
	885	+ self::$premium_analytics_enabled = $flag && class_exists( 'Automattic\Jetpack\PremiumAnalytics\Analytics' );
	886	+
	887	+ if ( $flag && ! self::$premium_analytics_enabled ) {
	888	+ wp_trigger_error(
	889	+ __METHOD__,
	890	+ 'The jetpack_premium_analytics_enabled flag is on but the Premium Analytics package is not loadable; keeping the Stats UI in place.'
	891	+ );
	892	+ }
	893	+
	894	+ return self::$premium_analytics_enabled;
	895	+ }
	896	+
	897	+ /**
	898	+ * Expose the setting that turns the Premium Analytics dashboard on and off.
	899	+ *
	900	+ * Deliberately not behind is_premium_analytics_enabled(): this is the setting that flips that
	901	+ * check, so it has to answer while the dashboard is still off.
	902	+ *
	903	+ * @since 16.2
	904	+ *
	905	+ * @return void
	906	+ */
	907	+ public static function register_premium_analytics_enablement_setting() {
	908	+ if ( class_exists( 'Automattic\Jetpack\PremiumAnalytics\Enablement_Setting' ) ) {
	909	+ \Automattic\Jetpack\PremiumAnalytics\Enablement_Setting::register();
	910	+ }
	911	+ }
	912	+
	913	+ /**
873	914	* Before everything else starts getting initalized, we need to initialize Jetpack using the
874	915	* Config object.
875	916	*/
876	917	public function configure() {
		@@ -879,13 +920,10 @@
879	920	foreach (
880	921	array(
881	922	'jitm',
882	923	'sync',
	924	+ 'account_protection',
883	925	'waf',
884		- 'videopress',
885		- 'stats',
886		- 'stats_admin',
887		- 'import',
888	926	)
889	927	as $feature
890	928	) {
891	929	$config->ensure( $feature );
		@@ -890,8 +928,103 @@
890	928	) {
891	929	$config->ensure( $feature );
892	930	}
893	931
	932	+ // Enable the VideoPress admin UI (the "Jetpack > VideoPress" dashboard) inside the
	933	+ // Jetpack plugin, mirroring the standalone Jetpack VideoPress plugin. The dashboard
	934	+ // only renders when the VideoPress module is active (Status::is_active()); when it
	935	+ // is not, the menu item links to the My Jetpack interstitial to activate it.
	936	+ $config->ensure( 'videopress', array( 'admin_ui' => true ) );
	937	+
	938	+ /*
	939	+ * The Import package only registers `jetpack/v4/import` REST routes — it
	940	+ * does nothing when rendering a front-end page — so gate its `ensure()`
	941	+ * to keep its PHP out of opcache on the front-end GET hot path. It still
	942	+ * loads on admin, cron, POST, and WP-CLI requests, and on `rest_api_init`
	943	+ * for REST: a REST request can't be identified yet at `plugins_loaded`
	944	+ * (this runs before `Config::on_plugins_loaded`, and `rest_api_init`
	945	+ * fires later), so it is initialized directly when that hook fires, while
	946	+ * a plain page view never fires it and so loads nothing.
	947	+ *
	948	+ * JITM stays eager (above): unlike Import, its `register()` adds a
	949	+ * `jetpack_sync_before_send_updated_option` filter that records the
	950	+ * `jetpack_last_plugin_sync` transient, and a Jetpack Sync send can fire
	951	+ * on a plain front-end GET — including the dedicated-sync `spawn-sync`
	952	+ * GET, which runs on `init` and exits before `rest_api_init`. Deferring
	953	+ * JITM would skip that bookkeeping and leave its message cache stale after
	954	+ * a plugin change, so it loads on every request as before.
	955	+ */
	956	+ if ( self::should_eager_load_packages() ) {
	957	+ $config->ensure( 'import' );
	958	+ } else {
	959	+ add_action(
	960	+ 'rest_api_init',
	961	+ array( __CLASS__, 'configure_import_package' ),
	962	+ 0
	963	+ );
	964	+ }
	965	+
	966	+ /*
	967	+ * The Stats and Stats Admin packages only do work when the Stats module
	968	+ * is active (the front-end tracking pixel) or on wp-admin, REST, cron,
	969	+ * POST, and WP-CLI requests: the Stats dashboard page, the stats /
	970	+ * stats-app REST endpoints (which the block editor also calls for
	971	+ * email-open rates), the transient-cleanup cron, the connection
	972	+ * package's package-version tracker (which runs on POSTs and reads the
	973	+ * `jetpack_package_versions` filter that Stats registers), and CLI
	974	+ * introspection such as the heartbeat inspector. On a plain front-end
	975	+ * GET page view with the module off they are inert: the pixel
	976	+ * short-circuits on `Stats\Main::should_track()` and every other entry
	977	+ * point only hooks rest_api_init, admin, cron, the POST-only tracker, or
	978	+ * is reached through WP-CLI.
	979	+ * Skip loading them — and eagerly constructing the Stats Admin REST
	980	+ * controller — on that hot path to keep their PHP out of opcache, but
	981	+ * keep loading them everywhere else exactly as before so the stats REST
	982	+ * permission mapping (view_stats, registered by Stats\Main), the
	983	+ * editor's stats-app calls, the cleanup cron, and the package-version
	984	+ * tracker are all unchanged.
	985	+ *
	986	+ * REST requests are not yet identifiable here (REST_REQUEST is defined
	987	+ * after plugins_loaded), so defer those to rest_api_init. Call the
	988	+ * package initializers directly rather than `$config->ensure()`: ensure()
	989	+ * only flags a feature for `Config::on_plugins_loaded()` (plugins_loaded
	990	+ * priority 2), which has already run by the time rest_api_init fires.
	991	+ * Priority 0 runs before each package's own priority-10 route
	992	+ * registration, so their routes still register within the same dispatch.
	993	+ * A plain page view never fires rest_api_init, so the packages stay
	994	+ * unloaded there. See JETPACK-1747.
	995	+ */
	996	+ $is_post_request = isset( $_SERVER['REQUEST_METHOD'] ) && 'POST' === $_SERVER['REQUEST_METHOD'];
	997	+ $is_wp_cli = defined( 'WP_CLI' ) && WP_CLI;
	998	+
	999	+ if ( self::is_module_active( 'stats' ) \|\| is_admin() \|\| wp_doing_cron() \|\| $is_post_request \|\| $is_wp_cli ) {
	1000	+ $config->ensure( 'stats' );
	1001	+ $config->ensure( 'stats_admin' );
	1002	+ } else {
	1003	+ add_action(
	1004	+ 'rest_api_init',
	1005	+ static function () {
	1006	+ if ( class_exists( 'Automattic\Jetpack\Stats\Main' ) ) {
	1007	+ \Automattic\Jetpack\Stats\Main::init();
	1008	+ }
	1009	+ if ( class_exists( 'Automattic\Jetpack\Stats_Admin\Main' ) ) {
	1010	+ \Automattic\Jetpack\Stats_Admin\Main::init();
	1011	+ }
	1012	+ },
	1013	+ 0
	1014	+ );
	1015	+ }
	1016	+
	1017	+ // Stats v2 (WOOA7S-1595). Unlike Stats above it cannot be deferred when enabled — see
	1018	+ // Analytics::init() for why, and for why it takes no menu_title here.
	1019	+ if ( self::is_premium_analytics_enabled() ) {
	1020	+ \Automattic\Jetpack\PremiumAnalytics\Analytics::init();
	1021	+ }
	1022	+
	1023	+ // Outside the check above on purpose — see Enablement_Setting. Deferred like Stats, to keep
	1024	+ // the autoload off the front-end hot path.
	1025	+ add_action( 'rest_api_init', array( __CLASS__, 'register_premium_analytics_enablement_setting' ), 0 );
	1026	+
894	1027	$config->ensure(
895	1028	'connection',
896	1029	array(
897	1030	'slug' => 'jetpack',
		@@ -909,12 +1042,8 @@
909	1042	);
910	1043
911	1044	$config->ensure( 'search' );
912	1045
913		- if ( defined( 'ENABLE_WORDADS_SHARED_UI' ) && ENABLE_WORDADS_SHARED_UI ) {
914		- $config->ensure( 'wordads' );
915		- }
916		-
917	1046	if ( ! $this->connection_manager ) {
918	1047	$this->connection_manager = new Connection_Manager( 'jetpack' );
919	1048	}
920	1049
		@@ -922,8 +1051,10 @@
922	1051	if ( $modules->is_active( 'publicize' ) && $this->connection_manager->has_connected_user() ) {
923	1052	$config->ensure( 'publicize' );
924	1053	}
925	1054
	1055	+ add_action( 'jetpack_initialize_tracking', array( $this, 'initialize_tracking' ) );
	1056	+
926	1057	/*
927	1058	* Load things that should only be in Network Admin.
928	1059	*
929	1060	* For now blow away everything else until a more full
		@@ -938,8 +1069,9 @@
938	1069	$is_connection_ready = self::is_connection_ready();
939	1070
940	1071	if ( $is_connection_ready ) {
941	1072	add_action( 'login_form_jetpack_json_api_authorization', array( $this, 'login_form_json_api_authorization' ) );
	1073	+ $this->run_initialize_tracking_action();
942	1074
943	1075	Jetpack_Heartbeat::init();
944	1076	if ( self::is_module_active( 'stats' ) && self::is_module_active( 'search' ) ) {
945	1077	require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-search-performance-logger.php';
		@@ -944,8 +1076,19 @@
944	1076	if ( self::is_module_active( 'stats' ) && self::is_module_active( 'search' ) ) {
945	1077	require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-search-performance-logger.php';
946	1078	Jetpack_Search_Performance_Logger::init();
947	1079	}
	1080	+ } else {
	1081	+ add_action( 'jetpack_agreed_to_terms_of_service', array( $this, 'run_initialize_tracking_action' ) );
	1082	+ add_action( 'rest_api_init', array( $this, 'run_initialize_tracking_action' ) );
	1083	+ add_filter(
	1084	+ 'xmlrpc_methods',
	1085	+ function ( $methods ) {
	1086	+ $this->run_initialize_tracking_action();
	1087	+ return $methods;
	1088	+ },
	1089	+ 1
	1090	+ );
948	1091	}
949	1092
950	1093	// Initialize remote file upload request handlers.
951	1094	$this->add_remote_request_handlers();
		@@ -955,20 +1098,10 @@
955	1098	*/
956	1099	if ( $is_connection_ready ) {
957	1100	require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-iframe-embed.php';
958	1101	add_action( 'init', array( 'Jetpack_Iframe_Embed', 'init' ), 9, 0 );
959		- require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-keyring-service-helper.php';
960		- add_action( 'init', array( 'Jetpack_Keyring_Service_Helper', 'init' ), 9, 0 );
	1102	+ add_action( 'rest_api_init', array( $this, 'maybe_initialize_rest_jsonapi' ) );
961	1103	}
962		-
963		- if ( ( new Tracking( 'jetpack', $this->connection_manager ) )->should_enable_tracking( new Terms_Of_Service(), new Status() ) ) {
964		- add_action( 'init', array( new Plugin_Tracking(), 'init' ) );
965		- } else {
966		- /**
967		- * Initialize tracking right after the user agrees to the terms of service.
968		- */
969		- add_action( 'jetpack_agreed_to_terms_of_service', array( new Plugin_Tracking(), 'init' ) );
970		- }
971	1104	}
972	1105
973	1106	/**
974	1107	* Runs on plugins_loaded. Use this to add code that needs to be executed later than other
		@@ -976,16 +1109,58 @@
976	1109	*
977	1110	* @action plugins_loaded
978	1111	*/
979	1112	public function late_initialization() {
980		- add_action( 'plugins_loaded', array( 'Jetpack', 'load_modules' ), 100 );
	1113	+ add_action( 'after_setup_theme', array( 'Jetpack', 'load_modules' ), -2 );
981	1114
982		- My_Jetpack_Initializer::init();
	1115	+ /*
	1116	+ * My Jetpack is a wp-admin dashboard. Its Initializer::init() only wires
	1117	+ * up admin-menu, admin_init, and rest_api_init surfaces — and eagerly
	1118	+ * loads every product class (backup, boost, protect, …) just to register
	1119	+ * admin plugin-action links — so none of it is needed on a plain
	1120	+ * front-end GET page view. (The pieces that do immediate work, e.g.
	1121	+ * Connection REST authentication and Licensing, are already initialized
	1122	+ * unconditionally in Jetpack's constructor, so they are unaffected here.)
	1123	+ *
	1124	+ * Gate the call to the request types where My Jetpack actually does work.
	1125	+ * REST can't be detected yet at plugins_loaded, so initialize on
	1126	+ * rest_api_init for that branch; a plain page view never fires it, so My
	1127	+ * Jetpack stays unloaded there.
	1128	+ */
	1129	+ if ( self::should_eager_load_packages() ) {
	1130	+ My_Jetpack_Initializer::init();
	1131	+ } else {
	1132	+ add_action( 'rest_api_init', array( My_Jetpack_Initializer::class, 'init' ), 0 );
	1133	+ }
983	1134
984		- // Initialize Boost Speed Score
985		- $modules = Jetpack_Boost_Modules::init();
986		- new Speed_Score( $modules, 'jetpack-dashboard' );
	1135	+ Scan_Page_Init::initialize();
	1136	+ Jetpack_SEO_Initializer::init();
987	1137
	1138	+ if ( ( new Modules() )->is_active( 'podcast' ) ) {
	1139	+ Podcast::init();
	1140	+ }
	1141	+
	1142	+ /*
	1143	+ * Initialize Boost Speed Score. It only does work on REST requests (the
	1144	+ * dashboard speed-score endpoints) and on a few Jetpack Boost lifecycle
	1145	+ * actions, so defer constructing it — and loading the boost-speed-score
	1146	+ * package classes — until one of those hooks actually fires instead of on
	1147	+ * every request. Priority 0 ensures the object's own callbacks (added in
	1148	+ * its constructor at the default priority) still run for the firing hook.
	1149	+ */
	1150	+ $initialize_speed_score = static function () {
	1151	+ static $initialized = false;
	1152	+ if ( $initialized ) {
	1153	+ return;
	1154	+ }
	1155	+ $initialized = true;
	1156	+ new Speed_Score( array(), 'jetpack-dashboard' );
	1157	+ };
	1158	+ add_action( 'rest_api_init', $initialize_speed_score, 0 );
	1159	+ add_action( 'jetpack_boost_deactivate', $initialize_speed_score, 0 );
	1160	+ add_action( 'jetpack_boost_environment_changed', $initialize_speed_score, 0 );
	1161	+ add_action( 'handle_environment_change', $initialize_speed_score, 0 );
	1162	+
988	1163	/**
989	1164	* Fires when Jetpack is fully loaded and ready. This is the point where it's safe
990	1165	* to instantiate classes from packages and namespaces that are managed by the Jetpack Autoloader.
991	1166	*
		@@ -1023,8 +1198,10 @@
1023	1198
1024	1199	/**
1025	1200	* Redirect edit post links to Calypso.
1026	1201	*
	1202	+ * @deprecated since 13.9
	1203	+ *
1027	1204	* @param string $default_url Post edit URL.
1028	1205	* @param int $post_id Post ID.
1029	1206	*
1030	1207	* @return string
		@@ -1029,8 +1206,10 @@
1029	1206	*
1030	1207	* @return string
1031	1208	*/
1032	1209	public function point_edit_post_links_to_calypso( $default_url, $post_id ) {
	1210	+ _deprecated_function( __METHOD__, '13.9' );
	1211	+
1033	1212	$post = get_post( $post_id );
1034	1213
1035	1214	if ( empty( $post ) ) {
1036	1215	return $default_url;
		@@ -1061,13 +1240,17 @@
1061	1240
1062	1241	/**
1063	1242	* Redirect edit comment links to Calypso.
1064	1243	*
	1244	+ * @deprecated since 13.9
	1245	+ *
1065	1246	* @param string $url Comment edit URL.
1066	1247	*
1067	1248	* @return string
1068	1249	*/
1069	1250	public function point_edit_comment_links_to_calypso( $url ) {
	1251	+ _deprecated_function( __METHOD__, '13.9' );
	1252	+
1070	1253	// Take the `query` key value from the URL, and parse its parts to the $query_args. `amp;c` matches the comment ID.
1071	1254	$query_args = null;
1072	1255	wp_parse_str( wp_parse_url( $url, PHP_URL_QUERY ), $query_args );
1073	1256
		@@ -1086,30 +1269,16 @@
1086	1269	*
1087	1270	* @return array list of callables.
1088	1271	*/
1089	1272	public function filter_sync_callable_whitelist( $callables ) {
1090		-
1091	1273	// Jetpack Functions.
1092	1274	$jetpack_callables = array(
1093	1275	'single_user_site' => array( 'Jetpack', 'is_single_user_site' ),
1094	1276	'updates' => array( 'Jetpack', 'get_updates' ),
1095	1277	'available_jetpack_blocks' => array( 'Jetpack_Gutenberg', 'get_availability' ), // Includes both Gutenberg blocks and plugins.
	1278	+ 'theme_styles' => array( 'Automattic\\Jetpack\\Plugin\\Theme_Styles_Sync', 'get_theme_styles' ),
1096	1279	);
1097		- $callables = array_merge( $callables, $jetpack_callables );
1098		-
1099		- // Jetpack_SSO_Helpers.
1100		- if ( include_once JETPACK__PLUGIN_DIR . 'modules/sso/class.jetpack-sso-helpers.php' ) {
1101		- $sso_helpers = array(
1102		- 'sso_is_two_step_required' => array( 'Jetpack_SSO_Helpers', 'is_two_step_required' ),
1103		- 'sso_should_hide_login_form' => array( 'Jetpack_SSO_Helpers', 'should_hide_login_form' ),
1104		- 'sso_match_by_email' => array( 'Jetpack_SSO_Helpers', 'match_by_email' ),
1105		- 'sso_new_user_override' => array( 'Jetpack_SSO_Helpers', 'new_user_override' ),
1106		- 'sso_bypass_default_login_form' => array( 'Jetpack_SSO_Helpers', 'bypass_login_forward_wpcom' ),
1107		- );
1108		- $callables = array_merge( $callables, $sso_helpers );
1109		- }
1110		-
1111		- return $callables;
	1280	+ return array_merge( $callables, $jetpack_callables );
1112	1281	}
1113	1282
1114	1283	/**
1115	1284	* Extend Sync multisite callables with Jetpack Plugin functions.
		@@ -1134,41 +1303,8 @@
1134	1303	return $callables;
1135	1304	}
1136	1305
1137	1306	/**
1138		- * Deprecated
1139		- * Please use Automattic\Jetpack\JITMS\JITM::jetpack_track_last_sync_callback instead.
1140		- *
1141		- * @param array $params The action parameters.
1142		- *
1143		- * @deprecated since 9.8.
1144		- */
1145		- public function jetpack_track_last_sync_callback( $params ) {
1146		- _deprecated_function( __METHOD__, 'jetpack-9.8', '\Automattic\Jetpack\JITMS\JITM->jetpack_track_last_sync_callback' );
1147		- return Automattic\Jetpack\JITMS\JITM::get_instance()->jetpack_track_last_sync_callback( $params );
1148		- }
1149		-
1150		- /**
1151		- * Jetpack Connection banner callback function.
1152		- *
1153		- * @return void
1154		- */
1155		- public function jetpack_connection_banner_callback() {
1156		- check_ajax_referer( 'jp-connection-banner-nonce', 'nonce' );
1157		-
1158		- // Disable the banner dismiss functionality if the pre-connection prompt helpers filter is set.
1159		- if (
1160		- isset( $_REQUEST['dismissBanner'] ) &&
1161		- ! Jetpack_Connection_Banner::force_display()
1162		- ) {
1163		- Jetpack_Options::update_option( 'dismissed_connection_banner', 1 );
1164		- wp_send_json_success();
1165		- }
1166		-
1167		- wp_die();
1168		- }
1169		-
1170		- /**
1171	1307	* If there are any stats that need to be pushed, but haven't been, push them now.
1172	1308	*/
1173	1309	public function push_stats() {
1174	1310	if ( ! empty( $this->stats ) ) {
		@@ -1183,16 +1319,8 @@
1183	1319	* @param string $cap Capability name.
1184	1320	*/
1185	1321	public function jetpack_custom_caps( $caps, $cap ) {
1186	1322	switch ( $cap ) {
1187		- case 'jetpack_manage_modules':
1188		- case 'jetpack_activate_modules':
1189		- case 'jetpack_deactivate_modules':
1190		- $caps = array( 'manage_options' );
1191		- break;
1192		- case 'jetpack_configure_modules':
1193		- $caps = array( 'manage_options' );
1194		- break;
1195	1323	case 'jetpack_manage_autoupdates':
1196	1324	$caps = array(
1197	1325	'manage_options',
1198	1326	'update_plugins',
		@@ -1210,9 +1338,9 @@
1210	1338	if ( $is_offline_mode ) {
1211	1339	$caps = array( 'manage_options' );
1212	1340	break;
1213	1341	} else {
1214		- $caps = array( 'read' );
	1342	+ $caps = array( 'edit_posts' );
1215	1343	}
1216	1344	break;
1217	1345	}
1218	1346	return $caps;
		@@ -1371,9 +1499,9 @@
1371	1499	}
1372	1500	/**
1373	1501	* Does the network allow admins to add new users.
1374	1502	*
1375		- * @return boolian
	1503	+ * @return bool
1376	1504	*/
1377	1505	public static function network_add_new_users() {
1378	1506	return (bool) get_site_option( 'add_new_users' );
1379	1507	}
		@@ -1380,9 +1508,9 @@
1380	1508	/**
1381	1509	* File upload psace left per site in MB.
1382	1510	* -1 means NO LIMIT.
1383	1511	*
1384		- * @return number
	1512	+ * @return int
1385	1513	*/
1386	1514	public static function network_site_upload_space() {
1387	1515	// value in MB.
1388	1516	return ( get_site_option( 'upload_space_check_disabled' ) ? -1 : get_space_allowed() );
		@@ -1399,9 +1527,9 @@
1399	1527
1400	1528	/**
1401	1529	* Maximum file upload size set by the network.
1402	1530	*
1403		- * @return number
	1531	+ * @return int
1404	1532	*/
1405	1533	public static function network_max_upload_file_size() {
1406	1534	// value in KB.
1407	1535	return get_site_option( 'fileupload_maxk', 300 );
		@@ -1655,44 +1783,8 @@
1655	1783	return apply_filters( 'jetpack_is_connection_ready', self::connection()->is_connected(), self::connection() );
1656	1784	}
1657	1785
1658	1786	/**
1659		- * Deprecated: Is Jetpack in development (offline) mode?
1660		- *
1661		- * This static method is being left here intentionally without the use of _deprecated_function(), as other plugins
1662		- * and themes still use it, and we do not want to flood them with notices.
1663		- *
1664		- * Please use Automattic\Jetpack\Status()->is_offline_mode() instead.
1665		- *
1666		- * @deprecated since 8.0.
1667		- */
1668		- public static function is_development_mode() {
1669		- _deprecated_function( __METHOD__, 'jetpack-8.0', '\Automattic\Jetpack\Status->is_offline_mode' );
1670		- return ( new Status() )->is_offline_mode();
1671		- }
1672		-
1673		- /**
1674		- * Whether the site is currently onboarding or not.
1675		- * A site is considered as being onboarded if it currently has an onboarding token.
1676		- *
1677		- * @since 5.8
1678		- * @deprecated Use \Automattic\Jetpack\Status()->is_onboarding()
1679		- *
1680		- * @access public
1681		- * @static
1682		- *
1683		- * @return bool True if the site is currently onboarding, false otherwise
1684		- */
1685		- public static function is_onboarding() {
1686		- _deprecated_function( __METHOD__, 'jetpack-10.9', 'Automattic\\Jetpack\\Status\\is_onboarding' );
1687		-
1688		- if ( ! method_exists( 'Automattic\Jetpack\Status', 'is_onboarding' ) ) {
1689		- return Jetpack_Options::get_option( 'onboarding' ) !== false;
1690		- }
1691		- return ( new Status() )->is_onboarding();
1692		- }
1693		-
1694		- /**
1695	1787	* Determines reason for Jetpack offline mode.
1696	1788	*/
1697	1789	public static function development_mode_trigger_text() {
1698	1790	$status = new Status();
		@@ -1706,11 +1798,10 @@
1706	1798	} elseif ( defined( 'WP_LOCAL_DEV' ) && WP_LOCAL_DEV ) {
1707	1799	$notice = __( 'The WP_LOCAL_DEV constant is defined in wp-config.php or elsewhere.', 'jetpack' );
1708	1800	} elseif ( $status->is_local_site() ) {
1709	1801	$notice = __( 'The site URL is a known local development environment URL (e.g. http://localhost).', 'jetpack' );
1710		- /** This filter is documented in packages/status/src/class-status.php */
1711		- } elseif ( has_filter( 'jetpack_development_mode' ) && apply_filters( 'jetpack_development_mode', false ) ) { // This is a deprecated filter name.
1712		- $notice = __( 'The jetpack_development_mode filter is set to true.', 'jetpack' );
	1802	+ } elseif ( get_option( 'jetpack_offline_mode' ) ) {
	1803	+ $notice = __( 'The jetpack_offline_mode option is set to true.', 'jetpack' );
1713	1804	} else {
1714	1805	$notice = __( 'The jetpack_offline_mode filter is set to true.', 'jetpack' );
1715	1806	}
1716	1807
		@@ -1740,15 +1831,8 @@
1740	1831	$notice = sprintf( __( 'You are currently running a development version of Jetpack. <a href="%s" target="_blank">Submit your feedback</a>', 'jetpack' ), esc_url( Redirect::get_url( 'jetpack-contact-support-beta-group' ) ) );
1741	1832
1742	1833	echo '<div class="updated" style="border-color: #f0821e;"><p>' . $notice . '</p></div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- All provided text.
1743	1834	}
1744		- // Throw up a notice if using staging mode.
1745		- if ( ( new Status() )->is_staging_site() ) {
1746		- /* translators: %s is a URL */
1747		- $notice = sprintf( __( 'You are running Jetpack on a <a href="%s" target="_blank">staging server</a>.', 'jetpack' ), esc_url( Redirect::get_url( 'jetpack-support-staging-sites' ) ) );
1748		-
1749		- echo '<div class="updated" style="border-color: #f0821e;"><p>' . $notice . '</p></div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- All provided text.
1750		- }
1751	1835	}
1752	1836
1753	1837	/**
1754	1838	* Whether Jetpack's version maps to a public release, or a development version.
		@@ -1769,28 +1853,8 @@
1769	1853	);
1770	1854	}
1771	1855
1772	1856	/**
1773		- * Is a given user (or the current user if none is specified) linked to a WordPress.com user?
1774		- *
1775		- * @param int $user_id User ID or will use get_current_user_id if false/not provided.
1776		- */
1777		- public static function is_user_connected( $user_id = false ) {
1778		- _deprecated_function( __METHOD__, 'jetpack-9.5', 'Automattic\\Jetpack\\Connection\\Manager\\is_user_connected' );
1779		- return self::connection()->is_user_connected( $user_id );
1780		- }
1781		-
1782		- /**
1783		- * Get the wpcom user data of the current\|specified connected user.
1784		- *
1785		- * @param null\|int $user_id User ID or will use get_current_user_id if null.
1786		- */
1787		- public static function get_connected_user_data( $user_id = null ) {
1788		- _deprecated_function( __METHOD__, 'jetpack-9.5', 'Automattic\\Jetpack\\Connection\\Manager\\get_connected_user_data' );
1789		- return self::connection()->get_connected_user_data( $user_id );
1790		- }
1791		-
1792		- /**
1793	1857	* Get the wpcom email of the current\|specified connected user.
1794	1858	*
1795	1859	* @param null\|int $user_id User ID or will use get_current_user_id if null.
1796	1860	*/
		@@ -1842,18 +1906,11 @@
1842	1906	*/
1843	1907	public static function load_modules() {
1844	1908	$status = new Status();
1845	1909
1846		- if ( method_exists( $status, 'is_onboarding' ) ) {
1847		- $is_onboarding = $status->is_onboarding();
1848		- } else {
1849		- $is_onboarding = self::is_onboarding();
1850		- }
1851		-
1852	1910	if (
1853	1911	! self::is_connection_ready()
1854	1912	&& ! $status->is_offline_mode()
1855		- && ! $is_onboarding
1856	1913	&& (
1857	1914	! is_multisite()
1858	1915	\|\| ! get_site_option( 'jetpack_protect_active' )
1859	1916	)
		@@ -1974,22 +2031,14 @@
1974	2031	*
1975	2032	* @todo Store the result in core's object cache maybe?
1976	2033	*/
1977	2034	public static function get_active_plugins() {
1978		- $active_plugins = (array) get_option( 'active_plugins', array() );
1979		-
1980		- if ( is_multisite() ) {
1981		- // Due to legacy code, active_sitewide_plugins stores them in the keys,
1982		- // whereas active_plugins stores them in the values.
1983		- $network_plugins = array_keys( get_site_option( 'active_sitewide_plugins', array() ) );
1984		- if ( $network_plugins ) {
1985		- $active_plugins = array_merge( $active_plugins, $network_plugins );
1986		- }
	2035	+ // Older Connection copies can load first and lack this method.
	2036	+ if ( ! method_exists( Heartbeat::class, 'get_active_plugins' ) ) {
	2037	+ return array();
1987	2038	}
1988	2039
1989		- sort( $active_plugins );
1990		-
1991		- return array_unique( $active_plugins );
	2040	+ return Heartbeat::get_active_plugins();
1992	2041	}
1993	2042
1994	2043	/**
1995	2044	* Gets and parses additional plugin data to send with the heartbeat data
		@@ -2127,8 +2176,10 @@
2127	2176	*
2128	2177	* @param bool true Should Twitter Card Meta tags be disabled. Default to true.
2129	2178	*/
2130	2179	if ( ! apply_filters( 'jetpack_disable_twitter_cards', false ) ) {
	2180	+ // @todo Remove this require once the deprecated Jetpack_Twitter_Cards wrapper has been removed.
	2181	+ // Twitter Cards functionality now lives in the jetpack-post-media package (Automattic\Jetpack\Post_Media\Twitter_Cards).
2131	2182	require_once JETPACK__PLUGIN_DIR . 'class.jetpack-twitter-cards.php';
2132	2183	}
2133	2184	}
2134	2185
		@@ -2231,9 +2282,9 @@
2231	2282	if ( isset( $_GET['page'] ) && in_array( $_GET['page'], array( 'jetpack', 'jetpack_modules' ), true ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- we're not changing the site.
2232	2283	$page = sanitize_text_field( wp_unslash( $_GET['page'] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- we're not changing the site.
2233	2284	}
2234	2285	wp_safe_redirect( self::admin_url( 'page=' . rawurlencode( $page ) ) );
2235		- exit;
	2286	+ exit( 0 );
2236	2287	}
2237	2288	}
2238	2289
2239	2290	/**
		@@ -2280,8 +2331,12 @@
2280	2331	default:
2281	2332	break;
2282	2333	}
2283	2334	}
	2335	+ if ( method_exists( Feature_Policy::class, 'ensure_hooks' ) ) {
	2336	+ Feature_Policy::ensure_hooks();
	2337	+ }
	2338	+
2284	2339	/**
2285	2340	* Filters the array of default modules.
2286	2341	*
2287	2342	* @since 2.5.0
		@@ -2313,12 +2368,14 @@
2313	2368	* @return array
2314	2369	*/
2315	2370	public function handle_deprecated_modules( $modules ) {
2316	2371	$deprecated_modules = array(
2317		- 'debug' => null, // Closed out and moved to the debugger library.
2318		- 'wpcc' => 'sso', // Closed out in 2.6 -- SSO provides the same functionality.
2319		- 'gplus-authorship' => null, // Closed out in 3.2 -- Google dropped support.
2320		- 'minileven' => null, // Closed out in 8.3 -- Responsive themes are common now, and so is AMP.
	2372	+ 'debug' => null, // Closed out and moved to the debugger library.
	2373	+ 'wpcc' => 'sso', // Closed out in 2.6 -- SSO provides the same functionality.
	2374	+ 'gplus-authorship' => null, // Closed out in 3.2 -- Google dropped support.
	2375	+ 'minileven' => null, // Closed out in 8.3 -- Responsive themes are common now, and so is AMP.
	2376	+ 'lazy-images' => null, // Closed out in 12.8 -- WordPress core now has native lazy loading.
	2377	+ 'enhanced-distribution' => null, // Closed out in 13.3 -- WP.com is winding down the firehose.
2321	2378	);
2322	2379
2323	2380	// Don't activate SSO if they never completed activating WPCC.
2324	2381	if ( self::is_module_active( 'wpcc' ) ) {
		@@ -2372,8 +2429,17 @@
2372	2429	}
2373	2430	}
2374	2431	}
2375	2432
	2433	+ // Special case to convert block setting to a block module.
	2434	+ $block_key = array_search( 'blocks', $modules, true );
	2435	+ if ( $block_key !== false ) { // Only care if 'blocks' made it through the previous filters.
	2436	+ $block_option = get_option( 'jetpack_blocks_disabled', null );
	2437	+ if ( $block_option ) {
	2438	+ unset( $modules[ $block_key ] );
	2439	+ }
	2440	+ }
	2441	+
2376	2442	return $modules;
2377	2443	}
2378	2444
2379	2445	/**
		@@ -2430,23 +2496,30 @@
2430	2496
2431	2497	/**
2432	2498	* Return module name translation. Uses matching string created in modules/module-headings.php.
2433	2499	*
	2500	+ * The module list is globbed from `modules/` at runtime, so a module can be listed with no
	2501	+ * entry in that generated file. Fall back to the untranslated header rather than overwriting
	2502	+ * it with the null `jetpack_get_module_i18n()` returns for an unknown slug.
	2503	+ *
2434	2504	* @since 3.9.2
2435	2505	*
2436	2506	* @param array $modules Array of Jetpack modules.
2437	2507	*
2438		- * @return string\|void
	2508	+ * @return array
2439	2509	*/
2440	2510	public static function get_translated_modules( $modules ) {
2441	2511	foreach ( $modules as $index => $module ) {
2442	2512	$i18n_module = jetpack_get_module_i18n( $module['module'] );
2443		- if ( isset( $module['name'] ) ) {
2444		- $modules[ $index ]['name'] = $i18n_module['name'];
	2513	+ $name = $i18n_module['name'] ?? null;
	2514	+ $description = $i18n_module['description'] ?? null;
	2515	+
	2516	+ if ( null !== $name && isset( $module['name'] ) ) {
	2517	+ $modules[ $index ]['name'] = $name;
2445	2518	}
2446		- if ( isset( $module['description'] ) ) {
2447		- $modules[ $index ]['description'] = $i18n_module['description'];
2448		- $modules[ $index ]['short_description'] = $i18n_module['description'];
	2519	+ if ( null !== $description && isset( $module['description'] ) ) {
	2520	+ $modules[ $index ]['description'] = $description;
	2521	+ $modules[ $index ]['short_description'] = $description;
2449	2522	}
2450	2523	if ( isset( $module['module_tags'] ) ) {
2451	2524	$modules[ $index ]['module_tags'] = array_map( 'jetpack_get_module_i18n_tag', $module['module_tags'] );
2452	2525	}
		@@ -2486,20 +2559,28 @@
2486	2559
2487	2560	/**
2488	2561	* Catches PHP errors. Must be used in conjunction with output buffering.
2489	2562	*
	2563	+ * @deprecated since 13.5
2490	2564	* @param bool $catch True to start catching, False to stop.
2491	2565	*
2492	2566	* @static
	2567	+ * @deprecated 13.5
	2568	+ * @see \Automattic\Jetpack\Errors
2493	2569	*/
2494	2570	public static function catch_errors( $catch ) {
	2571	+ _deprecated_function( __METHOD__, '13.5' );
	2572	+ // @phan-suppress-next-line PhanDeprecatedClass
2495	2573	return ( new Errors() )->catch_errors( $catch );
2496	2574	}
2497	2575
2498	2576	/**
2499	2577	* Saves any generated PHP errors in ::state( 'php_errors', {errors} )
	2578	+ *
	2579	+ * @deprecated since 13.5
2500	2580	*/
2501	2581	public static function catch_errors_on_shutdown() {
	2582	+ _deprecated_function( __METHOD__, '13.5' );
2502	2583	self::state( 'php_errors', self::alias_directories( ob_get_clean() ) );
2503	2584	}
2504	2585
2505	2586	/**
		@@ -2603,9 +2684,9 @@
2603	2684	),
2604	2685	add_query_arg( compact( 'min_version', 'max_version', 'other_modules' ), self::admin_url( 'page=jetpack' ) )
2605	2686	);
2606	2687	wp_safe_redirect( $url );
2607		- exit;
	2688	+ exit( 0 );
2608	2689	}
2609	2690	}
2610	2691
2611	2692	/**
		@@ -2623,9 +2704,8 @@
2623	2704
2624	2705	// Check each module for fatal errors, a la wp-admin/plugins.php::activate before activating.
2625	2706	if ( $send_state_messages ) {
2626	2707	self::restate();
2627		- self::catch_errors( true );
2628	2708	}
2629	2709
2630	2710	$active = self::get_active_modules();
2631	2711
		@@ -2693,10 +2773,8 @@
2693	2773	if ( $send_state_messages ) {
2694	2774	self::state( 'error', false );
2695	2775	self::state( 'module', false );
2696	2776	}
2697		-
2698		- self::catch_errors( false );
2699	2777	/**
2700	2778	* Fires when default modules are activated.
2701	2779	*
2702	2780	* @since 1.9.0
		@@ -2754,9 +2832,9 @@
2754	2832	* @return string $url module configuration URL.
2755	2833	*/
2756	2834	public static function module_configuration_url( $module ) {
2757	2835	$module = self::get_module_slug( $module );
2758		- $default_url = self::admin_url() . "#/settings?term=$module";
	2836	+ $default_url = self::admin_url( array( 'page' => 'jetpack-settings' ) ) . "#/settings?term=$module";
2759	2837	/**
2760	2838	* Allows to modify configure_url of specific module to be able to redirect to some custom location.
2761	2839	*
2762	2840	* @since 6.9.0
		@@ -2774,9 +2852,9 @@
2774	2852	*
2775	2853	* @param string $message Error message.
2776	2854	* @param bool $deactivate Deactivate Jetpack or not.
2777	2855	*
2778		- * @return void
	2856	+ * @return never
2779	2857	*/
2780	2858	public static function bail_on_activation( $message, $deactivate = true ) {
2781	2859	?>
2782	2860	<!doctype html>
		@@ -2814,9 +2892,9 @@
2814	2892	if ( $update ) {
2815	2893	update_option( 'active_plugins', array_filter( $plugins ) );
2816	2894	}
2817	2895	}
2818		- exit;
	2896	+ exit( 0 );
2819	2897	}
2820	2898
2821	2899	/**
2822	2900	* Attached to activate_{ plugin_basename( __FILES__ ) } by register_activation_hook()
		@@ -2841,12 +2919,18 @@
2841	2919	update_option( 'jetpack_activation_source', self::get_activation_source( wp_get_referer() ) );
2842	2920
2843	2921	Health::on_jetpack_activated();
2844	2922
	2923	+ \Automattic\Jetpack\Reprint_Export\Reprint_Exporter::discard_credentials();
	2924	+
2845	2925	if ( self::is_connection_ready() && method_exists( 'Automattic\Jetpack\Sync\Actions', 'do_only_first_initial_sync' ) ) {
2846	2926	Sync_Actions::do_only_first_initial_sync();
2847	2927	}
2848	2928
	2929	+ if ( ! defined( 'WC_ANALYTICS' ) && class_exists( 'Automattic\Woocommerce_Analytics' ) ) {
	2930	+ Woocommerce_Analytics::maybe_add_proxy_speed_module();
	2931	+ }
	2932	+
2849	2933	self::plugin_initialize();
2850	2934	}
2851	2935
2852	2936	/**
		@@ -2881,9 +2965,9 @@
2881	2965
2882	2966	if ( $plugins_path === $referer['path'] ) {
2883	2967	$source_type = 'list';
2884	2968	} elseif ( $plugins_install_path === $referer['path'] ) {
2885		- $tab = isset( $query_parts['tab'] ) ? $query_parts['tab'] : 'featured';
	2969	+ $tab = $query_parts['tab'] ?? 'featured';
2886	2970	switch ( $tab ) {
2887	2971	case 'popular':
2888	2972	$source_type = 'popular';
2889	2973	break;
		@@ -2893,10 +2977,10 @@
2893	2977	case 'favorites':
2894	2978	$source_type = 'favorites';
2895	2979	break;
2896	2980	case 'search':
2897		- $source_type = 'search-' . ( isset( $query_parts['type'] ) ? $query_parts['type'] : 'term' );
2898		- $source_query = isset( $query_parts['s'] ) ? $query_parts['s'] : null;
	2981	+ $source_type = 'search-' . ( $query_parts['type'] ?? 'term' );
	2982	+ $source_query = $query_parts['s'] ?? null;
2899	2983	break;
2900	2984	default:
2901	2985	$source_type = 'featured';
2902	2986	}
		@@ -2905,29 +2989,171 @@
2905	2989	return array( $source_type, $source_query );
2906	2990	}
2907	2991
2908	2992	/**
2909		- * Runs before bumping version numbers up to a new version
	2993	+ * Runs before bumping version numbers up to a new version.
2910	2994	*
2911		- * @param string $version Version:timestamp.
	2995	+ * Only ever registered the hooks for the release post update modal, which has been removed.
	2996	+ * No longer hooked to `updating_jetpack_version`.
	2997	+ *
	2998	+ * @deprecated 16.2
	2999	+ *
	3000	+ * @param string $version Version:timestamp.
2912	3001	* @param string $old_version Old Version:timestamp or false if not set yet.
2913	3002	*/
2914		- public static function do_version_bump( $version, $old_version ) {
2915		- if ( $old_version ) { // For existing Jetpack installations.
2916		- add_action( 'admin_enqueue_scripts', __CLASS__ . '::enqueue_block_style' );
	3003	+ public static function do_version_bump( $version, $old_version ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Signature preserved for the deprecation shim.
	3004	+ _deprecated_function( __METHOD__, 'jetpack-16.2' );
	3005	+ }
2917	3006
2918		- // If a front end page is visited after the update, the 'wp' action will fire.
2919		- add_action( 'wp', 'Jetpack::set_update_modal_display' );
	3007	+ /**
	3008	+ * Enables the Newsletter (subscriptions) module for existing sites now that it is a default-on module.
	3009	+ *
	3010	+ * Fresh installs receive the module via its "Auto Activate: Yes" header, so this only handles sites
	3011	+ * upgrading from a version where the module defaulted off. It runs once per site (guarded by the
	3012	+ * subscriptions_default_on_migrated option). Fresh installs are marked as migrated immediately so the
	3013	+ * migration never runs for them. After it has run, the user's choice to deactivate the module again
	3014	+ * (for example from the My Jetpack Products page) is respected and never reverted.
	3015	+ *
	3016	+ * The module requires a connection, so on a disconnected site the migration is deferred without setting
	3017	+ * the guard, allowing a later version bump to retry once the site is connected.
	3018	+ *
	3019	+ * @param string $version New Jetpack version:timestamp.
	3020	+ * @param string\|false $old_version Previous Jetpack version:timestamp, or false on a fresh install.
	3021	+ */
	3022	+ public static function activate_subscriptions_module_for_existing_sites( $version, $old_version ) {
	3023	+ if ( get_option( 'jetpack_subscriptions_default_on_migrated' ) ) {
	3024	+ return;
	3025	+ }
2920	3026
2921		- // If an admin page is visited after the update, the 'current_screen' action will fire.
2922		- add_action( 'current_screen', 'Jetpack::set_update_modal_display' );
	3027	+ // Fresh installs get the module via its "Auto Activate: Yes" header. Mark them as migrated so a
	3028	+ // later opt-out is never reverted by the existing-site path on a subsequent version bump.
	3029	+ if ( ! $old_version ) {
	3030	+ update_option( 'jetpack_subscriptions_default_on_migrated', true );
	3031	+ return;
2923	3032	}
	3033	+
	3034	+ if ( ! self::is_connection_ready() ) {
	3035	+ return;
	3036	+ }
	3037	+
	3038	+ // Mark as migrated only once the module is active, so a transient activation failure is retried on
	3039	+ // a later version bump rather than being silently skipped.
	3040	+ if ( self::is_module_active( 'subscriptions' ) \|\| self::activate_module( 'subscriptions', false, false ) ) {
	3041	+ update_option( 'jetpack_subscriptions_default_on_migrated', true );
	3042	+ }
2924	3043	}
2925	3044
2926	3045	/**
	3046	+ * Option flag that records the AI master-switch opt-out reconciliation has run,
	3047	+ * so it never runs twice.
	3048	+ *
	3049	+ * @var string
	3050	+ */
	3051	+ const AI_MASTER_OPTOUT_MIGRATED_OPTION = 'jetpack_ai_master_optout_migrated';
	3052	+
	3053	+ /**
	3054	+ * Register the on-upgrade init hooks whose relative ORDER matters, extracted so
	3055	+ * the ordering can be asserted in tests without invoking plugin_upgrade() (whose
	3056	+ * guards make it unreliable to trigger under test). activate_new_modules()
	3057	+ * (init, default priority 10) auto-activates "Auto Activate: Yes" modules
	3058	+ * including the `ai` master; reconcile_ai_master_optout() must run at a LATER
	3059	+ * priority to honor an explicit AI opt-out.
	3060	+ *
	3061	+ * @return void
	3062	+ */
	3063	+ public static function register_upgrade_init_hooks() {
	3064	+ add_action( 'init', array( __CLASS__, 'activate_new_modules' ) );
	3065	+ add_action( 'init', array( __CLASS__, 'reconcile_ai_master_optout' ), 20 );
	3066	+ }
	3067	+
	3068	+ /**
	3069	+ * Preserves an explicit Jetpack AI opt-out when the `ai` module becomes the site-wide
	3070	+ * master switch off WordPress.com Simple (self-hosted and Atomic).
	3071	+ *
	3072	+ * The `ai` module is "Auto Activate: Yes", so on upgrade {@see self::activate_new_modules()}
	3073	+ * turns it on for connected sites — the desired default-on / auto-enable-on-connection
	3074	+ * behavior, which this method deliberately leaves alone. The one case it corrects is a site
	3075	+ * that had explicitly disabled Jetpack AI (the `jetpack_ai_enabled` option present and falsey)
	3076	+ * before the module shipped: that opt-out must survive the module becoming the master, so the
	3077	+ * module is deactivated for exactly those sites. An absent or truthy option is left untouched.
	3078	+ *
	3079	+ * Ordering is the whole point. `activate_new_modules()` is hooked on `init` at priority 10 and
	3080	+ * auto-activates the module there; this method is hooked on `init` at priority 20 (see
	3081	+ * {@see self::plugin_upgrade()}), so it runs AFTER the auto-activation and its deactivation is
	3082	+ * the final state. A version-guarded block that ran inline during `plugins_loaded` would be
	3083	+ * undone by the later auto-activation, which is why this is a late-init hook rather than an
	3084	+ * inline upgrade step.
	3085	+ *
	3086	+ * WordPress.com Simple never runs modules — the option stays the master there — so this is a
	3087	+ * no-op on Simple. The {@see self::AI_MASTER_OPTOUT_MIGRATED_OPTION} flag makes it run exactly
	3088	+ * once, which matters because off-Simple the option is no longer the master after this runs:
	3089	+ * a stale falsey option must not keep re-deactivating a module the user later turns back on.
	3090	+ *
	3091	+ * @return void
	3092	+ */
	3093	+ public static function reconcile_ai_master_optout() {
	3094	+ if ( get_option( self::AI_MASTER_OPTOUT_MIGRATED_OPTION ) ) {
	3095	+ return;
	3096	+ }
	3097	+
	3098	+ // Simple keeps the `jetpack_ai_enabled` option as the master; modules don't run there.
	3099	+ if ( ( new Host() )->is_wpcom_simple() ) {
	3100	+ return;
	3101	+ }
	3102	+
	3103	+ // A sentinel default distinguishes an absent option (leave auto-activation alone) from one
	3104	+ // explicitly stored falsey (an opt-out to preserve).
	3105	+ $stored = get_option( 'jetpack_ai_enabled', 'not-set' );
	3106	+ if ( 'not-set' !== $stored && ! (bool) $stored ) {
	3107	+ ( new Modules() )->deactivate( 'ai' );
	3108	+ }
	3109	+
	3110	+ update_option( self::AI_MASTER_OPTOUT_MIGRATED_OPTION, true );
	3111	+ }
	3112	+
	3113	+ /**
	3114	+ * Deletes obsolete SEO module-state options without changing module activation.
	3115	+ *
	3116	+ * @since 16.3
	3117	+ */
	3118	+ public static function cleanup_seo_module_state_options() {
	3119	+ delete_option( 'jetpack_seo_sitemap_enabled' );
	3120	+ delete_option( 'jetpack_seo_canonical_urls_enabled' );
	3121	+ delete_option( 'jetpack_seo_module_state_reconciled' );
	3122	+ }
	3123	+
	3124	+ /**
	3125	+ * Seeds the Jetpack SEO discoverability cohort once, so the new SEO surface is
	3126	+ * auto-discoverable on fresh installs but opt-in on existing ones (JETPACK-1700).
	3127	+ *
	3128	+ * Hooked on `updating_jetpack_version`, which fires on every install including the
	3129	+ * first — with `$old_version === false` on a brand-new site (the same signal
	3130	+ * {@see self::activate_subscriptions_module_for_existing_sites()} keys off). Fresh
	3131	+ * installs are seeded visible; existing installs are seeded hidden and opt in later
	3132	+ * via the legacy Traffic page or My Jetpack. `add_option()` makes this seed-once: it
	3133	+ * never overrides a value a later opt-in (or opt-out) has set. WordPress.com sites
	3134	+ * ignore this option entirely (always visible) — see
	3135	+ * {@see \Automattic\Jetpack\SEO\Initializer::is_seo_surface_visible()}.
	3136	+ *
	3137	+ * @param string $version The new Jetpack version (unused).
	3138	+ * @param string\|false $old_version The previous version, or false on a fresh install.
	3139	+ */
	3140	+ public static function seed_seo_visibility_cohort( $version, $old_version ) {
	3141	+ add_option( Jetpack_SEO_Initializer::VISIBILITY_OPTION, ! $old_version );
	3142	+ }
	3143	+
	3144	+ /**
2927	3145	* Sets the display_update_modal state.
	3146	+ *
	3147	+ * The release post update modal that read this state has been removed. The write is kept so the
	3148	+ * method still behaves as documented for the deprecation window. When this is deleted, also drop
	3149	+ * the matching `display_update_modal` guard in Automattic\Jetpack\CookieState::should_set_cookie(),
	3150	+ * which exists only to keep this key out of the cookie on the Jetpack admin screen.
	3151	+ *
	3152	+ * @deprecated 16.2
2928	3153	*/
2929	3154	public static function set_update_modal_display() {
	3155	+ _deprecated_function( __METHOD__, 'jetpack-16.2' );
2930	3156	self::state( 'display_update_modal', true );
2931	3157	}
2932	3158
2933	3159	/**
		@@ -2932,11 +3158,16 @@
2932	3158
2933	3159	/**
2934	3160	* Enqueues the block library styles.
2935	3161	*
	3162	+ * Only ever used by the release post update modal, which has been removed.
	3163	+ *
	3164	+ * @deprecated 16.2
	3165	+ *
2936	3166	* @param string $hook The current admin page.
2937	3167	*/
2938	3168	public static function enqueue_block_style( $hook ) {
	3169	+ _deprecated_function( __METHOD__, 'jetpack-16.2' );
2939	3170	if ( 'toplevel_page_jetpack' === $hook ) {
2940	3171	wp_enqueue_style( 'wp-block-library' );
2941	3172	}
2942	3173	}
		@@ -2965,9 +3196,8 @@
2965	3196
2966	3197	self::load_modules();
2967	3198
2968	3199	Jetpack_Options::delete_option( 'do_activate' );
2969		- Jetpack_Options::delete_option( 'dismissed_connection_banner' );
2970	3200	}
2971	3201
2972	3202	/**
2973	3203	* Handles the activation of the default modules depending on the current state of the site:
		@@ -3026,8 +3256,12 @@
3026	3256	add_filter( 'jetpack_update_activated_state_on_disconnect', '__return_false' );
3027	3257	self::disconnect();
3028	3258	Jetpack_Options::delete_option( 'version' );
3029	3259	}
	3260	+
	3261	+ if ( ! defined( 'WC_ANALYTICS' ) && class_exists( 'Automattic\Woocommerce_Analytics' ) ) {
	3262	+ Woocommerce_Analytics::maybe_remove_proxy_speed_module();
	3263	+ }
3030	3264	}
3031	3265
3032	3266	/**
3033	3267	* Set activated option to 4 on jetpack_idc_disconnect action.
		@@ -3055,9 +3289,9 @@
3055	3289	$connection->remove_connection( ! Identity_Crisis::validate_sync_error_idc_option() );
3056	3290	}
3057	3291
3058	3292	/**
3059		- * Happens after a successfull disconnection.
	3293	+ * Happens after a successful disconnection.
3060	3294	*
3061	3295	* @static
3062	3296	*/
3063	3297	public static function jetpack_site_disconnected() {
		@@ -3062,8 +3296,10 @@
3062	3296	*/
3063	3297	public static function jetpack_site_disconnected() {
3064	3298	Identity_Crisis::clear_all_idc_options();
3065	3299
	3300	+ \Automattic\Jetpack\Reprint_Export\Reprint_Exporter::discard_credentials();
	3301	+
3066	3302	// Delete all the sync related data. Since it could be taking up space.
3067	3303	Sender::get_instance()->uninstall();
3068	3304
3069	3305	/**
		@@ -3080,10 +3316,13 @@
3080	3316	}
3081	3317	}
3082	3318
3083	3319	/**
3084		- * Disconnects the user
	3320	+ * Disconnects the user.
3085	3321	*
	3322	+ * @deprecated 13.4
	3323	+ * @see \Automattic\Jetpack\Connection\Manager::disconnect_user()
	3324	+ *
3086	3325	* @param int $user_id The user ID to disconnect.
3087	3326	*/
3088	3327	public function disconnect_user( $user_id ) {
3089	3328	$this->connection_manager->disconnect_user( $user_id );
		@@ -3089,21 +3328,8 @@
3089	3328	$this->connection_manager->disconnect_user( $user_id );
3090	3329	}
3091	3330
3092	3331	/**
3093		- * Attempts Jetpack registration. If it fail, a state flag is set: @see ::admin_page_load()
3094		- *
3095		- * @deprecated since Jetpack 9.7.0
3096		- * @see Automattic\Jetpack\Connection\Manager::try_registration()
3097		- *
3098		- * @return bool\|WP_Error
3099		- */
3100		- public static function try_registration() {
3101		- _deprecated_function( __METHOD__, 'jetpack-9.7', 'Automattic\\Jetpack\\Connection\\Manager::try_registration' );
3102		- return static::connection()->try_registration();
3103		- }
3104		-
3105		- /**
3106	3332	* Checking the domain names in beta versions.
3107	3333	* If this is a development version, before attempting to connect, let's make sure that the domains are viable.
3108	3334	*
3109	3335	* @param null\|\WP_Error $error The domain validation error, or `null` if everything's fine.
		@@ -3137,10 +3363,17 @@
3137	3363	* @param mixed $code Error code to log.
3138	3364	* @param mixed $data Data to log.
3139	3365	*/
3140	3366	public static function log( $code, $data = null ) {
	3367	+
	3368	+ $raw_log = Jetpack_Options::get_option( 'log', array() );
	3369	+ // This can be modified by the `jetpack_options` filter, so abort if we don't have an array.
	3370	+ if ( ! is_array( $raw_log ) ) {
	3371	+ return;
	3372	+ }
	3373	+
3141	3374	// only grab the latest 200 entries.
3142		- $log = array_slice( Jetpack_Options::get_option( 'log', array() ), -199, 199 );
	3375	+ $log = array_slice( $raw_log, -199, 199 );
3143	3376
3144	3377	// Append our event to the log.
3145	3378	$log_entry = array(
3146	3379	'time' => time(),
		@@ -3240,8 +3473,15 @@
3240	3473
3241	3474	/**
3242	3475	* Return stat data for WPCOM sync.
3243	3476	*
	3477	+ * The Sync stats module was this method's last caller and moved to the Connection package's
	3478	+ * `Heartbeat::generate_stats_array()`, which assembles the heartbeat data through the
	3479	+ * `jetpack_heartbeat_stats_array` filter. Note the package method does not include the extended
	3480	+ * data from `get_additional_stat_data()`, so callers relying on `$extended` need to add it themselves.
	3481	+ *
	3482	+ * @deprecated 16.2
	3483	+ *
3244	3484	* @param bool $encode JSON encode the result.
3245	3485	* @param bool $extended Adds additional stats data.
3246	3486	*
3247	3487	* @return array\|string Stats data. Array if $encode is false. JSON-encoded string is $encode is true.
		@@ -3246,10 +3486,15 @@
3246	3486	*
3247	3487	* @return array\|string Stats data. Array if $encode is false. JSON-encoded string is $encode is true.
3248	3488	*/
3249	3489	public static function get_stat_data( $encode = true, $extended = true ) {
3250		- $data = Jetpack_Heartbeat::generate_stats_array();
	3490	+ _deprecated_function( __METHOD__, 'jetpack-16.2', 'Automattic\\Jetpack\\Heartbeat::generate_stats_array' );
3251	3491
	3492	+ $env_stats = method_exists( Heartbeat::class, 'get_environment_stats' )
	3493	+ ? Heartbeat::get_environment_stats()
	3494	+ : array();
	3495	+ $data = array_merge( Jetpack_Heartbeat::generate_stats_array(), $env_stats );
	3496	+
3252	3497	if ( $extended ) {
3253	3498	$additional_data = self::get_additional_stat_data();
3254	3499	$data = array_merge( $data, $additional_data );
3255	3500	}
		@@ -3254,9 +3499,9 @@
3254	3499	$data = array_merge( $data, $additional_data );
3255	3500	}
3256	3501
3257	3502	if ( $encode ) {
3258		- return wp_json_encode( $data );
	3503	+ return wp_json_encode( $data, JSON_UNESCAPED_SLASHES );
3259	3504	}
3260	3505
3261	3506	return $data;
3262	3507	}
		@@ -3328,16 +3573,24 @@
3328	3573	$fallback_no_verify_ssl_certs = Jetpack_Options::get_option( 'fallback_no_verify_ssl_certs' );
3329	3574	/** Already documented in automattic/jetpack-connection::src/class-client.php */
3330	3575	$client_verify_ssl_certs = apply_filters( 'jetpack_client_verify_ssl_certs', false );
3331	3576
	3577	+ // Run post-activation actions if needed.
	3578	+ $this->plugin_post_activation();
	3579	+
3332	3580	if ( ( self::is_connection_ready() \|\| $is_offline_mode ) && false === $fallback_no_verify_ssl_certs && ! $client_verify_ssl_certs ) {
3333	3581	// Upgrade: 1.1 -> 1.1.1
3334	3582	// Check and see if host can verify the Jetpack servers' SSL certificate.
3335	3583	$args = array();
	3584	+ // @phan-suppress-next-line PhanAccessMethodInternal -- Phan is correct, but the usage is intentional.
3336	3585	Client::_wp_remote_request( self::connection()->api_url( 'test' ), $args, true );
3337	3586	}
3338	3587
3339		- if ( current_user_can( 'manage_options' ) && ! self::permit_ssl() ) {
	3588	+ if (
	3589	+ current_user_can( 'manage_options' )
	3590	+ && ! self::permit_ssl()
	3591	+ && ! $is_offline_mode
	3592	+ ) {
3340	3593	add_action( 'jetpack_notices', array( $this, 'alert_auto_ssl_fail' ) );
3341	3594	}
3342	3595
3343	3596	add_action( 'load-plugins.php', array( $this, 'intercept_plugin_error_scrape_init' ) );
		@@ -3346,12 +3599,8 @@
3346	3599	if ( ! ( is_multisite() && is_plugin_active_for_network( 'jetpack/jetpack.php' ) && ! is_network_admin() ) ) {
3347	3600	add_action( 'admin_enqueue_scripts', array( $this, 'deactivate_dialog' ) );
3348	3601	}
3349	3602
3350		- if ( isset( $_COOKIE['jetpackState']['display_update_modal'] ) ) {
3351		- add_action( 'admin_enqueue_scripts', __CLASS__ . '::enqueue_block_style' );
3352		- }
3353		-
3354	3603	add_filter( 'plugin_action_links_' . plugin_basename( JETPACK__PLUGIN_DIR . 'jetpack.php' ), array( $this, 'plugin_action_links' ) );
3355	3604
3356	3605	if ( self::is_connection_ready() \|\| $is_offline_mode ) {
3357	3606	// Artificially throw errors in certain specific cases during plugin activation.
		@@ -3356,13 +3605,8 @@
3356	3605	if ( self::is_connection_ready() \|\| $is_offline_mode ) {
3357	3606	// Artificially throw errors in certain specific cases during plugin activation.
3358	3607	add_action( 'activate_plugin', array( $this, 'throw_error_on_activate_plugin' ) );
3359	3608	}
3360		-
3361		- // Add custom column in wp-admin/users.php to show whether user is linked.
3362		- add_filter( 'manage_users_columns', array( $this, 'jetpack_icon_user_connected' ) );
3363		- add_action( 'manage_users_custom_column', array( $this, 'jetpack_show_user_connected_icon' ), 10, 3 );
3364		- add_action( 'admin_print_styles', array( $this, 'jetpack_user_col_style' ) );
3365	3609	}
3366	3610
3367	3611	/**
3368	3612	* Adds body classes.
		@@ -3395,8 +3639,9 @@
3395	3639	* Sometimes a plugin can activate without causing errors, but it will cause errors on the next page load.
3396	3640	* This function artificially throws errors for such cases (per a specific list).
3397	3641	*
3398	3642	* @param string $plugin The activated plugin.
	3643	+ * @throws RuntimeException If a conflicting plugin is detected.
3399	3644	*/
3400	3645	public function throw_error_on_activate_plugin( $plugin ) {
3401	3646	$active_modules = self::get_active_modules();
3402	3647
		@@ -3409,8 +3654,9 @@
3409	3654	if ( 'stats.php' === basename( $plugin ) ) {
3410	3655	$throw = true;
3411	3656	}
3412	3657	} else {
	3658	+ // @phan-suppress-next-line PhanUndeclaredFunctionInCallable -- Checked above. See also https://github.com/phan/phan/issues/1204.
3413	3659	$reflection = new ReflectionFunction( 'stats_get_api_key' );
3414	3660	if ( basename( $plugin ) === basename( $reflection->getFileName() ) ) {
3415	3661	$throw = true;
3416	3662	}
		@@ -3417,9 +3663,9 @@
3417	3663	}
3418	3664
3419	3665	if ( $throw ) {
3420	3666	/* translators: Plugin name to deactivate. */
3421		- trigger_error( sprintf( esc_html__( 'Jetpack contains the most recent version of the old “%1$s” plugin.', 'jetpack' ), 'WordPress.com Stats' ), E_USER_ERROR ); // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_trigger_error
	3667	+ throw new RuntimeException( sprintf( __( 'Jetpack contains the most recent version of the old "%1$s" plugin.', 'jetpack' ), 'WordPress.com Stats' ) );
3422	3668	}
3423	3669	}
3424	3670	}
3425	3671
		@@ -3501,8 +3747,9 @@
3501	3747	/**
3502	3748	* Handler for Jetpack remote file uploads.
3503	3749	*
3504	3750	* @access public
	3751	+ * @return never
3505	3752	*/
3506	3753	public function remote_request_handlers() {
3507	3754	switch ( current_filter() ) {
3508	3755	case 'wp_ajax_nopriv_jetpack_upload_file':
		@@ -3529,18 +3776,17 @@
3529	3776	if ( ! is_int( $status_code ) ) {
3530	3777	$status_code = 400;
3531	3778	}
3532	3779
3533		- status_header( $status_code );
3534		- die( wp_json_encode( (object) compact( 'error', 'error_description' ) ) );
	3780	+ wp_send_json( (object) compact( 'error', 'error_description' ), $status_code, JSON_UNESCAPED_SLASHES );
3535	3781	}
3536	3782
3537		- status_header( 200 );
3538	3783	if ( true === $response ) {
3539		- exit;
	3784	+ status_header( 200 );
	3785	+ exit( 0 );
3540	3786	}
3541	3787
3542		- die( wp_json_encode( (object) $response ) );
	3788	+ wp_send_json( (object) $response, 200, JSON_UNESCAPED_SLASHES );
3543	3789	}
3544	3790
3545	3791	/**
3546	3792	* Uploads a file gotten from the global $_FILES.
		@@ -3548,9 +3794,9 @@
3548	3794	* the attachment file of the media item (gotten through of the post_id)
3549	3795	* will be updated instead of add a new one.
3550	3796	*
3551	3797	* @param boolean $update_media_item - update media attachment.
3552		- * @return array - An array describing the uploadind files process.
	3798	+ * @return array\|WP_Error - An array describing the uploading files process.
3553	3799	*/
3554	3800	public function upload_handler( $update_media_item = false ) {
3555	3801	if ( isset( $_SERVER['REQUEST_METHOD'] ) && 'POST' !== strtoupper( sanitize_text_field( wp_unslash( $_SERVER['REQUEST_METHOD'] ) ) ) ) {
3556	3802	return new WP_Error( 405, get_status_header_desc( 405 ), 405 );
		@@ -3601,9 +3847,9 @@
3601	3847	return new WP_Error( 'handler_cannot_upload', __( 'The upload handler cannot upload files', 'jetpack' ), 400 );
3602	3848	}
3603	3849
3604	3850	$uploaded_files = array();
3605		- $global_post = isset( $GLOBALS['post'] ) ? $GLOBALS['post'] : null;
	3851	+ $global_post = $GLOBALS['post'] ?? null;
3606	3852	unset( $GLOBALS['post'] );
3607	3853	if ( empty( $_FILES['media']['name'] ) ) {
3608	3854	// Nothing to process, just return.
3609	3855	return $uploaded_files;
		@@ -3610,9 +3856,9 @@
3610	3856	}
3611	3857	foreach ( $_FILES['media']['name'] as $index => $name ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- As above, unslash sniff is wrong. Validation should happen below.
3612	3858	$file = array();
3613	3859	foreach ( $media_keys as $media_key ) {
3614		- $file[ $media_key ] = isset( $_FILES['media'][ $media_key ][ $index ] ) ? $_FILES['media'][ $media_key ][ $index ] : null; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- As above, the unslash sniff is wrong.
	3860	+ $file[ $media_key ] = $_FILES['media'][ $media_key ][ $index ] ?? null; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash,,WordPress.Security.NonceVerification.Missing,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- As above, the unslash sniff is wrong.
3615	3861	}
3616	3862
3617	3863	list( $hmac_provided, $salt ) = isset( $_POST['_jetpack_file_hmac_media'][ $index ] ) ? explode( ':', filter_var( wp_unslash( $_POST['_jetpack_file_hmac_media'][ $index ] ) ) ) : array( 'no', '' ); // phpcs:ignore WordPress.Security.NonceVerification.Missing -- Nonce should have been checked by the caller.
3618	3864
		@@ -3658,9 +3904,9 @@
3658	3904	'type' => (string) $edited_media_item->post_mime_type,
3659	3905	'meta' => (array) wp_get_attachment_metadata( $post_id ),
3660	3906	);
3661	3907
3662		- return (array) array( $response );
	3908	+ return array( $response );
3663	3909	}
3664	3910
3665	3911	$attachment_id = media_handle_upload(
3666	3912	'.jetpack.upload.',
		@@ -3699,67 +3945,8 @@
3699	3945	return $uploaded_files;
3700	3946	}
3701	3947
3702	3948	/**
3703		- * Add help to the Jetpack page
3704		- *
3705		- * @since Jetpack (1.2.3)
3706		- * @return void
3707		- */
3708		- public function admin_help() {
3709		- $current_screen = get_current_screen();
3710		-
3711		- // Overview.
3712		- $current_screen->add_help_tab(
3713		- array(
3714		- 'id' => 'home',
3715		- 'title' => __( 'Home', 'jetpack' ),
3716		- 'content' =>
3717		- '<p><strong>' . __( 'Jetpack', 'jetpack' ) . '</strong></p>' .
3718		- '<p>' . __( 'Jetpack supercharges your self-hosted WordPress site with the awesome cloud power of WordPress.com.', 'jetpack' ) . '</p>' .
3719		- '<p>' . __( 'On this page, you are able to view the modules available within Jetpack, learn more about them, and activate or deactivate them as needed.', 'jetpack' ) . '</p>',
3720		- )
3721		- );
3722		-
3723		- // Screen Content.
3724		- if ( current_user_can( 'manage_options' ) ) {
3725		- $current_screen->add_help_tab(
3726		- array(
3727		- 'id' => 'settings',
3728		- 'title' => __( 'Settings', 'jetpack' ),
3729		- 'content' =>
3730		- '<p><strong>' . __( 'Jetpack', 'jetpack' ) . '</strong></p>' .
3731		- '<p>' . __( 'You can activate or deactivate individual Jetpack modules to suit your needs.', 'jetpack' ) . '</p>' .
3732		- '<ol>' .
3733		- '<li>' . __( 'Each module has an Activate or Deactivate link so you can toggle one individually.', 'jetpack' ) . '</li>' .
3734		- '<li>' . __( 'Using the checkboxes next to each module, you can select multiple modules to toggle via the Bulk Actions menu at the top of the list.', 'jetpack' ) . '</li>' .
3735		- '</ol>' .
3736		- '<p>' . __( 'Using the tools on the right, you can search for specific modules, filter by module categories or which are active, or change the sorting order.', 'jetpack' ) . '</p>',
3737		- )
3738		- );
3739		- }
3740		-
3741		- // Help Sidebar.
3742		- $support_url = Redirect::get_url( 'jetpack-support' );
3743		- $faq_url = Redirect::get_url( 'jetpack-faq' );
3744		- $current_screen->set_help_sidebar(
3745		- '<p><strong>' . __( 'For more information:', 'jetpack' ) . '</strong></p>' .
3746		- '<p><a href="' . esc_url( $faq_url ) . '" rel="noopener noreferrer" target="_blank">' . __( 'Jetpack FAQ', 'jetpack' ) . '</a></p>' .
3747		- '<p><a href="' . esc_url( $support_url ) . '" rel="noopener noreferrer" target="_blank">' . __( 'Jetpack Support', 'jetpack' ) . '</a></p>' .
3748		- '<p><a href="' . esc_url( self::admin_url( array( 'page' => 'jetpack-debugger' ) ) ) . '">' . __( 'Jetpack Debugging Center', 'jetpack' ) . '</a></p>'
3749		- );
3750		- }
3751		-
3752		- /**
3753		- * Enqueues the jetpack-icons style.
3754		- *
3755		- * @return void
3756		- */
3757		- public function admin_menu_css() {
3758		- wp_enqueue_style( 'jetpack-icons' );
3759		- }
3760		-
3761		- /**
3762	3949	* Add action links for the Jetpack plugin.
3763	3950	*
3764	3951	* @param array $actions Plugin actions.
3765	3952	*
		@@ -3765,14 +3952,11 @@
3765	3952	*
3766	3953	* @return array
3767	3954	*/
3768	3955	public function plugin_action_links( $actions ) {
3769		- $support_link = ( new Host() )->is_woa_site() ? 'https://wordpress.com/help/contact/' : self::admin_url( 'page=jetpack-debugger' );
3770		-
3771	3956	if ( current_user_can( 'jetpack_manage_modules' ) && ( self::is_connection_ready() \|\| ( new Status() )->is_offline_mode() ) ) {
3772	3957	return array_merge(
3773		- array( 'settings' => sprintf( '<a href="%s">%s</a>', esc_url( self::admin_url( 'page=jetpack#/settings' ) ), __( 'Settings', 'jetpack' ) ) ),
3774		- array( 'support' => sprintf( '<a href="%s">%s</a>', esc_url( $support_link ), __( 'Support', 'jetpack' ) ) ),
	3958	+ array( 'settings' => sprintf( '<a href="%s">%s</a>', esc_url( self::admin_url( 'page=jetpack-settings#/settings' ) ), __( 'Settings', 'jetpack' ) ) ),
3775	3959	$actions
3776	3960	);
3777	3961	}
3778	3962
		@@ -3779,53 +3963,8 @@
3779	3963	return $actions;
3780	3964	}
3781	3965
3782	3966	/**
3783		- * Add an activation modal to the plugins page and the main dashboard.
3784		- *
3785		- * @param string $hook The current admin page.
3786		- *
3787		- * @return void
3788		- */
3789		- public function activate_dialog( $hook ) {
3790		- /*
3791		- * We do not need it on other plugin pages,
3792		- * or when Jetpack is already connected.
3793		- */
3794		- if (
3795		- ! in_array( $hook, array( 'plugins.php', 'index.php' ), true )
3796		- \|\| self::is_connection_ready()
3797		- ) {
3798		- return;
3799		- }
3800		-
3801		- // add an activation script that will pick up deactivation actions for the Jetpack plugin.
3802		- Assets::register_script(
3803		- 'jetpack-full-activation-modal-js',
3804		- '_inc/build/activation-modal.js',
3805		- JETPACK__PLUGIN_FILE,
3806		- array(
3807		- 'enqueue' => true,
3808		- 'in_footer' => true,
3809		- 'textdomain' => 'jetpack',
3810		- 'dependencies' => array(
3811		- 'wp-polyfill',
3812		- 'wp-components',
3813		- ),
3814		- )
3815		- );
3816		-
3817		- // Add objects to be passed to the initial state of the app.
3818		- // Use wp_add_inline_script instead of wp_localize_script, see https://core.trac.wordpress.org/ticket/25280.
3819		- wp_add_inline_script( 'jetpack-full-activation-modal-js', 'var Initial_State=JSON.parse(decodeURIComponent("' . rawurlencode( wp_json_encode( Jetpack_Redux_State_Helper::get_minimal_state() ) ) . '"));', 'before' );
3820		-
3821		- // Adds Connection package initial state.
3822		- Connection_Initial_State::render_script( 'jetpack-full-activation-modal-js' );
3823		-
3824		- add_action( 'admin_notices', array( $this, 'jetpack_plugin_portal_containers' ) );
3825		- }
3826		-
3827		- /**
3828	3967	* Adds the deactivation warning modal for Jetpack.
3829	3968	*
3830	3969	* @param string $hook The current admin page.
3831	3970	*
		@@ -3845,14 +3984,10 @@
3845	3984	'jetpack-plugins-page-js',
3846	3985	'_inc/build/plugins-page.js',
3847	3986	JETPACK__PLUGIN_FILE,
3848	3987	array(
3849		- 'in_footer' => true,
3850		- 'textdomain' => 'jetpack',
3851		- 'dependencies' => array(
3852		- 'wp-polyfill',
3853		- 'wp-components',
3854		- ),
	3988	+ 'in_footer' => true,
	3989	+ 'textdomain' => 'jetpack',
3855	3990	)
3856	3991	);
3857	3992	Assets::enqueue_script( 'jetpack-plugins-page-js' );
3858	3993
		@@ -3857,9 +3992,9 @@
3857	3992	Assets::enqueue_script( 'jetpack-plugins-page-js' );
3858	3993
3859	3994	// Add objects to be passed to the initial state of the app.
3860	3995	// Use wp_add_inline_script instead of wp_localize_script, see https://core.trac.wordpress.org/ticket/25280.
3861		- wp_add_inline_script( 'jetpack-plugins-page-js', 'var Initial_State=JSON.parse(decodeURIComponent("' . rawurlencode( wp_json_encode( Jetpack_Redux_State_Helper::get_minimal_state() ) ) . '"));', 'before' );
	3996	+ wp_add_inline_script( 'jetpack-plugins-page-js', 'var Initial_State=' . wp_json_encode( Jetpack_Redux_State_Helper::get_plugins_page_state(), JSON_UNESCAPED_SLASHES \| JSON_HEX_TAG \| JSON_HEX_AMP ) . ';', 'before' );
3862	3997
3863	3998	add_action( 'admin_footer', array( $this, 'jetpack_plugin_portal_containers' ) );
3864	3999	}
3865	4000	}
		@@ -3908,9 +4043,9 @@
3908	4043	// @todo provide way to go to specific calypso env.
3909	4044	self::get_calypso_host() . 'jetpack/connect'
3910	4045	)
3911	4046	);
3912		- exit;
	4047	+ exit( 0 );
3913	4048	}
3914	4049	}
3915	4050
3916	4051	/*
		@@ -3945,8 +4080,28 @@
3945	4080	* Done!
3946	4081	*/
3947	4082
3948	4083	/**
	4084	+ * Build the user-facing description stored alongside a registration error code.
	4085	+ *
	4086	+ * @since 16.2
	4087	+ *
	4088	+ * @param string $error_code The WP_Error code.
	4089	+ * @param string $message The WP_Error message.
	4090	+ * @return string The description, empty when the message is not user-facing copy.
	4091	+ */
	4092	+ public static function get_registration_error_description( $error_code, $message ) {
	4093	+ // Manager::validate_remote_register_response() does not always put user-facing copy in the
	4094	+ // message slot: wpcom_5??, wpcom_408 and wpcom_bad_response store the HTTP status there,
	4095	+ // and jetpack_id stores the raw response body, which can also overflow the state cookie.
	4096	+ if ( 'jetpack_id' === $error_code \|\| is_numeric( $message ) ) {
	4097	+ return '';
	4098	+ }
	4099	+
	4100	+ return mb_substr( (string) $message, 0, 250 );
	4101	+ }
	4102	+
	4103	+ /**
3949	4104	* Handles the page load events for the Jetpack admin page
3950	4105	*/
3951	4106	public function admin_page_load() {
3952	4107	$error = false;
		@@ -3982,10 +4137,11 @@
3982	4137	$registered = static::connection()->try_registration();
3983	4138	if ( is_wp_error( $registered ) ) {
3984	4139	$error = $registered->get_error_code();
3985	4140	self::state( 'error', $error );
3986		- self::state( 'error', $registered->get_error_message() );
3987	4141
	4142	+ self::state( 'error_description', self::get_registration_error_description( $error, $registered->get_error_message() ) );
	4143	+
3988	4144	/**
3989	4145	* Jetpack registration Error.
3990	4146	*
3991	4147	* @since 7.5.0
		@@ -4009,12 +4165,8 @@
4009	4165	do_action( 'jetpack_connection_register_success', $from );
4010	4166
4011	4167	$url = $this->build_connect_url( true, $redirect, $from );
4012	4168
4013		- if ( ! empty( $_GET['onboarding'] ) ) {
4014		- $url = add_query_arg( 'onboarding', rawurlencode_deep( wp_unslash( $_GET['onboarding'] ) ), $url ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
4015		- }
4016		-
4017	4169	if ( ! empty( $_GET['auth_approved'] ) && 'true' === $_GET['auth_approved'] ) {
4018	4170	$url = add_query_arg( 'auth_approved', 'true', $url );
4019	4171	}
4020	4172
		@@ -4019,9 +4171,9 @@
4019	4171	}
4020	4172
4021	4173	add_filter( 'allowed_redirect_hosts', array( Host::class, 'allow_wpcom_environments' ) );
4022	4174	wp_safe_redirect( $url );
4023		- exit;
	4175	+ exit( 0 );
4024	4176	case 'activate':
4025	4177	if ( ! current_user_can( 'jetpack_activate_modules' ) ) {
4026	4178	$error = 'cheatin';
4027	4179	break;
		@@ -4035,9 +4187,9 @@
4035	4187	self::state( 'error', sprintf( __( 'Could not activate %s', 'jetpack' ), $module ) );
4036	4188	}
4037	4189	// The following two lines will rarely happen, as Jetpack::activate_module normally exits at the end.
4038	4190	wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4039		- exit;
	4191	+ exit( 0 );
4040	4192	case 'activate_default_modules':
4041	4193	check_admin_referer( 'activate_default_modules' );
4042	4194	self::log( 'activate_default_modules' );
4043	4195	self::restate();
		@@ -4045,9 +4197,9 @@
4045	4197	$max_version = isset( $_GET['max_version'] ) ? sanitize_text_field( wp_unslash( $_GET['max_version'] ) ) : false;
4046	4198	$other_modules = isset( $_GET['other_modules'] ) && is_array( $_GET['other_modules'] ) ? array_map( 'sanitize_text_field', wp_unslash( $_GET['other_modules'] ) ) : array();
4047	4199	self::activate_default_modules( $min_version, $max_version, $other_modules );
4048	4200	wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4049		- exit;
	4201	+ exit( 0 );
4050	4202	case 'disconnect':
4051	4203	if ( ! current_user_can( 'jetpack_disconnect' ) ) {
4052	4204	$error = 'cheatin';
4053	4205	break;
		@@ -4056,9 +4208,9 @@
4056	4208	check_admin_referer( 'jetpack-disconnect' );
4057	4209	self::log( 'disconnect' );
4058	4210	self::disconnect();
4059	4211	wp_safe_redirect( self::admin_url( 'disconnected=true' ) );
4060		- exit;
	4212	+ exit( 0 );
4061	4213	case 'reconnect':
4062	4214	if ( ! current_user_can( 'jetpack_reconnect' ) ) {
4063	4215	$error = 'cheatin';
4064	4216	break;
		@@ -4069,9 +4221,9 @@
4069	4221	self::disconnect();
4070	4222
4071	4223	add_filter( 'allowed_redirect_hosts', array( Host::class, 'allow_wpcom_environments' ) );
4072	4224	wp_safe_redirect( $this->build_connect_url( true, false, 'reconnect' ) );
4073		- exit;
	4225	+ exit( 0 );
4074	4226	case 'deactivate':
4075	4227	if ( ! current_user_can( 'jetpack_deactivate_modules' ) ) {
4076	4228	$error = 'cheatin';
4077	4229	break;
		@@ -4085,9 +4237,9 @@
4085	4237	self::state( 'message', 'module_deactivated' );
4086	4238	}
4087	4239	self::state( 'module', $modules );
4088	4240	wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4089		- exit;
	4241	+ exit( 0 );
4090	4242	case 'unlink':
4091	4243	$redirect = isset( $_GET['redirect'] ) ? sanitize_text_field( wp_unslash( $_GET['redirect'] ) ) : '';
4092	4244	check_admin_referer( 'jetpack-unlink' );
4093	4245	self::log( 'unlink' );
		@@ -4097,32 +4249,9 @@
4097	4249	wp_safe_redirect( admin_url() );
4098	4250	} else {
4099	4251	wp_safe_redirect( self::admin_url( array( 'page' => rawurlencode( $redirect ) ) ) );
4100	4252	}
4101		- exit;
4102		- case 'onboard':
4103		- if ( ! current_user_can( 'manage_options' ) ) {
4104		- wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4105		- } else {
4106		- self::create_onboarding_token();
4107		- $url = $this->build_connect_url( true );
4108		-
4109		- $token = Jetpack_Options::get_option( 'onboarding' );
4110		-
4111		- if ( false !== ( $token ) ) {
4112		- $url = add_query_arg( 'onboarding', $token, $url );
4113		- }
4114		-
4115		- $calypso_env = ( new Host() )->get_calypso_env();
4116		- if ( ! empty( $calypso_env ) ) {
4117		- $url = add_query_arg( 'calypso_env', $calypso_env, $url );
4118		- }
4119		-
4120		- add_filter( 'allowed_redirect_hosts', array( Host::class, 'allow_wpcom_environments' ) );
4121		- wp_safe_redirect( $url );
4122		- exit;
4123		- }
4124		- exit;
	4253	+ exit( 0 );
4125	4254	default:
4126	4255	/**
4127	4256	* Fires when a Jetpack admin page is loaded with an unrecognized parameter.
4128	4257	*
		@@ -4345,37 +4474,8 @@
4345	4474	endif;
4346	4475	}
4347	4476
4348	4477	/**
4349		- * We can't always respond to a signed XML-RPC request with a
4350		- * helpful error message. In some circumstances, doing so could
4351		- * leak information.
4352		- *
4353		- * Instead, track that the error occurred via a Jetpack_Option,
4354		- * and send that data back in the heartbeat.
4355		- * All this does is increment a number, but it's enough to find
4356		- * trends.
4357		- *
4358		- * @param WP_Error $xmlrpc_error The error produced during
4359		- * signature validation.
4360		- */
4361		- public function track_xmlrpc_error( $xmlrpc_error ) {
4362		- $code = is_wp_error( $xmlrpc_error )
4363		- ? $xmlrpc_error->get_error_code()
4364		- : 'should-not-happen';
4365		-
4366		- $xmlrpc_errors = Jetpack_Options::get_option( 'xmlrpc_errors', array() );
4367		- if ( isset( $xmlrpc_errors[ $code ] ) && $xmlrpc_errors[ $code ] ) {
4368		- // No need to update the option if we already have
4369		- // this code stored.
4370		- return;
4371		- }
4372		- $xmlrpc_errors[ $code ] = true;
4373		-
4374		- Jetpack_Options::update_option( 'xmlrpc_errors', $xmlrpc_errors, false );
4375		- }
4376		-
4377		- /**
4378	4478	* Initialize the jetpack stats instance only when needed
4379	4479	*
4380	4480	* @return void
4381	4481	*/
		@@ -4498,9 +4598,9 @@
4498	4598	return $this->build_connect_url( $raw, $redirect, $from, true );
4499	4599	}
4500	4600	}
4501	4601
4502		- $url = static::build_authorize_url( $redirect );
	4602	+ $url = ( new Authorize_Redirect( static::connection() ) )->build_authorize_url( $redirect );
4503	4603	}
4504	4604
4505	4605	if ( $from ) {
4506	4606	$url = add_query_arg( 'from', $from, $url );
		@@ -4525,66 +4625,30 @@
4525	4625	* @param null $deprecated Deprecated since Jetpack 10.9.
4526	4626	*
4527	4627	* @todo Update default value for redirect since the called function expects a string.
4528	4628	*
	4629	+ * @deprecated 13.4
	4630	+ *
4529	4631	* @return mixed\|void
4530	4632	*/
4531	4633	public static function build_authorize_url( $redirect = false, $deprecated = null ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
	4634	+ _deprecated_function( __METHOD__, 'jetpack-13.4', 'Authorize_Redirect::build_authorize_url' );
4532	4635
4533		- add_filter( 'jetpack_connect_request_body', array( __CLASS__, 'filter_connect_request_body' ) );
4534		- add_filter( 'jetpack_connect_redirect_url', array( __CLASS__, 'filter_connect_redirect_url' ) );
4535		-
4536		- $c8n = self::connection();
4537		- $url = $c8n->get_authorization_url( wp_get_current_user(), $redirect );
4538		-
4539		- remove_filter( 'jetpack_connect_request_body', array( __CLASS__, 'filter_connect_request_body' ) );
4540		- remove_filter( 'jetpack_connect_redirect_url', array( __CLASS__, 'filter_connect_redirect_url' ) );
4541		-
4542		- /**
4543		- * Filter the URL used when authorizing a user to a WordPress.com account.
4544		- *
4545		- * @since 8.9.0
4546		- *
4547		- * @param string $url Connection URL.
4548		- */
4549		- return apply_filters( 'jetpack_build_authorize_url', $url );
	4636	+ return ( new Authorize_Redirect( static::connection() ) )->build_authorize_url( $redirect );
4550	4637	}
4551	4638
4552	4639	/**
4553	4640	* Filters the connection URL parameter array.
4554	4641	*
	4642	+ * @deprecated 13.4
	4643	+ *
4555	4644	* @param array $args default URL parameters used by the package.
4556	4645	* @return array the modified URL arguments array.
4557	4646	*/
4558	4647	public static function filter_connect_request_body( $args ) {
4559		- if (
4560		- Constants::is_defined( 'JETPACK__GLOTPRESS_LOCALES_PATH' )
4561		- && include_once Constants::get_constant( 'JETPACK__GLOTPRESS_LOCALES_PATH' )
4562		- ) {
4563		- $gp_locale = GP_Locales::by_field( 'wp_locale', get_locale() );
4564		- $args['locale'] = isset( $gp_locale ) && isset( $gp_locale->slug )
4565		- ? $gp_locale->slug
4566		- : '';
4567		- }
	4648	+ _deprecated_function( __METHOD__, 'jetpack-13.4', 'Authorize_Redirect::filter_connect_request_body' );
4568	4649
4569		- $tracking = new Tracking();
4570		- $tracks_identity = $tracking->tracks_get_identity( $args['state'] );
4571		-
4572		- $args = array_merge(
4573		- $args,
4574		- array(
4575		- '_ui' => $tracks_identity['_ui'],
4576		- '_ut' => $tracks_identity['_ut'],
4577		- )
4578		- );
4579		-
4580		- $calypso_env = ( new Host() )->get_calypso_env();
4581		-
4582		- if ( ! empty( $calypso_env ) ) {
4583		- $args['calypso_env'] = $calypso_env;
4584		- }
4585		-
4586		- return $args;
	4650	+ return Authorize_Redirect::filter_connect_request_body( $args );
4587	4651	}
4588	4652
4589	4653	/**
4590	4654	* Filters the `jetpack/v4/connection/data` API response of the Connection package in order to
		@@ -4621,41 +4685,19 @@
4621	4685	return $current_user_connection_data;
4622	4686	}
4623	4687
4624	4688	/**
4625		- * Filters the URL that will process the connection data. It can be different from the URL
4626		- * that we send the user to after everything is done.
4627		- *
4628		- * @param String $processing_url the default redirect URL used by the package.
4629		- * @return String the modified URL.
4630		- *
4631		- * @deprecated since Jetpack 9.5.0
4632		- */
4633		- public static function filter_connect_processing_url( $processing_url ) {
4634		- _deprecated_function( __METHOD__, 'jetpack-9.5' );
4635		-
4636		- $processing_url = admin_url( 'admin.php?page=jetpack' ); // Making PHPCS happy.
4637		- return $processing_url;
4638		- }
4639		-
4640		- /**
4641	4689	* Filters the redirection URL that is used for connect requests. The redirect
4642	4690	* URL should return the user back to the Jetpack console.
4643	4691	*
	4692	+ * @deprecated 13.4
	4693	+ *
4644	4694	* @param String $redirect the default redirect URL used by the package.
4645	4695	* @return String the modified URL.
4646	4696	*/
4647	4697	public static function filter_connect_redirect_url( $redirect ) {
4648		- $jetpack_admin_page = esc_url_raw( admin_url( 'admin.php?page=jetpack' ) );
4649		- $redirect = $redirect
4650		- ? wp_validate_redirect( esc_url_raw( $redirect ), $jetpack_admin_page )
4651		- : $jetpack_admin_page;
4652		-
4653		- if ( isset( $_REQUEST['is_multisite'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- not making a site change here.
4654		- $redirect = Jetpack_Network::init()->get_url( 'network_admin_page' );
4655		- }
4656		-
4657		- return $redirect;
	4698	+ _deprecated_function( __METHOD__, 'jetpack-13.4', 'Authorize_Redirect::filter_connect_redirect_url' );
	4699	+ return Authorize_Redirect::filter_connect_redirect_url( $redirect );
4658	4700	}
4659	4701
4660	4702	/**
4661	4703	* This action fires at the beginning of the Manager::authorize method.
		@@ -4719,11 +4761,8 @@
4719	4761	*
4720	4762	* @param array $data The request data.
4721	4763	*/
4722	4764	public static function authorize_ending_authorized( $data ) {
4723		- // If this site has been through the Jetpack Onboarding flow, delete the onboarding token.
4724		- self::invalidate_onboarding_token();
4725		-
4726	4765	// If redirect_uri is SSO, ensure SSO module is enabled.
4727	4766	parse_str( wp_parse_url( $data['redirect_uri'], PHP_URL_QUERY ), $redirect_options );
4728	4767
4729	4768	/** This filter is documented in class.jetpack-cli.php */
		@@ -4863,10 +4902,12 @@
4863	4902	$result = self::permit_ssl( true );
4864	4903	wp_send_json(
4865	4904	array(
4866	4905	'enabled' => $result,
4867		- 'message' => get_transient( 'jetpack_https_test_message' ),
4868		- )
	4906	+ 'message' => self::get_ssl_test_message(),
	4907	+ ),
	4908	+ null, // @phan-suppress-current-line PhanTypeMismatchArgumentProbablyReal -- It takes null, but its phpdoc only says int.
	4909	+ JSON_UNESCAPED_SLASHES
4869	4910	);
4870	4911	}
4871	4912
4872	4913	/* Client API */
		@@ -4873,8 +4914,10 @@
4873	4914
4874	4915	/**
4875	4916	* Verify the onboarding token.
4876	4917	*
	4918	+ * @deprecated since 13.9
	4919	+ *
4877	4920	* @param array $token_data Token data.
4878	4921	* @param string $token Token value.
4879	4922	* @param string $request_data JSON-encoded request data.
4880	4923	*
		@@ -4880,8 +4923,9 @@
4880	4923	*
4881	4924	* @return mixed
4882	4925	*/
4883	4926	public static function verify_onboarding_token( $token_data, $token, $request_data ) {
	4927	+ _deprecated_function( __METHOD__, '13.9' );
4884	4928	// Default to a blog token.
4885	4929	$token_type = 'blog';
4886	4930
4887	4931	// Let's see if this is onboarding. In such case, use user token type and the provided user id.
		@@ -4909,9 +4953,9 @@
4909	4953	$jp_user = get_user_by( 'email', $jpo_user );
4910	4954	if ( is_a( $jp_user, 'WP_User' ) ) {
4911	4955	wp_set_current_user( $jp_user->ID );
4912	4956	$user_can = is_multisite()
4913		- ? current_user_can_for_blog( get_current_blog_id(), 'manage_options' )
	4957	+ ? current_user_can_for_site( get_current_blog_id(), 'manage_options' )
4914	4958	: current_user_can( 'manage_options' );
4915	4959	if ( $user_can ) {
4916	4960	$token_type = 'user';
4917	4961	$token->external_user_id = $jp_user->ID;
		@@ -4928,11 +4972,13 @@
4928	4972
4929	4973	/**
4930	4974	* Create a random secret for validating onboarding payload
4931	4975	*
	4976	+ * @deprecated since 13.9
4932	4977	* @return string Secret token
4933	4978	*/
4934	4979	public static function create_onboarding_token() {
	4980	+ _deprecated_function( __METHOD__, '13.9' );
4935	4981	$token = Jetpack_Options::get_option( 'onboarding' );
4936	4982	if ( false === ( $token ) ) {
4937	4983	$token = wp_generate_password( 32, false );
4938	4984	Jetpack_Options::update_option( 'onboarding', $token );
		@@ -4943,11 +4989,13 @@
4943	4989
4944	4990	/**
4945	4991	* Remove the onboarding token
4946	4992	*
	4993	+ * @deprecated since 13.9
4947	4994	* @return bool True on success, false on failure
4948	4995	*/
4949	4996	public static function invalidate_onboarding_token() {
	4997	+ _deprecated_function( __METHOD__, '13.9' );
4950	4998	return Jetpack_Options::delete_option( 'onboarding' );
4951	4999	}
4952	5000
4953	5001	/**
		@@ -4952,8 +5000,10 @@
4952	5000
4953	5001	/**
4954	5002	* Validate an onboarding token for a specific action
4955	5003	*
	5004	+ * @deprecated since 13.9
	5005	+ *
4956	5006	* @param string $token Onboarding token.
4957	5007	* @param string $action Action name.
4958	5008	*
4959	5009	* @return boolean True if token/action pair is accepted, false if not
		@@ -4958,8 +5008,9 @@
4958	5008	*
4959	5009	* @return boolean True if token/action pair is accepted, false if not
4960	5010	*/
4961	5011	public static function validate_onboarding_token_action( $token, $action ) {
	5012	+ _deprecated_function( __METHOD__, '13.9' );
4962	5013	// Compare tokens, bail if tokens do not match.
4963	5014	if ( ! hash_equals( $token, Jetpack_Options::get_option( 'onboarding' ) ) ) {
4964	5015	return false;
4965	5016	}
		@@ -4985,39 +5036,41 @@
4985	5036	* @return boolean
4986	5037	* @since 2.3.3
4987	5038	*/
4988	5039	public static function permit_ssl( $force_recheck = false ) {
4989		- // Do some fancy tests to see if ssl is being supported.
4990		- if ( ! $force_recheck ) {
4991		- $ssl = get_transient( 'jetpack_https_test' );
	5040	+ if ( ! method_exists( Heartbeat::class, 'permit_ssl' ) ) {
	5041	+ // Skip the SSL-fail notice when the check cannot run.
	5042	+ return true;
4992	5043	}
4993	5044
4994		- if ( $force_recheck \|\| false === $ssl ) {
4995		- $message = '';
4996		- if ( ! str_starts_with( JETPACK__API_BASE, 'https' ) ) {
4997		- $ssl = 0;
4998		- } else {
4999		- $ssl = 1;
	5045	+ return Heartbeat::permit_ssl( $force_recheck );
	5046	+ }
5000	5047
5001		- if ( ! wp_http_supports( array( 'ssl' => true ) ) ) {
5002		- $ssl = 0;
5003		- $message = __( 'WordPress reports no SSL support', 'jetpack' );
5004		- } else {
5005		- $response = wp_remote_get( JETPACK__API_BASE . 'test/1/' );
5006		- if ( is_wp_error( $response ) ) {
5007		- $ssl = 0;
5008		- $message = __( 'WordPress reports no SSL support', 'jetpack' );
5009		- } elseif ( 'OK' !== wp_remote_retrieve_body( $response ) ) {
5010		- $ssl = 0;
5011		- $message = __( 'Response was not OK: ', 'jetpack' ) . wp_remote_retrieve_body( $response );
5012		- }
5013		- }
5014		- }
5015		- set_transient( 'jetpack_https_test', $ssl, DAY_IN_SECONDS );
5016		- set_transient( 'jetpack_https_test_message', $message, DAY_IN_SECONDS );
	5048	+ /**
	5049	+ * Returns a localized message describing the last SSL connectivity failure, if any.
	5050	+ *
	5051	+ * The Connection package's canonical SSL check stores a neutral reason code; this maps it to
	5052	+ * a translated, `jetpack`-domain message for display in the admin notice and AJAX recheck.
	5053	+ *
	5054	+ * @since 16.1
	5055	+ *
	5056	+ * @return string The localized message, or an empty string when there is no failure.
	5057	+ */
	5058	+ public static function get_ssl_test_message() {
	5059	+ if ( ! method_exists( Heartbeat::class, 'get_ssl_test_error' ) ) {
	5060	+ return '';
5017	5061	}
5018	5062
5019		- return (bool) $ssl;
	5063	+ $error = Heartbeat::get_ssl_test_error();
	5064	+
	5065	+ switch ( $error['code'] ) {
	5066	+ case 'no_ssl_support':
	5067	+ return __( 'WordPress reports no SSL support', 'jetpack' );
	5068	+ case 'bad_response':
	5069	+ return __( 'Response was not OK: ', 'jetpack' ) . $error['detail'];
	5070	+ default:
	5071	+ return '';
	5072	+ }
5020	5073	}
5021	5074
5022	5075	/**
5023	5076	* Displays an admin_notice, alerting the user that outbound SSL isn't working.
		@@ -5036,9 +5089,9 @@
5036	5089	<p><?php esc_html_e( 'Your site could not connect to WordPress.com via HTTPS. This could be due to any number of reasons, including faulty SSL certificates, misconfigured or missing SSL libraries, or network issues.', 'jetpack' ); ?></p>
5037	5090	<p>
5038	5091	<?php esc_html_e( 'Jetpack will re-test for HTTPS support once a day, but you can click here to try again immediately: ', 'jetpack' ); ?>
5039	5092	<a href="#" id="jetpack-recheck-ssl-button"><?php esc_html_e( 'Try again', 'jetpack' ); ?></a>
5040		- <span id="jetpack-recheck-ssl-output"><?php echo esc_html( get_transient( 'jetpack_https_test_message' ) ); ?></span>
	5093	+ <span id="jetpack-recheck-ssl-output"><?php echo esc_html( self::get_ssl_test_message() ); ?></span>
5041	5094	</p>
5042	5095	<p>
5043	5096	<?php
5044	5097	printf(
		@@ -5057,18 +5110,18 @@
5057	5110	<script type="text/javascript">
5058	5111	jQuery( document ).ready( function( $ ) {
5059	5112	$( '#jetpack-recheck-ssl-button' ).click( function( e ) {
5060	5113	var $this = $( this );
5061		- $this.html( <?php echo wp_json_encode( __( 'Checking', 'jetpack' ) ); ?> );
	5114	+ $this.html( <?php echo wp_json_encode( esc_html__( 'Checking', 'jetpack' ), JSON_UNESCAPED_SLASHES \| JSON_HEX_TAG \| JSON_HEX_AMP ); ?> );
5062	5115	$( '#jetpack-recheck-ssl-output' ).html( '' );
5063	5116	e.preventDefault();
5064		- var data = { action: 'jetpack-recheck-ssl', 'ajax-nonce': <?php echo wp_json_encode( $ajax_nonce ); ?> };
	5117	+ var data = { action: 'jetpack-recheck-ssl', 'ajax-nonce': <?php echo wp_json_encode( $ajax_nonce, JSON_UNESCAPED_SLASHES \| JSON_HEX_TAG \| JSON_HEX_AMP ); ?> };
5065	5118	$.post( ajaxurl, data )
5066	5119	.done( function( response ) {
5067	5120	if ( response.enabled ) {
5068	5121	$( '#jetpack-ssl-warning' ).hide();
5069	5122	} else {
5070		- this.html( <?php echo wp_json_encode( __( 'Try again', 'jetpack' ) ); ?> );
	5123	+ this.html( <?php echo wp_json_encode( esc_html__( 'Try again', 'jetpack' ), JSON_UNESCAPED_SLASHES \| JSON_HEX_TAG \| JSON_HEX_AMP ); ?> );
5071	5124	$( '#jetpack-recheck-ssl-output' ).html( 'SSL Failed: ' + response.message );
5072	5125	}
5073	5126	}.bind( $this ) );
5074	5127	} );
		@@ -5094,26 +5147,8 @@
5094	5147	return $jetpack->connection_manager;
5095	5148	}
5096	5149
5097	5150	/**
5098		- * Creates two secret tokens and the end of life timestamp for them.
5099		- *
5100		- * Note these tokens are unique per call, NOT static per site for connecting.
5101		- *
5102		- * @deprecated 9.5 Use Automattic\Jetpack\Connection\Secrets->generate() instead.
5103		- *
5104		- * @since 2.6
5105		- * @param String $action The action name.
5106		- * @param Integer $user_id The user identifier.
5107		- * @param Integer $exp Expiration time in seconds.
5108		- * @return array
5109		- */
5110		- public static function generate_secrets( $action, $user_id = false, $exp = 600 ) {
5111		- _deprecated_function( __METHOD__, 'jetpack-9.5', 'Automattic\\Jetpack\\Connection\\Secrets->generate' );
5112		- return self::connection()->generate_secrets( $action, $user_id, $exp );
5113		- }
5114		-
5115		- /**
5116	5151	* Get verification secrets.
5117	5152	*
5118	5153	* @param string $action Action name.
5119	5154	* @param int $user_id User ID.
		@@ -5134,35 +5169,8 @@
5134	5169	return $secrets;
5135	5170	}
5136	5171
5137	5172	/**
5138		- * Register a connection.
5139		- *
5140		- * @deprecated Jetpack 9.7.0
5141		- * @see Automattic\Jetpack\Connection\Manager::try_registration()
5142		- *
5143		- * @return bool\|WP_Error
5144		- */
5145		- public static function register() {
5146		- _deprecated_function( __METHOD__, 'jetpack-9.7', 'Automattic\\Jetpack\\Connection\\Manager::try_registration' );
5147		- return static::connection()->try_registration( false );
5148		- }
5149		-
5150		- /**
5151		- * Filters the registration request body to include tracking properties.
5152		- *
5153		- * @deprecated Jetpack 9.7.0
5154		- * @see Automattic\Jetpack\Connection\Utils::filter_register_request_body()
5155		- *
5156		- * @param array $properties Token request properties.
5157		- * @return array amended properties.
5158		- */
5159		- public static function filter_register_request_body( $properties ) {
5160		- _deprecated_function( __METHOD__, 'jetpack-9.7', 'Automattic\\Jetpack\\Connection\\Utils::filter_register_request_body' );
5161		- return Connection_Utils::filter_register_request_body( $properties );
5162		- }
5163		-
5164		- /**
5165	5173	* Filters the token request body to include tracking properties.
5166	5174	*
5167	5175	* @param array $properties Token request properties.
5168	5176	*
		@@ -5183,9 +5191,9 @@
5183	5191
5184	5192	/**
5185	5193	* If the db version is showing something other that what we've got now, bump it to current.
5186	5194	*
5187		- * @return bool: True if the option was incorrect and updated, false if nothing happened.
	5195	+ * @return bool True if the option was incorrect and updated, false if nothing happened.
5188	5196	*/
5189	5197	public static function maybe_set_version_option() {
5190	5198	list( $version ) = explode( ':', Jetpack_Options::get_option( 'version' ) );
5191	5199	if ( JETPACK__VERSION !== $version ) {
		@@ -5203,21 +5211,8 @@
5203	5211
5204	5212	/* Client Server API */
5205	5213
5206	5214	/**
5207		- * Loads the Jetpack XML-RPC client.
5208		- * No longer necessary, as the XML-RPC client will be automagically loaded.
5209		- *
5210		- * Note: we cannot remove this function yet as it is used in this plugin:
5211		- * https://wordpress.org/plugins/jetpack-subscription-form/
5212		- *
5213		- * @deprecated since 7.7.0
5214		- */
5215		- public static function load_xml_rpc_client() {
5216		- _deprecated_function( __METHOD__, 'jetpack-7.7' );
5217		- }
5218		-
5219		- /**
5220	5215	* State is passed via cookies from one request to the next, but never to subsequent requests.
5221	5216	* SET: state( $key, $value );
5222	5217	* GET: $value = state( $key );
5223	5218	*
		@@ -5291,20 +5286,8 @@
5291	5286
5292	5287	self::state( 'privacy_checks', $privacy_checks );
5293	5288	}
5294	5289
5295		- /**
5296		- * Serve a WordPress.com static resource via a randomized wp.com subdomain.
5297		- *
5298		- * @deprecated 9.3.0 Use Assets::staticize_subdomain.
5299		- *
5300		- * @param string $url WordPress.com static resource URL.
5301		- */
5302		- public static function staticize_subdomain( $url ) {
5303		- _deprecated_function( __METHOD__, 'jetpack-9.3.0', 'Automattic\Jetpack\Assets::staticize_subdomain' );
5304		- return Assets::staticize_subdomain( $url );
5305		- }
5306		-
5307	5290	/* JSON API Authorization */
5308	5291
5309	5292	/**
5310	5293	* Handles the login action for Authorizing the JSON API
		@@ -5309,13 +5292,14 @@
5309	5292	/**
5310	5293	* Handles the login action for Authorizing the JSON API
5311	5294	*/
5312	5295	public function login_form_json_api_authorization() {
5313		- $this->verify_json_api_authorization_request();
	5296	+ $authorize_json_api = new Authorize_Json_Api();
	5297	+ $authorize_json_api->verify_json_api_authorization_request();
5314	5298
5315		- add_action( 'wp_login', array( $this, 'store_json_api_authorization_token' ), 10, 2 );
	5299	+ add_action( 'wp_login', array( $authorize_json_api, 'store_json_api_authorization_token' ), 10, 2 );
5316	5300
5317		- add_action( 'login_message', array( $this, 'login_message_json_api_authorization' ) );
	5301	+ add_action( 'login_message', array( $authorize_json_api, 'login_message_json_api_authorization' ) );
5318	5302	add_action( 'login_form', array( $this, 'preserve_action_in_login_form_for_json_api_authorization' ) );
5319	5303	add_filter( 'site_url', array( $this, 'post_login_form_to_signed_url' ), 10, 3 );
5320	5304	}
5321	5305
		@@ -5353,16 +5337,17 @@
5353	5337
5354	5338	/**
5355	5339	* If someone logs in to approve API access, store the Access Code in usermeta.
5356	5340	*
	5341	+ * @deprecated 13.4
	5342	+ *
5357	5343	* @param string $user_login Unused.
5358	5344	* @param WP_User $user User logged in.
5359	5345	*/
5360	5346	public function store_json_api_authorization_token( $user_login, $user ) {
5361		- add_filter( 'login_redirect', array( $this, 'add_token_to_login_redirect_json_api_authorization' ), 10, 3 );
5362		- add_filter( 'allowed_redirect_hosts', array( $this, 'allow_wpcom_public_api_domain' ) );
5363		- $token = wp_generate_password( 32, false );
5364		- update_user_meta( $user->ID, 'jetpack_json_api_' . $this->json_api_authorization_request['client_id'], $token );
	5347	+ _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Connection\\Authorize_Json_Api::store_json_api_authorization_token' );
	5348	+
	5349	+ return ( new Authorize_Json_Api() )->store_json_api_authorization_token( $user_login, $user );
5365	5350	}
5366	5351
5367	5352	/**
5368	5353	* Add public-api.wordpress.com to the safe redirect allowed list - only added when someone allows API access.
		@@ -5368,23 +5353,29 @@
5368	5353	* Add public-api.wordpress.com to the safe redirect allowed list - only added when someone allows API access.
5369	5354	*
5370	5355	* To be used with a filter of allowed domains for a redirect.
5371	5356	*
	5357	+ * @deprecated 13.4
	5358	+ *
5372	5359	* @param array $domains Allowed WP.com Environments.
5373	5360	*/
5374	5361	public function allow_wpcom_public_api_domain( $domains ) {
5375		- $domains[] = 'public-api.wordpress.com';
5376		- return $domains;
	5362	+ _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Status\\Host::allow_wpcom_public_api_domain' );
	5363	+
	5364	+ return Host::allow_wpcom_public_api_domain( $domains );
5377	5365	}
5378	5366
5379	5367	/**
5380	5368	* Check if the redirect is encoded.
5381	5369	*
	5370	+ * @deprecated 13.4
	5371	+ *
5382	5372	* @param string $redirect_url Redirect URL.
5383	5373	*
5384	5374	* @return bool If redirect has been encoded.
5385	5375	*/
5386	5376	public static function is_redirect_encoded( $redirect_url ) {
	5377	+ _deprecated_function( __METHOD__, 'jetpack-13.4' );
5387	5378	return preg_match( '/https?%3A%2F%2F/i', $redirect_url ) > 0;
5388	5379	}
5389	5380
5390	5381	/**
		@@ -5402,8 +5393,10 @@
5402	5393
5403	5394	/**
5404	5395	* Add the Access Code details to the public-api.wordpress.com redirect.
5405	5396	*
	5397	+ * @deprecated 13.4
	5398	+ *
5406	5399	* @param string $redirect_to URL.
5407	5400	* @param string $original_redirect_to URL.
5408	5401	* @param WP_User $user WP_User for the redirect.
5409	5402	*
		@@ -5409,23 +5402,18 @@
5409	5402	*
5410	5403	* @return string
5411	5404	*/
5412	5405	public function add_token_to_login_redirect_json_api_authorization( $redirect_to, $original_redirect_to, $user ) {
5413		- return add_query_arg(
5414		- urlencode_deep(
5415		- array(
5416		- 'jetpack-code' => get_user_meta( $user->ID, 'jetpack_json_api_' . $this->json_api_authorization_request['client_id'], true ),
5417		- 'jetpack-user-id' => (int) $user->ID,
5418		- 'jetpack-state' => $this->json_api_authorization_request['state'],
5419		- )
5420		- ),
5421		- $redirect_to
5422		- );
	5406	+ _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Connection\\Authorize_Json_Api::add_token_to_login_redirect_json_api_authorization' );
	5407	+
	5408	+ return ( new Authorize_Json_Api() )->add_token_to_login_redirect_json_api_authorization( $redirect_to, $original_redirect_to, $user );
5423	5409	}
5424	5410
5425	5411	/**
5426	5412	* Verifies the request by checking the signature
5427	5413	*
	5414	+ * @deprecated 13.4
	5415	+ *
5428	5416	* @since 4.6.0 Method was updated to use `$_REQUEST` instead of `$_GET` and `$_POST`. Method also updated to allow
5429	5417	* passing in an `$environment` argument that overrides `$_REQUEST`. This was useful for integrating with SSO.
5430	5418	*
5431	5419	* @param null\|array $environment Value to override $_REQUEST.
		@@ -5430,194 +5418,24 @@
5430	5418	*
5431	5419	* @param null\|array $environment Value to override $_REQUEST.
5432	5420	*/
5433	5421	public function verify_json_api_authorization_request( $environment = null ) {
5434		- $environment = $environment === null
5435		- ? $_REQUEST // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- nonce verification handled later in function.
5436		- : $environment;
	5422	+ _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Connection\\Authorize_Json_Api::verify_json_api_authorization_request' );
5437	5423
5438		- list( $env_token,, $env_user_id ) = explode( ':', $environment['token'] );
5439		- $token = ( new Tokens() )->get_access_token( $env_user_id, $env_token );
5440		- if ( ! $token \|\| empty( $token->secret ) ) {
5441		- wp_die( esc_html__( 'You must connect your Jetpack plugin to WordPress.com to use this feature.', 'jetpack' ) );
5442		- }
5443		-
5444		- $die_error = __( 'Someone may be trying to trick you into giving them access to your site. Or it could be you just encountered a bug :). Either way, please close this window.', 'jetpack' );
5445		-
5446		- // Host has encoded the request URL, probably as a result of a bad http => https redirect.
5447		- if ( self::is_redirect_encoded( esc_url_raw( wp_unslash( $_GET['redirect_to'] ) ) ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- no site changes, we're erroring out.
5448		- /**
5449		- * Jetpack authorisation request Error.
5450		- *
5451		- * @since 7.5.0
5452		- */
5453		- do_action( 'jetpack_verify_api_authorization_request_error_double_encode' );
5454		- $die_error = sprintf(
5455		- /* translators: %s is a URL */
5456		- __( 'Your site is incorrectly double-encoding redirects from http to https. This is preventing Jetpack from authenticating your connection. Please visit our <a href="%s">support page</a> for details about how to resolve this.', 'jetpack' ),
5457		- esc_url( Redirect::get_url( 'jetpack-support-double-encoding' ) )
5458		- );
5459		- }
5460		-
5461		- $jetpack_signature = new Jetpack_Signature( $token->secret, (int) Jetpack_Options::get_option( 'time_diff' ) );
5462		-
5463		- if ( isset( $environment['jetpack_json_api_original_query'] ) ) {
5464		- $signature = $jetpack_signature->sign_request(
5465		- $environment['token'],
5466		- $environment['timestamp'],
5467		- $environment['nonce'],
5468		- '',
5469		- 'GET',
5470		- $environment['jetpack_json_api_original_query'],
5471		- null,
5472		- true
5473		- );
5474		- } else {
5475		- $signature = $jetpack_signature->sign_current_request(
5476		- array(
5477		- 'body' => null,
5478		- 'method' => 'GET',
5479		- )
5480		- );
5481		- }
5482		-
5483		- if ( ! $signature ) {
5484		- wp_die(
5485		- wp_kses(
5486		- $die_error,
5487		- array(
5488		- 'a' => array(
5489		- 'href' => array(),
5490		- ),
5491		- )
5492		- )
5493		- );
5494		- } elseif ( is_wp_error( $signature ) ) {
5495		- wp_die(
5496		- wp_kses(
5497		- $die_error,
5498		- array(
5499		- 'a' => array(
5500		- 'href' => array(),
5501		- ),
5502		- )
5503		- )
5504		- );
5505		- } elseif ( ! hash_equals( $signature, $environment['signature'] ) ) {
5506		- if ( is_ssl() ) {
5507		- // If we signed an HTTP request on the Jetpack Servers, but got redirected to HTTPS by the local blog, check the HTTP signature as well.
5508		- $signature = $jetpack_signature->sign_current_request(
5509		- array(
5510		- 'scheme' => 'http',
5511		- 'body' => null,
5512		- 'method' => 'GET',
5513		- )
5514		- );
5515		- if ( ! $signature \|\| is_wp_error( $signature ) \|\| ! hash_equals( $signature, $environment['signature'] ) ) {
5516		- wp_die(
5517		- wp_kses(
5518		- $die_error,
5519		- array(
5520		- 'a' => array(
5521		- 'href' => array(),
5522		- ),
5523		- )
5524		- )
5525		- );
5526		- }
5527		- } else {
5528		- wp_die(
5529		- wp_kses(
5530		- $die_error,
5531		- array(
5532		- 'a' => array(
5533		- 'href' => array(),
5534		- ),
5535		- )
5536		- )
5537		- );
5538		- }
5539		- }
5540		-
5541		- $timestamp = (int) $environment['timestamp'];
5542		- $nonce = stripslashes( (string) $environment['nonce'] );
5543		-
5544		- if ( ! $this->connection_manager ) {
5545		- $this->connection_manager = new Connection_Manager();
5546		- }
5547		-
5548		- if ( ! ( new Nonce_Handler() )->add( $timestamp, $nonce ) ) {
5549		- // De-nonce the nonce, at least for 5 minutes.
5550		- // We have to reuse this nonce at least once (used the first time when the initial request is made, used a second time when the login form is POSTed).
5551		- $old_nonce_time = get_option( "jetpack_nonce_{$timestamp}_{$nonce}" );
5552		- if ( $old_nonce_time < time() - 300 ) {
5553		- wp_die( esc_html__( 'The authorization process expired. Please go back and try again.', 'jetpack' ) );
5554		- }
5555		- }
5556		-
5557		- $data = json_decode( base64_decode( stripslashes( $environment['data'] ) ) ); // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_decode
5558		- $data_filters = array(
5559		- 'state' => 'opaque',
5560		- 'client_id' => 'int',
5561		- 'client_title' => 'string',
5562		- 'client_image' => 'url',
5563		- );
5564		-
5565		- foreach ( $data_filters as $key => $sanitation ) {
5566		- if ( ! isset( $data->$key ) ) {
5567		- wp_die(
5568		- wp_kses(
5569		- $die_error,
5570		- array(
5571		- 'a' => array(
5572		- 'href' => array(),
5573		- ),
5574		- )
5575		- )
5576		- );
5577		- }
5578		-
5579		- switch ( $sanitation ) {
5580		- case 'int':
5581		- $this->json_api_authorization_request[ $key ] = (int) $data->$key;
5582		- break;
5583		- case 'opaque':
5584		- $this->json_api_authorization_request[ $key ] = (string) $data->$key;
5585		- break;
5586		- case 'string':
5587		- $this->json_api_authorization_request[ $key ] = wp_kses( (string) $data->$key, array() );
5588		- break;
5589		- case 'url':
5590		- $this->json_api_authorization_request[ $key ] = esc_url_raw( (string) $data->$key );
5591		- break;
5592		- }
5593		- }
5594		-
5595		- if ( empty( $this->json_api_authorization_request['client_id'] ) ) {
5596		- wp_die(
5597		- wp_kses(
5598		- $die_error,
5599		- array(
5600		- 'a' => array(
5601		- 'href' => array(),
5602		- ),
5603		- )
5604		- )
5605		- );
5606		- }
	5424	+ return ( new Authorize_Json_Api() )->verify_json_api_authorization_request( $environment );
5607	5425	}
5608	5426
5609	5427	/**
5610	5428	* HTML for the JSON API authorization notice.
5611	5429	*
	5430	+ * @deprecated 13.4
	5431	+ *
5612	5432	* @return string
5613	5433	*/
5614	5434	public function login_message_json_api_authorization() {
5615		- return '<p class="message">' . sprintf(
5616		- /* translators: Name/image of the client requesting authorization */
5617		- esc_html__( '%s wants to access your site’s data. Log in to authorize that access.', 'jetpack' ),
5618		- '<strong>' . esc_html( $this->json_api_authorization_request['client_title'] ) . '</strong>'
5619		- ) . '<img src="' . esc_url( $this->json_api_authorization_request['client_image'] ) . '" /></p>';
	5435	+ _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Connection\\Authorize_Json_Api::login_message_json_api_authorization' );
	5436	+
	5437	+ return ( new Authorize_Json_Api() )->login_message_json_api_authorization();
5620	5438	}
5621	5439
5622	5440	/**
5623	5441	* Get $content_width, but with a <s>twist</s> filter.
		@@ -5661,28 +5479,20 @@
5661	5479
5662	5480	/**
5663	5481	* Checks if the site is currently in an identity crisis.
5664	5482	*
	5483	+ * Now delegates to the Connection package so this matches what the heartbeat itself reports.
	5484	+ * Note the package guards on `Connection\Manager::is_connected()` where this used to guard on
	5485	+ * `Jetpack::is_connection_ready()`, so the `jetpack_is_connection_ready` filter no longer applies.
	5486	+ *
	5487	+ * @deprecated 16.2
	5488	+ *
5665	5489	* @return array\|bool Array of options that are in a crisis, or false if everything is OK.
5666	5490	*/
5667	5491	public static function check_identity_crisis() {
5668		- if ( ! self::is_connection_ready() \|\| ( new Status() )->is_offline_mode() \|\| ! Identity_Crisis::validate_sync_error_idc_option() ) {
5669		- return false;
5670		- }
5671		- return Jetpack_Options::get_option( 'sync_error_idc' );
5672		- }
	5492	+ _deprecated_function( __METHOD__, 'jetpack-16.2', 'Automattic\\Jetpack\\Identity_Crisis::check_identity_crisis' );
5673	5493
5674		- /**
5675		- * Checks whether the sync_error_idc option is valid or not, and if not, will do cleanup.
5676		- *
5677		- * @since 4.4.0
5678		- * @since 5.4.0 Do not call get_sync_error_idc_option() unless site is in IDC
5679		- *
5680		- * @return bool
5681		- */
5682		- public static function validate_sync_error_idc_option() {
5683		- _deprecated_function( __METHOD__, 'jetpack-9.8', '\\Automattic\\Jetpack\\Identity_Crisis::validate_sync_error_idc_option' );
5684		- return Identity_Crisis::validate_sync_error_idc_option();
	5494	+ return Identity_Crisis::check_identity_crisis();
5685	5495	}
5686	5496
5687	5497	/**
5688	5498	* Normalizes a url by doing three things:
		@@ -5706,35 +5516,8 @@
5706	5516	return $url;
5707	5517	}
5708	5518
5709	5519	/**
5710		- * Gets the value that is to be saved in the jetpack_sync_error_idc option.
5711		- *
5712		- * @since 4.4.0
5713		- * @since 5.4.0 Add transient since home/siteurl retrieved directly from DB
5714		- * @deprecated 9.8.0 Use \\Automattic\\Jetpack\\Identity_Crisis::get_sync_error_idc_option
5715		- *
5716		- * @param array $response HTTP response.
5717		- * @return array Array of the local urls, wpcom urls, and error code
5718		- */
5719		- public static function get_sync_error_idc_option( $response = array() ) {
5720		- _deprecated_function( __METHOD__, 'jetpack-9.8', '\\Automattic\\Jetpack\\Identity_Crisis::get_sync_error_idc_option' );
5721		- return Identity_Crisis::get_sync_error_idc_option( $response );
5722		- }
5723		-
5724		- /**
5725		- * Returns the value of the jetpack_sync_idc_optin filter, or constant.
5726		- * If set to true, the site will be put into staging mode.
5727		- *
5728		- * @since 4.3.2
5729		- * @return bool
5730		- */
5731		- public static function sync_idc_optin() {
5732		- _deprecated_function( __METHOD__, 'jetpack-9.8', '\\Automattic\\Jetpack\\Identity_Crisis::sync_idc_optin' );
5733		- return Identity_Crisis::sync_idc_optin();
5734		- }
5735		-
5736		- /**
5737	5520	* Maybe Use a .min.css stylesheet, maybe not.
5738	5521	*
5739	5522	* Hooks onto `plugins_url` filter at priority 1, and accepts all 3 args.
5740	5523	*
		@@ -5797,9 +5580,9 @@
5797	5580	*
5798	5581	* @return mixed
5799	5582	*/
5800	5583	public static function set_suffix_on_min( $src, $handle ) {
5801		- if ( ! str_contains( $src, '.min.css' ) ) {
	5584	+ if ( ! is_string( $src ) \|\| ! str_contains( $src, '.min.css' ) ) {
5802	5585	return $src;
5803	5586	}
5804	5587
5805	5588	if ( ! empty( self::$min_assets ) ) {
		@@ -5835,8 +5618,10 @@
5835	5618	*
5836	5619	* Data passed in with the $data parameter will be available in the
5837	5620	* template file as $data['value']
5838	5621	*
	5622	+ * @html-template-var array $data
	5623	+ *
5839	5624	* @param string $template - Template file to load.
5840	5625	* @param array $data - Any data to pass along to the template.
5841	5626	* @return boolean - If template file was found.
5842	5627	**/
		@@ -5854,8 +5639,19 @@
5854	5639	return false;
5855	5640	}
5856	5641
5857	5642	/**
	5643	+ * Register Jetpack-specific tests on the connection package's health test suite.
	5644	+ *
	5645	+ * @param \Automattic\Jetpack\Connection\Connection_Health_Tests $connection_tests The test suite instance.
	5646	+ */
	5647	+ public function register_jetpack_connection_tests( $connection_tests ) {
	5648	+ require_once JETPACK__PLUGIN_DIR . '_inc/lib/debugger/class-jetpack-cxn-tests.php';
	5649	+ $jetpack_tests = new Jetpack_Cxn_Tests();
	5650	+ $jetpack_tests->register_tests_on( $connection_tests );
	5651	+ }
	5652	+
	5653	+ /**
5858	5654	* Throws warnings for deprecated hooks to be removed from Jetpack that cannot remain in the original place in the code.
5859	5655	*/
5860	5656	public function deprecated_hooks() {
5861	5657	$filter_deprecated_list = array(
		@@ -6071,8 +5867,18 @@
6071	5867	'jetpack_subscriptions_modal_enabled' => array(
6072	5868	'replacement' => null,
6073	5869	'version' => 'jetpack-12.7.0',
6074	5870	),
	5871	+ 'jetpack_pre_connection_prompt_helpers' => array(
	5872	+ 'replacement' => null,
	5873	+ 'version' => 'jetpack-13.2.0',
	5874	+ ),
	5875	+ 'jetpack_contact_form_use_package' => array(
	5876	+ 'replacement' => null,
	5877	+ 'version' => 'jetpack-13.4.0',
	5878	+ ),
	5879	+ // jetpack_implode_frontend_css has been removed, but is not listed here. The updated behavior is exactly the only use of the filter.
	5880	+ // We can reassess formally deprecating it here later; for now, it would be noise with no functional difference.
6075	5881	);
6076	5882
6077	5883	foreach ( $filter_deprecated_list as $tag => $args ) {
6078	5884	if ( has_filter( $tag ) ) {
		@@ -6203,125 +6009,8 @@
6203	6009	return $css;
6204	6010	}
6205	6011
6206	6012	/**
6207		- * This methods removes all of the registered css files on the front end
6208		- * from Jetpack in favor of using a single file. In effect "imploding"
6209		- * all the files into one file.
6210		- *
6211		- * Pros:
6212		- * - Uses only ONE css asset connection instead of 15
6213		- * - Saves a minimum of 56k
6214		- * - Reduces server load
6215		- * - Reduces time to first painted byte
6216		- *
6217		- * Cons:
6218		- * - Loads css for ALL modules. However all selectors are prefixed so it
6219		- * should not cause any issues with themes.
6220		- * - Plugins/themes dequeuing styles no longer do anything. See
6221		- * jetpack_implode_frontend_css filter for a workaround
6222		- *
6223		- * For some situations developers may wish to disable css imploding and
6224		- * instead operate in legacy mode where each file loads seperately and
6225		- * can be edited individually or dequeued. This can be accomplished with
6226		- * the following line:
6227		- *
6228		- * add_filter( 'jetpack_implode_frontend_css', '__return_false' );
6229		- *
6230		- * @param bool $travis_test Is this a test run.
6231		- *
6232		- * @since 3.2
6233		- */
6234		- public function implode_frontend_css( $travis_test = false ) {
6235		- $do_implode = true;
6236		- if ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) {
6237		- $do_implode = false;
6238		- }
6239		-
6240		- // Do not implode CSS when the page loads via the AMP plugin.
6241		- if ( class_exists( Jetpack_AMP_Support::class ) && Jetpack_AMP_Support::is_amp_request() ) {
6242		- $do_implode = false;
6243		- }
6244		-
6245		- /*
6246		- * Only proceed if at least 2 modules with concatenated CSS are active.
6247		- * There is no point in serving a big concatenated CSS file
6248		- * if there are no features (or only one) that actually need some CSS loaded.
6249		- */
6250		- $active_modules = self::get_active_modules();
6251		- $modules_with_concatenated_css = $this->modules_with_concatenated_css;
6252		- $active_module_with_css_count = count( array_intersect( $active_modules, $modules_with_concatenated_css ) );
6253		- if ( $active_module_with_css_count < 2 ) {
6254		- $do_implode = false;
6255		- }
6256		-
6257		- /**
6258		- * Allow CSS to be concatenated into a single jetpack.css file.
6259		- *
6260		- * @since 3.2.0
6261		- *
6262		- * @param bool $do_implode Should CSS be concatenated? Default to true.
6263		- */
6264		- $do_implode = apply_filters( 'jetpack_implode_frontend_css', $do_implode );
6265		-
6266		- // Do not use the imploded file when default behavior was altered through the filter.
6267		- if ( ! $do_implode ) {
6268		- return;
6269		- }
6270		-
6271		- // We do not want to use the imploded file in dev mode, or if not connected.
6272		- if ( ( new Status() )->is_offline_mode() \|\| ! self::is_connection_ready() ) {
6273		- if ( ! $travis_test ) {
6274		- return;
6275		- }
6276		- }
6277		-
6278		- // Do not use the imploded file if sharing css was dequeued via the sharing settings screen.
6279		- if ( get_option( 'sharedaddy_disable_resources' ) ) {
6280		- return;
6281		- }
6282		-
6283		- /*
6284		- * Now we assume Jetpack is connected and able to serve the single
6285		- * file.
6286		- *
6287		- * In the future there will be a check here to serve the file locally
6288		- * or potentially from the Jetpack CDN
6289		- *
6290		- * For now:
6291		- * - Enqueue a single imploded css file
6292		- * - Zero out the style_loader_tag for the bundled ones
6293		- * - Be happy, drink scotch
6294		- */
6295		-
6296		- add_filter( 'style_loader_tag', array( $this, 'concat_remove_style_loader_tag' ), 10, 2 );
6297		-
6298		- $version = self::is_development_version() ? filemtime( JETPACK__PLUGIN_DIR . 'css/jetpack.css' ) : JETPACK__VERSION;
6299		-
6300		- wp_enqueue_style( 'jetpack_css', plugins_url( 'css/jetpack.css', __FILE__ ), array(), $version );
6301		- wp_style_add_data( 'jetpack_css', 'rtl', 'replace' );
6302		- }
6303		-
6304		- /**
6305		- * Removes styles that are part of concatenated group.
6306		- *
6307		- * @param string $tag Style tag.
6308		- * @param string $handle Style handle.
6309		- *
6310		- * @return string
6311		- */
6312		- public function concat_remove_style_loader_tag( $tag, $handle ) {
6313		- if ( in_array( $handle, $this->concatenated_style_handles, true ) ) {
6314		- $tag = '';
6315		- if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
6316		- $tag = '<!-- `' . esc_html( $handle ) . "` is included in the concatenated jetpack.css -->\r\n";
6317		- }
6318		- }
6319		-
6320		- return $tag;
6321		- }
6322		-
6323		- /**
6324	6013	* Check the heartbeat data
6325	6014	*
6326	6015	* Organizes the heartbeat data by severity. For example, if the site
6327	6016	* is in an ID crisis, it will be in the $filtered_data['bad'] array.
		@@ -6333,9 +6022,23 @@
6333	6022	*
6334	6023	* $return array $filtered_data
6335	6024	*/
6336	6025	public static function jetpack_check_heartbeat_data() {
6337		- $raw_data = Jetpack_Heartbeat::generate_stats_array();
	6026	+ /*
	6027	+ * Site environment stats (incl. wp-version/php-version checked below) now live in the Connection package,
	6028	+ * and the IDC stat is contributed by the Connection package's `jetpack_heartbeat_stats_array` filter
	6029	+ * callback. We rebuild the stat here rather than running that filter: the filter's callbacks have side
	6030	+ * effects (Connection\Manager::add_stats_to_heartbeat() consumes and deletes the `xmlrpc_errors` option)
	6031	+ * and return non-scalar values, neither of which is appropriate for this read-only diagnostic.
	6032	+ */
	6033	+ $env_stats = method_exists( Heartbeat::class, 'get_environment_stats' )
	6034	+ ? Heartbeat::get_environment_stats()
	6035	+ : array();
	6036	+ $raw_data = array_merge(
	6037	+ Jetpack_Heartbeat::generate_stats_array(),
	6038	+ $env_stats,
	6039	+ array( 'identitycrisis' => Identity_Crisis::check_identity_crisis() ? 'yes' : 'no' )
	6040	+ );
6338	6041
6339	6042	$good = array();
6340	6043	$caution = array();
6341	6044	$bad = array();
		@@ -6401,23 +6104,8 @@
6401	6104	return Jetpack_Options::get_options_for_reset();
6402	6105	}
6403	6106
6404	6107	/**
6405		- * Strip http:// or https:// from a url, replaces forward slash with ::,
6406		- * so we can bring them directly to their site in calypso.
6407		- *
6408		- * @deprecated 9.2.0 Use Automattic\Jetpack\Status::get_site_suffix
6409		- *
6410		- * @param string $url URL.
6411		- * @return string url without the guff.
6412		- */
6413		- public static function build_raw_urls( $url ) {
6414		- _deprecated_function( __METHOD__, 'jetpack-9.2.0', 'Automattic\Jetpack\Status::get_site_suffix' );
6415		-
6416		- return ( new Status() )->get_site_suffix( $url );
6417		- }
6418		-
6419		- /**
6420	6108	* Get the user's meta box order.
6421	6109	*
6422	6110	* @param array $sorted Value for the user's option.
6423	6111	* @return mixed
		@@ -6446,68 +6134,9 @@
6446	6134	}
6447	6135
6448	6136	return $sorted;
6449	6137	}
6450		-
6451	6138	/**
6452		- * Adds a "blank" column in the user admin table to display indication of user connection.
6453		- *
6454		- * @param array $columns User list table columns.
6455		- *
6456		- * @return array
6457		- */
6458		- public function jetpack_icon_user_connected( $columns ) {
6459		- $columns['user_jetpack'] = '';
6460		- return $columns;
6461		- }
6462		-
6463		- /**
6464		- * Show Jetpack icon if the user is linked.
6465		- *
6466		- * @param string $val HTML for the icon.
6467		- * @param string $col User list table column.
6468		- * @param int $user_id User ID.
6469		- *
6470		- * @return string
6471		- */
6472		- public function jetpack_show_user_connected_icon( $val, $col, $user_id ) {
6473		- if ( 'user_jetpack' === $col && self::connection()->is_user_connected( $user_id ) ) {
6474		- $jetpack_logo = new Jetpack_Logo();
6475		- $emblem_html = sprintf(
6476		- '<a title="%1$s" class="jp-emblem-user-admin">%2$s</a>',
6477		- esc_attr__( 'This user is linked and ready to fly with Jetpack.', 'jetpack' ),
6478		- $jetpack_logo->get_jp_emblem()
6479		- );
6480		- return $emblem_html;
6481		- }
6482		-
6483		- return $val;
6484		- }
6485		-
6486		- /**
6487		- * Style the Jetpack user column
6488		- */
6489		- public function jetpack_user_col_style() {
6490		- global $current_screen;
6491		- if ( ! empty( $current_screen->base ) && 'users' === $current_screen->base ) {
6492		- ?>
6493		- <style>
6494		- .fixed .column-user_jetpack {
6495		- width: 21px;
6496		- }
6497		- .jp-emblem-user-admin svg {
6498		- width: 20px;
6499		- height: 20px;
6500		- }
6501		- .jp-emblem-user-admin path {
6502		- fill: #069e08;
6503		- }
6504		- </style>
6505		- <?php
6506		- }
6507		- }
6508		-
6509		- /**
6510	6139	* Checks if Akismet is active and working.
6511	6140	*
6512	6141	* We dropped support for Akismet 3.0 with Jetpack 6.1.1 while introducing a check for an Akismet valid key
6513	6142	* that implied usage of methods present since more recent version.
		@@ -6668,13 +6297,20 @@
6668	6297	}
6669	6298	}
6670	6299
6671	6300	/**
6672		- * Returns a boolean for whether backups UI should be displayed or not.
	6301	+ * Whether UI for backups should be displayed.
6673	6302	*
	6303	+ * On WPCom platforms this is gated on the backups-self-serve site feature.
	6304	+ * On self-hosted Jetpack sites it falls back to the jetpack_show_backups filter.
	6305	+ *
6674	6306	* @return bool Should backups UI be displayed?
6675	6307	*/
6676	6308	public static function show_backups_ui() {
	6309	+ if ( ( new \Automattic\Jetpack\Status\Host() )->is_wpcom_platform() ) {
	6310	+ return function_exists( 'wpcom_site_has_feature' ) && wpcom_site_has_feature( 'backups-self-serve' );
	6311	+ }
	6312	+
6677	6313	/**
6678	6314	* Whether UI for backups should be displayed.
6679	6315	*
6680	6316	* @since 6.5.0
		@@ -6684,8 +6320,24 @@
6684	6320	return self::is_plugin_active( 'vaultpress/vaultpress.php' ) \|\| apply_filters( 'jetpack_show_backups', true );
6685	6321	}
6686	6322
6687	6323	/**
	6324	+ * Whether UI for security scanning should be displayed.
	6325	+ *
	6326	+ * On WPCom platforms this is gated on the scan-self-serve site feature.
	6327	+ * On self-hosted Jetpack sites it always returns true.
	6328	+ *
	6329	+ * @return bool Should scan UI be displayed?
	6330	+ */
	6331	+ public static function show_scan_ui() {
	6332	+ if ( ( new \Automattic\Jetpack\Status\Host() )->is_wpcom_platform() ) {
	6333	+ return function_exists( 'wpcom_site_has_feature' ) && wpcom_site_has_feature( 'scan-self-serve' );
	6334	+ }
	6335	+
	6336	+ return true;
	6337	+ }
	6338	+
	6339	+ /**
6688	6340	* Clean leftoveruser meta.
6689	6341	*
6690	6342	* Delete Jetpack-related user meta when it is no longer needed.
6691	6343	*
		@@ -6772,8 +6424,25 @@
6772	6424	_x( 'Increase earnings with WordAds', 'Creator Product Feature', 'jetpack' ),
6773	6425	),
6774	6426	);
6775	6427
	6428	+ $products['growth'] = array(
	6429	+ 'title' => __( 'Jetpack Growth', 'jetpack' ),
	6430	+ 'slug' => 'jetpack_growth_yearly',
	6431	+ 'description' => __( 'Essential tools to help you grow your audience, track visitor engagement, and turn leads into loyal customers and advocates.', 'jetpack' ),
	6432	+ 'show_promotion' => true,
	6433	+ 'discount_percent' => 50,
	6434	+ 'included_in_plans' => array( 'complete' ),
	6435	+ 'features' => array(
	6436	+ _x( 'Jetpack Social', 'Growth Product Feature', 'jetpack' ),
	6437	+ _x( 'Jetpack Stats (10K site views, upgradeable)', 'Growth Product Feature', 'jetpack' ),
	6438	+ _x( 'Unlimited subscriber imports', 'Growth Product Feature', 'jetpack' ),
	6439	+ _x( 'Earn more from your content', 'Growth Product Feature', 'jetpack' ),
	6440	+ _x( 'Accept payments with PayPal', 'Growth Product Feature', 'jetpack' ),
	6441	+ _x( 'Increase earnings with WordAds', 'Growth Product Feature', 'jetpack' ),
	6442	+ ),
	6443	+ );
	6444	+
6776	6445	$products['scan'] = array(
6777	6446	'title' => __( 'Jetpack Scan', 'jetpack' ),
6778	6447	'slug' => 'jetpack_scan',
6779	6448	'description' => __( 'Automatic scanning and one-click fixes keep your site one step ahead of security threats and malware.', 'jetpack' ),
		@@ -6897,6 +6566,108 @@
6897	6566	return false;
6898	6567	}
6899	6568
6900	6569	return true;
	6570	+ }
	6571	+
	6572	+ /**
	6573	+ * Add 5-star review link on the Jetpack Plugin meta, in the plugins list table (on the plugins page).
	6574	+ *
	6575	+ * @param array $plugin_meta An array of the plugin's metadata.
	6576	+ * @param string $plugin_file Path to the plugin file.
	6577	+ *
	6578	+ * @return array $plugin_meta An array of the plugin's metadata.
	6579	+ */
	6580	+ public function add_5_star_review_link( $plugin_meta, $plugin_file ) {
	6581	+ if ( $plugin_file !== 'jetpack/jetpack.php' ) {
	6582	+ return $plugin_meta;
	6583	+ }
	6584	+
	6585	+ $u = get_current_user_id();
	6586	+ $site = get_site_url();
	6587	+
	6588	+ $plugin_meta[] = '<a href="https://jetpack.com/redirect?source=jetpack-plugin-review&site=' . esc_attr( $site ) . '&u=' . esc_attr( $u ) . '" target="_blank" rel="noopener noreferrer" title="' . esc_attr__( 'Rate Jetpack on WordPress.org', 'jetpack' ) . '" style="color: #ffb900">'
	6589	+ . str_repeat( '<span class="dashicons dashicons-star-filled" style="font-size: 16px; width:16px; height: 16px"></span>', 5 )
	6590	+ . '</a>';
	6591	+
	6592	+ return $plugin_meta;
	6593	+ }
	6594	+
	6595	+ /**
	6596	+ * Lazy instantiation of the Plugin_Tracking object.
	6597	+ *
	6598	+ * @since 13.9
	6599	+ *
	6600	+ * @return void
	6601	+ */
	6602	+ public function initialize_tracking() {
	6603	+ if ( did_action( 'jetpack_initialize_tracking' ) > 1 ) {
	6604	+ // Only need to run once.
	6605	+ return;
	6606	+ }
	6607	+
	6608	+ if ( ( new Tracking( 'jetpack', $this->connection_manager ) )->should_enable_tracking( new Terms_Of_Service(), new Status() ) \|\| static::is_connection_ready() ) {
	6609	+ ( new Plugin_Tracking() )->init();
	6610	+ }
	6611	+ }
	6612	+
	6613	+ /**
	6614	+ * Run the "initialize tracking" hook.
	6615	+ *
	6616	+ * @since 13.9
	6617	+ */
	6618	+ public function run_initialize_tracking_action() {
	6619	+ /**
	6620	+ * Fires when the tracking needs to be initialized.
	6621	+ * Doesn't necessarily mean that will actually happen, depends if the 'jetpack_tos_agreed' option is set.
	6622	+ *
	6623	+ * @since 13.9
	6624	+ */
	6625	+ do_action( 'jetpack_initialize_tracking' );
	6626	+ }
	6627	+
	6628	+ /**
	6629	+ * Initialize REST jsonAPI if needed.
	6630	+ *
	6631	+ * @return void
	6632	+ */
	6633	+ public function maybe_initialize_rest_jsonapi() {
	6634	+ // phpcs:ignore WordPress.Security.NonceVerification.Recommended
	6635	+ if ( ! empty( $_GET['jsonapi'] ) && ( ! defined( 'IS_WPCOM' ) \|\| ! IS_WPCOM ) ) {
	6636	+ require_once ABSPATH . 'wp-admin/includes/admin.php'; // JSON API relies on WP functionality not autoloaded in REST.
	6637	+
	6638	+ define( 'WPCOM_JSON_API__BASE', 'public-api.wordpress.com/rest/v1' );
	6639	+ require_once JETPACK__PLUGIN_DIR . 'class.json-api-endpoints.php';
	6640	+ }
	6641	+ }
	6642	+
	6643	+ /**
	6644	+ * Run plugin post-activation actions if we need to.
	6645	+ *
	6646	+ * @return void
	6647	+ */
	6648	+ private function plugin_post_activation() {
	6649	+ if ( ( new Status() )->is_offline_mode() ) {
	6650	+ return;
	6651	+ }
	6652	+
	6653	+ if ( get_transient( 'activated_jetpack' ) ) {
	6654	+ delete_transient( 'activated_jetpack' );
	6655	+
	6656	+ if ( ( new Host() )->is_woa_site() ) {
	6657	+ $redirect_url = static::admin_url( 'page=jetpack' );
	6658	+ } elseif ( is_network_admin() ) {
	6659	+ $redirect_url = admin_url( 'network/admin.php?page=jetpack' );
	6660	+ } elseif ( get_transient( 'my_jetpack_product_activated' ) ) {
	6661	+ // don't redirect if this is an activation that just came from My Jetpack
	6662	+ // My Jetpack has its own set of post-activation redirects
	6663	+ return;
	6664	+ } elseif ( My_Jetpack_Initializer::should_initialize() ) {
	6665	+ $redirect_url = static::admin_url( 'page=my-jetpack' );
	6666	+ } else {
	6667	+ $redirect_url = static::admin_url( 'page=jetpack' );
	6668	+ }
	6669	+
	6670	+ wp_safe_redirect( $redirect_url );
	6671	+ }
6901	6672	}
6902	6673	}