PluginProbe
Jetpack – WP Security, Backup, Speed, & Growth / 16.3-a.5
Jetpack – WP Security, Backup, Speed, & Growth v16.3-a.5
16.3-a.5 16.3-a.7 16.3-a.3 16.3-a.1 16.2 16.2-beta 12.0.3 12.1.3 12.2.3 12.3.2 12.4.2 12.5.2 12.6.4 12.7.3 12.8.3 12.9.5 13.0.2 13.1.5 13.2.4 13.3.3 13.4.5 13.5.2 13.6.2 13.7.2 13.8.3 All 506 releases
← All changes | class.jetpack.php +969 -1169 12.7.3 → 16.3-a.5 View file →
@@ -7,33 +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;
32 -use Automattic\Jetpack\Partner;
33 +use Automattic\Jetpack\Newsletter\Reader_Link;
33 34 use Automattic\Jetpack\Paths;
35 +use Automattic\Jetpack\Plugin\Deprecate;
34 36 use Automattic\Jetpack\Plugin\Tracking as Plugin_Tracking;
37 +use Automattic\Jetpack\Podcast\Podcast;
35 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;
36 41 use Automattic\Jetpack\Status;
37 42 use Automattic\Jetpack\Status\Host;
38 43 use Automattic\Jetpack\Status\Visitor;
39 44 use Automattic\Jetpack\Sync\Actions as Sync_Actions;
@@ -40,9 +45,14 @@
40 45 use Automattic\Jetpack\Sync\Health;
41 46 use Automattic\Jetpack\Sync\Sender;
42 47 use Automattic\Jetpack\Terms_Of_Service;
43 48 use Automattic\Jetpack\Tracking;
49 +use Automattic\Woocommerce_Analytics;
44 50
51 +if ( ! defined( 'ABSPATH' ) ) {
52 + exit( 0 );
53 +}
54 +
45 55 /*
46 56 Options:
47 57 jetpack_options (array)
48 58 An array of options.
@@ -77,49 +87,8 @@
77 87 */
78 88 public $xmlrpc_server = null;
79 89
80 90 /**
81 - * The handles of styles that are concatenated into jetpack.css.
82 - *
83 - * When making changes to that list, you must also update concat_list in tools/webpack.config.css.js.
84 - *
85 - * @var array The handles of styles that are concatenated into jetpack.css.
86 - */
87 - public $concatenated_style_handles = array(
88 - 'jetpack-carousel-swiper-css',
89 - 'jetpack-carousel',
90 - 'grunion.css',
91 - 'the-neverending-homepage',
92 - 'jetpack_likes',
93 - 'jetpack_related-posts',
94 - 'sharedaddy',
95 - 'jetpack-slideshow',
96 - 'presentations',
97 - 'quiz',
98 - 'jetpack-subscriptions',
99 - 'jetpack-responsive-videos',
100 - 'jetpack-social-menu',
101 - 'tiled-gallery',
102 - 'jetpack_display_posts_widget',
103 - 'gravatar-profile-widget',
104 - 'goodreads-widget',
105 - 'jetpack_social_media_icons_widget',
106 - 'jetpack-top-posts-widget',
107 - 'jetpack_image_widget',
108 - 'jetpack-my-community-widget',
109 - 'jetpack-authors-widget',
110 - 'wordads',
111 - 'eu-cookie-law-style',
112 - 'flickr-widget-style',
113 - 'jetpack-search-widget',
114 - 'jetpack-simple-payments-widget-style',
115 - 'jetpack-widget-social-icons-styles',
116 - 'wpcom_instagram_widget',
117 - 'milestone-widget',
118 - 'subscribe-modal-css',
119 - );
120 -
121 - /**
122 91 * Contains all assets that have had their URL rewritten to minified versions.
123 92 *
124 93 * @var array
125 94 */
@@ -134,11 +103,8 @@
134 103 'contact-form' => array(
135 104 array( 'grunion-contact-form/grunion-contact-form.php', 'Grunion Contact Form' ),
136 105 array( 'mullet/mullet-contact-form.php', 'Mullet Contact Form' ),
137 106 ),
138 - 'custom-css' => array(
139 - array( 'safecss/safecss.php', 'WordPress.com Custom CSS' ),
140 - ),
141 107 'gravatar-hovercards' => array(
142 108 array( 'jetpack-gravatar-hovercards/gravatar-hovercards.php', 'Jetpack Gravatar Hovercards' ),
143 109 ),
144 110 'latex' => array(
@@ -299,13 +265,8 @@
299 265 'MSM Sitemaps' => 'msm-sitemap/msm-sitemap.php',
300 266 'Rank Math' => 'seo-by-rank-math/rank-math.php',
301 267 'Slim SEO' => 'slim-seo/slim-seo.php',
302 268 ),
303 - 'lazy-images' => array(
304 - 'Lazy Load' => 'lazy-load/lazy-load.php',
305 - 'BJ Lazy Load' => 'bj-lazy-load/bj-lazy-load.php',
306 - 'Lazy Load by WP Rocket' => 'rocket-lazy-load/rocket-lazy-load.php',
307 - ),
308 269 );
309 270
310 271 /**
311 272 * Plugins for which we turn off our Facebook OG Tags implementation.
@@ -314,9 +275,8 @@
314 275 * Graph tags via filter when their Social Meta modules are active:
315 276 *
316 277 * - All in One SEO Pack, All in one SEO Pack Pro
317 278 * - WordPress SEO by Yoast, WordPress SEO Premium by Yoast
318 - * - SEOPress, SEOPress Pro
319 279 *
320 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:
321 281 * add_filter( 'jetpack_enable_open_graph', '__return_false' );
322 282 *
@@ -359,8 +319,10 @@
359 319 'wp-caregiver/wp-caregiver.php', // WP Caregiver.
360 320 'wp-facebook-like-send-open-graph-meta/wp-facebook-like-send-open-graph-meta.php', // WP Facebook Like Send & Open Graph Meta.
361 321 'wp-facebook-open-graph-protocol/wp-facebook-ogp.php', // WP Facebook Open Graph protocol.
362 322 'wp-ogp/wp-ogp.php', // WP-OGP.
323 + 'wp-seopress/seopress.php', // SEOPress.
324 + 'wp-seopress-pro/seopress-pro.php', // SEOPress Pro.
363 325 'zoltonorg-social-plugin/zosp.php', // Zolton.org Social Plugin.
364 326 'wp-fb-share-like-button/wp_fb_share-like_widget.php', // WP Facebook Like Button.
365 327 'open-graph-metabox/open-graph-metabox.php', // Open Graph Metabox.
366 328 'seo-by-rank-math/rank-math.php', // Rank Math.
@@ -427,8 +389,10 @@
427 389
428 390 /**
429 391 * Verified data for JSON authorization request
430 392 *
393 + * @deprecated 13.4
394 + *
431 395 * @var array
432 396 */
433 397 public $json_api_authorization_request = array();
434 398
@@ -469,8 +433,16 @@
469 433 */
470 434 public static $instance = false;
471 435
472 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 + /**
473 445 * Singleton
474 446 *
475 447 * @static
476 448 */
@@ -510,9 +482,9 @@
510 482 if ( array_diff( $unfiltered_modules, $modules ) ) {
511 483 self::update_active_modules( $modules );
512 484 }
513 485
514 - add_action( 'init', array( __CLASS__, 'activate_new_modules' ) );
486 + self::register_upgrade_init_hooks();
515 487
516 488 // Upgrade to 4.3.0.
517 489 if ( Jetpack_Options::get_option( 'identity_crisis_whitelist' ) ) {
518 490 Jetpack_Options::delete_option( 'identity_crisis_whitelist' );
@@ -567,8 +539,16 @@
567 539 Jetpack_Options::delete_option( 'autoupdate_plugins' );
568 540 } // Should we have some type of fallback if something fails here?
569 541 }
570 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 +
571 551 if ( did_action( 'wp_loaded' ) ) {
572 552 self::upgrade_on_load();
573 553 } else {
574 554 add_action(
@@ -602,9 +582,8 @@
602 582 }
603 583
604 584 if (
605 585 class_exists( 'Jetpack_Sitemap_Manager' )
606 - && version_compare( JETPACK__VERSION, '5.3', '>=' )
607 586 ) {
608 587 do_action( 'jetpack_sitemaps_purge_data' );
609 588 }
610 589
@@ -619,9 +598,9 @@
619 598 * Also fires Action hooks for each newly activated and deactivated module.
620 599 *
621 600 * @param array $modules Array of active modules to be saved in options.
622 601 *
623 - * @return $success bool true for success, false for failure.
602 + * @return bool $success true for success, false for failure.
624 603 */
625 604 public static function update_active_modules( $modules ) {
626 605 return ( new Modules() )->update_active( $modules );
627 606 }
@@ -651,10 +630,10 @@
651 630 sort( $taken_priorities );
652 631
653 632 $first_priority = array_shift( $taken_priorities );
654 633
655 - if ( defined( 'PHP_INT_MAX' ) && $first_priority <= - PHP_INT_MAX ) {
656 - $new_priority = - PHP_INT_MAX;
634 + if ( $first_priority <= PHP_INT_MIN ) {
635 + $new_priority = PHP_INT_MIN;
657 636 } else {
658 637 $new_priority = $first_priority - 1;
659 638 }
660 639
@@ -675,41 +654,17 @@
675 654 add_action( 'network_plugin_loaded', array( $this, 'add_configure_hook' ), 90 );
676 655 add_action( 'mu_plugin_loaded', array( $this, 'add_configure_hook' ), 90 );
677 656 add_action( 'plugins_loaded', array( $this, 'late_initialization' ), 90 );
678 657
679 - add_action( 'jetpack_verify_signature_error', array( $this, 'track_xmlrpc_error' ) );
680 -
681 - add_filter(
682 - 'jetpack_signature_check_token',
683 - array( __CLASS__, 'verify_onboarding_token' ),
684 - 10,
685 - 3
686 - );
687 -
688 658 /**
689 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.
690 663 */
691 664 require_once JETPACK__PLUGIN_DIR . 'class.jetpack-gutenberg.php';
692 - add_action( 'plugins_loaded', array( 'Jetpack_Gutenberg', 'load_independent_blocks' ) );
693 - add_action( 'plugins_loaded', array( 'Jetpack_Gutenberg', 'load_block_editor_extensions' ), 9 );
694 - /**
695 - * 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.
696 - *
697 - * 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.
698 - */
699 - if ( is_admin() ) {
700 - add_action( 'enqueue_block_assets', array( 'Jetpack_Gutenberg', 'enqueue_block_editor_assets' ) );
701 - } else {
702 - add_action( 'enqueue_block_editor_assets', array( 'Jetpack_Gutenberg', 'enqueue_block_editor_assets' ) );
703 - }
704 - add_filter( 'render_block', array( 'Jetpack_Gutenberg', 'display_deprecated_block_message' ), 10, 2 );
705 -
706 665 add_action( 'set_user_role', array( $this, 'maybe_clear_other_linked_admins_transient' ), 10, 3 );
707 666
708 - // Unlink user before deleting the user from WP.com.
709 - add_action( 'deleted_user', array( $this, 'disconnect_user' ), 10, 1 );
710 - add_action( 'remove_user_from_blog', array( $this, 'disconnect_user' ), 10, 1 );
711 -
712 667 add_action( 'jetpack_event_log', array( 'Jetpack', 'log' ), 10, 2 );
713 668
714 669 add_filter( 'login_url', array( $this, 'login_url' ), 10, 2 );
715 670 add_action( 'login_init', array( $this, 'login_init' ) );
@@ -716,8 +671,13 @@
716 671
717 672 // Set up the REST authentication hooks.
718 673 Connection_Rest_Authentication::init();
719 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 +
720 680 add_action( 'admin_init', array( $this, 'admin_init' ) );
721 681 add_action( 'admin_init', array( $this, 'dismiss_jetpack_notice' ) );
722 682
723 683 add_filter( 'admin_body_class', array( $this, 'admin_body_class' ), 20 );
@@ -731,12 +691,8 @@
731 691
732 692 // Returns HTTPS support status.
733 693 add_action( 'wp_ajax_jetpack-recheck-ssl', array( $this, 'ajax_recheck_ssl' ) );
734 694
735 - add_action( 'wp_ajax_jetpack_connection_banner', array( $this, 'jetpack_connection_banner_callback' ) );
736 -
737 - add_action( 'wp_ajax_jetpack_recommendations_banner', array( 'Jetpack_Recommendations_Banner', 'ajax_callback' ) );
738 -
739 695 add_action( 'wp_loaded', array( $this, 'register_assets' ) );
740 696
741 697 /**
742 698 * These actions run checks to load additional files.
@@ -754,29 +710,8 @@
754 710
755 711 add_filter( 'jetpack_get_default_modules', array( $this, 'filter_default_modules' ) );
756 712 add_filter( 'jetpack_get_default_modules', array( $this, 'handle_deprecated_modules' ), 99 );
757 713
758 - require_once JETPACK__PLUGIN_DIR . 'class-jetpack-pre-connection-jitms.php';
759 - $jetpack_jitm_messages = ( new Jetpack_Pre_Connection_JITMs() );
760 - add_filter( 'jetpack_pre_connection_jitms', array( $jetpack_jitm_messages, 'add_pre_connection_jitms' ) );
761 -
762 - /*
763 - * If enabled, point edit post, page, and comment links to Calypso instead of WP-Admin.
764 - * We should make sure to only do this for front end links.
765 - */
766 - if ( self::get_option( 'edit_links_calypso_redirect' ) && ! is_admin() ) {
767 - add_filter( 'get_edit_post_link', array( $this, 'point_edit_post_links_to_calypso' ), 1, 2 );
768 - add_filter( 'get_edit_comment_link', array( $this, 'point_edit_comment_links_to_calypso' ), 1 );
769 -
770 - /*
771 - * We'll shortcircuit wp_notify_postauthor and wp_notify_moderator pluggable functions
772 - * so they point moderation links on emails to Calypso.
773 - */
774 - require_once JETPACK__PLUGIN_DIR . '_inc/lib/functions.wp-notify.php';
775 - add_filter( 'comment_notification_recipients', 'jetpack_notify_postauthor', 1, 2 );
776 - add_filter( 'notify_moderator', 'jetpack_notify_moderator', 1, 2 );
777 - }
778 -
779 714 add_action(
780 715 'plugins_loaded',
781 716 function () {
782 717 if ( User_Agent_Info::is_mobile_app() ) {
@@ -787,18 +722,10 @@
787 722
788 723 // Update the site's Jetpack plan and products from API on heartbeats.
789 724 add_action( 'jetpack_heartbeat', array( Jetpack_Plan::class, 'refresh_from_wpcom' ) );
790 725
791 - /**
792 - * This is the hack to concatenate all css files into one.
793 - * For description and reasoning see the implode_frontend_css method.
794 - *
795 - * Super late priority so we catch all the registered styles.
796 - */
797 - if ( ! is_admin() ) {
798 - add_action( 'wp_print_styles', array( $this, 'implode_frontend_css' ), -1 ); // Run first.
799 - add_action( 'wp_print_footer_scripts', array( $this, 'implode_frontend_css' ), -1 ); // Run first to trigger before `print_late_styles`.
800 - }
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' ) );
801 728
802 729 // Actually push the stats on shutdown.
803 730 if ( ! has_action( 'shutdown', array( $this, 'push_stats' ) ) ) {
804 731 add_action( 'shutdown', array( $this, 'push_stats' ) );
@@ -806,8 +733,10 @@
806 733
807 734 // After a successful connection.
808 735 add_action( 'jetpack_site_registered', array( $this, 'activate_default_modules_on_site_register' ) );
809 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' ) );
810 739
811 740 // Actions for Manager::authorize().
812 741 add_action( 'jetpack_authorize_starting', array( $this, 'authorize_starting' ) );
813 742 add_action( 'jetpack_authorize_ending_linked', array( $this, 'authorize_ending_linked' ) );
@@ -812,8 +741,9 @@
812 741 add_action( 'jetpack_authorize_starting', array( $this, 'authorize_starting' ) );
813 742 add_action( 'jetpack_authorize_ending_linked', array( $this, 'authorize_ending_linked' ) );
814 743 add_action( 'jetpack_authorize_ending_authorized', array( $this, 'authorize_ending_authorized' ) );
815 744
745 + Jetpack_Client_Server::init();
816 746 add_action( 'jetpack_client_authorize_error', array( Jetpack_Client_Server::class, 'client_authorize_error' ) );
817 747 add_filter( 'jetpack_client_authorize_already_authorized_url', array( Jetpack_Client_Server::class, 'client_authorize_already_authorized_url' ) );
818 748 add_action( 'jetpack_client_authorize_processing', array( Jetpack_Client_Server::class, 'client_authorize_processing' ) );
819 749 add_filter( 'jetpack_client_authorize_fallback_url', array( Jetpack_Client_Server::class, 'client_authorize_fallback_url' ) );
@@ -818,9 +748,9 @@
818 748 add_action( 'jetpack_client_authorize_processing', array( Jetpack_Client_Server::class, 'client_authorize_processing' ) );
819 749 add_filter( 'jetpack_client_authorize_fallback_url', array( Jetpack_Client_Server::class, 'client_authorize_fallback_url' ) );
820 750
821 751 // Filters for the Manager::get_token() urls and request body.
822 - 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' ) );
823 753 add_filter( 'jetpack_token_request_body', array( __CLASS__, 'filter_token_request_body' ) );
824 754
825 755 // Filter for the `jetpack/v4/connection/data` API response.
826 756 add_filter( 'jetpack_current_user_connection_data', array( __CLASS__, 'filter_jetpack_current_user_connection_data' ) );
@@ -841,18 +771,147 @@
841 771 // Make resources use static domain when possible.
842 772 add_filter( 'jetpack_static_url', array( 'Automattic\\Jetpack\\Assets', 'staticize_subdomain' ) );
843 773
844 774 // Validate the domain names in Jetpack development versions.
845 - add_action( 'jetpack_pre_register', array( get_called_class(), 'registration_check_domains' ) );
775 + add_action( 'jetpack_pre_register', array( static::class, 'registration_check_domains' ) );
846 776
847 777 // Register product descriptions for partner coupon usage.
848 778 add_filter( 'jetpack_partner_coupon_products', array( $this, 'get_partner_coupon_product_descriptions' ) );
849 779
850 - // Actions for conditional recommendations.
851 - 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();
852 791 }
853 792
854 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 + /**
855 914 * Before everything else starts getting initalized, we need to initialize Jetpack using the
856 915 * Config object.
857 916 */
858 917 public function configure() {
@@ -861,13 +920,10 @@
861 920 foreach (
862 921 array(
863 922 'jitm',
864 923 'sync',
924 + 'account_protection',
865 925 'waf',
866 - 'videopress',
867 - 'stats',
868 - 'stats_admin',
869 - 'import',
870 926 )
871 927 as $feature
872 928 ) {
873 929 $config->ensure( $feature );
@@ -872,8 +928,103 @@
872 928 ) {
873 929 $config->ensure( $feature );
874 930 }
875 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 +
876 1027 $config->ensure(
877 1028 'connection',
878 1029 array(
879 1030 'slug' => 'jetpack',
@@ -891,12 +1042,8 @@
891 1042 );
892 1043
893 1044 $config->ensure( 'search' );
894 1045
895 - if ( defined( 'ENABLE_WORDADS_SHARED_UI' ) && ENABLE_WORDADS_SHARED_UI ) {
896 - $config->ensure( 'wordads' );
897 - }
898 -
899 1046 if ( ! $this->connection_manager ) {
900 1047 $this->connection_manager = new Connection_Manager( 'jetpack' );
901 1048 }
902 1049
@@ -904,8 +1051,10 @@
904 1051 if ( $modules->is_active( 'publicize' ) && $this->connection_manager->has_connected_user() ) {
905 1052 $config->ensure( 'publicize' );
906 1053 }
907 1054
1055 + add_action( 'jetpack_initialize_tracking', array( $this, 'initialize_tracking' ) );
1056 +
908 1057 /*
909 1058 * Load things that should only be in Network Admin.
910 1059 *
911 1060 * For now blow away everything else until a more full
@@ -920,8 +1069,9 @@
920 1069 $is_connection_ready = self::is_connection_ready();
921 1070
922 1071 if ( $is_connection_ready ) {
923 1072 add_action( 'login_form_jetpack_json_api_authorization', array( $this, 'login_form_json_api_authorization' ) );
1073 + $this->run_initialize_tracking_action();
924 1074
925 1075 Jetpack_Heartbeat::init();
926 1076 if ( self::is_module_active( 'stats' ) && self::is_module_active( 'search' ) ) {
927 1077 require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-search-performance-logger.php';
@@ -926,8 +1076,19 @@
926 1076 if ( self::is_module_active( 'stats' ) && self::is_module_active( 'search' ) ) {
927 1077 require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-search-performance-logger.php';
928 1078 Jetpack_Search_Performance_Logger::init();
929 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 + );
930 1091 }
931 1092
932 1093 // Initialize remote file upload request handlers.
933 1094 $this->add_remote_request_handlers();
@@ -937,20 +1098,10 @@
937 1098 */
938 1099 if ( $is_connection_ready ) {
939 1100 require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-iframe-embed.php';
940 1101 add_action( 'init', array( 'Jetpack_Iframe_Embed', 'init' ), 9, 0 );
941 - require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-keyring-service-helper.php';
942 - add_action( 'init', array( 'Jetpack_Keyring_Service_Helper', 'init' ), 9, 0 );
1102 + add_action( 'rest_api_init', array( $this, 'maybe_initialize_rest_jsonapi' ) );
943 1103 }
944 -
945 - if ( ( new Tracking( 'jetpack', $this->connection_manager ) )->should_enable_tracking( new Terms_Of_Service(), new Status() ) ) {
946 - add_action( 'init', array( new Plugin_Tracking(), 'init' ) );
947 - } else {
948 - /**
949 - * Initialize tracking right after the user agrees to the terms of service.
950 - */
951 - add_action( 'jetpack_agreed_to_terms_of_service', array( new Plugin_Tracking(), 'init' ) );
952 - }
953 1104 }
954 1105
955 1106 /**
956 1107 * Runs on plugins_loaded. Use this to add code that needs to be executed later than other
@@ -958,17 +1109,58 @@
958 1109 *
959 1110 * @action plugins_loaded
960 1111 */
961 1112 public function late_initialization() {
962 - add_action( 'plugins_loaded', array( 'Jetpack', 'load_modules' ), 100 );
1113 + add_action( 'after_setup_theme', array( 'Jetpack', 'load_modules' ), -2 );
963 1114
964 - Partner::init();
965 - 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 + }
966 1134
967 - // Initialize Boost Speed Score
968 - $modules = Jetpack_Boost_Modules::init();
969 - new Speed_Score( $modules, 'jetpack-dashboard' );
1135 + Scan_Page_Init::initialize();
1136 + Jetpack_SEO_Initializer::init();
970 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 +
971 1163 /**
972 1164 * Fires when Jetpack is fully loaded and ready. This is the point where it's safe
973 1165 * to instantiate classes from packages and namespaces that are managed by the Jetpack Autoloader.
974 1166 *
@@ -1006,8 +1198,10 @@
1006 1198
1007 1199 /**
1008 1200 * Redirect edit post links to Calypso.
1009 1201 *
1202 + * @deprecated since 13.9
1203 + *
1010 1204 * @param string $default_url Post edit URL.
1011 1205 * @param int $post_id Post ID.
1012 1206 *
1013 1207 * @return string
@@ -1012,8 +1206,10 @@
1012 1206 *
1013 1207 * @return string
1014 1208 */
1015 1209 public function point_edit_post_links_to_calypso( $default_url, $post_id ) {
1210 + _deprecated_function( __METHOD__, '13.9' );
1211 +
1016 1212 $post = get_post( $post_id );
1017 1213
1018 1214 if ( empty( $post ) ) {
1019 1215 return $default_url;
@@ -1044,13 +1240,17 @@
1044 1240
1045 1241 /**
1046 1242 * Redirect edit comment links to Calypso.
1047 1243 *
1244 + * @deprecated since 13.9
1245 + *
1048 1246 * @param string $url Comment edit URL.
1049 1247 *
1050 1248 * @return string
1051 1249 */
1052 1250 public function point_edit_comment_links_to_calypso( $url ) {
1251 + _deprecated_function( __METHOD__, '13.9' );
1252 +
1053 1253 // Take the `query` key value from the URL, and parse its parts to the $query_args. `amp;c` matches the comment ID.
1054 1254 $query_args = null;
1055 1255 wp_parse_str( wp_parse_url( $url, PHP_URL_QUERY ), $query_args );
1056 1256
@@ -1069,30 +1269,16 @@
1069 1269 *
1070 1270 * @return array list of callables.
1071 1271 */
1072 1272 public function filter_sync_callable_whitelist( $callables ) {
1073 -
1074 1273 // Jetpack Functions.
1075 1274 $jetpack_callables = array(
1076 1275 'single_user_site' => array( 'Jetpack', 'is_single_user_site' ),
1077 1276 'updates' => array( 'Jetpack', 'get_updates' ),
1078 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' ),
1079 1279 );
1080 - $callables = array_merge( $callables, $jetpack_callables );
1081 -
1082 - // Jetpack_SSO_Helpers.
1083 - if ( include_once JETPACK__PLUGIN_DIR . 'modules/sso/class.jetpack-sso-helpers.php' ) {
1084 - $sso_helpers = array(
1085 - 'sso_is_two_step_required' => array( 'Jetpack_SSO_Helpers', 'is_two_step_required' ),
1086 - 'sso_should_hide_login_form' => array( 'Jetpack_SSO_Helpers', 'should_hide_login_form' ),
1087 - 'sso_match_by_email' => array( 'Jetpack_SSO_Helpers', 'match_by_email' ),
1088 - 'sso_new_user_override' => array( 'Jetpack_SSO_Helpers', 'new_user_override' ),
1089 - 'sso_bypass_default_login_form' => array( 'Jetpack_SSO_Helpers', 'bypass_login_forward_wpcom' ),
1090 - );
1091 - $callables = array_merge( $callables, $sso_helpers );
1092 - }
1093 -
1094 - return $callables;
1280 + return array_merge( $callables, $jetpack_callables );
1095 1281 }
1096 1282
1097 1283 /**
1098 1284 * Extend Sync multisite callables with Jetpack Plugin functions.
@@ -1117,41 +1303,8 @@
1117 1303 return $callables;
1118 1304 }
1119 1305
1120 1306 /**
1121 - * Deprecated
1122 - * Please use Automattic\Jetpack\JITMS\JITM::jetpack_track_last_sync_callback instead.
1123 - *
1124 - * @param array $params The action parameters.
1125 - *
1126 - * @deprecated since 9.8.
1127 - */
1128 - public function jetpack_track_last_sync_callback( $params ) {
1129 - _deprecated_function( __METHOD__, 'jetpack-9.8', '\Automattic\Jetpack\JITMS\JITM->jetpack_track_last_sync_callback' );
1130 - return Automattic\Jetpack\JITMS\JITM::get_instance()->jetpack_track_last_sync_callback( $params );
1131 - }
1132 -
1133 - /**
1134 - * Jetpack Connection banner callback function.
1135 - *
1136 - * @return void
1137 - */
1138 - public function jetpack_connection_banner_callback() {
1139 - check_ajax_referer( 'jp-connection-banner-nonce', 'nonce' );
1140 -
1141 - // Disable the banner dismiss functionality if the pre-connection prompt helpers filter is set.
1142 - if (
1143 - isset( $_REQUEST['dismissBanner'] ) &&
1144 - ! Jetpack_Connection_Banner::force_display()
1145 - ) {
1146 - Jetpack_Options::update_option( 'dismissed_connection_banner', 1 );
1147 - wp_send_json_success();
1148 - }
1149 -
1150 - wp_die();
1151 - }
1152 -
1153 - /**
1154 1307 * If there are any stats that need to be pushed, but haven't been, push them now.
1155 1308 */
1156 1309 public function push_stats() {
1157 1310 if ( ! empty( $this->stats ) ) {
@@ -1166,16 +1319,8 @@
1166 1319 * @param string $cap Capability name.
1167 1320 */
1168 1321 public function jetpack_custom_caps( $caps, $cap ) {
1169 1322 switch ( $cap ) {
1170 - case 'jetpack_manage_modules':
1171 - case 'jetpack_activate_modules':
1172 - case 'jetpack_deactivate_modules':
1173 - $caps = array( 'manage_options' );
1174 - break;
1175 - case 'jetpack_configure_modules':
1176 - $caps = array( 'manage_options' );
1177 - break;
1178 1323 case 'jetpack_manage_autoupdates':
1179 1324 $caps = array(
1180 1325 'manage_options',
1181 1326 'update_plugins',
@@ -1193,9 +1338,9 @@
1193 1338 if ( $is_offline_mode ) {
1194 1339 $caps = array( 'manage_options' );
1195 1340 break;
1196 1341 } else {
1197 - $caps = array( 'read' );
1342 + $caps = array( 'edit_posts' );
1198 1343 }
1199 1344 break;
1200 1345 }
1201 1346 return $caps;
@@ -1354,9 +1499,9 @@
1354 1499 }
1355 1500 /**
1356 1501 * Does the network allow admins to add new users.
1357 1502 *
1358 - * @return boolian
1503 + * @return bool
1359 1504 */
1360 1505 public static function network_add_new_users() {
1361 1506 return (bool) get_site_option( 'add_new_users' );
1362 1507 }
@@ -1363,9 +1508,9 @@
1363 1508 /**
1364 1509 * File upload psace left per site in MB.
1365 1510 * -1 means NO LIMIT.
1366 1511 *
1367 - * @return number
1512 + * @return int
1368 1513 */
1369 1514 public static function network_site_upload_space() {
1370 1515 // value in MB.
1371 1516 return ( get_site_option( 'upload_space_check_disabled' ) ? -1 : get_space_allowed() );
@@ -1382,9 +1527,9 @@
1382 1527
1383 1528 /**
1384 1529 * Maximum file upload size set by the network.
1385 1530 *
1386 - * @return number
1531 + * @return int
1387 1532 */
1388 1533 public static function network_max_upload_file_size() {
1389 1534 // value in KB.
1390 1535 return get_site_option( 'fileupload_maxk', 300 );
@@ -1561,8 +1706,9 @@
1561 1706 *
1562 1707 * @return array
1563 1708 */
1564 1709 public static function get_updates() {
1710 + $updates = array();
1565 1711 $update_data = wp_get_update_data();
1566 1712
1567 1713 // Stores the individual update counts as well as the total count.
1568 1714 if ( isset( $update_data['counts'] ) ) {
@@ -1575,9 +1721,9 @@
1575 1721 if ( isset( $cur->response ) && 'upgrade' === $cur->response ) {
1576 1722 $updates['wp_update_version'] = $cur->current;
1577 1723 }
1578 1724 }
1579 - return isset( $updates ) ? $updates : array();
1725 + return $updates;
1580 1726 }
1581 1727 // phpcs:enable WordPress.WP.CapitalPDangit.MisspelledInComment
1582 1728
1583 1729 /**
@@ -1637,44 +1783,8 @@
1637 1783 return apply_filters( 'jetpack_is_connection_ready', self::connection()->is_connected(), self::connection() );
1638 1784 }
1639 1785
1640 1786 /**
1641 - * Deprecated: Is Jetpack in development (offline) mode?
1642 - *
1643 - * This static method is being left here intentionally without the use of _deprecated_function(), as other plugins
1644 - * and themes still use it, and we do not want to flood them with notices.
1645 - *
1646 - * Please use Automattic\Jetpack\Status()->is_offline_mode() instead.
1647 - *
1648 - * @deprecated since 8.0.
1649 - */
1650 - public static function is_development_mode() {
1651 - _deprecated_function( __METHOD__, 'jetpack-8.0', '\Automattic\Jetpack\Status->is_offline_mode' );
1652 - return ( new Status() )->is_offline_mode();
1653 - }
1654 -
1655 - /**
1656 - * Whether the site is currently onboarding or not.
1657 - * A site is considered as being onboarded if it currently has an onboarding token.
1658 - *
1659 - * @since 5.8
1660 - * @deprecated Use \Automattic\Jetpack\Status()->is_onboarding()
1661 - *
1662 - * @access public
1663 - * @static
1664 - *
1665 - * @return bool True if the site is currently onboarding, false otherwise
1666 - */
1667 - public static function is_onboarding() {
1668 - _deprecated_function( __METHOD__, 'jetpack-10.9', 'Automattic\\Jetpack\\Status\\is_onboarding' );
1669 -
1670 - if ( ! method_exists( 'Automattic\Jetpack\Status', 'is_onboarding' ) ) {
1671 - return Jetpack_Options::get_option( 'onboarding' ) !== false;
1672 - }
1673 - return ( new Status() )->is_onboarding();
1674 - }
1675 -
1676 - /**
1677 1787 * Determines reason for Jetpack offline mode.
1678 1788 */
1679 1789 public static function development_mode_trigger_text() {
1680 1790 $status = new Status();
@@ -1688,11 +1798,10 @@
1688 1798 } elseif ( defined( 'WP_LOCAL_DEV' ) && WP_LOCAL_DEV ) {
1689 1799 $notice = __( 'The WP_LOCAL_DEV constant is defined in wp-config.php or elsewhere.', 'jetpack' );
1690 1800 } elseif ( $status->is_local_site() ) {
1691 1801 $notice = __( 'The site URL is a known local development environment URL (e.g. http://localhost).', 'jetpack' );
1692 - /** This filter is documented in packages/status/src/class-status.php */
1693 - } elseif ( has_filter( 'jetpack_development_mode' ) && apply_filters( 'jetpack_development_mode', false ) ) { // This is a deprecated filter name.
1694 - $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' );
1695 1804 } else {
1696 1805 $notice = __( 'The jetpack_offline_mode filter is set to true.', 'jetpack' );
1697 1806 }
1698 1807
@@ -1722,15 +1831,8 @@
1722 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' ) ) );
1723 1832
1724 1833 echo '<div class="updated" style="border-color: #f0821e;"><p>' . $notice . '</p></div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- All provided text.
1725 1834 }
1726 - // Throw up a notice if using staging mode.
1727 - if ( ( new Status() )->is_staging_site() ) {
1728 - /* translators: %s is a URL */
1729 - $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' ) ) );
1730 -
1731 - echo '<div class="updated" style="border-color: #f0821e;"><p>' . $notice . '</p></div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- All provided text.
1732 - }
1733 1835 }
1734 1836
1735 1837 /**
1736 1838 * Whether Jetpack's version maps to a public release, or a development version.
@@ -1751,28 +1853,8 @@
1751 1853 );
1752 1854 }
1753 1855
1754 1856 /**
1755 - * Is a given user (or the current user if none is specified) linked to a WordPress.com user?
1756 - *
1757 - * @param int $user_id User ID or will use get_current_user_id if false/not provided.
1758 - */
1759 - public static function is_user_connected( $user_id = false ) {
1760 - _deprecated_function( __METHOD__, 'jetpack-9.5', 'Automattic\\Jetpack\\Connection\\Manager\\is_user_connected' );
1761 - return self::connection()->is_user_connected( $user_id );
1762 - }
1763 -
1764 - /**
1765 - * Get the wpcom user data of the current|specified connected user.
1766 - *
1767 - * @param null|int $user_id User ID or will use get_current_user_id if null.
1768 - */
1769 - public static function get_connected_user_data( $user_id = null ) {
1770 - _deprecated_function( __METHOD__, 'jetpack-9.5', 'Automattic\\Jetpack\\Connection\\Manager\\get_connected_user_data' );
1771 - return self::connection()->get_connected_user_data( $user_id );
1772 - }
1773 -
1774 - /**
1775 1857 * Get the wpcom email of the current|specified connected user.
1776 1858 *
1777 1859 * @param null|int $user_id User ID or will use get_current_user_id if null.
1778 1860 */
@@ -1824,18 +1906,11 @@
1824 1906 */
1825 1907 public static function load_modules() {
1826 1908 $status = new Status();
1827 1909
1828 - if ( method_exists( $status, 'is_onboarding' ) ) {
1829 - $is_onboarding = $status->is_onboarding();
1830 - } else {
1831 - $is_onboarding = self::is_onboarding();
1832 - }
1833 -
1834 1910 if (
1835 1911 ! self::is_connection_ready()
1836 1912 && ! $status->is_offline_mode()
1837 - && ! $is_onboarding
1838 1913 && (
1839 1914 ! is_multisite()
1840 1915 || ! get_site_option( 'jetpack_protect_active' )
1841 1916 )
@@ -1956,22 +2031,14 @@
1956 2031 *
1957 2032 * @todo Store the result in core's object cache maybe?
1958 2033 */
1959 2034 public static function get_active_plugins() {
1960 - $active_plugins = (array) get_option( 'active_plugins', array() );
1961 -
1962 - if ( is_multisite() ) {
1963 - // Due to legacy code, active_sitewide_plugins stores them in the keys,
1964 - // whereas active_plugins stores them in the values.
1965 - $network_plugins = array_keys( get_site_option( 'active_sitewide_plugins', array() ) );
1966 - if ( $network_plugins ) {
1967 - $active_plugins = array_merge( $active_plugins, $network_plugins );
1968 - }
2035 + // Older Connection copies can load first and lack this method.
2036 + if ( ! method_exists( Heartbeat::class, 'get_active_plugins' ) ) {
2037 + return array();
1969 2038 }
1970 2039
1971 - sort( $active_plugins );
1972 -
1973 - return array_unique( $active_plugins );
2040 + return Heartbeat::get_active_plugins();
1974 2041 }
1975 2042
1976 2043 /**
1977 2044 * Gets and parses additional plugin data to send with the heartbeat data
@@ -2109,8 +2176,10 @@
2109 2176 *
2110 2177 * @param bool true Should Twitter Card Meta tags be disabled. Default to true.
2111 2178 */
2112 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).
2113 2182 require_once JETPACK__PLUGIN_DIR . 'class.jetpack-twitter-cards.php';
2114 2183 }
2115 2184 }
2116 2185
@@ -2213,9 +2282,9 @@
2213 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.
2214 2283 $page = sanitize_text_field( wp_unslash( $_GET['page'] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- we're not changing the site.
2215 2284 }
2216 2285 wp_safe_redirect( self::admin_url( 'page=' . rawurlencode( $page ) ) );
2217 - exit;
2286 + exit( 0 );
2218 2287 }
2219 2288 }
2220 2289
2221 2290 /**
@@ -2262,8 +2331,12 @@
2262 2331 default:
2263 2332 break;
2264 2333 }
2265 2334 }
2335 + if ( method_exists( Feature_Policy::class, 'ensure_hooks' ) ) {
2336 + Feature_Policy::ensure_hooks();
2337 + }
2338 +
2266 2339 /**
2267 2340 * Filters the array of default modules.
2268 2341 *
2269 2342 * @since 2.5.0
@@ -2295,12 +2368,14 @@
2295 2368 * @return array
2296 2369 */
2297 2370 public function handle_deprecated_modules( $modules ) {
2298 2371 $deprecated_modules = array(
2299 - 'debug' => null, // Closed out and moved to the debugger library.
2300 - 'wpcc' => 'sso', // Closed out in 2.6 -- SSO provides the same functionality.
2301 - 'gplus-authorship' => null, // Closed out in 3.2 -- Google dropped support.
2302 - '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.
2303 2378 );
2304 2379
2305 2380 // Don't activate SSO if they never completed activating WPCC.
2306 2381 if ( self::is_module_active( 'wpcc' ) ) {
@@ -2354,8 +2429,17 @@
2354 2429 }
2355 2430 }
2356 2431 }
2357 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 +
2358 2442 return $modules;
2359 2443 }
2360 2444
2361 2445 /**
@@ -2412,23 +2496,30 @@
2412 2496
2413 2497 /**
2414 2498 * Return module name translation. Uses matching string created in modules/module-headings.php.
2415 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 + *
2416 2504 * @since 3.9.2
2417 2505 *
2418 2506 * @param array $modules Array of Jetpack modules.
2419 2507 *
2420 - * @return string|void
2508 + * @return array
2421 2509 */
2422 2510 public static function get_translated_modules( $modules ) {
2423 2511 foreach ( $modules as $index => $module ) {
2424 2512 $i18n_module = jetpack_get_module_i18n( $module['module'] );
2425 - if ( isset( $module['name'] ) ) {
2426 - $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;
2427 2518 }
2428 - if ( isset( $module['description'] ) ) {
2429 - $modules[ $index ]['description'] = $i18n_module['description'];
2430 - $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;
2431 2522 }
2432 2523 if ( isset( $module['module_tags'] ) ) {
2433 2524 $modules[ $index ]['module_tags'] = array_map( 'jetpack_get_module_i18n_tag', $module['module_tags'] );
2434 2525 }
@@ -2468,20 +2559,28 @@
2468 2559
2469 2560 /**
2470 2561 * Catches PHP errors. Must be used in conjunction with output buffering.
2471 2562 *
2563 + * @deprecated since 13.5
2472 2564 * @param bool $catch True to start catching, False to stop.
2473 2565 *
2474 2566 * @static
2567 + * @deprecated 13.5
2568 + * @see \Automattic\Jetpack\Errors
2475 2569 */
2476 2570 public static function catch_errors( $catch ) {
2571 + _deprecated_function( __METHOD__, '13.5' );
2572 + // @phan-suppress-next-line PhanDeprecatedClass
2477 2573 return ( new Errors() )->catch_errors( $catch );
2478 2574 }
2479 2575
2480 2576 /**
2481 2577 * Saves any generated PHP errors in ::state( 'php_errors', {errors} )
2578 + *
2579 + * @deprecated since 13.5
2482 2580 */
2483 2581 public static function catch_errors_on_shutdown() {
2582 + _deprecated_function( __METHOD__, '13.5' );
2484 2583 self::state( 'php_errors', self::alias_directories( ob_get_clean() ) );
2485 2584 }
2486 2585
2487 2586 /**
@@ -2585,9 +2684,9 @@
2585 2684 ),
2586 2685 add_query_arg( compact( 'min_version', 'max_version', 'other_modules' ), self::admin_url( 'page=jetpack' ) )
2587 2686 );
2588 2687 wp_safe_redirect( $url );
2589 - exit;
2688 + exit( 0 );
2590 2689 }
2591 2690 }
2592 2691
2593 2692 /**
@@ -2605,9 +2704,8 @@
2605 2704
2606 2705 // Check each module for fatal errors, a la wp-admin/plugins.php::activate before activating.
2607 2706 if ( $send_state_messages ) {
2608 2707 self::restate();
2609 - self::catch_errors( true );
2610 2708 }
2611 2709
2612 2710 $active = self::get_active_modules();
2613 2711
@@ -2675,10 +2773,8 @@
2675 2773 if ( $send_state_messages ) {
2676 2774 self::state( 'error', false );
2677 2775 self::state( 'module', false );
2678 2776 }
2679 -
2680 - self::catch_errors( false );
2681 2777 /**
2682 2778 * Fires when default modules are activated.
2683 2779 *
2684 2780 * @since 1.9.0
@@ -2736,9 +2832,9 @@
2736 2832 * @return string $url module configuration URL.
2737 2833 */
2738 2834 public static function module_configuration_url( $module ) {
2739 2835 $module = self::get_module_slug( $module );
2740 - $default_url = self::admin_url() . "#/settings?term=$module";
2836 + $default_url = self::admin_url( array( 'page' => 'jetpack-settings' ) ) . "#/settings?term=$module";
2741 2837 /**
2742 2838 * Allows to modify configure_url of specific module to be able to redirect to some custom location.
2743 2839 *
2744 2840 * @since 6.9.0
@@ -2756,9 +2852,9 @@
2756 2852 *
2757 2853 * @param string $message Error message.
2758 2854 * @param bool $deactivate Deactivate Jetpack or not.
2759 2855 *
2760 - * @return void
2856 + * @return never
2761 2857 */
2762 2858 public static function bail_on_activation( $message, $deactivate = true ) {
2763 2859 ?>
2764 2860 <!doctype html>
@@ -2796,9 +2892,9 @@
2796 2892 if ( $update ) {
2797 2893 update_option( 'active_plugins', array_filter( $plugins ) );
2798 2894 }
2799 2895 }
2800 - exit;
2896 + exit( 0 );
2801 2897 }
2802 2898
2803 2899 /**
2804 2900 * Attached to activate_{ plugin_basename( __FILES__ ) } by register_activation_hook()
@@ -2823,12 +2919,18 @@
2823 2919 update_option( 'jetpack_activation_source', self::get_activation_source( wp_get_referer() ) );
2824 2920
2825 2921 Health::on_jetpack_activated();
2826 2922
2923 + \Automattic\Jetpack\Reprint_Export\Reprint_Exporter::discard_credentials();
2924 +
2827 2925 if ( self::is_connection_ready() && method_exists( 'Automattic\Jetpack\Sync\Actions', 'do_only_first_initial_sync' ) ) {
2828 2926 Sync_Actions::do_only_first_initial_sync();
2829 2927 }
2830 2928
2929 + if ( ! defined( 'WC_ANALYTICS' ) && class_exists( 'Automattic\Woocommerce_Analytics' ) ) {
2930 + Woocommerce_Analytics::maybe_add_proxy_speed_module();
2931 + }
2932 +
2831 2933 self::plugin_initialize();
2832 2934 }
2833 2935
2834 2936 /**
@@ -2863,9 +2965,9 @@
2863 2965
2864 2966 if ( $plugins_path === $referer['path'] ) {
2865 2967 $source_type = 'list';
2866 2968 } elseif ( $plugins_install_path === $referer['path'] ) {
2867 - $tab = isset( $query_parts['tab'] ) ? $query_parts['tab'] : 'featured';
2969 + $tab = $query_parts['tab'] ?? 'featured';
2868 2970 switch ( $tab ) {
2869 2971 case 'popular':
2870 2972 $source_type = 'popular';
2871 2973 break;
@@ -2875,10 +2977,10 @@
2875 2977 case 'favorites':
2876 2978 $source_type = 'favorites';
2877 2979 break;
2878 2980 case 'search':
2879 - $source_type = 'search-' . ( isset( $query_parts['type'] ) ? $query_parts['type'] : 'term' );
2880 - $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;
2881 2983 break;
2882 2984 default:
2883 2985 $source_type = 'featured';
2884 2986 }
@@ -2887,29 +2989,171 @@
2887 2989 return array( $source_type, $source_query );
2888 2990 }
2889 2991
2890 2992 /**
2891 - * Runs before bumping version numbers up to a new version
2993 + * Runs before bumping version numbers up to a new version.
2892 2994 *
2893 - * @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.
2894 3001 * @param string $old_version Old Version:timestamp or false if not set yet.
2895 3002 */
2896 - public static function do_version_bump( $version, $old_version ) {
2897 - if ( $old_version ) { // For existing Jetpack installations.
2898 - 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 + }
2899 3006
2900 - // If a front end page is visited after the update, the 'wp' action will fire.
2901 - 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 + }
2902 3026
2903 - // If an admin page is visited after the update, the 'current_screen' action will fire.
2904 - 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;
2905 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 + }
2906 3043 }
2907 3044
2908 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 + /**
2909 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
2910 3153 */
2911 3154 public static function set_update_modal_display() {
3155 + _deprecated_function( __METHOD__, 'jetpack-16.2' );
2912 3156 self::state( 'display_update_modal', true );
2913 3157 }
2914 3158
2915 3159 /**
@@ -2914,11 +3158,16 @@
2914 3158
2915 3159 /**
2916 3160 * Enqueues the block library styles.
2917 3161 *
3162 + * Only ever used by the release post update modal, which has been removed.
3163 + *
3164 + * @deprecated 16.2
3165 + *
2918 3166 * @param string $hook The current admin page.
2919 3167 */
2920 3168 public static function enqueue_block_style( $hook ) {
3169 + _deprecated_function( __METHOD__, 'jetpack-16.2' );
2921 3170 if ( 'toplevel_page_jetpack' === $hook ) {
2922 3171 wp_enqueue_style( 'wp-block-library' );
2923 3172 }
2924 3173 }
@@ -2947,9 +3196,8 @@
2947 3196
2948 3197 self::load_modules();
2949 3198
2950 3199 Jetpack_Options::delete_option( 'do_activate' );
2951 - Jetpack_Options::delete_option( 'dismissed_connection_banner' );
2952 3200 }
2953 3201
2954 3202 /**
2955 3203 * Handles the activation of the default modules depending on the current state of the site:
@@ -3008,8 +3256,12 @@
3008 3256 add_filter( 'jetpack_update_activated_state_on_disconnect', '__return_false' );
3009 3257 self::disconnect();
3010 3258 Jetpack_Options::delete_option( 'version' );
3011 3259 }
3260 +
3261 + if ( ! defined( 'WC_ANALYTICS' ) && class_exists( 'Automattic\Woocommerce_Analytics' ) ) {
3262 + Woocommerce_Analytics::maybe_remove_proxy_speed_module();
3263 + }
3012 3264 }
3013 3265
3014 3266 /**
3015 3267 * Set activated option to 4 on jetpack_idc_disconnect action.
@@ -3037,9 +3289,9 @@
3037 3289 $connection->remove_connection( ! Identity_Crisis::validate_sync_error_idc_option() );
3038 3290 }
3039 3291
3040 3292 /**
3041 - * Happens after a successfull disconnection.
3293 + * Happens after a successful disconnection.
3042 3294 *
3043 3295 * @static
3044 3296 */
3045 3297 public static function jetpack_site_disconnected() {
@@ -3044,8 +3296,10 @@
3044 3296 */
3045 3297 public static function jetpack_site_disconnected() {
3046 3298 Identity_Crisis::clear_all_idc_options();
3047 3299
3300 + \Automattic\Jetpack\Reprint_Export\Reprint_Exporter::discard_credentials();
3301 +
3048 3302 // Delete all the sync related data. Since it could be taking up space.
3049 3303 Sender::get_instance()->uninstall();
3050 3304
3051 3305 /**
@@ -3062,10 +3316,13 @@
3062 3316 }
3063 3317 }
3064 3318
3065 3319 /**
3066 - * Disconnects the user
3320 + * Disconnects the user.
3067 3321 *
3322 + * @deprecated 13.4
3323 + * @see \Automattic\Jetpack\Connection\Manager::disconnect_user()
3324 + *
3068 3325 * @param int $user_id The user ID to disconnect.
3069 3326 */
3070 3327 public function disconnect_user( $user_id ) {
3071 3328 $this->connection_manager->disconnect_user( $user_id );
@@ -3071,21 +3328,8 @@
3071 3328 $this->connection_manager->disconnect_user( $user_id );
3072 3329 }
3073 3330
3074 3331 /**
3075 - * Attempts Jetpack registration. If it fail, a state flag is set: @see ::admin_page_load()
3076 - *
3077 - * @deprecated since Jetpack 9.7.0
3078 - * @see Automattic\Jetpack\Connection\Manager::try_registration()
3079 - *
3080 - * @return bool|WP_Error
3081 - */
3082 - public static function try_registration() {
3083 - _deprecated_function( __METHOD__, 'jetpack-9.7', 'Automattic\\Jetpack\\Connection\\Manager::try_registration' );
3084 - return static::connection()->try_registration();
3085 - }
3086 -
3087 - /**
3088 3332 * Checking the domain names in beta versions.
3089 3333 * If this is a development version, before attempting to connect, let's make sure that the domains are viable.
3090 3334 *
3091 3335 * @param null|\WP_Error $error The domain validation error, or `null` if everything's fine.
@@ -3092,9 +3336,9 @@
3092 3336 *
3093 3337 * @return null|\WP_Error The domain validation error, or `null` if everything's fine.
3094 3338 */
3095 3339 public static function registration_check_domains( $error ) {
3096 - if ( static::is_development_version() && defined( 'PHP_URL_HOST' ) ) {
3340 + if ( static::is_development_version() ) {
3097 3341 $domains_to_check = array_unique(
3098 3342 array(
3099 3343 'siteurl' => wp_parse_url( get_site_url(), PHP_URL_HOST ),
3100 3344 'homeurl' => wp_parse_url( get_home_url(), PHP_URL_HOST ),
@@ -3119,10 +3363,17 @@
3119 3363 * @param mixed $code Error code to log.
3120 3364 * @param mixed $data Data to log.
3121 3365 */
3122 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 +
3123 3374 // only grab the latest 200 entries.
3124 - $log = array_slice( Jetpack_Options::get_option( 'log', array() ), -199, 199 );
3375 + $log = array_slice( $raw_log, -199, 199 );
3125 3376
3126 3377 // Append our event to the log.
3127 3378 $log_entry = array(
3128 3379 'time' => time(),
@@ -3222,8 +3473,15 @@
3222 3473
3223 3474 /**
3224 3475 * Return stat data for WPCOM sync.
3225 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 + *
3226 3484 * @param bool $encode JSON encode the result.
3227 3485 * @param bool $extended Adds additional stats data.
3228 3486 *
3229 3487 * @return array|string Stats data. Array if $encode is false. JSON-encoded string is $encode is true.
@@ -3228,10 +3486,15 @@
3228 3486 *
3229 3487 * @return array|string Stats data. Array if $encode is false. JSON-encoded string is $encode is true.
3230 3488 */
3231 3489 public static function get_stat_data( $encode = true, $extended = true ) {
3232 - $data = Jetpack_Heartbeat::generate_stats_array();
3490 + _deprecated_function( __METHOD__, 'jetpack-16.2', 'Automattic\\Jetpack\\Heartbeat::generate_stats_array' );
3233 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 +
3234 3497 if ( $extended ) {
3235 3498 $additional_data = self::get_additional_stat_data();
3236 3499 $data = array_merge( $data, $additional_data );
3237 3500 }
@@ -3236,9 +3499,9 @@
3236 3499 $data = array_merge( $data, $additional_data );
3237 3500 }
3238 3501
3239 3502 if ( $encode ) {
3240 - return wp_json_encode( $data );
3503 + return wp_json_encode( $data, JSON_UNESCAPED_SLASHES );
3241 3504 }
3242 3505
3243 3506 return $data;
3244 3507 }
@@ -3310,23 +3573,24 @@
3310 3573 $fallback_no_verify_ssl_certs = Jetpack_Options::get_option( 'fallback_no_verify_ssl_certs' );
3311 3574 /** Already documented in automattic/jetpack-connection::src/class-client.php */
3312 3575 $client_verify_ssl_certs = apply_filters( 'jetpack_client_verify_ssl_certs', false );
3313 3576
3314 - if ( ! $is_offline_mode ) {
3315 - Jetpack_Connection_Banner::init();
3316 - Jetpack_Connection_Widget::init();
3317 - }
3577 + // Run post-activation actions if needed.
3578 + $this->plugin_post_activation();
3318 3579
3319 3580 if ( ( self::is_connection_ready() || $is_offline_mode ) && false === $fallback_no_verify_ssl_certs && ! $client_verify_ssl_certs ) {
3320 3581 // Upgrade: 1.1 -> 1.1.1
3321 3582 // Check and see if host can verify the Jetpack servers' SSL certificate.
3322 3583 $args = array();
3584 + // @phan-suppress-next-line PhanAccessMethodInternal -- Phan is correct, but the usage is intentional.
3323 3585 Client::_wp_remote_request( self::connection()->api_url( 'test' ), $args, true );
3324 3586 }
3325 3587
3326 - Jetpack_Recommendations_Banner::init();
3327 -
3328 - 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 + ) {
3329 3593 add_action( 'jetpack_notices', array( $this, 'alert_auto_ssl_fail' ) );
3330 3594 }
3331 3595
3332 3596 add_action( 'load-plugins.php', array( $this, 'intercept_plugin_error_scrape_init' ) );
@@ -3335,12 +3599,8 @@
3335 3599 if ( ! ( is_multisite() && is_plugin_active_for_network( 'jetpack/jetpack.php' ) && ! is_network_admin() ) ) {
3336 3600 add_action( 'admin_enqueue_scripts', array( $this, 'deactivate_dialog' ) );
3337 3601 }
3338 3602
3339 - if ( isset( $_COOKIE['jetpackState']['display_update_modal'] ) ) {
3340 - add_action( 'admin_enqueue_scripts', __CLASS__ . '::enqueue_block_style' );
3341 - }
3342 -
3343 3603 add_filter( 'plugin_action_links_' . plugin_basename( JETPACK__PLUGIN_DIR . 'jetpack.php' ), array( $this, 'plugin_action_links' ) );
3344 3604
3345 3605 if ( self::is_connection_ready() || $is_offline_mode ) {
3346 3606 // Artificially throw errors in certain specific cases during plugin activation.
@@ -3345,13 +3605,8 @@
3345 3605 if ( self::is_connection_ready() || $is_offline_mode ) {
3346 3606 // Artificially throw errors in certain specific cases during plugin activation.
3347 3607 add_action( 'activate_plugin', array( $this, 'throw_error_on_activate_plugin' ) );
3348 3608 }
3349 -
3350 - // Add custom column in wp-admin/users.php to show whether user is linked.
3351 - add_filter( 'manage_users_columns', array( $this, 'jetpack_icon_user_connected' ) );
3352 - add_action( 'manage_users_custom_column', array( $this, 'jetpack_show_user_connected_icon' ), 10, 3 );
3353 - add_action( 'admin_print_styles', array( $this, 'jetpack_user_col_style' ) );
3354 3609 }
3355 3610
3356 3611 /**
3357 3612 * Adds body classes.
@@ -3384,8 +3639,9 @@
3384 3639 * Sometimes a plugin can activate without causing errors, but it will cause errors on the next page load.
3385 3640 * This function artificially throws errors for such cases (per a specific list).
3386 3641 *
3387 3642 * @param string $plugin The activated plugin.
3643 + * @throws RuntimeException If a conflicting plugin is detected.
3388 3644 */
3389 3645 public function throw_error_on_activate_plugin( $plugin ) {
3390 3646 $active_modules = self::get_active_modules();
3391 3647
@@ -3398,8 +3654,9 @@
3398 3654 if ( 'stats.php' === basename( $plugin ) ) {
3399 3655 $throw = true;
3400 3656 }
3401 3657 } else {
3658 + // @phan-suppress-next-line PhanUndeclaredFunctionInCallable -- Checked above. See also https://github.com/phan/phan/issues/1204.
3402 3659 $reflection = new ReflectionFunction( 'stats_get_api_key' );
3403 3660 if ( basename( $plugin ) === basename( $reflection->getFileName() ) ) {
3404 3661 $throw = true;
3405 3662 }
@@ -3406,9 +3663,9 @@
3406 3663 }
3407 3664
3408 3665 if ( $throw ) {
3409 3666 /* translators: Plugin name to deactivate. */
3410 - trigger_error( sprintf( esc_html__( 'Jetpack contains the most recent version of the old &#8220;%1$s&#8221; 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' ) );
3411 3668 }
3412 3669 }
3413 3670 }
3414 3671
@@ -3490,8 +3747,9 @@
3490 3747 /**
3491 3748 * Handler for Jetpack remote file uploads.
3492 3749 *
3493 3750 * @access public
3751 + * @return never
3494 3752 */
3495 3753 public function remote_request_handlers() {
3496 3754 switch ( current_filter() ) {
3497 3755 case 'wp_ajax_nopriv_jetpack_upload_file':
@@ -3518,18 +3776,17 @@
3518 3776 if ( ! is_int( $status_code ) ) {
3519 3777 $status_code = 400;
3520 3778 }
3521 3779
3522 - status_header( $status_code );
3523 - die( wp_json_encode( (object) compact( 'error', 'error_description' ) ) );
3780 + wp_send_json( (object) compact( 'error', 'error_description' ), $status_code, JSON_UNESCAPED_SLASHES );
3524 3781 }
3525 3782
3526 - status_header( 200 );
3527 3783 if ( true === $response ) {
3528 - exit;
3784 + status_header( 200 );
3785 + exit( 0 );
3529 3786 }
3530 3787
3531 - die( wp_json_encode( (object) $response ) );
3788 + wp_send_json( (object) $response, 200, JSON_UNESCAPED_SLASHES );
3532 3789 }
3533 3790
3534 3791 /**
3535 3792 * Uploads a file gotten from the global $_FILES.
@@ -3537,9 +3794,9 @@
3537 3794 * the attachment file of the media item (gotten through of the post_id)
3538 3795 * will be updated instead of add a new one.
3539 3796 *
3540 3797 * @param boolean $update_media_item - update media attachment.
3541 - * @return array - An array describing the uploadind files process.
3798 + * @return array|WP_Error - An array describing the uploading files process.
3542 3799 */
3543 3800 public function upload_handler( $update_media_item = false ) {
3544 3801 if ( isset( $_SERVER['REQUEST_METHOD'] ) && 'POST' !== strtoupper( sanitize_text_field( wp_unslash( $_SERVER['REQUEST_METHOD'] ) ) ) ) {
3545 3802 return new WP_Error( 405, get_status_header_desc( 405 ), 405 );
@@ -3590,9 +3847,9 @@
3590 3847 return new WP_Error( 'handler_cannot_upload', __( 'The upload handler cannot upload files', 'jetpack' ), 400 );
3591 3848 }
3592 3849
3593 3850 $uploaded_files = array();
3594 - $global_post = isset( $GLOBALS['post'] ) ? $GLOBALS['post'] : null;
3851 + $global_post = $GLOBALS['post'] ?? null;
3595 3852 unset( $GLOBALS['post'] );
3596 3853 if ( empty( $_FILES['media']['name'] ) ) {
3597 3854 // Nothing to process, just return.
3598 3855 return $uploaded_files;
@@ -3599,9 +3856,9 @@
3599 3856 }
3600 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.
3601 3858 $file = array();
3602 3859 foreach ( $media_keys as $media_key ) {
3603 - $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.
3604 3861 }
3605 3862
3606 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.
3607 3864
@@ -3647,9 +3904,9 @@
3647 3904 'type' => (string) $edited_media_item->post_mime_type,
3648 3905 'meta' => (array) wp_get_attachment_metadata( $post_id ),
3649 3906 );
3650 3907
3651 - return (array) array( $response );
3908 + return array( $response );
3652 3909 }
3653 3910
3654 3911 $attachment_id = media_handle_upload(
3655 3912 '.jetpack.upload.',
@@ -3688,67 +3945,8 @@
3688 3945 return $uploaded_files;
3689 3946 }
3690 3947
3691 3948 /**
3692 - * Add help to the Jetpack page
3693 - *
3694 - * @since Jetpack (1.2.3)
3695 - * @return void
3696 - */
3697 - public function admin_help() {
3698 - $current_screen = get_current_screen();
3699 -
3700 - // Overview.
3701 - $current_screen->add_help_tab(
3702 - array(
3703 - 'id' => 'home',
3704 - 'title' => __( 'Home', 'jetpack' ),
3705 - 'content' =>
3706 - '<p><strong>' . __( 'Jetpack', 'jetpack' ) . '</strong></p>' .
3707 - '<p>' . __( 'Jetpack supercharges your self-hosted WordPress site with the awesome cloud power of WordPress.com.', 'jetpack' ) . '</p>' .
3708 - '<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>',
3709 - )
3710 - );
3711 -
3712 - // Screen Content.
3713 - if ( current_user_can( 'manage_options' ) ) {
3714 - $current_screen->add_help_tab(
3715 - array(
3716 - 'id' => 'settings',
3717 - 'title' => __( 'Settings', 'jetpack' ),
3718 - 'content' =>
3719 - '<p><strong>' . __( 'Jetpack', 'jetpack' ) . '</strong></p>' .
3720 - '<p>' . __( 'You can activate or deactivate individual Jetpack modules to suit your needs.', 'jetpack' ) . '</p>' .
3721 - '<ol>' .
3722 - '<li>' . __( 'Each module has an Activate or Deactivate link so you can toggle one individually.', 'jetpack' ) . '</li>' .
3723 - '<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>' .
3724 - '</ol>' .
3725 - '<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>',
3726 - )
3727 - );
3728 - }
3729 -
3730 - // Help Sidebar.
3731 - $support_url = Redirect::get_url( 'jetpack-support' );
3732 - $faq_url = Redirect::get_url( 'jetpack-faq' );
3733 - $current_screen->set_help_sidebar(
3734 - '<p><strong>' . __( 'For more information:', 'jetpack' ) . '</strong></p>' .
3735 - '<p><a href="' . esc_url( $faq_url ) . '" rel="noopener noreferrer" target="_blank">' . __( 'Jetpack FAQ', 'jetpack' ) . '</a></p>' .
3736 - '<p><a href="' . esc_url( $support_url ) . '" rel="noopener noreferrer" target="_blank">' . __( 'Jetpack Support', 'jetpack' ) . '</a></p>' .
3737 - '<p><a href="' . esc_url( self::admin_url( array( 'page' => 'jetpack-debugger' ) ) ) . '">' . __( 'Jetpack Debugging Center', 'jetpack' ) . '</a></p>'
3738 - );
3739 - }
3740 -
3741 - /**
3742 - * Enqueues the jetpack-icons style.
3743 - *
3744 - * @return void
3745 - */
3746 - public function admin_menu_css() {
3747 - wp_enqueue_style( 'jetpack-icons' );
3748 - }
3749 -
3750 - /**
3751 3949 * Add action links for the Jetpack plugin.
3752 3950 *
3753 3951 * @param array $actions Plugin actions.
3754 3952 *
@@ -3754,14 +3952,11 @@
3754 3952 *
3755 3953 * @return array
3756 3954 */
3757 3955 public function plugin_action_links( $actions ) {
3758 - $support_link = ( new Host() )->is_woa_site() ? 'https://wordpress.com/help/contact/' : self::admin_url( 'page=jetpack-debugger' );
3759 -
3760 3956 if ( current_user_can( 'jetpack_manage_modules' ) && ( self::is_connection_ready() || ( new Status() )->is_offline_mode() ) ) {
3761 3957 return array_merge(
3762 - array( 'settings' => sprintf( '<a href="%s">%s</a>', esc_url( self::admin_url( 'page=jetpack#/settings' ) ), __( 'Settings', 'jetpack' ) ) ),
3763 - 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' ) ) ),
3764 3959 $actions
3765 3960 );
3766 3961 }
3767 3962
@@ -3768,53 +3963,8 @@
3768 3963 return $actions;
3769 3964 }
3770 3965
3771 3966 /**
3772 - * Add an activation modal to the plugins page and the main dashboard.
3773 - *
3774 - * @param string $hook The current admin page.
3775 - *
3776 - * @return void
3777 - */
3778 - public function activate_dialog( $hook ) {
3779 - /*
3780 - * We do not need it on other plugin pages,
3781 - * or when Jetpack is already connected.
3782 - */
3783 - if (
3784 - ! in_array( $hook, array( 'plugins.php', 'index.php' ), true )
3785 - || self::is_connection_ready()
3786 - ) {
3787 - return;
3788 - }
3789 -
3790 - // add an activation script that will pick up deactivation actions for the Jetpack plugin.
3791 - Assets::register_script(
3792 - 'jetpack-full-activation-modal-js',
3793 - '_inc/build/activation-modal.js',
3794 - JETPACK__PLUGIN_FILE,
3795 - array(
3796 - 'enqueue' => true,
3797 - 'in_footer' => true,
3798 - 'textdomain' => 'jetpack',
3799 - 'dependencies' => array(
3800 - 'wp-polyfill',
3801 - 'wp-components',
3802 - ),
3803 - )
3804 - );
3805 -
3806 - // Add objects to be passed to the initial state of the app.
3807 - // Use wp_add_inline_script instead of wp_localize_script, see https://core.trac.wordpress.org/ticket/25280.
3808 - 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' );
3809 -
3810 - // Adds Connection package initial state.
3811 - Connection_Initial_State::render_script( 'jetpack-full-activation-modal-js' );
3812 -
3813 - add_action( 'admin_notices', array( $this, 'jetpack_plugin_portal_containers' ) );
3814 - }
3815 -
3816 - /**
3817 3967 * Adds the deactivation warning modal for Jetpack.
3818 3968 *
3819 3969 * @param string $hook The current admin page.
3820 3970 *
@@ -3834,14 +3984,10 @@
3834 3984 'jetpack-plugins-page-js',
3835 3985 '_inc/build/plugins-page.js',
3836 3986 JETPACK__PLUGIN_FILE,
3837 3987 array(
3838 - 'in_footer' => true,
3839 - 'textdomain' => 'jetpack',
3840 - 'dependencies' => array(
3841 - 'wp-polyfill',
3842 - 'wp-components',
3843 - ),
3988 + 'in_footer' => true,
3989 + 'textdomain' => 'jetpack',
3844 3990 )
3845 3991 );
3846 3992 Assets::enqueue_script( 'jetpack-plugins-page-js' );
3847 3993
@@ -3846,9 +3992,9 @@
3846 3992 Assets::enqueue_script( 'jetpack-plugins-page-js' );
3847 3993
3848 3994 // Add objects to be passed to the initial state of the app.
3849 3995 // Use wp_add_inline_script instead of wp_localize_script, see https://core.trac.wordpress.org/ticket/25280.
3850 - 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' );
3851 3997
3852 3998 add_action( 'admin_footer', array( $this, 'jetpack_plugin_portal_containers' ) );
3853 3999 }
3854 4000 }
@@ -3897,9 +4043,9 @@
3897 4043 // @todo provide way to go to specific calypso env.
3898 4044 self::get_calypso_host() . 'jetpack/connect'
3899 4045 )
3900 4046 );
3901 - exit;
4047 + exit( 0 );
3902 4048 }
3903 4049 }
3904 4050
3905 4051 /*
@@ -3934,8 +4080,28 @@
3934 4080 * Done!
3935 4081 */
3936 4082
3937 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 + /**
3938 4104 * Handles the page load events for the Jetpack admin page
3939 4105 */
3940 4106 public function admin_page_load() {
3941 4107 $error = false;
@@ -3971,10 +4137,11 @@
3971 4137 $registered = static::connection()->try_registration();
3972 4138 if ( is_wp_error( $registered ) ) {
3973 4139 $error = $registered->get_error_code();
3974 4140 self::state( 'error', $error );
3975 - self::state( 'error', $registered->get_error_message() );
3976 4141
4142 + self::state( 'error_description', self::get_registration_error_description( $error, $registered->get_error_message() ) );
4143 +
3977 4144 /**
3978 4145 * Jetpack registration Error.
3979 4146 *
3980 4147 * @since 7.5.0
@@ -3998,12 +4165,8 @@
3998 4165 do_action( 'jetpack_connection_register_success', $from );
3999 4166
4000 4167 $url = $this->build_connect_url( true, $redirect, $from );
4001 4168
4002 - if ( ! empty( $_GET['onboarding'] ) ) {
4003 - $url = add_query_arg( 'onboarding', rawurlencode_deep( wp_unslash( $_GET['onboarding'] ) ), $url ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
4004 - }
4005 -
4006 4169 if ( ! empty( $_GET['auth_approved'] ) && 'true' === $_GET['auth_approved'] ) {
4007 4170 $url = add_query_arg( 'auth_approved', 'true', $url );
4008 4171 }
4009 4172
@@ -4008,9 +4171,9 @@
4008 4171 }
4009 4172
4010 4173 add_filter( 'allowed_redirect_hosts', array( Host::class, 'allow_wpcom_environments' ) );
4011 4174 wp_safe_redirect( $url );
4012 - exit;
4175 + exit( 0 );
4013 4176 case 'activate':
4014 4177 if ( ! current_user_can( 'jetpack_activate_modules' ) ) {
4015 4178 $error = 'cheatin';
4016 4179 break;
@@ -4024,9 +4187,9 @@
4024 4187 self::state( 'error', sprintf( __( 'Could not activate %s', 'jetpack' ), $module ) );
4025 4188 }
4026 4189 // The following two lines will rarely happen, as Jetpack::activate_module normally exits at the end.
4027 4190 wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4028 - exit;
4191 + exit( 0 );
4029 4192 case 'activate_default_modules':
4030 4193 check_admin_referer( 'activate_default_modules' );
4031 4194 self::log( 'activate_default_modules' );
4032 4195 self::restate();
@@ -4034,9 +4197,9 @@
4034 4197 $max_version = isset( $_GET['max_version'] ) ? sanitize_text_field( wp_unslash( $_GET['max_version'] ) ) : false;
4035 4198 $other_modules = isset( $_GET['other_modules'] ) && is_array( $_GET['other_modules'] ) ? array_map( 'sanitize_text_field', wp_unslash( $_GET['other_modules'] ) ) : array();
4036 4199 self::activate_default_modules( $min_version, $max_version, $other_modules );
4037 4200 wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4038 - exit;
4201 + exit( 0 );
4039 4202 case 'disconnect':
4040 4203 if ( ! current_user_can( 'jetpack_disconnect' ) ) {
4041 4204 $error = 'cheatin';
4042 4205 break;
@@ -4045,9 +4208,9 @@
4045 4208 check_admin_referer( 'jetpack-disconnect' );
4046 4209 self::log( 'disconnect' );
4047 4210 self::disconnect();
4048 4211 wp_safe_redirect( self::admin_url( 'disconnected=true' ) );
4049 - exit;
4212 + exit( 0 );
4050 4213 case 'reconnect':
4051 4214 if ( ! current_user_can( 'jetpack_reconnect' ) ) {
4052 4215 $error = 'cheatin';
4053 4216 break;
@@ -4058,9 +4221,9 @@
4058 4221 self::disconnect();
4059 4222
4060 4223 add_filter( 'allowed_redirect_hosts', array( Host::class, 'allow_wpcom_environments' ) );
4061 4224 wp_safe_redirect( $this->build_connect_url( true, false, 'reconnect' ) );
4062 - exit;
4225 + exit( 0 );
4063 4226 case 'deactivate':
4064 4227 if ( ! current_user_can( 'jetpack_deactivate_modules' ) ) {
4065 4228 $error = 'cheatin';
4066 4229 break;
@@ -4074,9 +4237,9 @@
4074 4237 self::state( 'message', 'module_deactivated' );
4075 4238 }
4076 4239 self::state( 'module', $modules );
4077 4240 wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4078 - exit;
4241 + exit( 0 );
4079 4242 case 'unlink':
4080 4243 $redirect = isset( $_GET['redirect'] ) ? sanitize_text_field( wp_unslash( $_GET['redirect'] ) ) : '';
4081 4244 check_admin_referer( 'jetpack-unlink' );
4082 4245 self::log( 'unlink' );
@@ -4086,32 +4249,9 @@
4086 4249 wp_safe_redirect( admin_url() );
4087 4250 } else {
4088 4251 wp_safe_redirect( self::admin_url( array( 'page' => rawurlencode( $redirect ) ) ) );
4089 4252 }
4090 - exit;
4091 - case 'onboard':
4092 - if ( ! current_user_can( 'manage_options' ) ) {
4093 - wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4094 - } else {
4095 - self::create_onboarding_token();
4096 - $url = $this->build_connect_url( true );
4097 -
4098 - $token = Jetpack_Options::get_option( 'onboarding' );
4099 -
4100 - if ( false !== ( $token ) ) {
4101 - $url = add_query_arg( 'onboarding', $token, $url );
4102 - }
4103 -
4104 - $calypso_env = ( new Host() )->get_calypso_env();
4105 - if ( ! empty( $calypso_env ) ) {
4106 - $url = add_query_arg( 'calypso_env', $calypso_env, $url );
4107 - }
4108 -
4109 - add_filter( 'allowed_redirect_hosts', array( Host::class, 'allow_wpcom_environments' ) );
4110 - wp_safe_redirect( $url );
4111 - exit;
4112 - }
4113 - exit;
4253 + exit( 0 );
4114 4254 default:
4115 4255 /**
4116 4256 * Fires when a Jetpack admin page is loaded with an unrecognized parameter.
4117 4257 *
@@ -4127,9 +4267,10 @@
4127 4267 if ( ! $error ) {
4128 4268 self::activate_new_modules( true );
4129 4269 }
4130 4270
4131 - $message_code = self::state( 'message' );
4271 + $activated_manage = false;
4272 + $message_code = self::state( 'message' );
4132 4273 if ( self::state( 'optin-manage' ) ) {
4133 4274 $activated_manage = $message_code;
4134 4275 $message_code = 'jetpack-manage';
4135 4276 }
@@ -4333,37 +4474,8 @@
4333 4474 endif;
4334 4475 }
4335 4476
4336 4477 /**
4337 - * We can't always respond to a signed XML-RPC request with a
4338 - * helpful error message. In some circumstances, doing so could
4339 - * leak information.
4340 - *
4341 - * Instead, track that the error occurred via a Jetpack_Option,
4342 - * and send that data back in the heartbeat.
4343 - * All this does is increment a number, but it's enough to find
4344 - * trends.
4345 - *
4346 - * @param WP_Error $xmlrpc_error The error produced during
4347 - * signature validation.
4348 - */
4349 - public function track_xmlrpc_error( $xmlrpc_error ) {
4350 - $code = is_wp_error( $xmlrpc_error )
4351 - ? $xmlrpc_error->get_error_code()
4352 - : 'should-not-happen';
4353 -
4354 - $xmlrpc_errors = Jetpack_Options::get_option( 'xmlrpc_errors', array() );
4355 - if ( isset( $xmlrpc_errors[ $code ] ) && $xmlrpc_errors[ $code ] ) {
4356 - // No need to update the option if we already have
4357 - // this code stored.
4358 - return;
4359 - }
4360 - $xmlrpc_errors[ $code ] = true;
4361 -
4362 - Jetpack_Options::update_option( 'xmlrpc_errors', $xmlrpc_errors, false );
4363 - }
4364 -
4365 - /**
4366 4478 * Initialize the jetpack stats instance only when needed
4367 4479 *
4368 4480 * @return void
4369 4481 */
@@ -4486,9 +4598,9 @@
4486 4598 return $this->build_connect_url( $raw, $redirect, $from, true );
4487 4599 }
4488 4600 }
4489 4601
4490 - $url = $this->build_authorize_url( $redirect );
4602 + $url = ( new Authorize_Redirect( static::connection() ) )->build_authorize_url( $redirect );
4491 4603 }
4492 4604
4493 4605 if ( $from ) {
4494 4606 $url = add_query_arg( 'from', $from, $url );
@@ -4513,66 +4625,30 @@
4513 4625 * @param null $deprecated Deprecated since Jetpack 10.9.
4514 4626 *
4515 4627 * @todo Update default value for redirect since the called function expects a string.
4516 4628 *
4629 + * @deprecated 13.4
4630 + *
4517 4631 * @return mixed|void
4518 4632 */
4519 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' );
4520 4635
4521 - add_filter( 'jetpack_connect_request_body', array( __CLASS__, 'filter_connect_request_body' ) );
4522 - add_filter( 'jetpack_connect_redirect_url', array( __CLASS__, 'filter_connect_redirect_url' ) );
4523 -
4524 - $c8n = self::connection();
4525 - $url = $c8n->get_authorization_url( wp_get_current_user(), $redirect );
4526 -
4527 - remove_filter( 'jetpack_connect_request_body', array( __CLASS__, 'filter_connect_request_body' ) );
4528 - remove_filter( 'jetpack_connect_redirect_url', array( __CLASS__, 'filter_connect_redirect_url' ) );
4529 -
4530 - /**
4531 - * Filter the URL used when authorizing a user to a WordPress.com account.
4532 - *
4533 - * @since 8.9.0
4534 - *
4535 - * @param string $url Connection URL.
4536 - */
4537 - return apply_filters( 'jetpack_build_authorize_url', $url );
4636 + return ( new Authorize_Redirect( static::connection() ) )->build_authorize_url( $redirect );
4538 4637 }
4539 4638
4540 4639 /**
4541 4640 * Filters the connection URL parameter array.
4542 4641 *
4642 + * @deprecated 13.4
4643 + *
4543 4644 * @param array $args default URL parameters used by the package.
4544 4645 * @return array the modified URL arguments array.
4545 4646 */
4546 4647 public static function filter_connect_request_body( $args ) {
4547 - if (
4548 - Constants::is_defined( 'JETPACK__GLOTPRESS_LOCALES_PATH' )
4549 - && include_once Constants::get_constant( 'JETPACK__GLOTPRESS_LOCALES_PATH' )
4550 - ) {
4551 - $gp_locale = GP_Locales::by_field( 'wp_locale', get_locale() );
4552 - $args['locale'] = isset( $gp_locale ) && isset( $gp_locale->slug )
4553 - ? $gp_locale->slug
4554 - : '';
4555 - }
4648 + _deprecated_function( __METHOD__, 'jetpack-13.4', 'Authorize_Redirect::filter_connect_request_body' );
4556 4649
4557 - $tracking = new Tracking();
4558 - $tracks_identity = $tracking->tracks_get_identity( $args['state'] );
4559 -
4560 - $args = array_merge(
4561 - $args,
4562 - array(
4563 - '_ui' => $tracks_identity['_ui'],
4564 - '_ut' => $tracks_identity['_ut'],
4565 - )
4566 - );
4567 -
4568 - $calypso_env = ( new Host() )->get_calypso_env();
4569 -
4570 - if ( ! empty( $calypso_env ) ) {
4571 - $args['calypso_env'] = $calypso_env;
4572 - }
4573 -
4574 - return $args;
4650 + return Authorize_Redirect::filter_connect_request_body( $args );
4575 4651 }
4576 4652
4577 4653 /**
4578 4654 * Filters the `jetpack/v4/connection/data` API response of the Connection package in order to
@@ -4609,41 +4685,19 @@
4609 4685 return $current_user_connection_data;
4610 4686 }
4611 4687
4612 4688 /**
4613 - * Filters the URL that will process the connection data. It can be different from the URL
4614 - * that we send the user to after everything is done.
4615 - *
4616 - * @param String $processing_url the default redirect URL used by the package.
4617 - * @return String the modified URL.
4618 - *
4619 - * @deprecated since Jetpack 9.5.0
4620 - */
4621 - public static function filter_connect_processing_url( $processing_url ) {
4622 - _deprecated_function( __METHOD__, 'jetpack-9.5' );
4623 -
4624 - $processing_url = admin_url( 'admin.php?page=jetpack' ); // Making PHPCS happy.
4625 - return $processing_url;
4626 - }
4627 -
4628 - /**
4629 4689 * Filters the redirection URL that is used for connect requests. The redirect
4630 4690 * URL should return the user back to the Jetpack console.
4631 4691 *
4692 + * @deprecated 13.4
4693 + *
4632 4694 * @param String $redirect the default redirect URL used by the package.
4633 4695 * @return String the modified URL.
4634 4696 */
4635 4697 public static function filter_connect_redirect_url( $redirect ) {
4636 - $jetpack_admin_page = esc_url_raw( admin_url( 'admin.php?page=jetpack' ) );
4637 - $redirect = $redirect
4638 - ? wp_validate_redirect( esc_url_raw( $redirect ), $jetpack_admin_page )
4639 - : $jetpack_admin_page;
4640 -
4641 - if ( isset( $_REQUEST['is_multisite'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- not making a site change here.
4642 - $redirect = Jetpack_Network::init()->get_url( 'network_admin_page' );
4643 - }
4644 -
4645 - return $redirect;
4698 + _deprecated_function( __METHOD__, 'jetpack-13.4', 'Authorize_Redirect::filter_connect_redirect_url' );
4699 + return Authorize_Redirect::filter_connect_redirect_url( $redirect );
4646 4700 }
4647 4701
4648 4702 /**
4649 4703 * This action fires at the beginning of the Manager::authorize method.
@@ -4707,11 +4761,8 @@
4707 4761 *
4708 4762 * @param array $data The request data.
4709 4763 */
4710 4764 public static function authorize_ending_authorized( $data ) {
4711 - // If this site has been through the Jetpack Onboarding flow, delete the onboarding token.
4712 - self::invalidate_onboarding_token();
4713 -
4714 4765 // If redirect_uri is SSO, ensure SSO module is enabled.
4715 4766 parse_str( wp_parse_url( $data['redirect_uri'], PHP_URL_QUERY ), $redirect_options );
4716 4767
4717 4768 /** This filter is documented in class.jetpack-cli.php */
@@ -4835,13 +4886,9 @@
4835 4886 *
4836 4887 * @return int 0 if the same sort or (+/-) to indicate which is greater.
4837 4888 */
4838 4889 public static function sort_modules( $a, $b ) {
4839 - if ( $a['sort'] === $b['sort'] ) {
4840 - return 0;
4841 - }
4842 -
4843 - return ( $a['sort'] < $b['sort'] ) ? -1 : 1;
4890 + return $a['sort'] <=> $b['sort'];
4844 4891 }
4845 4892
4846 4893 /**
4847 4894 * Recheck SSL status for use via an AJAX call.
@@ -4855,10 +4902,12 @@
4855 4902 $result = self::permit_ssl( true );
4856 4903 wp_send_json(
4857 4904 array(
4858 4905 'enabled' => $result,
4859 - 'message' => get_transient( 'jetpack_https_test_message' ),
4860 - )
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
4861 4910 );
4862 4911 }
4863 4912
4864 4913 /* Client API */
@@ -4865,8 +4914,10 @@
4865 4914
4866 4915 /**
4867 4916 * Verify the onboarding token.
4868 4917 *
4918 + * @deprecated since 13.9
4919 + *
4869 4920 * @param array $token_data Token data.
4870 4921 * @param string $token Token value.
4871 4922 * @param string $request_data JSON-encoded request data.
4872 4923 *
@@ -4872,8 +4923,9 @@
4872 4923 *
4873 4924 * @return mixed
4874 4925 */
4875 4926 public static function verify_onboarding_token( $token_data, $token, $request_data ) {
4927 + _deprecated_function( __METHOD__, '13.9' );
4876 4928 // Default to a blog token.
4877 4929 $token_type = 'blog';
4878 4930
4879 4931 // Let's see if this is onboarding. In such case, use user token type and the provided user id.
@@ -4901,9 +4953,9 @@
4901 4953 $jp_user = get_user_by( 'email', $jpo_user );
4902 4954 if ( is_a( $jp_user, 'WP_User' ) ) {
4903 4955 wp_set_current_user( $jp_user->ID );
4904 4956 $user_can = is_multisite()
4905 - ? current_user_can_for_blog( get_current_blog_id(), 'manage_options' )
4957 + ? current_user_can_for_site( get_current_blog_id(), 'manage_options' )
4906 4958 : current_user_can( 'manage_options' );
4907 4959 if ( $user_can ) {
4908 4960 $token_type = 'user';
4909 4961 $token->external_user_id = $jp_user->ID;
@@ -4920,11 +4972,13 @@
4920 4972
4921 4973 /**
4922 4974 * Create a random secret for validating onboarding payload
4923 4975 *
4976 + * @deprecated since 13.9
4924 4977 * @return string Secret token
4925 4978 */
4926 4979 public static function create_onboarding_token() {
4980 + _deprecated_function( __METHOD__, '13.9' );
4927 4981 $token = Jetpack_Options::get_option( 'onboarding' );
4928 4982 if ( false === ( $token ) ) {
4929 4983 $token = wp_generate_password( 32, false );
4930 4984 Jetpack_Options::update_option( 'onboarding', $token );
@@ -4935,11 +4989,13 @@
4935 4989
4936 4990 /**
4937 4991 * Remove the onboarding token
4938 4992 *
4993 + * @deprecated since 13.9
4939 4994 * @return bool True on success, false on failure
4940 4995 */
4941 4996 public static function invalidate_onboarding_token() {
4997 + _deprecated_function( __METHOD__, '13.9' );
4942 4998 return Jetpack_Options::delete_option( 'onboarding' );
4943 4999 }
4944 5000
4945 5001 /**
@@ -4944,8 +5000,10 @@
4944 5000
4945 5001 /**
4946 5002 * Validate an onboarding token for a specific action
4947 5003 *
5004 + * @deprecated since 13.9
5005 + *
4948 5006 * @param string $token Onboarding token.
4949 5007 * @param string $action Action name.
4950 5008 *
4951 5009 * @return boolean True if token/action pair is accepted, false if not
@@ -4950,8 +5008,9 @@
4950 5008 *
4951 5009 * @return boolean True if token/action pair is accepted, false if not
4952 5010 */
4953 5011 public static function validate_onboarding_token_action( $token, $action ) {
5012 + _deprecated_function( __METHOD__, '13.9' );
4954 5013 // Compare tokens, bail if tokens do not match.
4955 5014 if ( ! hash_equals( $token, Jetpack_Options::get_option( 'onboarding' ) ) ) {
4956 5015 return false;
4957 5016 }
@@ -4977,39 +5036,41 @@
4977 5036 * @return boolean
4978 5037 * @since 2.3.3
4979 5038 */
4980 5039 public static function permit_ssl( $force_recheck = false ) {
4981 - // Do some fancy tests to see if ssl is being supported.
4982 - if ( ! $force_recheck ) {
4983 - $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;
4984 5043 }
4985 5044
4986 - if ( $force_recheck || false === $ssl ) {
4987 - $message = '';
4988 - if ( 'https' !== substr( JETPACK__API_BASE, 0, 5 ) ) {
4989 - $ssl = 0;
4990 - } else {
4991 - $ssl = 1;
5045 + return Heartbeat::permit_ssl( $force_recheck );
5046 + }
4992 5047
4993 - if ( ! wp_http_supports( array( 'ssl' => true ) ) ) {
4994 - $ssl = 0;
4995 - $message = __( 'WordPress reports no SSL support', 'jetpack' );
4996 - } else {
4997 - $response = wp_remote_get( JETPACK__API_BASE . 'test/1/' );
4998 - if ( is_wp_error( $response ) ) {
4999 - $ssl = 0;
5000 - $message = __( 'WordPress reports no SSL support', 'jetpack' );
5001 - } elseif ( 'OK' !== wp_remote_retrieve_body( $response ) ) {
5002 - $ssl = 0;
5003 - $message = __( 'Response was not OK: ', 'jetpack' ) . wp_remote_retrieve_body( $response );
5004 - }
5005 - }
5006 - }
5007 - set_transient( 'jetpack_https_test', $ssl, DAY_IN_SECONDS );
5008 - 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 '';
5009 5061 }
5010 5062
5011 - 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 + }
5012 5073 }
5013 5074
5014 5075 /**
5015 5076 * Displays an admin_notice, alerting the user that outbound SSL isn't working.
@@ -5028,9 +5089,9 @@
5028 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>
5029 5090 <p>
5030 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' ); ?>
5031 5092 <a href="#" id="jetpack-recheck-ssl-button"><?php esc_html_e( 'Try again', 'jetpack' ); ?></a>
5032 - <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>
5033 5094 </p>
5034 5095 <p>
5035 5096 <?php
5036 5097 printf(
@@ -5049,18 +5110,18 @@
5049 5110 <script type="text/javascript">
5050 5111 jQuery( document ).ready( function( $ ) {
5051 5112 $( '#jetpack-recheck-ssl-button' ).click( function( e ) {
5052 5113 var $this = $( this );
5053 - $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 ); ?> );
5054 5115 $( '#jetpack-recheck-ssl-output' ).html( '' );
5055 5116 e.preventDefault();
5056 - 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 ); ?> };
5057 5118 $.post( ajaxurl, data )
5058 5119 .done( function( response ) {
5059 5120 if ( response.enabled ) {
5060 5121 $( '#jetpack-ssl-warning' ).hide();
5061 5122 } else {
5062 - 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 ); ?> );
5063 5124 $( '#jetpack-recheck-ssl-output' ).html( 'SSL Failed: ' + response.message );
5064 5125 }
5065 5126 }.bind( $this ) );
5066 5127 } );
@@ -5086,26 +5147,8 @@
5086 5147 return $jetpack->connection_manager;
5087 5148 }
5088 5149
5089 5150 /**
5090 - * Creates two secret tokens and the end of life timestamp for them.
5091 - *
5092 - * Note these tokens are unique per call, NOT static per site for connecting.
5093 - *
5094 - * @deprecated 9.5 Use Automattic\Jetpack\Connection\Secrets->generate() instead.
5095 - *
5096 - * @since 2.6
5097 - * @param String $action The action name.
5098 - * @param Integer $user_id The user identifier.
5099 - * @param Integer $exp Expiration time in seconds.
5100 - * @return array
5101 - */
5102 - public static function generate_secrets( $action, $user_id = false, $exp = 600 ) {
5103 - _deprecated_function( __METHOD__, 'jetpack-9.5', 'Automattic\\Jetpack\\Connection\\Secrets->generate' );
5104 - return self::connection()->generate_secrets( $action, $user_id, $exp );
5105 - }
5106 -
5107 - /**
5108 5151 * Get verification secrets.
5109 5152 *
5110 5153 * @param string $action Action name.
5111 5154 * @param int $user_id User ID.
@@ -5126,35 +5169,8 @@
5126 5169 return $secrets;
5127 5170 }
5128 5171
5129 5172 /**
5130 - * Register a connection.
5131 - *
5132 - * @deprecated Jetpack 9.7.0
5133 - * @see Automattic\Jetpack\Connection\Manager::try_registration()
5134 - *
5135 - * @return bool|WP_Error
5136 - */
5137 - public static function register() {
5138 - _deprecated_function( __METHOD__, 'jetpack-9.7', 'Automattic\\Jetpack\\Connection\\Manager::try_registration' );
5139 - return static::connection()->try_registration( false );
5140 - }
5141 -
5142 - /**
5143 - * Filters the registration request body to include tracking properties.
5144 - *
5145 - * @deprecated Jetpack 9.7.0
5146 - * @see Automattic\Jetpack\Connection\Utils::filter_register_request_body()
5147 - *
5148 - * @param array $properties Token request properties.
5149 - * @return array amended properties.
5150 - */
5151 - public static function filter_register_request_body( $properties ) {
5152 - _deprecated_function( __METHOD__, 'jetpack-9.7', 'Automattic\\Jetpack\\Connection\\Utils::filter_register_request_body' );
5153 - return Connection_Utils::filter_register_request_body( $properties );
5154 - }
5155 -
5156 - /**
5157 5173 * Filters the token request body to include tracking properties.
5158 5174 *
5159 5175 * @param array $properties Token request properties.
5160 5176 *
@@ -5175,9 +5191,9 @@
5175 5191
5176 5192 /**
5177 5193 * If the db version is showing something other that what we've got now, bump it to current.
5178 5194 *
5179 - * @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.
5180 5196 */
5181 5197 public static function maybe_set_version_option() {
5182 5198 list( $version ) = explode( ':', Jetpack_Options::get_option( 'version' ) );
5183 5199 if ( JETPACK__VERSION !== $version ) {
@@ -5195,21 +5211,8 @@
5195 5211
5196 5212 /* Client Server API */
5197 5213
5198 5214 /**
5199 - * Loads the Jetpack XML-RPC client.
5200 - * No longer necessary, as the XML-RPC client will be automagically loaded.
5201 - *
5202 - * Note: we cannot remove this function yet as it is used in this plugin:
5203 - * https://wordpress.org/plugins/jetpack-subscription-form/
5204 - *
5205 - * @deprecated since 7.7.0
5206 - */
5207 - public static function load_xml_rpc_client() {
5208 - _deprecated_function( __METHOD__, 'jetpack-7.7' );
5209 - }
5210 -
5211 - /**
5212 5215 * State is passed via cookies from one request to the next, but never to subsequent requests.
5213 5216 * SET: state( $key, $value );
5214 5217 * GET: $value = state( $key );
5215 5218 *
@@ -5283,20 +5286,8 @@
5283 5286
5284 5287 self::state( 'privacy_checks', $privacy_checks );
5285 5288 }
5286 5289
5287 - /**
5288 - * Serve a WordPress.com static resource via a randomized wp.com subdomain.
5289 - *
5290 - * @deprecated 9.3.0 Use Assets::staticize_subdomain.
5291 - *
5292 - * @param string $url WordPress.com static resource URL.
5293 - */
5294 - public static function staticize_subdomain( $url ) {
5295 - _deprecated_function( __METHOD__, 'jetpack-9.3.0', 'Automattic\Jetpack\Assets::staticize_subdomain' );
5296 - return Assets::staticize_subdomain( $url );
5297 - }
5298 -
5299 5290 /* JSON API Authorization */
5300 5291
5301 5292 /**
5302 5293 * Handles the login action for Authorizing the JSON API
@@ -5301,13 +5292,14 @@
5301 5292 /**
5302 5293 * Handles the login action for Authorizing the JSON API
5303 5294 */
5304 5295 public function login_form_json_api_authorization() {
5305 - $this->verify_json_api_authorization_request();
5296 + $authorize_json_api = new Authorize_Json_Api();
5297 + $authorize_json_api->verify_json_api_authorization_request();
5306 5298
5307 - 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 );
5308 5300
5309 - 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' ) );
5310 5302 add_action( 'login_form', array( $this, 'preserve_action_in_login_form_for_json_api_authorization' ) );
5311 5303 add_filter( 'site_url', array( $this, 'post_login_form_to_signed_url' ), 10, 3 );
5312 5304 }
5313 5305
@@ -5345,16 +5337,17 @@
5345 5337
5346 5338 /**
5347 5339 * If someone logs in to approve API access, store the Access Code in usermeta.
5348 5340 *
5341 + * @deprecated 13.4
5342 + *
5349 5343 * @param string $user_login Unused.
5350 5344 * @param WP_User $user User logged in.
5351 5345 */
5352 5346 public function store_json_api_authorization_token( $user_login, $user ) {
5353 - add_filter( 'login_redirect', array( $this, 'add_token_to_login_redirect_json_api_authorization' ), 10, 3 );
5354 - add_filter( 'allowed_redirect_hosts', array( $this, 'allow_wpcom_public_api_domain' ) );
5355 - $token = wp_generate_password( 32, false );
5356 - 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 );
5357 5350 }
5358 5351
5359 5352 /**
5360 5353 * Add public-api.wordpress.com to the safe redirect allowed list - only added when someone allows API access.
@@ -5360,23 +5353,29 @@
5360 5353 * Add public-api.wordpress.com to the safe redirect allowed list - only added when someone allows API access.
5361 5354 *
5362 5355 * To be used with a filter of allowed domains for a redirect.
5363 5356 *
5357 + * @deprecated 13.4
5358 + *
5364 5359 * @param array $domains Allowed WP.com Environments.
5365 5360 */
5366 5361 public function allow_wpcom_public_api_domain( $domains ) {
5367 - $domains[] = 'public-api.wordpress.com';
5368 - 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 );
5369 5365 }
5370 5366
5371 5367 /**
5372 5368 * Check if the redirect is encoded.
5373 5369 *
5370 + * @deprecated 13.4
5371 + *
5374 5372 * @param string $redirect_url Redirect URL.
5375 5373 *
5376 5374 * @return bool If redirect has been encoded.
5377 5375 */
5378 5376 public static function is_redirect_encoded( $redirect_url ) {
5377 + _deprecated_function( __METHOD__, 'jetpack-13.4' );
5379 5378 return preg_match( '/https?%3A%2F%2F/i', $redirect_url ) > 0;
5380 5379 }
5381 5380
5382 5381 /**
@@ -5394,8 +5393,10 @@
5394 5393
5395 5394 /**
5396 5395 * Add the Access Code details to the public-api.wordpress.com redirect.
5397 5396 *
5397 + * @deprecated 13.4
5398 + *
5398 5399 * @param string $redirect_to URL.
5399 5400 * @param string $original_redirect_to URL.
5400 5401 * @param WP_User $user WP_User for the redirect.
5401 5402 *
@@ -5401,23 +5402,18 @@
5401 5402 *
5402 5403 * @return string
5403 5404 */
5404 5405 public function add_token_to_login_redirect_json_api_authorization( $redirect_to, $original_redirect_to, $user ) {
5405 - return add_query_arg(
5406 - urlencode_deep(
5407 - array(
5408 - 'jetpack-code' => get_user_meta( $user->ID, 'jetpack_json_api_' . $this->json_api_authorization_request['client_id'], true ),
5409 - 'jetpack-user-id' => (int) $user->ID,
5410 - 'jetpack-state' => $this->json_api_authorization_request['state'],
5411 - )
5412 - ),
5413 - $redirect_to
5414 - );
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 );
5415 5409 }
5416 5410
5417 5411 /**
5418 5412 * Verifies the request by checking the signature
5419 5413 *
5414 + * @deprecated 13.4
5415 + *
5420 5416 * @since 4.6.0 Method was updated to use `$_REQUEST` instead of `$_GET` and `$_POST`. Method also updated to allow
5421 5417 * passing in an `$environment` argument that overrides `$_REQUEST`. This was useful for integrating with SSO.
5422 5418 *
5423 5419 * @param null|array $environment Value to override $_REQUEST.
@@ -5422,194 +5418,24 @@
5422 5418 *
5423 5419 * @param null|array $environment Value to override $_REQUEST.
5424 5420 */
5425 5421 public function verify_json_api_authorization_request( $environment = null ) {
5426 - $environment = $environment === null
5427 - ? $_REQUEST // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- nonce verification handled later in function.
5428 - : $environment;
5422 + _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Connection\\Authorize_Json_Api::verify_json_api_authorization_request' );
5429 5423
5430 - list( $env_token,, $env_user_id ) = explode( ':', $environment['token'] );
5431 - $token = ( new Tokens() )->get_access_token( $env_user_id, $env_token );
5432 - if ( ! $token || empty( $token->secret ) ) {
5433 - wp_die( esc_html__( 'You must connect your Jetpack plugin to WordPress.com to use this feature.', 'jetpack' ) );
5434 - }
5435 -
5436 - $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' );
5437 -
5438 - // Host has encoded the request URL, probably as a result of a bad http => https redirect.
5439 - 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.
5440 - /**
5441 - * Jetpack authorisation request Error.
5442 - *
5443 - * @since 7.5.0
5444 - */
5445 - do_action( 'jetpack_verify_api_authorization_request_error_double_encode' );
5446 - $die_error = sprintf(
5447 - /* translators: %s is a URL */
5448 - __( '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' ),
5449 - esc_url( Redirect::get_url( 'jetpack-support-double-encoding' ) )
5450 - );
5451 - }
5452 -
5453 - $jetpack_signature = new Jetpack_Signature( $token->secret, (int) Jetpack_Options::get_option( 'time_diff' ) );
5454 -
5455 - if ( isset( $environment['jetpack_json_api_original_query'] ) ) {
5456 - $signature = $jetpack_signature->sign_request(
5457 - $environment['token'],
5458 - $environment['timestamp'],
5459 - $environment['nonce'],
5460 - '',
5461 - 'GET',
5462 - $environment['jetpack_json_api_original_query'],
5463 - null,
5464 - true
5465 - );
5466 - } else {
5467 - $signature = $jetpack_signature->sign_current_request(
5468 - array(
5469 - 'body' => null,
5470 - 'method' => 'GET',
5471 - )
5472 - );
5473 - }
5474 -
5475 - if ( ! $signature ) {
5476 - wp_die(
5477 - wp_kses(
5478 - $die_error,
5479 - array(
5480 - 'a' => array(
5481 - 'href' => array(),
5482 - ),
5483 - )
5484 - )
5485 - );
5486 - } elseif ( is_wp_error( $signature ) ) {
5487 - wp_die(
5488 - wp_kses(
5489 - $die_error,
5490 - array(
5491 - 'a' => array(
5492 - 'href' => array(),
5493 - ),
5494 - )
5495 - )
5496 - );
5497 - } elseif ( ! hash_equals( $signature, $environment['signature'] ) ) {
5498 - if ( is_ssl() ) {
5499 - // 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.
5500 - $signature = $jetpack_signature->sign_current_request(
5501 - array(
5502 - 'scheme' => 'http',
5503 - 'body' => null,
5504 - 'method' => 'GET',
5505 - )
5506 - );
5507 - if ( ! $signature || is_wp_error( $signature ) || ! hash_equals( $signature, $environment['signature'] ) ) {
5508 - wp_die(
5509 - wp_kses(
5510 - $die_error,
5511 - array(
5512 - 'a' => array(
5513 - 'href' => array(),
5514 - ),
5515 - )
5516 - )
5517 - );
5518 - }
5519 - } else {
5520 - wp_die(
5521 - wp_kses(
5522 - $die_error,
5523 - array(
5524 - 'a' => array(
5525 - 'href' => array(),
5526 - ),
5527 - )
5528 - )
5529 - );
5530 - }
5531 - }
5532 -
5533 - $timestamp = (int) $environment['timestamp'];
5534 - $nonce = stripslashes( (string) $environment['nonce'] );
5535 -
5536 - if ( ! $this->connection_manager ) {
5537 - $this->connection_manager = new Connection_Manager();
5538 - }
5539 -
5540 - if ( ! ( new Nonce_Handler() )->add( $timestamp, $nonce ) ) {
5541 - // De-nonce the nonce, at least for 5 minutes.
5542 - // 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).
5543 - $old_nonce_time = get_option( "jetpack_nonce_{$timestamp}_{$nonce}" );
5544 - if ( $old_nonce_time < time() - 300 ) {
5545 - wp_die( esc_html__( 'The authorization process expired. Please go back and try again.', 'jetpack' ) );
5546 - }
5547 - }
5548 -
5549 - $data = json_decode( base64_decode( stripslashes( $environment['data'] ) ) ); // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_decode
5550 - $data_filters = array(
5551 - 'state' => 'opaque',
5552 - 'client_id' => 'int',
5553 - 'client_title' => 'string',
5554 - 'client_image' => 'url',
5555 - );
5556 -
5557 - foreach ( $data_filters as $key => $sanitation ) {
5558 - if ( ! isset( $data->$key ) ) {
5559 - wp_die(
5560 - wp_kses(
5561 - $die_error,
5562 - array(
5563 - 'a' => array(
5564 - 'href' => array(),
5565 - ),
5566 - )
5567 - )
5568 - );
5569 - }
5570 -
5571 - switch ( $sanitation ) {
5572 - case 'int':
5573 - $this->json_api_authorization_request[ $key ] = (int) $data->$key;
5574 - break;
5575 - case 'opaque':
5576 - $this->json_api_authorization_request[ $key ] = (string) $data->$key;
5577 - break;
5578 - case 'string':
5579 - $this->json_api_authorization_request[ $key ] = wp_kses( (string) $data->$key, array() );
5580 - break;
5581 - case 'url':
5582 - $this->json_api_authorization_request[ $key ] = esc_url_raw( (string) $data->$key );
5583 - break;
5584 - }
5585 - }
5586 -
5587 - if ( empty( $this->json_api_authorization_request['client_id'] ) ) {
5588 - wp_die(
5589 - wp_kses(
5590 - $die_error,
5591 - array(
5592 - 'a' => array(
5593 - 'href' => array(),
5594 - ),
5595 - )
5596 - )
5597 - );
5598 - }
5424 + return ( new Authorize_Json_Api() )->verify_json_api_authorization_request( $environment );
5599 5425 }
5600 5426
5601 5427 /**
5602 5428 * HTML for the JSON API authorization notice.
5603 5429 *
5430 + * @deprecated 13.4
5431 + *
5604 5432 * @return string
5605 5433 */
5606 5434 public function login_message_json_api_authorization() {
5607 - return '<p class="message">' . sprintf(
5608 - /* translators: Name/image of the client requesting authorization */
5609 - esc_html__( '%s wants to access your site’s data. Log in to authorize that access.', 'jetpack' ),
5610 - '<strong>' . esc_html( $this->json_api_authorization_request['client_title'] ) . '</strong>'
5611 - ) . '<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();
5612 5438 }
5613 5439
5614 5440 /**
5615 5441 * Get $content_width, but with a <s>twist</s> filter.
@@ -5653,32 +5479,23 @@
5653 5479
5654 5480 /**
5655 5481 * Checks if the site is currently in an identity crisis.
5656 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 + *
5657 5489 * @return array|bool Array of options that are in a crisis, or false if everything is OK.
5658 5490 */
5659 5491 public static function check_identity_crisis() {
5660 - if ( ! self::is_connection_ready() || ( new Status() )->is_offline_mode() || ! Identity_Crisis::validate_sync_error_idc_option() ) {
5661 - return false;
5662 - }
5492 + _deprecated_function( __METHOD__, 'jetpack-16.2', 'Automattic\\Jetpack\\Identity_Crisis::check_identity_crisis' );
5663 5493
5664 - return Jetpack_Options::get_option( 'sync_error_idc' );
5494 + return Identity_Crisis::check_identity_crisis();
5665 5495 }
5666 5496
5667 5497 /**
5668 - * Checks whether the sync_error_idc option is valid or not, and if not, will do cleanup.
5669 - *
5670 - * @since 4.4.0
5671 - * @since 5.4.0 Do not call get_sync_error_idc_option() unless site is in IDC
5672 - *
5673 - * @return bool
5674 - */
5675 - public static function validate_sync_error_idc_option() {
5676 - _deprecated_function( __METHOD__, 'jetpack-9.8', '\\Automattic\\Jetpack\\Identity_Crisis::validate_sync_error_idc_option' );
5677 - return Identity_Crisis::validate_sync_error_idc_option();
5678 - }
5679 -
5680 - /**
5681 5498 * Normalizes a url by doing three things:
5682 5499 * - Strips protocol
5683 5500 * - Strips www
5684 5501 * - Adds a trailing slash
@@ -5699,35 +5516,8 @@
5699 5516 return $url;
5700 5517 }
5701 5518
5702 5519 /**
5703 - * Gets the value that is to be saved in the jetpack_sync_error_idc option.
5704 - *
5705 - * @since 4.4.0
5706 - * @since 5.4.0 Add transient since home/siteurl retrieved directly from DB
5707 - * @deprecated 9.8.0 Use \\Automattic\\Jetpack\\Identity_Crisis::get_sync_error_idc_option
5708 - *
5709 - * @param array $response HTTP response.
5710 - * @return array Array of the local urls, wpcom urls, and error code
5711 - */
5712 - public static function get_sync_error_idc_option( $response = array() ) {
5713 - _deprecated_function( __METHOD__, 'jetpack-9.8', '\\Automattic\\Jetpack\\Identity_Crisis::get_sync_error_idc_option' );
5714 - return Identity_Crisis::get_sync_error_idc_option( $response );
5715 - }
5716 -
5717 - /**
5718 - * Returns the value of the jetpack_sync_idc_optin filter, or constant.
5719 - * If set to true, the site will be put into staging mode.
5720 - *
5721 - * @since 4.3.2
5722 - * @return bool
5723 - */
5724 - public static function sync_idc_optin() {
5725 - _deprecated_function( __METHOD__, 'jetpack-9.8', '\\Automattic\\Jetpack\\Identity_Crisis::sync_idc_optin' );
5726 - return Identity_Crisis::sync_idc_optin();
5727 - }
5728 -
5729 - /**
5730 5520 * Maybe Use a .min.css stylesheet, maybe not.
5731 5521 *
5732 5522 * Hooks onto `plugins_url` filter at priority 1, and accepts all 3 args.
5733 5523 *
@@ -5748,9 +5538,9 @@
5748 5538 // Strip out the abspath.
5749 5539 $base = dirname( plugin_basename( $plugin ) );
5750 5540
5751 5541 // Short out on non-Jetpack assets.
5752 - if ( 'jetpack/' !== substr( $base, 0, 8 ) ) {
5542 + if ( ! str_starts_with( $base, 'jetpack/' ) ) {
5753 5543 return $url;
5754 5544 }
5755 5545
5756 5546 // File name parsing.
@@ -5790,15 +5580,15 @@
5790 5580 *
5791 5581 * @return mixed
5792 5582 */
5793 5583 public static function set_suffix_on_min( $src, $handle ) {
5794 - if ( false === strpos( $src, '.min.css' ) ) {
5584 + if ( ! is_string( $src ) || ! str_contains( $src, '.min.css' ) ) {
5795 5585 return $src;
5796 5586 }
5797 5587
5798 5588 if ( ! empty( self::$min_assets ) ) {
5799 5589 foreach ( self::$min_assets as $file => $path ) {
5800 - if ( false !== strpos( $src, $file ) ) {
5590 + if ( str_contains( $src, $file ) ) {
5801 5591 wp_style_add_data( $handle, 'suffix', '.min' );
5802 5592 return $src;
5803 5593 }
5804 5594 }
@@ -5828,8 +5618,10 @@
5828 5618 *
5829 5619 * Data passed in with the $data parameter will be available in the
5830 5620 * template file as $data['value']
5831 5621 *
5622 + * @html-template-var array $data
5623 + *
5832 5624 * @param string $template - Template file to load.
5833 5625 * @param array $data - Any data to pass along to the template.
5834 5626 * @return boolean - If template file was found.
5835 5627 **/
@@ -5847,8 +5639,19 @@
5847 5639 return false;
5848 5640 }
5849 5641
5850 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 + /**
5851 5654 * Throws warnings for deprecated hooks to be removed from Jetpack that cannot remain in the original place in the code.
5852 5655 */
5853 5656 public function deprecated_hooks() {
5854 5657 $filter_deprecated_list = array(
@@ -5975,13 +5778,8 @@
5975 5778 'jetpack_cache_plans' => array(
5976 5779 'replacement' => null,
5977 5780 'version' => 'jetpack-6.1.0',
5978 5781 ),
5979 -
5980 - 'jetpack_lazy_images_skip_image_with_atttributes' => array(
5981 - 'replacement' => 'jetpack_lazy_images_skip_image_with_attributes',
5982 - 'version' => 'jetpack-6.5.0',
5983 - ),
5984 5782 'jetpack_enable_site_verification' => array(
5985 5783 'replacement' => null,
5986 5784 'version' => 'jetpack-6.5.0',
5987 5785 ),
@@ -6069,8 +5867,18 @@
6069 5867 'jetpack_subscriptions_modal_enabled' => array(
6070 5868 'replacement' => null,
6071 5869 'version' => 'jetpack-12.7.0',
6072 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.
6073 5881 );
6074 5882
6075 5883 foreach ( $filter_deprecated_list as $tag => $args ) {
6076 5884 if ( has_filter( $tag ) ) {
@@ -6173,9 +5981,9 @@
6173 5981 foreach ( $matches as $match ) {
6174 5982 $url = trim( $match['path'], "'\" \t" );
6175 5983
6176 5984 // If this is a data url, we don't want to mess with it.
6177 - if ( 'data:' === substr( $url, 0, 5 ) ) {
5985 + if ( str_starts_with( $url, 'data:' ) ) {
6178 5986 continue;
6179 5987 }
6180 5988
6181 5989 // If this is an absolute or protocol-agnostic url,
@@ -6201,113 +6009,8 @@
6201 6009 return $css;
6202 6010 }
6203 6011
6204 6012 /**
6205 - * This methods removes all of the registered css files on the front end
6206 - * from Jetpack in favor of using a single file. In effect "imploding"
6207 - * all the files into one file.
6208 - *
6209 - * Pros:
6210 - * - Uses only ONE css asset connection instead of 15
6211 - * - Saves a minimum of 56k
6212 - * - Reduces server load
6213 - * - Reduces time to first painted byte
6214 - *
6215 - * Cons:
6216 - * - Loads css for ALL modules. However all selectors are prefixed so it
6217 - * should not cause any issues with themes.
6218 - * - Plugins/themes dequeuing styles no longer do anything. See
6219 - * jetpack_implode_frontend_css filter for a workaround
6220 - *
6221 - * For some situations developers may wish to disable css imploding and
6222 - * instead operate in legacy mode where each file loads seperately and
6223 - * can be edited individually or dequeued. This can be accomplished with
6224 - * the following line:
6225 - *
6226 - * add_filter( 'jetpack_implode_frontend_css', '__return_false' );
6227 - *
6228 - * @param bool $travis_test Is this a test run.
6229 - *
6230 - * @since 3.2
6231 - */
6232 - public function implode_frontend_css( $travis_test = false ) {
6233 - $do_implode = true;
6234 - if ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) {
6235 - $do_implode = false;
6236 - }
6237 -
6238 - // Do not implode CSS when the page loads via the AMP plugin.
6239 - if ( class_exists( Jetpack_AMP_Support::class ) && Jetpack_AMP_Support::is_amp_request() ) {
6240 - $do_implode = false;
6241 - }
6242 -
6243 - /**
6244 - * Allow CSS to be concatenated into a single jetpack.css file.
6245 - *
6246 - * @since 3.2.0
6247 - *
6248 - * @param bool $do_implode Should CSS be concatenated? Default to true.
6249 - */
6250 - $do_implode = apply_filters( 'jetpack_implode_frontend_css', $do_implode );
6251 -
6252 - // Do not use the imploded file when default behavior was altered through the filter.
6253 - if ( ! $do_implode ) {
6254 - return;
6255 - }
6256 -
6257 - // We do not want to use the imploded file in dev mode, or if not connected.
6258 - if ( ( new Status() )->is_offline_mode() || ! self::is_connection_ready() ) {
6259 - if ( ! $travis_test ) {
6260 - return;
6261 - }
6262 - }
6263 -
6264 - // Do not use the imploded file if sharing css was dequeued via the sharing settings screen.
6265 - if ( get_option( 'sharedaddy_disable_resources' ) ) {
6266 - return;
6267 - }
6268 -
6269 - /*
6270 - * Now we assume Jetpack is connected and able to serve the single
6271 - * file.
6272 - *
6273 - * In the future there will be a check here to serve the file locally
6274 - * or potentially from the Jetpack CDN
6275 - *
6276 - * For now:
6277 - * - Enqueue a single imploded css file
6278 - * - Zero out the style_loader_tag for the bundled ones
6279 - * - Be happy, drink scotch
6280 - */
6281 -
6282 - add_filter( 'style_loader_tag', array( $this, 'concat_remove_style_loader_tag' ), 10, 2 );
6283 -
6284 - $version = self::is_development_version() ? filemtime( JETPACK__PLUGIN_DIR . 'css/jetpack.css' ) : JETPACK__VERSION;
6285 -
6286 - wp_enqueue_style( 'jetpack_css', plugins_url( 'css/jetpack.css', __FILE__ ), array(), $version );
6287 - wp_style_add_data( 'jetpack_css', 'rtl', 'replace' );
6288 - }
6289 -
6290 - /**
6291 - * Removes styles that are part of concatenated group.
6292 - *
6293 - * @param string $tag Style tag.
6294 - * @param string $handle Style handle.
6295 - *
6296 - * @return string
6297 - */
6298 - public function concat_remove_style_loader_tag( $tag, $handle ) {
6299 - if ( in_array( $handle, $this->concatenated_style_handles, true ) ) {
6300 - $tag = '';
6301 - if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
6302 - $tag = '<!-- `' . esc_html( $handle ) . "` is included in the concatenated jetpack.css -->\r\n";
6303 - }
6304 - }
6305 -
6306 - return $tag;
6307 - }
6308 -
6309 - /**
6310 6013 * Check the heartbeat data
6311 6014 *
6312 6015 * Organizes the heartbeat data by severity. For example, if the site
6313 6016 * is in an ID crisis, it will be in the $filtered_data['bad'] array.
@@ -6319,9 +6022,23 @@
6319 6022 *
6320 6023 * $return array $filtered_data
6321 6024 */
6322 6025 public static function jetpack_check_heartbeat_data() {
6323 - $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 + );
6324 6041
6325 6042 $good = array();
6326 6043 $caution = array();
6327 6044 $bad = array();
@@ -6387,23 +6104,8 @@
6387 6104 return Jetpack_Options::get_options_for_reset();
6388 6105 }
6389 6106
6390 6107 /**
6391 - * Strip http:// or https:// from a url, replaces forward slash with ::,
6392 - * so we can bring them directly to their site in calypso.
6393 - *
6394 - * @deprecated 9.2.0 Use Automattic\Jetpack\Status::get_site_suffix
6395 - *
6396 - * @param string $url URL.
6397 - * @return string url without the guff.
6398 - */
6399 - public static function build_raw_urls( $url ) {
6400 - _deprecated_function( __METHOD__, 'jetpack-9.2.0', 'Automattic\Jetpack\Status::get_site_suffix' );
6401 -
6402 - return ( new Status() )->get_site_suffix( $url );
6403 - }
6404 -
6405 - /**
6406 6108 * Get the user's meta box order.
6407 6109 *
6408 6110 * @param array $sorted Value for the user's option.
6409 6111 * @return mixed
@@ -6413,9 +6115,9 @@
6413 6115 return $sorted;
6414 6116 }
6415 6117
6416 6118 foreach ( $sorted as $box_context => $ids ) {
6417 - if ( false === strpos( $ids, 'dashboard_stats' ) ) {
6119 + if ( ! str_contains( $ids, 'dashboard_stats' ) ) {
6418 6120 // If the old id isn't anywhere in the ids, don't bother exploding and fail out.
6419 6121 continue;
6420 6122 }
6421 6123
@@ -6432,68 +6134,9 @@
6432 6134 }
6433 6135
6434 6136 return $sorted;
6435 6137 }
6436 -
6437 6138 /**
6438 - * Adds a "blank" column in the user admin table to display indication of user connection.
6439 - *
6440 - * @param array $columns User list table columns.
6441 - *
6442 - * @return array
6443 - */
6444 - public function jetpack_icon_user_connected( $columns ) {
6445 - $columns['user_jetpack'] = '';
6446 - return $columns;
6447 - }
6448 -
6449 - /**
6450 - * Show Jetpack icon if the user is linked.
6451 - *
6452 - * @param string $val HTML for the icon.
6453 - * @param string $col User list table column.
6454 - * @param int $user_id User ID.
6455 - *
6456 - * @return string
6457 - */
6458 - public function jetpack_show_user_connected_icon( $val, $col, $user_id ) {
6459 - if ( 'user_jetpack' === $col && self::connection()->is_user_connected( $user_id ) ) {
6460 - $jetpack_logo = new Jetpack_Logo();
6461 - $emblem_html = sprintf(
6462 - '<a title="%1$s" class="jp-emblem-user-admin">%2$s</a>',
6463 - esc_attr__( 'This user is linked and ready to fly with Jetpack.', 'jetpack' ),
6464 - $jetpack_logo->get_jp_emblem()
6465 - );
6466 - return $emblem_html;
6467 - }
6468 -
6469 - return $val;
6470 - }
6471 -
6472 - /**
6473 - * Style the Jetpack user column
6474 - */
6475 - public function jetpack_user_col_style() {
6476 - global $current_screen;
6477 - if ( ! empty( $current_screen->base ) && 'users' === $current_screen->base ) {
6478 - ?>
6479 - <style>
6480 - .fixed .column-user_jetpack {
6481 - width: 21px;
6482 - }
6483 - .jp-emblem-user-admin svg {
6484 - width: 20px;
6485 - height: 20px;
6486 - }
6487 - .jp-emblem-user-admin path {
6488 - fill: #069e08;
6489 - }
6490 - </style>
6491 - <?php
6492 - }
6493 - }
6494 -
6495 - /**
6496 6139 * Checks if Akismet is active and working.
6497 6140 *
6498 6141 * We dropped support for Akismet 3.0 with Jetpack 6.1.1 while introducing a check for an Akismet valid key
6499 6142 * that implied usage of methods present since more recent version.
@@ -6654,13 +6297,20 @@
6654 6297 }
6655 6298 }
6656 6299
6657 6300 /**
6658 - * Returns a boolean for whether backups UI should be displayed or not.
6301 + * Whether UI for backups should be displayed.
6659 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 + *
6660 6306 * @return bool Should backups UI be displayed?
6661 6307 */
6662 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 +
6663 6313 /**
6664 6314 * Whether UI for backups should be displayed.
6665 6315 *
6666 6316 * @since 6.5.0
@@ -6670,8 +6320,24 @@
6670 6320 return self::is_plugin_active( 'vaultpress/vaultpress.php' ) || apply_filters( 'jetpack_show_backups', true );
6671 6321 }
6672 6322
6673 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 + /**
6674 6340 * Clean leftoveruser meta.
6675 6341 *
6676 6342 * Delete Jetpack-related user meta when it is no longer needed.
6677 6343 *
@@ -6743,8 +6409,40 @@
6743 6409 'url' => Redirect::get_url( 'jetpack-faq-backup-disclaimer' ),
6744 6410 ),
6745 6411 );
6746 6412
6413 + $products['creator'] = array(
6414 + 'title' => __( 'Jetpack Creator', 'jetpack' ),
6415 + 'slug' => 'jetpack_creator_yearly',
6416 + 'description' => __( 'Craft stunning content, boost your subscriber base, and monetize your online presence.', 'jetpack' ),
6417 + 'show_promotion' => true,
6418 + 'discount_percent' => 50,
6419 + 'included_in_plans' => array( 'complete' ),
6420 + 'features' => array(
6421 + _x( 'Unlimited subscriber imports', 'Creator Product Feature', 'jetpack' ),
6422 + _x( 'Earn more from your content', 'Creator Product Feature', 'jetpack' ),
6423 + _x( 'Accept payments with PayPal', 'Creator Product Feature', 'jetpack' ),
6424 + _x( 'Increase earnings with WordAds', 'Creator Product Feature', 'jetpack' ),
6425 + ),
6426 + );
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 +
6747 6445 $products['scan'] = array(
6748 6446 'title' => __( 'Jetpack Scan', 'jetpack' ),
6749 6447 'slug' => 'jetpack_scan',
6750 6448 'description' => __( 'Automatic scanning and one-click fixes keep your site one step ahead of security threats and malware.', 'jetpack' ),
@@ -6868,6 +6566,108 @@
6868 6566 return false;
6869 6567 }
6870 6568
6871 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 + }
6872 6672 }
6873 6673 }