Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
39.50% covered (danger)
39.50%
937 / 2372
28.89% covered (danger)
28.89%
52 / 180
CRAP
0.00% covered (danger)
0.00%
0 / 1
Jetpack
39.55% covered (danger)
39.55%
937 / 2369
28.89% covered (danger)
28.89%
52 / 180
146080.88
0.00% covered (danger)
0.00%
0 / 1
 init
40.00% covered (danger)
40.00%
2 / 5
0.00% covered (danger)
0.00%
0 / 1
2.86
 plugin_upgrade
0.00% covered (danger)
0.00%
0 / 49
0.00% covered (danger)
0.00%
0 / 1
380
 upgrade_on_load
0.00% covered (danger)
0.00%
0 / 10
0.00% covered (danger)
0.00%
0 / 1
20
 update_active_modules
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 delete_active_modules
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 add_configure_hook
0.00% covered (danger)
0.00%
0 / 10
0.00% covered (danger)
0.00%
0 / 1
12
 __construct
0.00% covered (danger)
0.00%
0 / 68
0.00% covered (danger)
0.00%
0 / 1
12
 should_eager_load_packages
100.00% covered (success)
100.00%
3 / 3
100.00% covered (success)
100.00%
1 / 1
5
 configure_import_package
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
3
 get_module_deactivation_note
100.00% covered (success)
100.00%
3 / 3
100.00% covered (success)
100.00%
1 / 1
2
 offers_backup_dashboard
50.00% covered (danger)
50.00%
3 / 6
0.00% covered (danger)
0.00%
0 / 1
10.50
 configure_backup_package
83.33% covered (warning)
83.33%
5 / 6
0.00% covered (danger)
0.00%
0 / 1
4.07
 is_premium_analytics_enabled
66.67% covered (warning)
66.67%
12 / 18
0.00% covered (danger)
0.00%
0 / 1
8.81
 register_premium_analytics_enablement_setting
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
2
 configure
91.95% covered (success)
91.95%
80 / 87
0.00% covered (danger)
0.00%
0 / 1
23.28
 late_initialization
96.15% covered (success)
96.15%
25 / 26
0.00% covered (danger)
0.00%
0 / 1
4
 add_wpcom_to_allowed_redirect_hosts
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 allow_wpcom_domain
0.00% covered (danger)
0.00%
0 / 4
0.00% covered (danger)
0.00%
0 / 1
6
 point_edit_post_links_to_calypso
n/a
0 / 0
n/a
0 / 0
3
 point_edit_comment_links_to_calypso
n/a
0 / 0
n/a
0 / 0
1
 filter_sync_callable_whitelist
100.00% covered (success)
100.00%
7 / 7
100.00% covered (success)
100.00%
1 / 1
1
 filter_sync_multisite_callable_whitelist
100.00% covered (success)
100.00%
10 / 10
100.00% covered (success)
100.00%
1 / 1
1
 push_stats
0.00% covered (danger)
0.00%
0 / 2
0.00% covered (danger)
0.00%
0 / 1
6
 jetpack_custom_caps
76.19% covered (warning)
76.19%
16 / 21
0.00% covered (danger)
0.00%
0 / 1
7.66
 register_assets
97.44% covered (success)
97.44%
38 / 39
0.00% covered (danger)
0.00%
0 / 1
5
 guess_locale_from_lang
12.50% covered (danger)
12.50%
2 / 16
0.00% covered (danger)
0.00%
0 / 1
108.47
 get_locale
75.00% covered (warning)
75.00%
3 / 4
0.00% covered (danger)
0.00%
0 / 1
2.06
 jetpack_main_network_site_option
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 network_name
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 network_allow_new_registrations
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
2
 network_add_new_users
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 network_site_upload_space
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
2
 network_upload_file_types
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 network_max_upload_file_size
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 network_enable_administration_menus
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 maybe_clear_other_linked_admins_transient
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
5
 get_other_linked_admins
93.33% covered (success)
93.33%
14 / 15
0.00% covered (danger)
0.00%
0 / 1
7.01
 is_main_network_option
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 is_multisite
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 is_multi_network
83.33% covered (warning)
83.33%
5 / 6
0.00% covered (danger)
0.00%
0 / 1
3.04
 is_single_user_site
100.00% covered (success)
100.00%
5 / 5
100.00% covered (success)
100.00%
1 / 1
2
 file_system_write_access
0.00% covered (danger)
0.00%
0 / 12
0.00% covered (danger)
0.00%
0 / 1
20
 get_updates
66.67% covered (warning)
66.67%
6 / 9
0.00% covered (danger)
0.00%
0 / 1
5.93
 get_update_details
0.00% covered (danger)
0.00%
0 / 6
0.00% covered (danger)
0.00%
0 / 1
2
 is_active
n/a
0 / 0
n/a
0 / 0
1
 is_connection_ready
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 development_mode_trigger_text
0.00% covered (danger)
0.00%
0 / 13
0.00% covered (danger)
0.00%
0 / 1
72
 show_development_mode_notice
0.00% covered (danger)
0.00%
0 / 10
0.00% covered (danger)
0.00%
0 / 1
12
 is_development_version
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
1
 get_connected_user_email
0.00% covered (danger)
0.00%
0 / 11
0.00% covered (danger)
0.00%
0 / 1
12
 get_master_user_email
0.00% covered (danger)
0.00%
0 / 4
0.00% covered (danger)
0.00%
0 / 1
6
 current_user_ip
n/a
0 / 0
n/a
0 / 0
1
 load_modules
64.44% covered (warning)
64.44%
29 / 45
0.00% covered (danger)
0.00%
0 / 1
40.82
 check_rest_api_compat
0.00% covered (danger)
0.00%
0 / 3
0.00% covered (danger)
0.00%
0 / 1
6
 get_active_plugins
66.67% covered (warning)
66.67%
2 / 3
0.00% covered (danger)
0.00%
0 / 1
2.15
 get_parsed_plugin_data
0.00% covered (danger)
0.00%
0 / 14
0.00% covered (danger)
0.00%
0 / 1
12
 get_parsed_theme_data
0.00% covered (danger)
0.00%
0 / 15
0.00% covered (danger)
0.00%
0 / 1
12
 is_plugin_active
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 check_open_graph
0.00% covered (danger)
0.00%
0 / 11
0.00% covered (danger)
0.00%
0 / 1
56
 check_twitter_tags
0.00% covered (danger)
0.00%
0 / 8
0.00% covered (danger)
0.00%
0 / 1
30
 get_option_names
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 get_option
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 glob_php
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 activate_new_modules
0.00% covered (danger)
0.00%
0 / 38
0.00% covered (danger)
0.00%
0 / 1
132
 get_available_modules
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 get_default_modules
93.75% covered (success)
93.75%
15 / 16
0.00% covered (danger)
0.00%
0 / 1
8.02
 handle_deprecated_modules
66.67% covered (warning)
66.67%
12 / 18
0.00% covered (danger)
0.00%
0 / 1
10.37
 filter_default_modules
53.85% covered (warning)
53.85%
7 / 13
0.00% covered (danger)
0.00%
0 / 1
14.29
 get_module_slug
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 get_module_path
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 get_module
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 get_file_data
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 translate_module_tag
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 get_translated_modules
100.00% covered (success)
100.00%
12 / 12
100.00% covered (success)
100.00%
1 / 1
7
 get_active_modules
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 is_module_active
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 is_module
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 catch_errors
n/a
0 / 0
n/a
0 / 0
1
 catch_errors_on_shutdown
n/a
0 / 0
n/a
0 / 0
1
 alias_directories
0.00% covered (danger)
0.00%
0 / 3
0.00% covered (danger)
0.00%
0 / 1
2
 activate_default_modules
40.96% covered (danger)
40.96%
34 / 83
0.00% covered (danger)
0.00%
0 / 1
318.68
 activate_module
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 deactivate_module
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 enable_module_configurable
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
1
 module_configuration_url
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
1
 bail_on_activation
0.00% covered (danger)
0.00%
0 / 16
0.00% covered (danger)
0.00%
0 / 1
30
 plugin_activation
85.71% covered (warning)
85.71%
12 / 14
0.00% covered (danger)
0.00%
0 / 1
7.14
 get_activation_source
93.55% covered (success)
93.55%
29 / 31
0.00% covered (danger)
0.00%
0 / 1
13.05
 do_version_bump
n/a
0 / 0
n/a
0 / 0
1
 activate_subscriptions_module_for_existing_sites
77.78% covered (warning)
77.78%
7 / 9
0.00% covered (danger)
0.00%
0 / 1
6.40
 register_upgrade_init_hooks
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
1
 reconcile_ai_master_optout
100.00% covered (success)
100.00%
8 / 8
100.00% covered (success)
100.00%
1 / 1
5
 cleanup_seo_module_state_options
100.00% covered (success)
100.00%
3 / 3
100.00% covered (success)
100.00%
1 / 1
1
 seed_seo_visibility_cohort
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
1
 set_update_modal_display
n/a
0 / 0
n/a
0 / 0
1
 enqueue_block_style
n/a
0 / 0
n/a
0 / 0
2
 plugin_initialize
90.91% covered (success)
90.91%
10 / 11
0.00% covered (danger)
0.00%
0 / 1
4.01
 handle_default_module_activation
88.24% covered (warning)
88.24%
15 / 17
0.00% covered (danger)
0.00%
0 / 1
5.04
 plugin_deactivation
90.00% covered (success)
90.00%
9 / 10
0.00% covered (danger)
0.00%
0 / 1
4.02
 on_idc_disconnect
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 disconnect
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
1
 jetpack_site_disconnected
100.00% covered (success)
100.00%
6 / 6
100.00% covered (success)
100.00%
1 / 1
2
 disconnect_user
n/a
0 / 0
n/a
0 / 0
1
 registration_check_domains
0.00% covered (danger)
0.00%
0 / 12
0.00% covered (danger)
0.00%
0 / 1
20
 log
0.00% covered (danger)
0.00%
0 / 16
0.00% covered (danger)
0.00%
0 / 1
20
 get_log
0.00% covered (danger)
0.00%
0 / 17
0.00% covered (danger)
0.00%
0 / 1
132
 log_settings_change
0.00% covered (danger)
0.00%
0 / 3
0.00% covered (danger)
0.00%
0 / 1
6
 get_stat_data
n/a
0 / 0
n/a
0 / 0
4
 get_additional_stat_data
0.00% covered (danger)
0.00%
0 / 8
0.00% covered (danger)
0.00%
0 / 1
6
 get_site_user_count
0.00% covered (danger)
0.00%
0 / 8
0.00% covered (danger)
0.00%
0 / 1
20
 admin_init
0.00% covered (danger)
0.00%
0 / 21
0.00% covered (danger)
0.00%
0 / 1
240
 admin_body_class
0.00% covered (danger)
0.00%
0 / 4
0.00% covered (danger)
0.00%
0 / 1
6
 add_jetpack_pagestyles
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 throw_error_on_activate_plugin
0.00% covered (danger)
0.00%
0 / 11
0.00% covered (danger)
0.00%
0 / 1
56
 plugins_page_init_jetpack_state
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 intercept_plugin_error_scrape_init
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 intercept_plugin_error_scrape
0.00% covered (danger)
0.00%
0 / 6
0.00% covered (danger)
0.00%
0 / 1
30
 add_remote_request_handlers
15.38% covered (danger)
15.38%
2 / 13
0.00% covered (danger)
0.00%
0 / 1
36.69
 remote_request_handlers
0.00% covered (danger)
0.00%
0 / 22
0.00% covered (danger)
0.00%
0 / 1
72
 upload_handler
0.00% covered (danger)
0.00%
0 / 93
0.00% covered (danger)
0.00%
0 / 1
870
 plugin_action_links
0.00% covered (danger)
0.00%
0 / 6
0.00% covered (danger)
0.00%
0 / 1
20
 deactivate_dialog
0.00% covered (danger)
0.00%
0 / 15
0.00% covered (danger)
0.00%
0 / 1
12
 jetpack_plugin_portal_containers
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 login_url
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
2
 login_init
91.67% covered (success)
91.67%
11 / 12
0.00% covered (danger)
0.00%
0 / 1
2.00
 get_registration_error_description
0.00% covered (danger)
0.00%
0 / 5
0.00% covered (danger)
0.00%
0 / 1
20
 admin_page_load
0.00% covered (danger)
0.00%
0 / 144
0.00% covered (danger)
0.00%
0 / 1
2162
 admin_notices
0.00% covered (danger)
0.00%
0 / 106
0.00% covered (danger)
0.00%
0 / 1
56
 initialize_stats
50.00% covered (danger)
50.00%
1 / 2
0.00% covered (danger)
0.00%
0 / 1
2.50
 stat
100.00% covered (success)
100.00%
3 / 3
100.00% covered (success)
100.00%
1 / 1
1
 do_stats
80.00% covered (warning)
80.00%
4 / 5
0.00% covered (danger)
0.00%
0 / 1
2.03
 do_server_side_stat
0.00% covered (danger)
0.00%
0 / 3
0.00% covered (danger)
0.00%
0 / 1
2
 build_stats_url
0.00% covered (danger)
0.00%
0 / 2
0.00% covered (danger)
0.00%
0 / 1
2
 build_connect_url
68.97% covered (warning)
68.97%
20 / 29
0.00% covered (danger)
0.00%
0 / 1
16.30
 build_authorize_url
n/a
0 / 0
n/a
0 / 0
1
 filter_connect_request_body
n/a
0 / 0
n/a
0 / 0
1
 filter_jetpack_current_user_connection_data
94.74% covered (success)
94.74%
18 / 19
0.00% covered (danger)
0.00%
0 / 1
6.01
 filter_connect_redirect_url
n/a
0 / 0
n/a
0 / 0
1
 authorize_starting
0.00% covered (danger)
0.00%
0 / 13
0.00% covered (danger)
0.00%
0 / 1
6
 handle_unique_registrations_stats
100.00% covered (success)
100.00%
7 / 7
100.00% covered (success)
100.00%
1 / 1
2
 authorize_ending_linked
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 authorize_ending_authorized
0.00% covered (danger)
0.00%
0 / 9
0.00% covered (danger)
0.00%
0 / 1
12
 activate_default_modules_on_site_register
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
1
 reconnection_completed
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 apply_activation_source_to_args
0.00% covered (danger)
0.00%
0 / 5
0.00% covered (danger)
0.00%
0 / 1
12
 build_reconnect_url
0.00% covered (danger)
0.00%
0 / 2
0.00% covered (danger)
0.00%
0 / 1
6
 admin_url
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 nonce_url_no_esc
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
1
 dismiss_jetpack_notice
0.00% covered (danger)
0.00%
0 / 9
0.00% covered (danger)
0.00%
0 / 1
30
 sort_modules
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 ajax_recheck_ssl
0.00% covered (danger)
0.00%
0 / 10
0.00% covered (danger)
0.00%
0 / 1
2
 verify_onboarding_token
n/a
0 / 0
n/a
0 / 0
15
 create_onboarding_token
n/a
0 / 0
n/a
0 / 0
2
 invalidate_onboarding_token
n/a
0 / 0
n/a
0 / 0
1
 validate_onboarding_token_action
n/a
0 / 0
n/a
0 / 0
3
 permit_ssl
0.00% covered (danger)
0.00%
0 / 3
0.00% covered (danger)
0.00%
0 / 1
6
 get_ssl_test_message
0.00% covered (danger)
0.00%
0 / 9
0.00% covered (danger)
0.00%
0 / 1
30
 alert_auto_ssl_fail
0.00% covered (danger)
0.00%
0 / 28
0.00% covered (danger)
0.00%
0 / 1
6
 connection
75.00% covered (warning)
75.00%
3 / 4
0.00% covered (danger)
0.00%
0 / 1
2.06
 get_secrets
0.00% covered (danger)
0.00%
0 / 6
0.00% covered (danger)
0.00%
0 / 1
12
 filter_token_request_body
0.00% covered (danger)
0.00%
0 / 9
0.00% covered (danger)
0.00%
0 / 1
2
 maybe_set_version_option
0.00% covered (danger)
0.00%
0 / 7
0.00% covered (danger)
0.00%
0 / 1
12
 state
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 restate
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 should_set_cookie
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 check_privacy
0.00% covered (danger)
0.00%
0 / 18
0.00% covered (danger)
0.00%
0 / 1
42
 login_form_json_api_authorization
0.00% covered (danger)
0.00%
0 / 6
0.00% covered (danger)
0.00%
0 / 1
2
 post_login_form_to_signed_url
0.00% covered (danger)
0.00%
0 / 9
0.00% covered (danger)
0.00%
0 / 1
42
 preserve_action_in_login_form_for_json_api_authorization
0.00% covered (danger)
0.00%
0 / 4
0.00% covered (danger)
0.00%
0 / 1
12
 store_json_api_authorization_token
n/a
0 / 0
n/a
0 / 0
1
 allow_wpcom_public_api_domain
n/a
0 / 0
n/a
0 / 0
1
 is_redirect_encoded
n/a
0 / 0
n/a
0 / 0
1
 allow_wpcom_environments
n/a
0 / 0
n/a
0 / 0
1
 add_token_to_login_redirect_json_api_authorization
n/a
0 / 0
n/a
0 / 0
1
 verify_json_api_authorization_request
n/a
0 / 0
n/a
0 / 0
1
 login_message_json_api_authorization
n/a
0 / 0
n/a
0 / 0
1
 get_content_width
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
3
 get_cloud_site_options
0.00% covered (danger)
0.00%
0 / 10
0.00% covered (danger)
0.00%
0 / 1
6
 check_identity_crisis
n/a
0 / 0
n/a
0 / 0
1
 normalize_url_protocol_agnostic
80.00% covered (warning)
80.00%
4 / 5
0.00% covered (danger)
0.00%
0 / 1
4.13
 maybe_min_asset
28.57% covered (danger)
28.57%
6 / 21
0.00% covered (danger)
0.00%
0 / 1
31.32
 set_suffix_on_min
50.00% covered (danger)
50.00%
4 / 8
0.00% covered (danger)
0.00%
0 / 1
10.50
 maybe_inline_style
n/a
0 / 0
n/a
0 / 0
1
 load_view
0.00% covered (danger)
0.00%
0 / 7
0.00% covered (danger)
0.00%
0 / 1
20
 register_jetpack_connection_tests
100.00% covered (success)
100.00%
3 / 3
100.00% covered (success)
100.00%
1 / 1
1
 deprecated_hooks
100.00% covered (success)
100.00%
284 / 284
100.00% covered (success)
100.00%
1 / 1
5
 absolutize_css_urls
100.00% covered (success)
100.00%
28 / 28
100.00% covered (success)
100.00%
1 / 1
10
 jetpack_check_heartbeat_data
0.00% covered (danger)
0.00%
0 / 35
0.00% covered (danger)
0.00%
0 / 1
156
 get_jetpack_options_for_reset
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 get_user_option_meta_box_order_dashboard
0.00% covered (danger)
0.00%
0 / 12
0.00% covered (danger)
0.00%
0 / 1
30
 is_akismet_active
0.00% covered (danger)
0.00%
0 / 17
0.00% covered (danger)
0.00%
0 / 1
90
 get_file_url_for_environment
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 is_rewind_enabled
0.00% covered (danger)
0.00%
0 / 14
0.00% covered (danger)
0.00%
0 / 1
110
 get_calypso_env
n/a
0 / 0
n/a
0 / 0
1
 get_calypso_host
100.00% covered (success)
100.00%
8 / 8
100.00% covered (success)
100.00%
1 / 1
5
 handle_post_authorization_actions
58.33% covered (warning)
58.33%
7 / 12
0.00% covered (danger)
0.00%
0 / 1
5.16
 show_backups_ui
0.00% covered (danger)
0.00%
0 / 3
0.00% covered (danger)
0.00%
0 / 1
20
 show_scan_ui
0.00% covered (danger)
0.00%
0 / 3
0.00% covered (danger)
0.00%
0 / 1
12
 user_meta_cleanup
88.89% covered (warning)
88.89%
8 / 9
0.00% covered (danger)
0.00%
0 / 1
3.01
 is_active_and_not_offline_mode
66.67% covered (warning)
66.67%
2 / 3
0.00% covered (danger)
0.00%
0 / 1
3.33
 get_products_for_purchase
0.00% covered (danger)
0.00%
0 / 134
0.00% covered (danger)
0.00%
0 / 1
6
 get_partner_coupon_product_descriptions
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 current_user_can_purchase
0.00% covered (danger)
0.00%
0 / 5
0.00% covered (danger)
0.00%
0 / 1
12
 add_5_star_review_link
0.00% covered (danger)
0.00%
0 / 8
0.00% covered (danger)
0.00%
0 / 1
6
 initialize_tracking
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
4
 run_initialize_tracking_action
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 maybe_initialize_rest_jsonapi
0.00% covered (danger)
0.00%
0 / 4
0.00% covered (danger)
0.00%
0 / 1
20
 plugin_post_activation
0.00% covered (danger)
0.00%
0 / 14
0.00% covered (danger)
0.00%
0 / 1
56
1<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
2/**
3 * The mega-class.
4 *
5 * This contains too much, so please think twice before adding more.
6 *
7 * @package automattic/jetpack
8 */
9
10use Automattic\Jetpack\Assets;
11use Automattic\Jetpack\Boost_Speed_Score\Speed_Score;
12use Automattic\Jetpack\Config;
13use Automattic\Jetpack\Connection\Authorize_Json_Api;
14use Automattic\Jetpack\Connection\Client;
15use Automattic\Jetpack\Connection\Manager as Connection_Manager;
16use Automattic\Jetpack\Connection\Rest_Authentication as Connection_Rest_Authentication;
17use Automattic\Jetpack\Connection\Secrets;
18use Automattic\Jetpack\Connection\Tokens;
19use Automattic\Jetpack\Connection\Utils as Connection_Utils;
20use Automattic\Jetpack\Connection\Webhooks\Authorize_Redirect;
21use Automattic\Jetpack\Constants;
22use Automattic\Jetpack\CookieState;
23use Automattic\Jetpack\Current_Plan as Jetpack_Plan;
24use Automattic\Jetpack\Device_Detection\User_Agent_Info;
25use Automattic\Jetpack\Errors;
26use Automattic\Jetpack\Feature_Policy;
27use Automattic\Jetpack\Files;
28use Automattic\Jetpack\Heartbeat;
29use Automattic\Jetpack\Identity_Crisis;
30use Automattic\Jetpack\Import\Main as Import_Main;
31use Automattic\Jetpack\Licensing;
32use Automattic\Jetpack\Modules;
33use Automattic\Jetpack\My_Jetpack\Initializer as My_Jetpack_Initializer;
34use Automattic\Jetpack\Newsletter\Reader_Link;
35use Automattic\Jetpack\Paths;
36use Automattic\Jetpack\Plugin\Deprecate;
37use Automattic\Jetpack\Plugin\Tracking as Plugin_Tracking;
38use Automattic\Jetpack\Podcast\Podcast;
39use Automattic\Jetpack\Redirect;
40use Automattic\Jetpack\SEO\Initializer as Jetpack_SEO_Initializer;
41use Automattic\Jetpack\Status;
42use Automattic\Jetpack\Status\Host;
43use Automattic\Jetpack\Status\Visitor;
44use Automattic\Jetpack\Sync\Actions as Sync_Actions;
45use Automattic\Jetpack\Sync\Health;
46use Automattic\Jetpack\Sync\Sender;
47use Automattic\Jetpack\Terms_Of_Service;
48use Automattic\Jetpack\Tracking;
49use Automattic\Woocommerce_Analytics;
50
51if ( ! defined( 'ABSPATH' ) ) {
52    exit( 0 );
53}
54
55/*
56Options:
57jetpack_options (array)
58    An array of options.
59    @see Jetpack_Options::get_option_names()
60
61jetpack_register (string)
62    Temporary verification secrets.
63
64jetpack_activated (int)
65    1: the plugin was activated normally
66    2: the plugin was activated on this site because of a network-wide activation
67    3: the plugin was auto-installed
68    4: the plugin was manually disconnected (but is still installed)
69
70jetpack_active_modules (array)
71    Array of active module slugs.
72
73jetpack_do_activate (bool)
74    Flag for "activating" the plugin on sites where the activation hook never fired (auto-installs)
75*/
76
77require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.media.php';
78
79/**
80 * The Jetpack class.
81 */
82class Jetpack {
83    /**
84     * Marks a Jetpack plugin whose Backup dashboard follows the site's plan, not the backup module.
85     *
86     * @since 16.4
87     *
88     * @var bool
89     */
90    const BACKUP_FOLLOWS_PLAN = true;
91
92    /**
93     * XMLRPC server instance.
94     *
95     * @var null|Jetpack_XMLRPC_Server XMLRPC server used by Jetpack.
96     */
97    public $xmlrpc_server = null;
98
99    /**
100     * Contains all assets that have had their URL rewritten to minified versions.
101     *
102     * @var array
103     */
104    public static $min_assets = array();
105
106    /**
107     * Plugins to deactivate.
108     *
109     * @var array Plugins to deactivate by module.
110     */
111    public $plugins_to_deactivate = array(
112        'contact-form'        => array(
113            array( 'grunion-contact-form/grunion-contact-form.php', 'Grunion Contact Form' ),
114            array( 'mullet/mullet-contact-form.php', 'Mullet Contact Form' ),
115        ),
116        'gravatar-hovercards' => array(
117            array( 'jetpack-gravatar-hovercards/gravatar-hovercards.php', 'Jetpack Gravatar Hovercards' ),
118        ),
119        'latex'               => array(
120            array( 'wp-latex/wp-latex.php', 'WP LaTeX' ),
121        ),
122        'random-redirect'     => array(
123            array( 'random-redirect/random-redirect.php', 'Random Redirect' ),
124        ),
125        'sharedaddy'          => array(
126            array( 'sharedaddy/sharedaddy.php', 'Sharedaddy' ),
127            array( 'jetpack-sharing/sharedaddy.php', 'Jetpack Sharing' ),
128        ),
129        'shortlinks'          => array(
130            array( 'stats/stats.php', 'WordPress.com Stats' ),
131        ),
132        'stats'               => array(
133            array( 'stats/stats.php', 'WordPress.com Stats' ),
134        ),
135        'twitter-widget'      => array(
136            array( 'wickett-twitter-widget/wickett-twitter-widget.php', 'Wickett Twitter Widget' ),
137        ),
138        'videopress'          => array(
139            array( 'video/video.php', 'VideoPress' ),
140        ),
141        'widget-visibility'   => array(
142            array( 'jetpack-widget-visibility/widget-visibility.php', 'Jetpack Widget Visibility' ),
143            array( 'widget-visibility-without-jetpack/widget-visibility-without-jetpack.php', 'Widget Visibility Without Jetpack' ),
144        ),
145    );
146
147    /**
148     * Map of roles we care about, and their corresponding minimum capabilities.
149     *
150     * @deprecated 7.6 Use Automattic\Jetpack\Roles::$capability_translations instead.
151     *
152     * @access public
153     * @static
154     *
155     * @var array
156     */
157    public static $capability_translations = array(
158        'administrator' => 'manage_options',
159        'editor'        => 'edit_others_posts',
160        'author'        => 'publish_posts',
161        'contributor'   => 'edit_posts',
162        'subscriber'    => 'read',
163    );
164
165    /**
166     * Map of modules that have conflicts with plugins and should not be auto-activated
167     * if the plugins are active.  Used by filter_default_modules
168     *
169     * Plugin Authors: If you'd like to prevent a single module from auto-activating,
170     * change `module-slug` and add this to your plugin:
171     *
172     * add_filter( 'jetpack_get_default_modules', 'my_jetpack_get_default_modules' );
173     * function my_jetpack_get_default_modules( $modules ) {
174     *     return array_diff( $modules, array( 'module-slug' ) );
175     * }
176     *
177     * @var array
178     */
179    private $conflicting_plugins = array(
180        'comments'           => array(
181            'Intense Debate'                 => 'intensedebate/intensedebate.php',
182            'Disqus'                         => 'disqus-comment-system/disqus.php',
183            'Livefyre'                       => 'livefyre-comments/livefyre.php',
184            'Comments Evolved for WordPress' => 'gplus-comments/comments-evolved.php',
185            'Google+ Comments'               => 'google-plus-comments/google-plus-comments.php',
186            'WP-SpamShield Anti-Spam'        => 'wp-spamshield/wp-spamshield.php',
187        ),
188        'comment-likes'      => array(
189            'Epoch' => 'epoch/plugincore.php',
190        ),
191        'latex'              => array(
192            'LaTeX for WordPress'     => 'latex/latex.php',
193            'Youngwhans Simple Latex' => 'youngwhans-simple-latex/yw-latex.php',
194            'Easy WP LaTeX'           => 'easy-wp-latex-lite/easy-wp-latex-lite.php',
195            'MathJax-LaTeX'           => 'mathjax-latex/mathjax-latex.php',
196            'Enable Latex'            => 'enable-latex/enable-latex.php',
197            'WP QuickLaTeX'           => 'wp-quicklatex/wp-quicklatex.php',
198        ),
199        'protect'            => array(
200            'Limit Login Attempts'              => 'limit-login-attempts/limit-login-attempts.php',
201            'Captcha'                           => 'captcha/captcha.php',
202            'Brute Force Login Protection'      => 'brute-force-login-protection/brute-force-login-protection.php',
203            'Login Security Solution'           => 'login-security-solution/login-security-solution.php',
204            'WPSecureOps Brute Force Protect'   => 'wpsecureops-bruteforce-protect/wpsecureops-bruteforce-protect.php',
205            'BulletProof Security'              => 'bulletproof-security/bulletproof-security.php',
206            'SiteGuard WP Plugin'               => 'siteguard/siteguard.php',
207            'Security-protection'               => 'security-protection/security-protection.php',
208            'Login Security'                    => 'login-security/login-security.php',
209            'Botnet Attack Blocker'             => 'botnet-attack-blocker/botnet-attack-blocker.php',
210            'Wordfence Security'                => 'wordfence/wordfence.php',
211            'All In One WP Security & Firewall' => 'all-in-one-wp-security-and-firewall/wp-security.php',
212            'iThemes Security'                  => 'better-wp-security/better-wp-security.php',
213        ),
214        'random-redirect'    => array(
215            'Random Redirect 2' => 'random-redirect-2/random-redirect.php',
216        ),
217        'related-posts'      => array(
218            'YARPP'                       => 'yet-another-related-posts-plugin/yarpp.php',
219            'WordPress Related Posts'     => 'wordpress-23-related-posts-plugin/wp_related_posts.php',
220            'nrelate Related Content'     => 'nrelate-related-content/nrelate-related.php',
221            'Contextual Related Posts'    => 'contextual-related-posts/contextual-related-posts.php',
222            'Related Posts for WordPress' => 'microkids-related-posts/microkids-related-posts.php',
223            'outbrain'                    => 'outbrain/outbrain.php',
224            'Shareaholic'                 => 'shareaholic/shareaholic.php',
225            'Sexybookmarks'               => 'sexybookmarks/shareaholic.php',
226        ),
227        'sharedaddy'         => array(
228            'AddThis'     => 'addthis/addthis_social_widget.php',
229            'Add To Any'  => 'add-to-any/add-to-any.php',
230            'ShareThis'   => 'share-this/sharethis.php',
231            'Shareaholic' => 'shareaholic/shareaholic.php',
232        ),
233        'seo-tools'          => array(
234            'WordPress SEO by Yoast'         => 'wordpress-seo/wp-seo.php',
235            'WordPress SEO Premium by Yoast' => 'wordpress-seo-premium/wp-seo-premium.php',
236            'All in One SEO Pack'            => 'all-in-one-seo-pack/all_in_one_seo_pack.php',
237            'All in One SEO Pack Pro'        => 'all-in-one-seo-pack-pro/all_in_one_seo_pack.php',
238            'The SEO Framework'              => 'autodescription/autodescription.php',
239            'Rank Math'                      => 'seo-by-rank-math/rank-math.php',
240            'Slim SEO'                       => 'slim-seo/slim-seo.php',
241            'SEOKEY'                         => 'seo-key/seo-key.php',
242            'SEOKEY Pro'                     => 'seo-key-pro/seo-key.php',
243            'SEOPress'                       => 'wp-seopress/seopress.php',
244            'SEOPress Pro'                   => 'wp-seopress-pro/seopress-pro.php',
245        ),
246        'verification-tools' => array(
247            'WordPress SEO by Yoast'         => 'wordpress-seo/wp-seo.php',
248            'WordPress SEO Premium by Yoast' => 'wordpress-seo-premium/wp-seo-premium.php',
249            'All in One SEO Pack'            => 'all-in-one-seo-pack/all_in_one_seo_pack.php',
250            'All in One SEO Pack Pro'        => 'all-in-one-seo-pack-pro/all_in_one_seo_pack.php',
251            'The SEO Framework'              => 'autodescription/autodescription.php',
252            'Rank Math'                      => 'seo-by-rank-math/rank-math.php',
253            'Slim SEO'                       => 'slim-seo/slim-seo.php',
254        ),
255        'widget-visibility'  => array(
256            'Widget Logic'    => 'widget-logic/widget_logic.php',
257            'Dynamic Widgets' => 'dynamic-widgets/dynamic-widgets.php',
258        ),
259        'sitemaps'           => array(
260            'Google XML Sitemaps'                  => 'google-sitemap-generator/sitemap.php',
261            'Better WordPress Google XML Sitemaps' => 'bwp-google-xml-sitemaps/bwp-simple-gxs.php',
262            'Google XML Sitemaps for qTranslate'   => 'google-xml-sitemaps-v3-for-qtranslate/sitemap.php',
263            'XML Sitemap & Google News feeds'      => 'xml-sitemap-feed/xml-sitemap.php',
264            'Google Sitemap by BestWebSoft'        => 'google-sitemap-plugin/google-sitemap-plugin.php',
265            'WordPress SEO by Yoast'               => 'wordpress-seo/wp-seo.php',
266            'WordPress SEO Premium by Yoast'       => 'wordpress-seo-premium/wp-seo-premium.php',
267            'All in One SEO Pack'                  => 'all-in-one-seo-pack/all_in_one_seo_pack.php',
268            'All in One SEO Pack Pro'              => 'all-in-one-seo-pack-pro/all_in_one_seo_pack.php',
269            'The SEO Framework'                    => 'autodescription/autodescription.php',
270            'Sitemap'                              => 'sitemap/sitemap.php',
271            'Simple Wp Sitemap'                    => 'simple-wp-sitemap/simple-wp-sitemap.php',
272            'Simple Sitemap'                       => 'simple-sitemap/simple-sitemap.php',
273            'XML Sitemaps'                         => 'xml-sitemaps/xml-sitemaps.php',
274            'MSM Sitemaps'                         => 'msm-sitemap/msm-sitemap.php',
275            'Rank Math'                            => 'seo-by-rank-math/rank-math.php',
276            'Slim SEO'                             => 'slim-seo/slim-seo.php',
277        ),
278    );
279
280    /**
281     * Plugins for which we turn off our Facebook OG Tags implementation.
282     *
283     * Note: the following plugins automatically deactivate Jetpack's Open
284     * Graph tags via filter when their Social Meta modules are active:
285     *
286     * - All in One SEO Pack, All in one SEO Pack Pro
287     * - WordPress SEO by Yoast, WordPress SEO Premium by Yoast
288     *
289     * Plugin authors: If you'd like to prevent Jetpack's Open Graph tag generation in your plugin, you can do so via this filter:
290     * add_filter( 'jetpack_enable_open_graph', '__return_false' );
291     *
292     * @var array Array of plugin slugs.
293     */
294    private $open_graph_conflicting_plugins = array(
295        '2-click-socialmedia-buttons/2-click-socialmedia-buttons.php', // 2 Click Social Media Buttons.
296        'add-link-to-facebook/add-link-to-facebook.php',         // Add Link to Facebook.
297        'add-meta-tags/add-meta-tags.php',                       // Add Meta Tags.
298        'complete-open-graph/complete-open-graph.php',           // Complete Open Graph.
299        'easy-facebook-share-thumbnails/esft.php',               // Easy Facebook Share Thumbnail.
300        'heateor-open-graph-meta-tags/heateor-open-graph-meta-tags.php', // Open Graph Meta Tags by Heateor.
301        'facebook/facebook.php',                                 // Facebook (official plugin).
302        'facebook-awd/AWD_facebook.php',                         // Facebook AWD All in one.
303        'facebook-featured-image-and-open-graph-meta-tags/fb-featured-image.php', // Facebook Featured Image & OG Meta Tags.
304        'facebook-meta-tags/facebook-metatags.php',              // Facebook Meta Tags.
305        'wonderm00ns-simple-facebook-open-graph-tags/wonderm00n-open-graph.php', // Facebook Open Graph Meta Tags for WordPress.
306        'facebook-revised-open-graph-meta-tag/index.php',        // Facebook Revised Open Graph Meta Tag.
307        'facebook-thumb-fixer/_facebook-thumb-fixer.php',        // Facebook Thumb Fixer.
308        'facebook-and-digg-thumbnail-generator/facebook-and-digg-thumbnail-generator.php', // Fedmich's Facebook Open Graph Meta.
309        'network-publisher/networkpub.php',                      // Network Publisher.
310        'nextgen-facebook/nextgen-facebook.php',                 // NextGEN Facebook OG.
311        'social-networks-auto-poster-facebook-twitter-g/NextScripts_SNAP.php', // NextScripts SNAP.
312        'og-tags/og-tags.php',                                   // OG Tags.
313        'opengraph/opengraph.php',                               // Open Graph.
314        'open-graph-protocol-framework/open-graph-protocol-framework.php', // Open Graph Protocol Framework.
315        'seo-facebook-comments/seofacebook.php',                 // SEO Facebook Comments.
316        'seo-ultimate/seo-ultimate.php',                         // SEO Ultimate.
317        'sexybookmarks/sexy-bookmarks.php',                      // Shareaholic.
318        'shareaholic/sexy-bookmarks.php',                        // Shareaholic.
319        'sharepress/sharepress.php',                             // SharePress.
320        'simple-facebook-connect/sfc.php',                       // Simple Facebook Connect.
321        'social-discussions/social-discussions.php',             // Social Discussions.
322        'social-sharing-toolkit/social_sharing_toolkit.php',     // Social Sharing Toolkit.
323        'socialize/socialize.php',                               // Socialize.
324        'squirrly-seo/squirrly.php',                             // SEO by SQUIRRLYâ„¢.
325        'only-tweet-like-share-and-google-1/tweet-like-plusone.php', // Tweet, Like, Google +1 and Share.
326        'wordbooker/wordbooker.php',                             // Wordbooker.
327        'wpsso/wpsso.php',                                       // WordPress Social Sharing Optimization.
328        'wp-caregiver/wp-caregiver.php',                         // WP Caregiver.
329        'wp-facebook-like-send-open-graph-meta/wp-facebook-like-send-open-graph-meta.php', // WP Facebook Like Send & Open Graph Meta.
330        'wp-facebook-open-graph-protocol/wp-facebook-ogp.php',   // WP Facebook Open Graph protocol.
331        'wp-ogp/wp-ogp.php',                                     // WP-OGP.
332        'wp-seopress/seopress.php',                              // SEOPress.
333        'wp-seopress-pro/seopress-pro.php',                      // SEOPress Pro.
334        'zoltonorg-social-plugin/zosp.php',                      // Zolton.org Social Plugin.
335        'wp-fb-share-like-button/wp_fb_share-like_widget.php',   // WP Facebook Like Button.
336        'open-graph-metabox/open-graph-metabox.php',              // Open Graph Metabox.
337        'seo-by-rank-math/rank-math.php',                        // Rank Math.
338        'slim-seo/slim-seo.php',                                 // Slim SEO.
339    );
340
341    /**
342     * Plugins for which we turn off our Twitter Cards Tags implementation.
343     *
344     * @var array Plugins that conflict with Twitter cards.
345     */
346    private $twitter_cards_conflicting_plugins = array(
347        // phpcs:ignore Squiz.PHP.CommentedOutCode.Found
348        // 'twitter/twitter.php',                       // The official one handles this on its own.
349        // https://github.com/twitter/wordpress/blob/master/src/Twitter/WordPress/Cards/Compatibility.php
350            'eewee-twitter-card/index.php',              // Eewee Twitter Card.
351        'ig-twitter-cards/ig-twitter-cards.php',     // IG:Twitter Cards.
352        'jm-twitter-cards/jm-twitter-cards.php',     // JM Twitter Cards.
353        'kevinjohn-gallagher-pure-web-brilliants-social-graph-twitter-cards-extention/kevinjohn_gallagher___social_graph_twitter_output.php',  // Pure Web Brilliant's Social Graph Twitter Cards Extension.
354        'twitter-cards/twitter-cards.php',           // Twitter Cards.
355        'twitter-cards-meta/twitter-cards-meta.php', // Twitter Cards Meta.
356        'wp-to-twitter/wp-to-twitter.php',           // WP to Twitter.
357        'wp-twitter-cards/twitter_cards.php',        // WP Twitter Cards.
358        'seo-by-rank-math/rank-math.php',            // Rank Math.
359        'slim-seo/slim-seo.php',                     // Slim SEO.
360    );
361
362    /**
363     * Message to display in admin_notice
364     *
365     * @var string
366     */
367    public $message = '';
368
369    /**
370     * Error to display in admin_notice
371     *
372     * @var string
373     */
374    public $error = '';
375
376    /**
377     * Modules that need more privacy description.
378     *
379     * @var string
380     */
381    public $privacy_checks = '';
382
383    /**
384     * Stats to record once the page loads
385     *
386     * @var array
387     */
388    public $stats = array();
389
390    /**
391     * Jetpack_Sync object
392     *
393     * @todo This is also seemingly unused.
394     *
395     * @var object
396     */
397    public $sync;
398
399    /**
400     * Verified data for JSON authorization request
401     *
402     * @deprecated 13.4
403     *
404     * @var array
405     */
406    public $json_api_authorization_request = array();
407
408    /**
409     * Connection manager.
410     *
411     * @var Automattic\Jetpack\Connection\Manager
412     */
413    protected $connection_manager;
414
415    /**
416     * Plugin lock key.
417     *
418     * @var string Transient key used to prevent multiple simultaneous plugin upgrades
419     */
420    public static $plugin_upgrade_lock_key = 'jetpack_upgrade_lock';
421
422    /**
423     * Holds an instance of Automattic\Jetpack\A8c_Mc_Stats
424     *
425     * @var Automattic\Jetpack\A8c_Mc_Stats
426     */
427    public $a8c_mc_stats_instance;
428
429    /**
430     * Constant for login redirect key.
431     *
432     * @var string
433     * @since 8.4.0
434     */
435    public static $jetpack_redirect_login = 'jetpack_connect_login_redirect';
436
437    /**
438     * Holds the singleton instance of this class
439     *
440     * @since 2.3.3
441     * @var Jetpack
442     */
443    public static $instance = false;
444
445    /**
446     * Resolved answer for `is_premium_analytics_enabled()`, or null before the first call.
447     *
448     * @since 16.1
449     * @var bool|null
450     */
451    private static $premium_analytics_enabled = null;
452
453    /**
454     * Singleton
455     *
456     * @static
457     */
458    public static function init() {
459        if ( ! self::$instance ) {
460            self::$instance = new Jetpack();
461            add_action( 'plugins_loaded', array( self::$instance, 'plugin_upgrade' ) );
462            add_action( 'jetpack_idc_disconnect', array( __CLASS__, 'on_idc_disconnect' ) );
463        }
464
465        return self::$instance;
466    }
467
468    /**
469     * Must never be called statically
470     */
471    public function plugin_upgrade() {
472        if ( self::is_connection_ready() ) {
473            list( $version ) = explode( ':', Jetpack_Options::get_option( 'version' ) );
474            if ( JETPACK__VERSION !== $version ) {
475                // Prevent multiple upgrades at once - only a single process should trigger an upgrade to avoid stampedes.
476                if ( wp_using_ext_object_cache() ) {
477                    if ( true !== wp_cache_add( self::$plugin_upgrade_lock_key, 1, 'transient', 10 ) ) {
478                        return;
479                    }
480                } else {
481                    if ( false !== get_transient( self::$plugin_upgrade_lock_key ) ) {
482                        return;
483                    }
484
485                    set_transient( self::$plugin_upgrade_lock_key, 1, 10 );
486                }
487
488                // check which active modules actually exist and remove others from active_modules list.
489                $unfiltered_modules = self::get_active_modules();
490                $modules            = array_filter( $unfiltered_modules, array( 'Jetpack', 'is_module' ) );
491                if ( array_diff( $unfiltered_modules, $modules ) ) {
492                    self::update_active_modules( $modules );
493                }
494
495                self::register_upgrade_init_hooks();
496
497                // Upgrade to 4.3.0.
498                if ( Jetpack_Options::get_option( 'identity_crisis_whitelist' ) ) {
499                    Jetpack_Options::delete_option( 'identity_crisis_whitelist' );
500                }
501
502                /*
503                 * Minileven deprecation. 8.3.0.
504                 * Only delete options if not using
505                 * the replacement standalone Minileven plugin.
506                 */
507                if (
508                    ! self::is_plugin_active( 'minileven-master/minileven.php' )
509                    && ! self::is_plugin_active( 'minileven/minileven.php' )
510                ) {
511                    if ( get_option( 'wp_mobile_custom_css' ) ) {
512                        delete_option( 'wp_mobile_custom_css' );
513                    }
514                    if ( get_option( 'wp_mobile_excerpt' ) ) {
515                        delete_option( 'wp_mobile_excerpt' );
516                    }
517                    if ( get_option( 'wp_mobile_featured_images' ) ) {
518                        delete_option( 'wp_mobile_featured_images' );
519                    }
520                    if ( get_option( 'wp_mobile_app_promos' ) ) {
521                        delete_option( 'wp_mobile_app_promos' );
522                    }
523                }
524
525                // Upgrade to 8.4.0.
526                if ( Jetpack_Options::get_option( 'ab_connect_banner_green_bar' ) ) {
527                    Jetpack_Options::delete_option( 'ab_connect_banner_green_bar' );
528                }
529
530                // Update to 8.8.x (WordPress 5.5 Compatibility).
531                if ( Jetpack_Options::get_option( 'autoupdate_plugins' ) ) {
532                    $updated = update_site_option(
533                        'auto_update_plugins',
534                        array_unique(
535                            array_merge(
536                                (array) Jetpack_Options::get_option( 'autoupdate_plugins', array() ),
537                                (array) get_site_option( 'auto_update_plugins', array() )
538                            )
539                        )
540                    );
541
542                    if ( $updated ) {
543                        Jetpack_Options::delete_option( 'autoupdate_plugins' );
544                    } // Should we have some type of fallback if something fails here?
545                }
546
547                // Set the newsletter send default option for existing sites.
548                if ( false === get_option( 'wpcom_newsletter_send_default' ) ) {
549                    add_option( 'wpcom_newsletter_send_default', 1 );
550                }
551
552                // Its handler went with the Recommendations assistant.
553                wp_clear_scheduled_hook( 'jetpack_recommend_videopress' );
554
555                if ( did_action( 'wp_loaded' ) ) {
556                    self::upgrade_on_load();
557                } else {
558                    add_action(
559                        'wp_loaded',
560                        array( __CLASS__, 'upgrade_on_load' )
561                    );
562                }
563            }
564        }
565    }
566
567    /**
568     * Runs upgrade routines that need to have modules loaded.
569     */
570    public static function upgrade_on_load() {
571
572        // Not attempting any upgrades if jetpack_modules_loaded did not fire.
573        // This can happen in case Jetpack has been just upgraded and is
574        // being initialized late during the page load. In this case we wait
575        // until the next proper admin page load with Jetpack active.
576        if ( ! did_action( 'jetpack_modules_loaded' ) ) {
577            delete_transient( self::$plugin_upgrade_lock_key );
578
579            return;
580        }
581
582        self::maybe_set_version_option();
583
584        if ( method_exists( 'Jetpack_Widget_Conditions', 'migrate_post_type_rules' ) ) {
585            Jetpack_Widget_Conditions::migrate_post_type_rules();
586        }
587
588        if (
589            class_exists( 'Jetpack_Sitemap_Manager' )
590        ) {
591            do_action( 'jetpack_sitemaps_purge_data' );
592        }
593
594        // Delete old stats cache.
595        delete_option( 'jetpack_restapi_stats_cache' );
596
597        delete_transient( self::$plugin_upgrade_lock_key );
598    }
599
600    /**
601     * Saves all the currently active modules to options.
602     * Also fires Action hooks for each newly activated and deactivated module.
603     *
604     * @param array $modules Array of active modules to be saved in options.
605     *
606     * @return bool $success true for success, false for failure.
607     */
608    public static function update_active_modules( $modules ) {
609        return ( new Modules() )->update_active( $modules );
610    }
611
612    /**
613     * Remove all active modules.
614     *
615     * @return void
616     */
617    public static function delete_active_modules() {
618        self::update_active_modules( array() );
619    }
620
621    /**
622     * Adds a hook to plugins_loaded at a priority that's currently the earliest
623     * available.
624     */
625    public function add_configure_hook() {
626        global $wp_filter;
627
628        $current_priority = has_filter( 'plugins_loaded', array( $this, 'configure' ) );
629        if ( false !== $current_priority ) {
630            remove_action( 'plugins_loaded', array( $this, 'configure' ), $current_priority );
631        }
632
633        $taken_priorities = array_map( 'intval', array_keys( $wp_filter['plugins_loaded']->callbacks ) );
634        sort( $taken_priorities );
635
636        $first_priority = array_shift( $taken_priorities );
637
638        if ( $first_priority <= PHP_INT_MIN ) {
639            $new_priority = PHP_INT_MIN;
640        } else {
641            $new_priority = $first_priority - 1;
642        }
643
644        add_action( 'plugins_loaded', array( $this, 'configure' ), $new_priority );
645    }
646
647    /**
648     * Constructor.  Initializes WordPress hooks
649     */
650    private function __construct() {
651        /*
652         * Check for and alert any deprecated hooks
653         */
654        add_action( 'init', array( $this, 'deprecated_hooks' ) );
655
656        // Note how this runs at an earlier plugin_loaded hook intentionally to accomodate for other plugins.
657        add_action( 'plugin_loaded', array( $this, 'add_configure_hook' ), 90 );
658        add_action( 'network_plugin_loaded', array( $this, 'add_configure_hook' ), 90 );
659        add_action( 'mu_plugin_loaded', array( $this, 'add_configure_hook' ), 90 );
660        add_action( 'plugins_loaded', array( $this, 'late_initialization' ), 90 );
661
662        /**
663         * Prepare Gutenberg Editor functionality
664         *
665         * The hooks previously here have been moved to modules/blocks.php but leaving this here pending
666         * a longer investigation to see if code is expecting the Gutenberg class to always be available.
667         */
668        require_once JETPACK__PLUGIN_DIR . 'class.jetpack-gutenberg.php';
669        \Automattic\Jetpack\Plugin\Unavailable_Blocks::init();
670        add_action( 'set_user_role', array( $this, 'maybe_clear_other_linked_admins_transient' ), 10, 3 );
671
672        add_action( 'jetpack_event_log', array( 'Jetpack', 'log' ), 10, 2 );
673
674        add_filter( 'login_url', array( $this, 'login_url' ), 10, 2 );
675        add_action( 'login_init', array( $this, 'login_init' ) );
676
677        // Set up the REST authentication hooks.
678        Connection_Rest_Authentication::init();
679
680        // Register Jetpack-specific connection tests (sync health, etc.) with the connection
681        // package's health test suite. This runs on all requests (not just admin), because
682        // the connection/test REST endpoint can be called outside admin context.
683        add_action( 'jetpack_connection_tests_loaded', array( $this, 'register_jetpack_connection_tests' ) );
684
685        add_action( 'admin_init', array( $this, 'admin_init' ) );
686        add_action( 'admin_init', array( $this, 'dismiss_jetpack_notice' ) );
687
688        add_filter( 'admin_body_class', array( $this, 'admin_body_class' ), 20 );
689
690        // Filter the dashboard meta box order to swap the new one in in place of the old one.
691        add_filter( 'get_user_option_meta-box-order_dashboard', array( $this, 'get_user_option_meta_box_order_dashboard' ) );
692
693        // WordPress dashboard widget.
694        require_once JETPACK__PLUGIN_DIR . 'class-jetpack-stats-dashboard-widget.php';
695        add_action( 'wp_dashboard_setup', array( new Jetpack_Stats_Dashboard_Widget(), 'init' ) );
696
697        // Returns HTTPS support status.
698        add_action( 'wp_ajax_jetpack-recheck-ssl', array( $this, 'ajax_recheck_ssl' ) );
699
700        add_action( 'wp_loaded', array( $this, 'register_assets' ) );
701
702        /**
703         * These actions run checks to load additional files.
704         * They check for external files or plugins, so they need to run as late as possible.
705         */
706        add_action( 'wp_head', array( $this, 'check_open_graph' ), 1 );
707        add_action( 'web_stories_story_head', array( $this, 'check_open_graph' ), 1 );
708        add_action( 'plugins_loaded', array( $this, 'check_twitter_tags' ), 999 );
709        add_action( 'plugins_loaded', array( $this, 'check_rest_api_compat' ), 1000 );
710
711        add_filter( 'plugins_url', array( 'Jetpack', 'maybe_min_asset' ), 1, 3 );
712        add_action( 'style_loader_src', array( 'Jetpack', 'set_suffix_on_min' ), 10, 2 );
713
714        add_filter( 'profile_update', array( 'Jetpack', 'user_meta_cleanup' ) );
715
716        add_filter( 'jetpack_get_default_modules', array( $this, 'filter_default_modules' ) );
717        add_filter( 'jetpack_get_default_modules', array( $this, 'handle_deprecated_modules' ), 99 );
718
719        add_action(
720            'plugins_loaded',
721            function () {
722                if ( User_Agent_Info::is_mobile_app() ) {
723                    add_filter( 'get_edit_post_link', '__return_empty_string' );
724                }
725            }
726        );
727
728        // Update the site's Jetpack plan and products from API on heartbeats.
729        add_action( 'jetpack_heartbeat', array( Jetpack_Plan::class, 'refresh_from_wpcom' ) );
730
731        // The Connection package fetches the site record for `jetpack/v4/site`; reuse it to refresh the plan.
732        add_action( 'jetpack_site_data_fetched', array( Jetpack_Plan::class, 'update_from_site_record' ) );
733
734        // Actually push the stats on shutdown.
735        if ( ! has_action( 'shutdown', array( $this, 'push_stats' ) ) ) {
736            add_action( 'shutdown', array( $this, 'push_stats' ) );
737        }
738
739        // After a successful connection.
740        add_action( 'jetpack_site_registered', array( $this, 'activate_default_modules_on_site_register' ) );
741        add_action( 'jetpack_site_registered', array( $this, 'handle_unique_registrations_stats' ) );
742        add_action( 'jetpack_site_registered', array( Reader_Link::class, 'activate_on_connection' ), 9 );
743        add_action( 'jetpack_site_registered', array( \Automattic\Jetpack\Reprint_Export\Reprint_Exporter::class, 'discard_credentials' ) );
744
745        // Actions for Manager::authorize().
746        add_action( 'jetpack_authorize_starting', array( $this, 'authorize_starting' ) );
747        add_action( 'jetpack_authorize_ending_linked', array( $this, 'authorize_ending_linked' ) );
748        add_action( 'jetpack_authorize_ending_authorized', array( $this, 'authorize_ending_authorized' ) );
749
750        Jetpack_Client_Server::init();
751        add_action( 'jetpack_client_authorize_error', array( Jetpack_Client_Server::class, 'client_authorize_error' ) );
752        add_filter( 'jetpack_client_authorize_already_authorized_url', array( Jetpack_Client_Server::class, 'client_authorize_already_authorized_url' ) );
753        add_action( 'jetpack_client_authorize_processing', array( Jetpack_Client_Server::class, 'client_authorize_processing' ) );
754        add_filter( 'jetpack_client_authorize_fallback_url', array( Jetpack_Client_Server::class, 'client_authorize_fallback_url' ) );
755
756        // Filters for the Manager::get_token() urls and request body.
757        add_filter( 'jetpack_token_redirect_url', array( Authorize_Redirect::class, 'filter_connect_redirect_url' ) );
758        add_filter( 'jetpack_token_request_body', array( __CLASS__, 'filter_token_request_body' ) );
759
760        // Filter for the `jetpack/v4/connection/data` API response.
761        add_filter( 'jetpack_current_user_connection_data', array( __CLASS__, 'filter_jetpack_current_user_connection_data' ) );
762
763        // Actions for successful reconnect.
764        add_action( 'jetpack_reconnection_completed', array( $this, 'reconnection_completed' ) );
765
766        // Actions for successful disconnect.
767        add_action( 'jetpack_site_disconnected', array( $this, 'jetpack_site_disconnected' ) );
768
769        // Actions for licensing.
770        Licensing::instance()->initialize();
771
772        // Filters for Sync Callables.
773        add_filter( 'jetpack_sync_callable_whitelist', array( $this, 'filter_sync_callable_whitelist' ), 10, 1 );
774        add_filter( 'jetpack_sync_multisite_callable_whitelist', array( $this, 'filter_sync_multisite_callable_whitelist' ), 10, 1 );
775
776        // Make resources use static domain when possible.
777        add_filter( 'jetpack_static_url', array( 'Automattic\\Jetpack\\Assets', 'staticize_subdomain' ) );
778
779        // Validate the domain names in Jetpack development versions.
780        add_action( 'jetpack_pre_register', array( static::class, 'registration_check_domains' ) );
781
782        // Register product descriptions for partner coupon usage.
783        add_filter( 'jetpack_partner_coupon_products', array( $this, 'get_partner_coupon_product_descriptions' ) );
784
785        // Add 5-star
786        add_filter( 'plugin_row_meta', array( $this, 'add_5_star_review_link' ), 10, 2 );
787        add_action( 'init', array( Deprecate::class, 'instance' ) );
788
789        // Register Jetpack module management abilities (WordPress Abilities API, WP 6.9+).
790        \Automattic\Jetpack\Plugin\Abilities\Modules_Abilities::init();
791
792        // Register Connection abilities (WordPress Abilities API, WP 6.9+). Scoped to the
793        // Jetpack plugin for now: the Connection package no longer auto-wires these, so
794        // connection-only consumers (Boost, Protect, Search, etc.) do not register them yet.
795        \Automattic\Jetpack\Connection\Abilities\Connection_Abilities::init();
796    }
797
798    /**
799     * Whether the current request should eagerly initialize the admin/REST-only
800     * packages (the Import package and My Jetpack) now, at `plugins_loaded` time.
801     *
802     * Returns true for admin, cron, POST, and WP-CLI requests â€” the contexts,
803     * knowable this early, where those packages have work to do. Returns false
804     * for a plain front-end GET *and* for a REST request: the two can't be told
805     * apart yet (this runs before `rest_api_init`), so callers defer the REST
806     * case by initializing the package on `rest_api_init` instead, while a plain
807     * page view never fires that hook and so loads nothing. This keeps
808     * admin/REST-only PHP out of opcache on the front-end GET hot path.
809     *
810     * No in-repo code depends on the deferral. The one externally observable
811     * change is timing: the packages' documented init hooks
812     * (`jetpack_import_initialized`, `jetpack_feature_import_enabled`, and
813     * `my_jetpack_init`) no longer fire on a plain front-end GET â€” they fire on
814     * the admin, cron, POST, WP-CLI, and REST requests where the packages load.
815     *
816     * @return bool
817     */
818    private static function should_eager_load_packages() {
819        $is_post_request = isset( $_SERVER['REQUEST_METHOD'] ) && 'POST' === strtoupper( sanitize_text_field( wp_unslash( $_SERVER['REQUEST_METHOD'] ) ) );
820        $is_wp_cli       = Constants::is_true( 'WP_CLI' );
821
822        return is_admin() || wp_doing_cron() || $is_post_request || $is_wp_cli;
823    }
824
825    /**
826     * Configure the Import package from a deferred hook.
827     *
828     * The eager path uses Config::ensure( 'import' ), but the deferred REST path
829     * runs after Config::on_plugins_loaded() has already processed its feature
830     * flags, so it needs a hookable bootstrap callback. Preserve Config's
831     * feature-enabled action for hook consumers.
832     *
833     * @since 16.0
834     *
835     * @return void
836     */
837    public static function configure_import_package() {
838        if ( class_exists( Import_Main::class ) ) {
839            Import_Main::configure();
840
841            if ( ! did_action( 'jetpack_feature_import_enabled' ) ) {
842                do_action( 'jetpack_feature_import_enabled' );
843            }
844        }
845    }
846
847    /**
848     * What switching a module off leaves unchanged, for interfaces that still offer it; empty when nothing.
849     *
850     * @since 16.4
851     *
852     * @param string $module Module slug.
853     * @return string
854     */
855    public static function get_module_deactivation_note( $module ) {
856        return 'backup' === $module
857            ? __( 'Backups are controlled by your site’s plan.', 'jetpack' )
858            : '';
859    }
860
861    /**
862     * Whether to offer the bundled Backup dashboard; Backup::offers_jetpack_dashboard() decides.
863     *
864     * @return bool
865     */
866    private static function offers_backup_dashboard() {
867        $product = 'Automattic\\Jetpack\\My_Jetpack\\Products\\Backup';
868
869        if ( method_exists( $product, 'offers_jetpack_dashboard' ) ) {
870            return $product::offers_jetpack_dashboard();
871        }
872
873        // Another plugin may have loaded an older My Jetpack without it: the same gates, on the current plan only.
874        if ( is_multisite() || ! self::is_connection_ready() || ! self::connection()->has_connected_owner() || ! Jetpack_Plan::supports( 'backups' ) ) {
875            return false;
876        }
877
878        /**
879         * Filters whether the Jetpack plugin offers its bundled Backup dashboard.
880         *
881         * Resolved at the earliest `plugins_loaded` priority, so hook it from a mu-plugin.
882         *
883         * @since 16.3
884         *
885         * @param bool $enabled Whether to initialize the bundled Backup dashboard. Default true.
886         */
887        return (bool) apply_filters( 'jetpack_backup_dashboard_enabled', true );
888    }
889
890    /**
891     * Enable the bundled Backup dashboard.
892     *
893     * The standalone plugin initializes the package first, so with both active this is a no-op.
894     *
895     * @return void
896     */
897    public static function configure_backup_package() {
898        if ( ! self::offers_backup_dashboard() ) {
899            return;
900        }
901
902        $backup = 'Automattic\\Jetpack\\Backup\\V0005\\Jetpack_Backup';
903
904        // An older package would take over the connection (see Jetpack_Backup::DEFAULT_INIT_OPTIONS);
905        // only the standalone plugin ships one that old, and it draws its own menu.
906        if ( ! class_exists( $backup ) || ! defined( $backup . '::DEFAULT_INIT_OPTIONS' ) ) {
907            return;
908        }
909
910        $backup::initialize( array( 'manage_connection' => false ) );
911    }
912
913    /**
914     * Whether the bundled Stats v2 dashboard is enabled.
915     *
916     * Resolves `Enablement::is_enabled()` once per request (WOOA7S-1595). The classic Stats menu
917     * stays beside Stats v2 until `jetpack-stats-classic-page-retired` retires it.
918     *
919     * The package has to be loadable for this to be true, so a site with the
920     * flag on but a missing package answers false here and never adds the
921     * Stats v2 menu (a warning is logged instead).
922     *
923     * @since 16.1
924     *
925     * @return bool
926     */
927    public static function is_premium_analytics_enabled() {
928        if ( null !== self::$premium_analytics_enabled ) {
929            return self::$premium_analytics_enabled;
930        }
931
932        // The fallback covers an older package, loaded ahead of ours, that predates the shared rule and the retirement flag.
933        $enablement = 'Automattic\Jetpack\PremiumAnalytics\Enablement';
934        if ( method_exists( $enablement, 'is_enabled' ) ) {
935            $flag = $enablement::is_enabled();
936        } elseif ( ! self::is_module_active( 'stats' ) ) {
937            $flag = false;
938        } else {
939            /** This filter is documented in projects/packages/premium-analytics/src/class-enablement.php */
940            $flag = (bool) apply_filters(
941                'jetpack_premium_analytics_enabled',
942                (bool) get_option( 'jetpack_premium_analytics_enabled' )
943            );
944        }
945
946        self::$premium_analytics_enabled = $flag && class_exists( 'Automattic\Jetpack\PremiumAnalytics\Analytics' );
947
948        if ( $flag && ! self::$premium_analytics_enabled ) {
949            wp_trigger_error(
950                __METHOD__,
951                'The jetpack_premium_analytics_enabled flag is on but the Premium Analytics package is not loadable; keeping the Stats UI in place.'
952            );
953        }
954
955        return self::$premium_analytics_enabled;
956    }
957
958    /**
959     * Expose the setting that turns the Premium Analytics dashboard on and off.
960     *
961     * Deliberately not behind is_premium_analytics_enabled(): this is the setting that flips that
962     * check, so it has to answer while the dashboard is still off.
963     *
964     * @since 16.2
965     *
966     * @return void
967     */
968    public static function register_premium_analytics_enablement_setting() {
969        if ( class_exists( 'Automattic\Jetpack\PremiumAnalytics\Enablement_Setting' ) ) {
970            \Automattic\Jetpack\PremiumAnalytics\Enablement_Setting::register();
971        }
972    }
973
974    /**
975     * Before everything else starts getting initalized, we need to initialize Jetpack using the
976     * Config object.
977     */
978    public function configure() {
979        $config = new Config();
980
981        foreach (
982            array(
983                'jitm',
984                'sync',
985                'account_protection',
986                'waf',
987            )
988            as $feature
989        ) {
990            $config->ensure( $feature );
991        }
992
993        // Enable the VideoPress admin UI (the "Jetpack > VideoPress" dashboard) inside the
994        // Jetpack plugin, mirroring the standalone Jetpack VideoPress plugin. The dashboard
995        // only renders when the VideoPress module is active (Status::is_active()); when it
996        // is not, the menu item links to the My Jetpack interstitial to activate it.
997        $config->ensure( 'videopress', array( 'admin_ui' => true ) );
998
999        // The Backup dashboard is only an admin menu and REST routes, so it is deferred like Import below.
1000        if ( self::should_eager_load_packages() ) {
1001            self::configure_backup_package();
1002        } else {
1003            add_action( 'rest_api_init', array( __CLASS__, 'configure_backup_package' ), 0 );
1004        }
1005
1006        /*
1007         * The Import package only registers `jetpack/v4/import` REST routes â€” it
1008         * does nothing when rendering a front-end page â€” so gate its `ensure()`
1009         * to keep its PHP out of opcache on the front-end GET hot path. It still
1010         * loads on admin, cron, POST, and WP-CLI requests, and on `rest_api_init`
1011         * for REST: a REST request can't be identified yet at `plugins_loaded`
1012         * (this runs before `Config::on_plugins_loaded`, and `rest_api_init`
1013         * fires later), so it is initialized directly when that hook fires, while
1014         * a plain page view never fires it and so loads nothing.
1015         *
1016         * JITM stays eager (above): unlike Import, its `register()` adds a
1017         * `jetpack_sync_before_send_updated_option` filter that records the
1018         * `jetpack_last_plugin_sync` transient, and a Jetpack Sync send can fire
1019         * on a plain front-end GET â€” including the dedicated-sync `spawn-sync`
1020         * GET, which runs on `init` and exits before `rest_api_init`. Deferring
1021         * JITM would skip that bookkeeping and leave its message cache stale after
1022         * a plugin change, so it loads on every request as before.
1023         */
1024        if ( self::should_eager_load_packages() ) {
1025            $config->ensure( 'import' );
1026        } else {
1027            add_action(
1028                'rest_api_init',
1029                array( __CLASS__, 'configure_import_package' ),
1030                0
1031            );
1032        }
1033
1034        /*
1035         * The Stats and Stats Admin packages only do work when the Stats module
1036         * is active (the front-end tracking pixel) or on wp-admin, REST, cron,
1037         * POST, and WP-CLI requests: the Stats dashboard page, the stats /
1038         * stats-app REST endpoints (which the block editor also calls for
1039         * email-open rates), the transient-cleanup cron, the connection
1040         * package's package-version tracker (which runs on POSTs and reads the
1041         * `jetpack_package_versions` filter that Stats registers), and CLI
1042         * introspection such as the heartbeat inspector. On a plain front-end
1043         * GET page view with the module off they are inert: the pixel
1044         * short-circuits on `Stats\Main::should_track()` and every other entry
1045         * point only hooks rest_api_init, admin, cron, the POST-only tracker, or
1046         * is reached through WP-CLI.
1047         * Skip loading them â€” and eagerly constructing the Stats Admin REST
1048         * controller â€” on that hot path to keep their PHP out of opcache, but
1049         * keep loading them everywhere else exactly as before so the stats REST
1050         * permission mapping (view_stats, registered by Stats\Main), the
1051         * editor's stats-app calls, the cleanup cron, and the package-version
1052         * tracker are all unchanged.
1053         *
1054         * REST requests are not yet identifiable here (REST_REQUEST is defined
1055         * after plugins_loaded), so defer those to rest_api_init. Call the
1056         * package initializers directly rather than `$config->ensure()`: ensure()
1057         * only flags a feature for `Config::on_plugins_loaded()` (plugins_loaded
1058         * priority 2), which has already run by the time rest_api_init fires.
1059         * Priority 0 runs before each package's own priority-10 route
1060         * registration, so their routes still register within the same dispatch.
1061         * A plain page view never fires rest_api_init, so the packages stay
1062         * unloaded there. See JETPACK-1747.
1063         */
1064        $is_post_request = isset( $_SERVER['REQUEST_METHOD'] ) && 'POST' === $_SERVER['REQUEST_METHOD'];
1065        $is_wp_cli       = defined( 'WP_CLI' ) && WP_CLI;
1066
1067        if ( self::is_module_active( 'stats' ) || is_admin() || wp_doing_cron() || $is_post_request || $is_wp_cli ) {
1068            $config->ensure( 'stats' );
1069            $config->ensure( 'stats_admin' );
1070        } else {
1071            add_action(
1072                'rest_api_init',
1073                static function () {
1074                    if ( class_exists( 'Automattic\Jetpack\Stats\Main' ) ) {
1075                        \Automattic\Jetpack\Stats\Main::init();
1076                    }
1077                    if ( class_exists( 'Automattic\Jetpack\Stats_Admin\Main' ) ) {
1078                        \Automattic\Jetpack\Stats_Admin\Main::init();
1079                    }
1080                },
1081                0
1082            );
1083        }
1084
1085        // Stats v2 (WOOA7S-1595). Unlike Stats above it cannot be deferred when enabled â€” see
1086        // Analytics::init() for why.
1087        if ( self::is_premium_analytics_enabled() ) {
1088            \Automattic\Jetpack\PremiumAnalytics\Analytics::init();
1089            if ( class_exists( 'Automattic\Jetpack\WooCommerceStats\Analytics_Dashboard' ) ) {
1090                \Automattic\Jetpack\WooCommerceStats\Analytics_Dashboard::init();
1091            }
1092        }
1093
1094        // Outside the check above on purpose â€” see Enablement_Setting. Deferred like Stats, to keep
1095        // the autoload off the front-end hot path.
1096        add_action( 'rest_api_init', array( __CLASS__, 'register_premium_analytics_enablement_setting' ), 0 );
1097
1098        $config->ensure(
1099            'connection',
1100            array(
1101                'slug' => 'jetpack',
1102                'name' => 'Jetpack',
1103            )
1104        );
1105
1106        // Identity crisis package.
1107        $config->ensure(
1108            'identity_crisis',
1109            array(
1110                'slug'       => 'jetpack',
1111                'admin_page' => '/wp-admin/admin.php?page=jetpack',
1112            )
1113        );
1114
1115        $config->ensure( 'search' );
1116
1117        if ( ! $this->connection_manager ) {
1118            $this->connection_manager = new Connection_Manager( 'jetpack' );
1119        }
1120
1121        $modules = new Automattic\Jetpack\Modules();
1122        if ( $modules->is_active( 'publicize' ) && $this->connection_manager->has_connected_user() ) {
1123            $config->ensure( 'publicize' );
1124        }
1125
1126        add_action( 'jetpack_initialize_tracking', array( $this, 'initialize_tracking' ) );
1127
1128        /*
1129         * Load things that should only be in Network Admin.
1130         *
1131         * For now blow away everything else until a more full
1132         * understanding of what is needed at the network level is
1133         * available
1134         */
1135        if ( is_multisite() ) {
1136            $network = Jetpack_Network::init();
1137            $network->set_connection( $this->connection_manager );
1138        }
1139
1140        $is_connection_ready = self::is_connection_ready();
1141
1142        if ( $is_connection_ready ) {
1143            add_action( 'login_form_jetpack_json_api_authorization', array( $this, 'login_form_json_api_authorization' ) );
1144            $this->run_initialize_tracking_action();
1145
1146            Jetpack_Heartbeat::init();
1147            if ( self::is_module_active( 'stats' ) && self::is_module_active( 'search' ) ) {
1148                require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-search-performance-logger.php';
1149                Jetpack_Search_Performance_Logger::init();
1150            }
1151        } else {
1152            add_action( 'jetpack_agreed_to_terms_of_service', array( $this, 'run_initialize_tracking_action' ) );
1153            add_action( 'rest_api_init', array( $this, 'run_initialize_tracking_action' ) );
1154            add_filter(
1155                'xmlrpc_methods',
1156                function ( $methods ) {
1157                    $this->run_initialize_tracking_action();
1158                    return $methods;
1159                },
1160                1
1161            );
1162        }
1163
1164        // Initialize remote file upload request handlers.
1165        $this->add_remote_request_handlers();
1166
1167        /*
1168         * Enable enhanced handling of previewing sites in Calypso
1169         */
1170        if ( $is_connection_ready ) {
1171            require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.jetpack-iframe-embed.php';
1172            add_action( 'init', array( 'Jetpack_Iframe_Embed', 'init' ), 9, 0 );
1173            add_action( 'rest_api_init', array( $this, 'maybe_initialize_rest_jsonapi' ) );
1174        }
1175    }
1176
1177    /**
1178     * Runs on plugins_loaded. Use this to add code that needs to be executed later than other
1179     * initialization code.
1180     *
1181     * @action plugins_loaded
1182     */
1183    public function late_initialization() {
1184        add_action( 'after_setup_theme', array( 'Jetpack', 'load_modules' ), -2 );
1185
1186        /*
1187         * My Jetpack is a wp-admin dashboard. Its Initializer::init() only wires
1188         * up admin-menu, admin_init, and rest_api_init surfaces â€” and eagerly
1189         * loads every product class (backup, boost, protect, â€¦) just to register
1190         * admin plugin-action links â€” so none of it is needed on a plain
1191         * front-end GET page view. (The pieces that do immediate work, e.g.
1192         * Connection REST authentication and Licensing, are already initialized
1193         * unconditionally in Jetpack's constructor, so they are unaffected here.)
1194         *
1195         * Gate the call to the request types where My Jetpack actually does work.
1196         * REST can't be detected yet at plugins_loaded, so initialize on
1197         * rest_api_init for that branch; a plain page view never fires it, so My
1198         * Jetpack stays unloaded there.
1199         */
1200        if ( self::should_eager_load_packages() ) {
1201            My_Jetpack_Initializer::init();
1202        } else {
1203            add_action( 'rest_api_init', array( My_Jetpack_Initializer::class, 'init' ), 0 );
1204        }
1205
1206        Jetpack_SEO_Initializer::init();
1207
1208        if ( ( new Modules() )->is_active( 'podcast' ) ) {
1209            Podcast::init();
1210        } else {
1211            add_action(
1212                'jetpack_register_gutenberg_extensions',
1213                static function () {
1214                    Jetpack_Gutenberg::set_extension_unavailable( 'podcast-episode', 'missing_module', array( 'module' => 'podcast' ) );
1215                }
1216            );
1217        }
1218
1219        /*
1220         * Initialize Boost Speed Score. It only does work on REST requests (the
1221         * dashboard speed-score endpoints) and on a few Jetpack Boost lifecycle
1222         * actions, so defer constructing it â€” and loading the boost-speed-score
1223         * package classes â€” until one of those hooks actually fires instead of on
1224         * every request. Priority 0 ensures the object's own callbacks (added in
1225         * its constructor at the default priority) still run for the firing hook.
1226         */
1227        $initialize_speed_score = static function () {
1228            static $initialized = false;
1229            if ( $initialized ) {
1230                return;
1231            }
1232            $initialized = true;
1233            new Speed_Score( array(), 'jetpack-dashboard' );
1234        };
1235        add_action( 'rest_api_init', $initialize_speed_score, 0 );
1236        add_action( 'jetpack_boost_deactivate', $initialize_speed_score, 0 );
1237        add_action( 'jetpack_boost_environment_changed', $initialize_speed_score, 0 );
1238        add_action( 'handle_environment_change', $initialize_speed_score, 0 );
1239
1240        /**
1241         * Fires when Jetpack is fully loaded and ready. This is the point where it's safe
1242         * to instantiate classes from packages and namespaces that are managed by the Jetpack Autoloader.
1243         *
1244         * @since 8.1.0
1245         *
1246         * @param Jetpack $jetpack the main plugin class object.
1247         */
1248        do_action( 'jetpack_loaded', $this );
1249
1250        add_filter( 'map_meta_cap', array( $this, 'jetpack_custom_caps' ), 1, 2 );
1251    }
1252
1253    /**
1254     * This is ported over from the manage module, which has been deprecated and baked in here.
1255     */
1256    public function add_wpcom_to_allowed_redirect_hosts() {
1257        add_filter( 'allowed_redirect_hosts', array( $this, 'allow_wpcom_domain' ) );
1258    }
1259
1260    /**
1261     * Return $domains, with 'wordpress.com' appended.
1262     * This is ported over from the manage module, which has been deprecated and baked in here.
1263     *
1264     * @param array $domains Array of domains allowed for redirect.
1265     *
1266     * @return array
1267     */
1268    public function allow_wpcom_domain( $domains ) {
1269        if ( empty( $domains ) ) {
1270            $domains = array();
1271        }
1272        $domains[] = 'wordpress.com';
1273        return array_unique( $domains );
1274    }
1275
1276    /**
1277     * Redirect edit post links to Calypso.
1278     *
1279     * @deprecated since 13.9
1280     *
1281     * @param string $default_url Post edit URL.
1282     * @param int    $post_id Post ID.
1283     *
1284     * @return string
1285     */
1286    public function point_edit_post_links_to_calypso( $default_url, $post_id ) {
1287        _deprecated_function( __METHOD__, '13.9' );
1288
1289        $post = get_post( $post_id );
1290
1291        if ( empty( $post ) ) {
1292            return $default_url;
1293        }
1294
1295        $post_type = $post->post_type;
1296
1297        // Mapping the allowed CPTs on WordPress.com to corresponding paths in Calypso.
1298        // https://en.support.wordpress.com/custom-post-types/.
1299        $allowed_post_types = array(
1300            'post',
1301            'page',
1302            'jetpack-portfolio',
1303            'jetpack-testimonial',
1304        );
1305
1306        if ( ! in_array( $post_type, $allowed_post_types, true ) ) {
1307            return $default_url;
1308        }
1309
1310        return Redirect::get_url(
1311            'calypso-edit-' . $post_type,
1312            array(
1313                'path' => $post_id,
1314            )
1315        );
1316    }
1317
1318    /**
1319     * Redirect edit comment links to Calypso.
1320     *
1321     * @deprecated since 13.9
1322     *
1323     * @param string $url Comment edit URL.
1324     *
1325     * @return string
1326     */
1327    public function point_edit_comment_links_to_calypso( $url ) {
1328        _deprecated_function( __METHOD__, '13.9' );
1329
1330        // Take the `query` key value from the URL, and parse its parts to the $query_args. `amp;c` matches the comment ID.
1331        $query_args = null;
1332        wp_parse_str( wp_parse_url( $url, PHP_URL_QUERY ), $query_args );
1333
1334        return Redirect::get_url(
1335            'calypso-edit-comment',
1336            array(
1337                'path' => $query_args['amp;c'],
1338            )
1339        );
1340    }
1341
1342    /**
1343     * Extend Sync callables with Jetpack Plugin functions.
1344     *
1345     * @param array $callables list of callables.
1346     *
1347     * @return array list of callables.
1348     */
1349    public function filter_sync_callable_whitelist( $callables ) {
1350        // Jetpack Functions.
1351        $jetpack_callables = array(
1352            'single_user_site'         => array( 'Jetpack', 'is_single_user_site' ),
1353            'updates'                  => array( 'Jetpack', 'get_updates' ),
1354            'available_jetpack_blocks' => array( 'Jetpack_Gutenberg', 'get_availability' ), // Includes both Gutenberg blocks *and* plugins.
1355            'theme_styles'             => array( 'Automattic\\Jetpack\\Plugin\\Theme_Styles_Sync', 'get_theme_styles' ),
1356        );
1357        return array_merge( $callables, $jetpack_callables );
1358    }
1359
1360    /**
1361     * Extend Sync multisite callables with Jetpack Plugin functions.
1362     *
1363     * @param array $callables list of callables.
1364     *
1365     * @return array list of callables.
1366     */
1367    public function filter_sync_multisite_callable_whitelist( $callables ) {
1368
1369        // Jetpack Funtions.
1370        $jetpack_multisite_callables = array(
1371            'network_name'                        => array( 'Jetpack', 'network_name' ),
1372            'network_allow_new_registrations'     => array( 'Jetpack', 'network_allow_new_registrations' ),
1373            'network_add_new_users'               => array( 'Jetpack', 'network_add_new_users' ),
1374            'network_site_upload_space'           => array( 'Jetpack', 'network_site_upload_space' ),
1375            'network_upload_file_types'           => array( 'Jetpack', 'network_upload_file_types' ),
1376            'network_enable_administration_menus' => array( 'Jetpack', 'network_enable_administration_menus' ),
1377        );
1378        $callables                   = array_merge( $callables, $jetpack_multisite_callables );
1379
1380        return $callables;
1381    }
1382
1383    /**
1384     * If there are any stats that need to be pushed, but haven't been, push them now.
1385     */
1386    public function push_stats() {
1387        if ( ! empty( $this->stats ) ) {
1388            $this->do_stats( 'server_side' );
1389        }
1390    }
1391
1392    /**
1393     * Sets the Jetpack custom capabilities.
1394     *
1395     * @param string[] $caps    Array of the user's capabilities.
1396     * @param string   $cap     Capability name.
1397     */
1398    public function jetpack_custom_caps( $caps, $cap ) {
1399        switch ( $cap ) {
1400            case 'jetpack_manage_autoupdates':
1401                $caps = array(
1402                    'manage_options',
1403                    'update_plugins',
1404                );
1405                break;
1406            case 'jetpack_network_admin_page':
1407            case 'jetpack_network_settings_page':
1408                $caps = array( 'manage_network_plugins' );
1409                break;
1410            case 'jetpack_network_sites_page':
1411                $caps = array( 'manage_sites' );
1412                break;
1413            case 'jetpack_admin_page':
1414                $is_offline_mode = ( new Status() )->is_offline_mode();
1415                if ( $is_offline_mode ) {
1416                    $caps = array( 'manage_options' );
1417                    break;
1418                } else {
1419                    $caps = array( 'edit_posts' );
1420                }
1421                break;
1422        }
1423        return $caps;
1424    }
1425
1426    /**
1427     * Register assets for use in various modules and the Jetpack admin page.
1428     *
1429     * @uses wp_script_is, wp_register_script, plugins_url
1430     * @action wp_loaded
1431     * @return void
1432     */
1433    public function register_assets() {
1434        if ( ! wp_script_is( 'jetpack-gallery-settings', 'registered' ) ) {
1435            wp_register_script(
1436                'jetpack-gallery-settings',
1437                Assets::get_file_url_for_environment( '_inc/build/gallery-settings.min.js', '_inc/gallery-settings.js' ),
1438                array( 'media-views' ),
1439                '20121225',
1440                true
1441            );
1442        }
1443
1444        if ( ! wp_script_is( 'jetpack-twitter-timeline', 'registered' ) ) {
1445            wp_register_script(
1446                'jetpack-twitter-timeline',
1447                Assets::get_file_url_for_environment( '_inc/build/twitter-timeline.min.js', '_inc/twitter-timeline.js' ),
1448                array(),
1449                '4.0.0',
1450                true
1451            );
1452        }
1453
1454        if ( ! wp_script_is( 'jetpack-facebook-embed', 'registered' ) ) {
1455            wp_register_script(
1456                'jetpack-facebook-embed',
1457                Assets::get_file_url_for_environment( '_inc/build/facebook-embed.min.js', '_inc/facebook-embed.js' ),
1458                array(),
1459                JETPACK__VERSION,
1460                true
1461            );
1462
1463            /** This filter is documented in modules/sharedaddy/sharing-sources.php */
1464            $fb_app_id = apply_filters( 'jetpack_sharing_facebook_app_id', '249643311490' );
1465            if ( ! is_numeric( $fb_app_id ) ) {
1466                $fb_app_id = '';
1467            }
1468            wp_localize_script(
1469                'jetpack-facebook-embed',
1470                'jpfbembed',
1471                array(
1472                    'appid'  => $fb_app_id,
1473                    'locale' => $this->get_locale(),
1474                )
1475            );
1476        }
1477
1478        /**
1479         * As jetpack_register_genericons is by default fired off a hook,
1480         * the hook may have already fired by this point.
1481         * So, let's just trigger it manually.
1482         */
1483        require_once JETPACK__PLUGIN_DIR . '_inc/genericons.php';
1484        jetpack_register_genericons();
1485
1486        /**
1487         * Register the social logos
1488         */
1489        require_once JETPACK__PLUGIN_DIR . '_inc/social-logos.php';
1490        jetpack_register_social_logos();
1491    }
1492
1493    /**
1494     * Guess locale from language code.
1495     *
1496     * @param string $lang Language code.
1497     * @return string|bool
1498     */
1499    public function guess_locale_from_lang( $lang ) {
1500        if ( 'en' === $lang || 'en_US' === $lang || ! $lang ) {
1501            return 'en_US';
1502        }
1503
1504        if ( ! class_exists( 'GP_Locales' ) ) {
1505            if ( ! defined( 'JETPACK__GLOTPRESS_LOCALES_PATH' ) || ! file_exists( JETPACK__GLOTPRESS_LOCALES_PATH ) ) {
1506                return false;
1507            }
1508
1509            require JETPACK__GLOTPRESS_LOCALES_PATH;
1510        }
1511
1512        if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {
1513            // WP.com: get_locale() returns 'it'.
1514            $locale = GP_Locales::by_slug( $lang );
1515        } else {
1516            // Jetpack: get_locale() returns 'it_IT';.
1517            $locale = GP_Locales::by_field( 'facebook_locale', $lang );
1518        }
1519
1520        if ( ! $locale ) {
1521            return false;
1522        }
1523
1524        if ( empty( $locale->facebook_locale ) ) {
1525            if ( empty( $locale->wp_locale ) ) {
1526                return false;
1527            } else {
1528                // Facebook SDK is smart enough to fall back to en_US if a
1529                // locale isn't supported. Since supported Facebook locales
1530                // can fall out of sync, we'll attempt to use the known
1531                // wp_locale value and rely on said fallback.
1532                return $locale->wp_locale;
1533            }
1534        }
1535
1536        return $locale->facebook_locale;
1537    }
1538
1539    /**
1540     * Get the locale.
1541     *
1542     * @return string|bool
1543     */
1544    public function get_locale() {
1545        $locale = $this->guess_locale_from_lang( get_locale() );
1546
1547        if ( ! $locale ) {
1548            $locale = 'en_US';
1549        }
1550
1551        return $locale;
1552    }
1553
1554    /**
1555     * Return the network_site_url so that .com knows what network this site is a part of.
1556     *
1557     * @return string
1558     */
1559    public function jetpack_main_network_site_option() {
1560        return network_site_url();
1561    }
1562    /**
1563     * Network Name.
1564     */
1565    public static function network_name() {
1566        global $current_site;
1567        return $current_site->site_name;
1568    }
1569    /**
1570     * Does the network allow new user and site registrations.
1571     *
1572     * @return string
1573     */
1574    public static function network_allow_new_registrations() {
1575        return ( in_array( get_site_option( 'registration' ), array( 'none', 'user', 'blog', 'all' ), true ) ? get_site_option( 'registration' ) : 'none' );
1576    }
1577    /**
1578     * Does the network allow admins to add new users.
1579     *
1580     * @return bool
1581     */
1582    public static function network_add_new_users() {
1583        return (bool) get_site_option( 'add_new_users' );
1584    }
1585    /**
1586     * File upload psace left per site in MB.
1587     *  -1 means NO LIMIT.
1588     *
1589     * @return int
1590     */
1591    public static function network_site_upload_space() {
1592        // value in MB.
1593        return ( get_site_option( 'upload_space_check_disabled' ) ? -1 : get_space_allowed() );
1594    }
1595
1596    /**
1597     * Network allowed file types.
1598     *
1599     * @return string
1600     */
1601    public static function network_upload_file_types() {
1602        return get_site_option( 'upload_filetypes', 'jpg jpeg png gif' );
1603    }
1604
1605    /**
1606     * Maximum file upload size set by the network.
1607     *
1608     * @return int
1609     */
1610    public static function network_max_upload_file_size() {
1611        // value in KB.
1612        return get_site_option( 'fileupload_maxk', 300 );
1613    }
1614
1615    /**
1616     * Lets us know if a site allows admins to manage the network.
1617     *
1618     * @return array
1619     */
1620    public static function network_enable_administration_menus() {
1621        return get_site_option( 'menu_items' );
1622    }
1623
1624    /**
1625     * If a user has been promoted to or demoted from admin, we need to clear the
1626     * jetpack_other_linked_admins transient.
1627     *
1628     * @since 4.3.2
1629     * @since 4.4.0  $old_roles is null by default and if it's not passed, the transient is cleared.
1630     *
1631     * @param int    $user_id   The user ID whose role changed.
1632     * @param string $role      The new role.
1633     * @param array  $old_roles An array of the user's previous roles.
1634     */
1635    public function maybe_clear_other_linked_admins_transient( $user_id, $role, $old_roles = null ) {
1636        if ( 'administrator' === $role
1637            || ( is_array( $old_roles ) && in_array( 'administrator', $old_roles, true ) )
1638            || $old_roles === null
1639        ) {
1640            delete_transient( 'jetpack_other_linked_admins' );
1641        }
1642    }
1643
1644    /**
1645     * Checks to see if there are any other users available to become primary
1646     * Users must both:
1647     * - Be linked to wpcom
1648     * - Be an admin
1649     *
1650     * @return mixed False if no other users are linked, Int if there are.
1651     */
1652    public static function get_other_linked_admins() {
1653        $other_linked_users = get_transient( 'jetpack_other_linked_admins' );
1654
1655        if ( false === $other_linked_users ) {
1656            $admins = get_users( array( 'role' => 'administrator' ) );
1657            if ( count( $admins ) > 1 ) {
1658                $available = array();
1659                foreach ( $admins as $admin ) {
1660                    if ( self::connection()->is_user_connected( $admin->ID ) ) {
1661                        $available[] = $admin->ID;
1662                    }
1663                }
1664
1665                $count_connected_admins = count( $available );
1666                if ( count( $available ) > 1 ) {
1667                    $other_linked_users = $count_connected_admins;
1668                } else {
1669                    $other_linked_users = 0;
1670                }
1671            } else {
1672                $other_linked_users = 0;
1673            }
1674
1675            set_transient( 'jetpack_other_linked_admins', $other_linked_users, HOUR_IN_SECONDS );
1676        }
1677
1678        return ( 0 === $other_linked_users ) ? false : $other_linked_users;
1679    }
1680
1681    /**
1682     * Return whether we are dealing with a multi network setup or not.
1683     * The reason we are type casting this is because we want to avoid the situation where
1684     * the result is false since when is_main_network_option return false it cases
1685     * the rest the get_option( 'jetpack_is_multi_network' ); to return the value that is set in the
1686     * database which could be set to anything as opposed to what this function returns.
1687     *
1688     * @return boolean
1689     */
1690    public function is_main_network_option() {
1691        // returns either an '1' or an empty string.
1692        return (string) (bool) self::is_multi_network();
1693    }
1694
1695    /**
1696     * Return true if we are with multi-site or multi-network false if we are dealing with single site.
1697     *
1698     * @return string
1699     */
1700    public function is_multisite() {
1701        return (string) (bool) is_multisite();
1702    }
1703
1704    /**
1705     * Implemented since there is no core is multi network function
1706     * Right now there is no way to tell if we which network is the dominant network on the system
1707     *
1708     * @since  3.3
1709     * @return boolean
1710     */
1711    public static function is_multi_network() {
1712        global  $wpdb;
1713
1714        // if we don't have a multi site setup no need to do any more.
1715        if ( ! is_multisite() ) {
1716            return false;
1717        }
1718
1719        $num_sites = $wpdb->get_var( "SELECT COUNT(*) FROM {$wpdb->site}" );
1720        if ( $num_sites > 1 ) {
1721            return true;
1722        } else {
1723            return false;
1724        }
1725    }
1726
1727    /**
1728     * Get back if the current site is single user site.
1729     *
1730     * @return bool
1731     */
1732    public static function is_single_user_site() {
1733        global $wpdb;
1734
1735        $some_users = get_transient( 'jetpack_is_single_user' );
1736        if ( false === $some_users ) {
1737            $some_users = $wpdb->get_var( "SELECT COUNT(*) FROM (SELECT user_id FROM $wpdb->usermeta WHERE meta_key = '{$wpdb->prefix}capabilities' LIMIT 2) AS someusers" );
1738            set_transient( 'jetpack_is_single_user', (int) $some_users, 12 * HOUR_IN_SECONDS );
1739        }
1740        return 1 === (int) $some_users;
1741    }
1742
1743    /**
1744     * Returns true if the site has file write access false otherwise.
1745     *
1746     * @return string ( '1' | '0' )
1747     **/
1748    public static function file_system_write_access() {
1749        if ( ! function_exists( 'get_filesystem_method' ) ) {
1750            require_once ABSPATH . 'wp-admin/includes/file.php';
1751        }
1752
1753        require_once ABSPATH . 'wp-admin/includes/template.php';
1754
1755        $filesystem_method = get_filesystem_method();
1756        if ( 'direct' === $filesystem_method ) {
1757            return 1;
1758        }
1759
1760        ob_start();
1761        $filesystem_credentials_are_stored = request_filesystem_credentials( self_admin_url() );
1762        ob_end_clean();
1763        if ( $filesystem_credentials_are_stored ) {
1764            return 1;
1765        }
1766        return 0;
1767    }
1768
1769    // phpcs:disable WordPress.WP.CapitalPDangit.MisspelledInComment
1770    /**
1771     * Gets updates and stores in jetpack_updates.
1772     *
1773     * The jetpack_updates option is saved in the following schema:
1774     *
1775     * array (
1776     *      'plugins'                       => (int) Number of plugin updates available.
1777     *      'themes'                        => (int) Number of theme updates available.
1778     *      'wordpress'                     => (int) Number of WordPress core updates available.
1779     *      'translations'                  => (int) Number of translation updates available.
1780     *      'total'                         => (int) Total of all available updates.
1781     *      'wp_update_version'             => (string) The latest available version of WordPress, only present if a WordPress update is needed.
1782     * )
1783     *
1784     * @return array
1785     */
1786    public static function get_updates() {
1787        $updates     = array();
1788        $update_data = wp_get_update_data();
1789
1790        // Stores the individual update counts as well as the total count.
1791        if ( isset( $update_data['counts'] ) ) {
1792            $updates = $update_data['counts'];
1793        }
1794
1795        // If we need to update WordPress core, let's find the latest version number.
1796        if ( ! empty( $updates['wordpress'] ) ) {
1797            $cur = get_preferred_from_update_core();
1798            if ( isset( $cur->response ) && 'upgrade' === $cur->response ) {
1799                $updates['wp_update_version'] = $cur->current;
1800            }
1801        }
1802        return $updates;
1803    }
1804    // phpcs:enable WordPress.WP.CapitalPDangit.MisspelledInComment
1805
1806    /**
1807     * Get update details for core, plugins, and themes.
1808     *
1809     * @return array
1810     */
1811    public static function get_update_details() {
1812        $update_details = array(
1813            'update_core'    => get_site_transient( 'update_core' ),
1814            'update_plugins' => get_site_transient( 'update_plugins' ),
1815            'update_themes'  => get_site_transient( 'update_themes' ),
1816        );
1817        return $update_details;
1818    }
1819
1820    /**
1821     * Is Jetpack active?
1822     * The method only checks if there's an existing token for the master user. It doesn't validate the token.
1823     *
1824     * This method is deprecated since 9.6.0. Please use one of the methods provided by the Manager class in the Connection package,
1825     * or Jetpack::is_connection_ready if you want to know when the Jetpack plugin starts considering the connection ready to be used.
1826     *
1827     * Since this method has a wide spread use, we decided not to throw any deprecation warnings for now.
1828     *
1829     * @deprecated 9.6.0
1830     *
1831     * @return bool
1832     */
1833    public static function is_active() {
1834        return self::connection()->has_connected_owner();
1835    }
1836
1837    /**
1838     * Returns true if the current site is connected to WordPress.com and has the minimum requirements to enable Jetpack UI
1839     *
1840     * This method was introduced just before the release of the possibility to use Jetpack without a user connection, while
1841     * it was available only when no_user_testing_mode was enabled. In the near future, this will return is_connected for all
1842     * users and this option will be available by default for everybody.
1843     *
1844     * @since 9.6.0
1845     * @since 9.7.0 returns is_connected in all cases and adds filter to the returned value
1846     *
1847     * @return bool is the site connection ready to be used?
1848     */
1849    public static function is_connection_ready() {
1850        /**
1851         * Allows filtering whether the connection is ready to be used. If true, this will enable the Jetpack UI and modules
1852         *
1853         * Modules will be enabled depending on the connection status and if the module requires a connection or user connection.
1854         *
1855         * @since 9.7.0
1856         *
1857         * @param bool                                  $is_connection_ready Is the connection ready?
1858         * @param Automattic\Jetpack\Connection\Manager $connection_manager Instance of the Manager class, can be used to check the connection status.
1859         */
1860        return apply_filters( 'jetpack_is_connection_ready', self::connection()->is_connected(), self::connection() );
1861    }
1862
1863    /**
1864     * Determines reason for Jetpack offline mode.
1865     */
1866    public static function development_mode_trigger_text() {
1867        $status = new Status();
1868
1869        if ( ! $status->is_offline_mode() ) {
1870            return __( 'Jetpack is not in Offline Mode.', 'jetpack' );
1871        }
1872
1873        if ( defined( 'JETPACK_DEV_DEBUG' ) && JETPACK_DEV_DEBUG ) {
1874            $notice = __( 'The JETPACK_DEV_DEBUG constant is defined in wp-config.php or elsewhere.', 'jetpack' );
1875        } elseif ( defined( 'WP_LOCAL_DEV' ) && WP_LOCAL_DEV ) {
1876            $notice = __( 'The WP_LOCAL_DEV constant is defined in wp-config.php or elsewhere.', 'jetpack' );
1877        } elseif ( $status->is_local_site() ) {
1878            $notice = __( 'The site URL is a known local development environment URL (e.g. http://localhost).', 'jetpack' );
1879        } elseif ( get_option( 'jetpack_offline_mode' ) ) {
1880            $notice = __( 'The jetpack_offline_mode option is set to true.', 'jetpack' );
1881        } else {
1882            $notice = __( 'The jetpack_offline_mode filter is set to true.', 'jetpack' );
1883        }
1884
1885        return $notice;
1886    }
1887    /**
1888     * Get Jetpack offline mode notice text and notice class.
1889     *
1890     * Mirrors the checks made in Automattic\Jetpack\Status->is_offline_mode
1891     */
1892    public static function show_development_mode_notice() {
1893        if ( ( new Status() )->is_offline_mode() ) {
1894            $notice = sprintf(
1895                /* translators: %s is a URL */
1896                __( 'In <a href="%s" target="_blank">Offline Mode</a>:', 'jetpack' ),
1897                esc_url( Redirect::get_url( 'jetpack-support-development-mode' ) )
1898            );
1899
1900            $notice .= ' ' . self::development_mode_trigger_text();
1901
1902            echo '<div class="updated" style="border-color: #f0821e;"><p>' . $notice . '</p></div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- All provided text.
1903        }
1904
1905        // Throw up a notice if using a development version and as for feedback.
1906        if ( self::is_development_version() ) {
1907            /* translators: %s is a URL */
1908            $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' ) ) );
1909
1910            echo '<div class="updated" style="border-color: #f0821e;"><p>' . $notice . '</p></div>'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- All provided text.
1911        }
1912    }
1913
1914    /**
1915     * Whether Jetpack's version maps to a public release, or a development version.
1916     */
1917    public static function is_development_version() {
1918        /**
1919         * Allows filtering whether this is a development version of Jetpack.
1920         *
1921         * This filter is especially useful for tests.
1922         *
1923         * @since 4.3.0
1924         *
1925         * @param bool $development_version Is this a develoment version of Jetpack?
1926         */
1927        return (bool) apply_filters(
1928            'jetpack_development_version',
1929            ! preg_match( '/^\d+(\.\d+)+$/', Constants::get_constant( 'JETPACK__VERSION' ) )
1930        );
1931    }
1932
1933    /**
1934     * Get the wpcom email of the current|specified connected user.
1935     *
1936     * @param null|int $user_id User ID or will use get_current_user_id if null.
1937     */
1938    public static function get_connected_user_email( $user_id = null ) {
1939        if ( ! $user_id ) {
1940            $user_id = get_current_user_id();
1941        }
1942
1943        $xml = new Jetpack_IXR_Client(
1944            array(
1945                'user_id' => $user_id,
1946            )
1947        );
1948        $xml->query( 'wpcom.getUserEmail' );
1949        if ( ! $xml->isError() ) {
1950            return $xml->getResponse();
1951        }
1952        return false;
1953    }
1954
1955    /**
1956     * Get the wpcom email of the master user.
1957     */
1958    public static function get_master_user_email() {
1959        $master_user_id = Jetpack_Options::get_option( 'master_user' );
1960        if ( $master_user_id ) {
1961            return self::get_connected_user_email( $master_user_id );
1962        }
1963        return '';
1964    }
1965
1966    /**
1967     * Gets current user IP address.
1968     *
1969     * @param  bool $check_all_headers Check all headers? Default is `false`.
1970     *
1971     * @deprecated Jetpack 10.6
1972     *
1973     * @return string                  Current user IP address.
1974     */
1975    public static function current_user_ip( $check_all_headers = false ) {
1976        _deprecated_function( __METHOD__, 'jetpack-10.6', 'Automattic\\Jetpack\\Status\\Visitor::get_ip' );
1977
1978        return ( new Visitor() )->get_ip( $check_all_headers );
1979    }
1980
1981    /**
1982     * Loads the currently active modules.
1983     */
1984    public static function load_modules() {
1985        $status = new Status();
1986
1987        if (
1988            ! self::is_connection_ready()
1989            && ! $status->is_offline_mode()
1990            && (
1991                ! is_multisite()
1992                || ! get_site_option( 'jetpack_protect_active' )
1993            )
1994        ) {
1995            return;
1996        }
1997
1998        $version = Jetpack_Options::get_option( 'version' );
1999        if ( ! $version ) {
2000            $version     = JETPACK__VERSION . ':' . time();
2001            $old_version = $version;
2002            /** This action is documented in class.jetpack.php */
2003            do_action( 'updating_jetpack_version', $version, false );
2004            Jetpack_Options::update_options( compact( 'version', 'old_version' ) );
2005        }
2006        list( $version ) = explode( ':', $version );
2007
2008        $modules = array_filter( self::get_active_modules(), array( 'Jetpack', 'is_module' ) );
2009
2010        $modules_data = array();
2011
2012        // Don't load modules that have had "Major" changes since the stored version until they have been deactivated/reactivated through the lint check.
2013        if ( version_compare( $version, JETPACK__VERSION, '<' ) ) {
2014            $updated_modules = array();
2015            foreach ( $modules as $module ) {
2016                $modules_data[ $module ] = self::get_module( $module );
2017                if ( ! isset( $modules_data[ $module ]['changed'] ) ) {
2018                    continue;
2019                }
2020
2021                if ( version_compare( $modules_data[ $module ]['changed'], $version, '<=' ) ) {
2022                    continue;
2023                }
2024
2025                $updated_modules[] = $module;
2026            }
2027
2028            $modules = array_diff( $modules, $updated_modules );
2029        }
2030
2031        $is_site_connection = false;
2032
2033        if ( method_exists( self::connection(), 'is_site_connection' ) ) {
2034            $is_site_connection = self::connection()->is_site_connection();
2035        }
2036
2037        foreach ( $modules as $index => $module ) {
2038            // If we're in offline/site-connection mode, disable modules requiring a connection/user connection.
2039            if ( $status->is_offline_mode() || $is_site_connection ) {
2040                // Prime the pump if we need to.
2041                if ( empty( $modules_data[ $module ] ) ) {
2042                    $modules_data[ $module ] = self::get_module( $module );
2043                }
2044                // If the module requires a connection, but we're in local mode, don't include it.
2045                if ( $status->is_offline_mode() && $modules_data[ $module ]['requires_connection'] ) {
2046                    continue;
2047                }
2048
2049                if ( $is_site_connection && $modules_data[ $module ]['requires_user_connection'] ) {
2050                    continue;
2051                }
2052            }
2053
2054            if ( did_action( 'jetpack_module_loaded_' . $module ) ) {
2055                continue;
2056            }
2057
2058            if ( ! include_once self::get_module_path( $module ) ) { // phpcs:ignore WordPressVIPMinimum.Files.IncludingFile.NotAbsolutePath
2059                unset( $modules[ $index ] );
2060                self::update_active_modules( array_values( $modules ) );
2061                continue;
2062            }
2063
2064            /**
2065             * Fires when a specific module is loaded.
2066             * The dynamic part of the hook, $module, is the module slug.
2067             *
2068             * @since 1.1.0
2069             */
2070            do_action( 'jetpack_module_loaded_' . $module );
2071        }
2072
2073        /**
2074         * Fires when all the modules are loaded.
2075         *
2076         * @since 1.1.0
2077         */
2078        do_action( 'jetpack_modules_loaded' );
2079
2080        // Load module-specific code that is needed even when a module isn't active. Loaded here because code contained therein may need actions such as setup_theme.
2081        require_once JETPACK__PLUGIN_DIR . 'modules/module-extras.php';
2082    }
2083
2084    /**
2085     * Check if Jetpack's REST API compat file should be included
2086     *
2087     * @action plugins_loaded
2088     * @return void
2089     */
2090    public function check_rest_api_compat() {
2091        /**
2092         * Filters the list of REST API compat files to be included.
2093         *
2094         * @since 2.2.5
2095         *
2096         * @param array $args Array of REST API compat files to include.
2097         */
2098        $_jetpack_rest_api_compat_includes = apply_filters( 'jetpack_rest_api_compat', array() );
2099
2100        foreach ( $_jetpack_rest_api_compat_includes as $_jetpack_rest_api_compat_include ) {
2101            require_once $_jetpack_rest_api_compat_include;
2102        }
2103    }
2104
2105    /**
2106     * Gets all plugins currently active in values, regardless of whether they're
2107     * traditionally activated or network activated.
2108     *
2109     * @todo Store the result in core's object cache maybe?
2110     */
2111    public static function get_active_plugins() {
2112        // Older Connection copies can load first and lack this method.
2113        if ( ! method_exists( Heartbeat::class, 'get_active_plugins' ) ) {
2114            return array();
2115        }
2116
2117        return Heartbeat::get_active_plugins();
2118    }
2119
2120    /**
2121     * Gets and parses additional plugin data to send with the heartbeat data
2122     *
2123     * @since 3.8.1
2124     *
2125     * @return array Array of plugin data
2126     */
2127    public static function get_parsed_plugin_data() {
2128        if ( ! function_exists( 'get_plugins' ) ) {
2129            require_once ABSPATH . 'wp-admin/includes/plugin.php';
2130        }
2131        /** This filter is documented in wp-admin/includes/class-wp-plugins-list-table.php */
2132        $all_plugins    = apply_filters( 'all_plugins', get_plugins() );
2133        $active_plugins = self::get_active_plugins();
2134
2135        $plugins = array();
2136        foreach ( $all_plugins as $path => $plugin_data ) {
2137            $plugins[ $path ] = array(
2138                'is_active' => in_array( $path, $active_plugins, true ),
2139                'file'      => $path,
2140                'name'      => $plugin_data['Name'],
2141                'version'   => $plugin_data['Version'],
2142                'author'    => $plugin_data['Author'],
2143            );
2144        }
2145
2146        return $plugins;
2147    }
2148
2149    /**
2150     * Gets and parses theme data to send with the heartbeat data
2151     *
2152     * @since 3.8.1
2153     *
2154     * @return array Array of theme data
2155     */
2156    public static function get_parsed_theme_data() {
2157        $all_themes  = wp_get_themes( array( 'allowed' => true ) );
2158        $header_keys = array( 'Name', 'Author', 'Version', 'ThemeURI', 'AuthorURI', 'Status', 'Tags' );
2159
2160        $themes = array();
2161        foreach ( $all_themes as $slug => $theme_data ) {
2162            $theme_headers = array();
2163            foreach ( $header_keys as $header_key ) {
2164                $theme_headers[ $header_key ] = $theme_data->get( $header_key );
2165            }
2166
2167            $themes[ $slug ] = array(
2168                'is_active_theme' => wp_get_theme()->get_template() === $slug,
2169                'slug'            => $slug,
2170                'theme_root'      => $theme_data->get_theme_root_uri(),
2171                'parent'          => $theme_data->parent(),
2172                'headers'         => $theme_headers,
2173            );
2174        }
2175
2176        return $themes;
2177    }
2178
2179    /**
2180     * Checks whether a specific plugin is active.
2181     *
2182     * We don't want to store these in a static variable, in case
2183     * there are switch_to_blog() calls involved.
2184     *
2185     * @param string $plugin Plugin to check in 'folder/file.php` format.
2186     */
2187    public static function is_plugin_active( $plugin = 'jetpack/jetpack.php' ) {
2188        return in_array( $plugin, self::get_active_plugins(), true );
2189    }
2190
2191    /**
2192     * Check if Jetpack's Open Graph tags should be used.
2193     * If certain plugins are active, Jetpack's og tags are suppressed.
2194     *
2195     * @uses Jetpack::get_active_modules, add_filter, get_option, apply_filters
2196     * @action plugins_loaded
2197     * @return void
2198     */
2199    public function check_open_graph() {
2200        if ( in_array( 'publicize', self::get_active_modules(), true ) || in_array( 'sharedaddy', self::get_active_modules(), true ) ) {
2201            include_once JETPACK__PLUGIN_DIR . 'enhanced-open-graph.php';
2202            add_filter( 'jetpack_enable_open_graph', '__return_true', 0 );
2203        }
2204
2205        $active_plugins = self::get_active_plugins();
2206
2207        if ( ! empty( $active_plugins ) ) {
2208            foreach ( $this->open_graph_conflicting_plugins as $plugin ) {
2209                if ( in_array( $plugin, $active_plugins, true ) ) {
2210                    add_filter( 'jetpack_enable_open_graph', '__return_false', 99 );
2211                    break;
2212                }
2213            }
2214        }
2215
2216        /**
2217         * Allow the addition of Open Graph Meta Tags to all pages.
2218         *
2219         * @since 2.0.3
2220         *
2221         * @param bool false Should Open Graph Meta tags be added. Default to false.
2222         */
2223        if ( apply_filters( 'jetpack_enable_open_graph', false ) ) {
2224            require_once JETPACK__PLUGIN_DIR . 'functions.opengraph.php';
2225        }
2226    }
2227
2228    /**
2229     * Check if Jetpack's Twitter tags should be used.
2230     * If certain plugins are active, Jetpack's twitter tags are suppressed.
2231     *
2232     * @uses Jetpack::get_active_modules, add_filter, get_option, apply_filters
2233     * @action plugins_loaded
2234     * @return void
2235     */
2236    public function check_twitter_tags() {
2237
2238        $active_plugins = self::get_active_plugins();
2239
2240        if ( ! empty( $active_plugins ) ) {
2241            foreach ( $this->twitter_cards_conflicting_plugins as $plugin ) {
2242                if ( in_array( $plugin, $active_plugins, true ) ) {
2243                    add_filter( 'jetpack_disable_twitter_cards', '__return_true', 99 );
2244                    break;
2245                }
2246            }
2247        }
2248
2249        /**
2250         * Allow Twitter Card Meta tags to be disabled.
2251         *
2252         * @since 2.6.0
2253         *
2254         * @param bool true Should Twitter Card Meta tags be disabled. Default to true.
2255         */
2256        if ( ! apply_filters( 'jetpack_disable_twitter_cards', false ) ) {
2257            // @todo Remove this require once the deprecated Jetpack_Twitter_Cards wrapper has been removed.
2258            // Twitter Cards functionality now lives in the jetpack-post-media package (Automattic\Jetpack\Post_Media\Twitter_Cards).
2259            require_once JETPACK__PLUGIN_DIR . 'class.jetpack-twitter-cards.php';
2260        }
2261    }
2262
2263    /* Jetpack Options API */
2264
2265    /**
2266     * Gets the option names from Jetpack_Options.
2267     *
2268     * @param string $type Jetpack option type.
2269     *
2270     * @return array
2271     */
2272    public static function get_option_names( $type = 'compact' ) {
2273        return Jetpack_Options::get_option_names( $type );
2274    }
2275
2276    /**
2277     * Returns the requested option.
2278     *
2279     * Looks in jetpack_options or jetpack_$name as appropriate.
2280     *
2281     * @param string $name    Option name.
2282     * @param mixed  $default Default value.
2283     */
2284    public static function get_option( $name, $default = false ) {
2285        return Jetpack_Options::get_option( $name, $default );
2286    }
2287
2288    /**
2289     * Returns an array of all PHP files in the specified absolute path.
2290     * Equivalent to glob( "$absolute_path/*.php" ).
2291     *
2292     * @param string $absolute_path The absolute path of the directory to search.
2293     * @return array Array of absolute paths to the PHP files.
2294     */
2295    public static function glob_php( $absolute_path ) {
2296        return ( new Files() )->glob_php( $absolute_path );
2297    }
2298
2299    /**
2300     * Activate new modules.
2301     *
2302     * @param bool $redirect Should this function redirect after activation.
2303     *
2304     * @return void
2305     */
2306    public static function activate_new_modules( $redirect = false ) {
2307        if ( ! self::is_connection_ready() && ! ( new Status() )->is_offline_mode() ) {
2308            return;
2309        }
2310
2311        $jetpack_old_version = Jetpack_Options::get_option( 'version' );
2312        if ( ! $jetpack_old_version ) {
2313            $old_version         = '1.1:' . time();
2314            $version             = $old_version;
2315            $jetpack_old_version = $version;
2316            /** This action is documented in class.jetpack.php */
2317            do_action( 'updating_jetpack_version', $version, false );
2318            Jetpack_Options::update_options( compact( 'version', 'old_version' ) );
2319        }
2320
2321        list( $jetpack_version ) = explode( ':', $jetpack_old_version );
2322
2323        if ( version_compare( JETPACK__VERSION, $jetpack_version, '<=' ) ) {
2324            return;
2325        }
2326
2327        $active_modules     = self::get_active_modules();
2328        $reactivate_modules = array();
2329        foreach ( $active_modules as $active_module ) {
2330            $module = self::get_module( $active_module );
2331            if ( ! isset( $module['changed'] ) ) {
2332                continue;
2333            }
2334
2335            if ( version_compare( $module['changed'], $jetpack_version, '<=' ) ) {
2336                continue;
2337            }
2338
2339            $reactivate_modules[] = $active_module;
2340            self::deactivate_module( $active_module );
2341        }
2342
2343        $new_version = JETPACK__VERSION . ':' . time();
2344        /** This action is documented in class.jetpack.php */
2345        do_action( 'updating_jetpack_version', $new_version, $jetpack_old_version );
2346        Jetpack_Options::update_options(
2347            array(
2348                'version'     => $new_version,
2349                'old_version' => $jetpack_old_version,
2350            )
2351        );
2352
2353        self::state( 'message', 'modules_activated' );
2354
2355        self::activate_default_modules( $jetpack_version, JETPACK__VERSION, $reactivate_modules, $redirect );
2356
2357        if ( $redirect ) {
2358            $page = 'jetpack'; // make sure we redirect to either settings or the jetpack page.
2359            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.
2360                $page = sanitize_text_field( wp_unslash( $_GET['page'] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- we're not changing the site.
2361            }
2362            wp_safe_redirect( self::admin_url( 'page=' . rawurlencode( $page ) ) );
2363            exit( 0 );
2364        }
2365    }
2366
2367    /**
2368     * List available Jetpack modules. Simply lists .php files in /modules/.
2369     * Make sure to tuck away module "library" files in a sub-directory.
2370     *
2371     * @param bool|string $min_version Only return modules introduced in this version or later. Default is false, do not filter.
2372     * @param bool|string $max_version Only return modules introduced before this version. Default is false, do not filter.
2373     * @param bool|null   $requires_connection Pass a boolean value to only return modules that require (or do not require) a connection.
2374     * @param bool|null   $requires_user_connection Pass a boolean value to only return modules that require (or do not require) a user connection.
2375     *
2376     * @return array $modules Array of module slugs
2377     */
2378    public static function get_available_modules( $min_version = false, $max_version = false, $requires_connection = null, $requires_user_connection = null ) {
2379        return ( new Modules() )->get_available( $min_version, $max_version, $requires_connection, $requires_user_connection );
2380    }
2381
2382    /**
2383     * Get default modules loaded on activation.
2384     *
2385     * @param bool|string $min_version Only return modules introduced in this version or later. Default is false, do not filter.
2386     * @param bool|string $max_version Only return modules introduced before this version. Default is false, do not filter.
2387     * @param bool|null   $requires_connection Pass a boolean value to only return modules that require (or do not require) a connection.
2388     * @param bool|null   $requires_user_connection Pass a boolean value to only return modules that require (or do not require) a user connection.
2389     *
2390     * @return array $modules Array of module slugs
2391     */
2392    public static function get_default_modules( $min_version = false, $max_version = false, $requires_connection = null, $requires_user_connection = null ) {
2393        $return = array();
2394
2395        foreach ( self::get_available_modules( $min_version, $max_version, $requires_connection, $requires_user_connection ) as $module ) {
2396            $module_data = self::get_module( $module );
2397
2398            switch ( strtolower( $module_data['auto_activate'] ) ) {
2399                case 'yes':
2400                    $return[] = $module;
2401                    break;
2402                case 'public':
2403                    if ( Jetpack_Options::get_option( 'public' ) ) {
2404                        $return[] = $module;
2405                    }
2406                    break;
2407                case 'no':
2408                default:
2409                    break;
2410            }
2411        }
2412        if ( method_exists( Feature_Policy::class, 'ensure_hooks' ) ) {
2413            Feature_Policy::ensure_hooks();
2414        }
2415
2416        /**
2417         * Filters the array of default modules.
2418         *
2419         * @since 2.5.0
2420         *
2421         * @param array $return Array of default modules.
2422         * @param string $min_version Minimum version number required to use modules.
2423         * @param string $max_version Maximum version number required to use modules.
2424         * @param bool|null $requires_connection Value of the Requires Connection filter.
2425         * @param bool|null $requires_user_connection Value of the Requires User Connection filter.
2426         */
2427        return apply_filters( 'jetpack_get_default_modules', $return, $min_version, $max_version, $requires_connection, $requires_user_connection );
2428    }
2429
2430    /**
2431     * Checks activated modules during auto-activation to determine
2432     * if any of those modules are being deprecated.  If so, close
2433     * them out, and add any replacement modules.
2434     *
2435     * Runs at priority 99 by default.
2436     *
2437     * This is run late, so that it can still activate a module if
2438     * the new module is a replacement for another that the user
2439     * currently has active, even if something at the normal priority
2440     * would kibosh everything.
2441     *
2442     * @since 2.6
2443     * @uses jetpack_get_default_modules filter
2444     * @param array $modules Array of Jetpack modules.
2445     * @return array
2446     */
2447    public function handle_deprecated_modules( $modules ) {
2448        $deprecated_modules = array(
2449            'debug'                 => null,  // Closed out and moved to the debugger library.
2450            'wpcc'                  => 'sso', // Closed out in 2.6 -- SSO provides the same functionality.
2451            'gplus-authorship'      => null,  // Closed out in 3.2 -- Google dropped support.
2452            'minileven'             => null,  // Closed out in 8.3 -- Responsive themes are common now, and so is AMP.
2453            'lazy-images'           => null, // Closed out in 12.8 -- WordPress core now has native lazy loading.
2454            'enhanced-distribution' => null, // Closed out in 13.3 -- WP.com is winding down the firehose.
2455        );
2456
2457        // Don't activate SSO if they never completed activating WPCC.
2458        if ( self::is_module_active( 'wpcc' ) ) {
2459            $wpcc_options = Jetpack_Options::get_option( 'wpcc_options' );
2460            if ( empty( $wpcc_options ) || empty( $wpcc_options['client_id'] ) || empty( $wpcc_options['client_id'] ) ) {
2461                $deprecated_modules['wpcc'] = null;
2462            }
2463        }
2464
2465        foreach ( $deprecated_modules as $module => $replacement ) {
2466            if ( self::is_module_active( $module ) ) {
2467                self::deactivate_module( $module );
2468                if ( $replacement ) {
2469                    $modules[] = $replacement;
2470                }
2471            }
2472        }
2473
2474        return array_unique( $modules );
2475    }
2476
2477    /**
2478     * Checks activated plugins during auto-activation to determine
2479     * if any of those plugins are in the list with a corresponding module
2480     * that is not compatible with the plugin. The module will not be allowed
2481     * to auto-activate.
2482     *
2483     * @since 2.6
2484     * @uses jetpack_get_default_modules filter
2485     * @param array $modules Array of Jetpack modules.
2486     * @return array
2487     */
2488    public function filter_default_modules( $modules ) {
2489
2490        $active_plugins = self::get_active_plugins();
2491
2492        if ( ! empty( $active_plugins ) ) {
2493
2494            // For each module we'd like to auto-activate...
2495            foreach ( $modules as $key => $module ) {
2496                // If there are potential conflicts for it...
2497                if ( ! empty( $this->conflicting_plugins[ $module ] ) ) {
2498                    // For each potential conflict...
2499                    foreach ( $this->conflicting_plugins[ $module ] as $plugin ) {
2500                        // If that conflicting plugin is active...
2501                        if ( in_array( $plugin, $active_plugins, true ) ) {
2502                            // Remove that item from being auto-activated.
2503                            unset( $modules[ $key ] );
2504                        }
2505                    }
2506                }
2507            }
2508        }
2509
2510        // Special case to convert block setting to a block module.
2511        $block_key = array_search( 'blocks', $modules, true );
2512        if ( $block_key !== false ) { // Only care if 'blocks' made it through the previous filters.
2513            $block_option = get_option( 'jetpack_blocks_disabled', null );
2514            if ( $block_option ) {
2515                unset( $modules[ $block_key ] );
2516            }
2517        }
2518
2519        return $modules;
2520    }
2521
2522    /**
2523     * Extract a module's slug from its full path.
2524     *
2525     * @param string $file Full path to a file.
2526     *
2527     * @return string Module slug.
2528     */
2529    public static function get_module_slug( $file ) {
2530        return ( new Modules() )->get_slug( $file );
2531    }
2532
2533    /**
2534     * Generate a module's path from its slug.
2535     *
2536     * @param string $slug Module slug.
2537     */
2538    public static function get_module_path( $slug ) {
2539        return ( new Modules() )->get_path( $slug );
2540    }
2541
2542    /**
2543     * Load module data from module file. Headers differ from WordPress
2544     * plugin headers to avoid them being identified as standalone
2545     * plugins on the WordPress plugins page.
2546     *
2547     * @param string $module The module slug.
2548     */
2549    public static function get_module( $module ) {
2550        return ( new Modules() )->get( $module );
2551    }
2552
2553    /**
2554     * Like core's get_file_data implementation, but caches the result.
2555     *
2556     * @param string $file Absolute path to the file.
2557     * @param array  $headers List of headers, in the format array( 'HeaderKey' => 'Header Name' ).
2558     */
2559    public static function get_file_data( $file, $headers ) {
2560        return ( new Modules() )->get_file_data( $file, $headers );
2561    }
2562
2563    /**
2564     * Return translated module tag.
2565     *
2566     * @param string $tag Tag as it appears in each module heading.
2567     *
2568     * @return mixed
2569     */
2570    public static function translate_module_tag( $tag ) {
2571        return jetpack_get_module_i18n_tag( $tag );
2572    }
2573
2574    /**
2575     * Return module name translation. Uses matching string created in modules/module-headings.php.
2576     *
2577     * The module list is globbed from `modules/` at runtime, so a module can be listed with no
2578     * entry in that generated file. Fall back to the untranslated header rather than overwriting
2579     * it with the null `jetpack_get_module_i18n()` returns for an unknown slug.
2580     *
2581     * @since 3.9.2
2582     *
2583     * @param array $modules Array of Jetpack modules.
2584     *
2585     * @return array
2586     */
2587    public static function get_translated_modules( $modules ) {
2588        foreach ( $modules as $index => $module ) {
2589            $i18n_module = jetpack_get_module_i18n( $module['module'] );
2590            $name        = $i18n_module['name'] ?? null;
2591            $description = $i18n_module['description'] ?? null;
2592
2593            if ( null !== $name && isset( $module['name'] ) ) {
2594                $modules[ $index ]['name'] = $name;
2595            }
2596            if ( null !== $description && isset( $module['description'] ) ) {
2597                $modules[ $index ]['description']       = $description;
2598                $modules[ $index ]['short_description'] = $description;
2599            }
2600            if ( isset( $module['module_tags'] ) ) {
2601                $modules[ $index ]['module_tags'] = array_map( 'jetpack_get_module_i18n_tag', $module['module_tags'] );
2602            }
2603        }
2604        return $modules;
2605    }
2606
2607    /**
2608     * Get a list of activated modules as an array of module slugs.
2609     */
2610    public static function get_active_modules() {
2611        return ( new Modules() )->get_active();
2612    }
2613
2614    /**
2615     * Check whether or not a Jetpack module is active.
2616     *
2617     * @param string $module The slug of a Jetpack module.
2618     * @return bool
2619     *
2620     * @static
2621     */
2622    public static function is_module_active( $module ) {
2623        return ( new Modules() )->is_active( $module );
2624    }
2625
2626    /**
2627     * Is slug a valid module.
2628     *
2629     * @param string $module Module slug.
2630     *
2631     * @return bool
2632     */
2633    public static function is_module( $module ) {
2634        return ( new Modules() )->is_module( $module );
2635    }
2636
2637    /**
2638     * Catches PHP errors.  Must be used in conjunction with output buffering.
2639     *
2640     * @deprecated since 13.5
2641     * @param bool $catch True to start catching, False to stop.
2642     *
2643     * @static
2644     * @deprecated 13.5
2645     * @see \Automattic\Jetpack\Errors
2646     */
2647    public static function catch_errors( $catch ) {
2648        _deprecated_function( __METHOD__, '13.5' );
2649        // @phan-suppress-next-line PhanDeprecatedClass
2650        return ( new Errors() )->catch_errors( $catch );
2651    }
2652
2653    /**
2654     * Saves any generated PHP errors in ::state( 'php_errors', {errors} )
2655     *
2656     * @deprecated since 13.5
2657     */
2658    public static function catch_errors_on_shutdown() {
2659        _deprecated_function( __METHOD__, '13.5' );
2660        self::state( 'php_errors', self::alias_directories( ob_get_clean() ) );
2661    }
2662
2663    /**
2664     * Rewrite any string to make paths easier to read.
2665     *
2666     * Rewrites ABSPATH (eg `/home/jetpack/wordpress/`) to ABSPATH, and if WP_CONTENT_DIR
2667     * is located outside of ABSPATH, rewrites that to WP_CONTENT_DIR.
2668     *
2669     * @param string $string String to attempt rewrite.
2670     * @return mixed
2671     */
2672    public static function alias_directories( $string ) {
2673        // ABSPATH has a trailing slash.
2674        $string = str_replace( ABSPATH, 'ABSPATH/', $string );
2675        // WP_CONTENT_DIR does not have a trailing slash.
2676        $string = str_replace( WP_CONTENT_DIR, 'WP_CONTENT_DIR', $string );
2677
2678        return $string;
2679    }
2680
2681    /**
2682     * Activates default Jetpack modules.
2683     *
2684     * @param null|string $min_version Only return modules introduced in this version or later. Default is false, do not filter.
2685     * @param null|string $max_version Only return modules introduced before this version. Default is false, do not filter.
2686     * @param array       $other_modules Other modules to activate.
2687     * @param null|bool   $redirect Should there be a redirection after activation.
2688     * @param bool        $send_state_messages If a state message should be sent.
2689     * @param bool|null   $requires_connection Pass a boolean value to only return modules that require (or do not require) a connection.
2690     * @param bool|null   $requires_user_connection Pass a boolean value to only return modules that require (or do not require) a user connection.
2691     *
2692     * @return void
2693     */
2694    public static function activate_default_modules(
2695        $min_version = false,
2696        $max_version = false,
2697        $other_modules = array(),
2698        $redirect = null,
2699        $send_state_messages = null,
2700        $requires_connection = null,
2701        $requires_user_connection = null
2702    ) {
2703        $jetpack = self::init();
2704
2705        if ( $redirect === null ) {
2706            if (
2707                ( defined( 'REST_REQUEST' ) && REST_REQUEST )
2708            ||
2709                ( defined( 'XMLRPC_REQUEST' ) && XMLRPC_REQUEST )
2710            ||
2711                ( defined( 'WP_CLI' ) && WP_CLI )
2712            ||
2713                ( defined( 'DOING_CRON' ) && DOING_CRON )
2714            ||
2715                ( defined( 'DOING_AJAX' ) && DOING_AJAX )
2716            ) {
2717                $redirect = false;
2718            } elseif ( is_admin() ) {
2719                $redirect = true;
2720            } else {
2721                $redirect = false;
2722            }
2723        }
2724
2725        if ( $send_state_messages === null ) {
2726            $send_state_messages = current_user_can( 'jetpack_activate_modules' );
2727        }
2728
2729        $modules = self::get_default_modules( $min_version, $max_version, $requires_connection, $requires_user_connection );
2730        $modules = array_merge( $other_modules, $modules );
2731
2732        // Look for standalone plugins and disable if active.
2733
2734        $to_deactivate = array();
2735        foreach ( $modules as $module ) {
2736            if ( isset( $jetpack->plugins_to_deactivate[ $module ] ) ) {
2737                $to_deactivate[ $module ] = $jetpack->plugins_to_deactivate[ $module ];
2738            }
2739        }
2740
2741        $deactivated = array();
2742        foreach ( $to_deactivate as $module => $deactivate_us ) {
2743            foreach ( $deactivate_us as $i => $deactivate_me ) {
2744                list( $probable_file, $probable_title ) = $deactivate_me;
2745                if ( Jetpack_Client_Server::deactivate_plugin( $probable_file, $probable_title ) ) {
2746                    $deactivated[] = "$module:$i";
2747                }
2748            }
2749        }
2750
2751        if ( $deactivated ) {
2752            if ( $send_state_messages ) {
2753                self::state( 'deactivated_plugins', implode( ',', $deactivated ) );
2754            }
2755
2756            if ( $redirect ) {
2757                $url = add_query_arg(
2758                    array(
2759                        'action'   => 'activate_default_modules',
2760                        '_wpnonce' => wp_create_nonce( 'activate_default_modules' ),
2761                    ),
2762                    add_query_arg( compact( 'min_version', 'max_version', 'other_modules' ), self::admin_url( 'page=jetpack' ) )
2763                );
2764                wp_safe_redirect( $url );
2765                exit( 0 );
2766            }
2767        }
2768
2769        /**
2770         * Fires before default modules are activated.
2771         *
2772         * @since 1.9.0
2773         *
2774         * @param string    $min_version Minimum version number required to use modules.
2775         * @param string    $max_version Maximum version number required to use modules.
2776         * @param array     $other_modules Array of other modules to activate alongside the default modules.
2777         * @param bool|null $requires_connection Value of the Requires Connection filter.
2778         * @param bool|null $requires_user_connection Value of the Requires User Connection filter.
2779         */
2780        do_action( 'jetpack_before_activate_default_modules', $min_version, $max_version, $other_modules, $requires_connection, $requires_user_connection );
2781
2782        // Check each module for fatal errors, a la wp-admin/plugins.php::activate before activating.
2783        if ( $send_state_messages ) {
2784            self::restate();
2785        }
2786
2787        $active = self::get_active_modules();
2788
2789        foreach ( $modules as $module ) {
2790            if ( did_action( "jetpack_module_loaded_$module" ) ) {
2791                $active[] = $module;
2792                self::update_active_modules( $active );
2793                continue;
2794            }
2795
2796            if ( $send_state_messages && in_array( $module, $active, true ) ) {
2797                $module_info = self::get_module( $module );
2798                if ( ! $module_info['deactivate'] ) {
2799                    $state        = in_array( $module, $other_modules, true ) ? 'reactivated_modules' : 'activated_modules';
2800                    $active_state = self::state( $state );
2801                    if ( $active_state ) {
2802                        $active_state = explode( ',', $active_state );
2803                    } else {
2804                        $active_state = array();
2805                    }
2806                    $active_state[] = $module;
2807                    self::state( $state, implode( ',', $active_state ) );
2808                }
2809                continue;
2810            }
2811
2812            $file = self::get_module_path( $module );
2813            if ( ! file_exists( $file ) ) {
2814                continue;
2815            }
2816
2817            // we'll override this later if the plugin can be included without fatal error.
2818            if ( $redirect ) {
2819                wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
2820            }
2821
2822            if ( $send_state_messages ) {
2823                self::state( 'error', 'module_activation_failed' );
2824                self::state( 'module', $module );
2825            }
2826
2827            ob_start();
2828            require_once $file;
2829
2830            $active[] = $module;
2831
2832            if ( $send_state_messages ) {
2833
2834                $state        = in_array( $module, $other_modules, true ) ? 'reactivated_modules' : 'activated_modules';
2835                $active_state = self::state( $state );
2836                if ( $active_state ) {
2837                    $active_state = explode( ',', $active_state );
2838                } else {
2839                    $active_state = array();
2840                }
2841                $active_state[] = $module;
2842                self::state( $state, implode( ',', $active_state ) );
2843            }
2844
2845            self::update_active_modules( $active );
2846
2847            ob_end_clean();
2848        }
2849
2850        if ( $send_state_messages ) {
2851            self::state( 'error', false );
2852            self::state( 'module', false );
2853        }
2854        /**
2855         * Fires when default modules are activated.
2856         *
2857         * @since 1.9.0
2858         *
2859         * @param string    $min_version Minimum version number required to use modules.
2860         * @param string    $max_version Maximum version number required to use modules.
2861         * @param array     $other_modules Array of other modules to activate alongside the default modules.
2862         * @param bool|null $requires_connection Value of the Requires Connection filter.
2863         * @param bool|null $requires_user_connection Value of the Requires User Connection filter.
2864         */
2865        do_action( 'jetpack_activate_default_modules', $min_version, $max_version, $other_modules, $requires_connection, $requires_user_connection );
2866    }
2867
2868    /**
2869     * Activate a module.
2870     *
2871     * @param string $module Module slug.
2872     * @param bool   $exit Should exit be called after deactivation.
2873     * @param bool   $redirect Should there be a redirection after activation.
2874     *
2875     * @return bool|void
2876     */
2877    public static function activate_module( $module, $exit = true, $redirect = true ) {
2878        return ( new Modules() )->activate( $module, $exit, $redirect );
2879    }
2880
2881    /**
2882     * Deactivate module.
2883     *
2884     * @param string $module Module slug.
2885     *
2886     * @return bool
2887     */
2888    public static function deactivate_module( $module ) {
2889        return ( new Modules() )->deactivate( $module );
2890    }
2891
2892    /**
2893     * Enable a configuable module.
2894     *
2895     * @param string $module Module slug.
2896     *
2897     * @return void
2898     */
2899    public static function enable_module_configurable( $module ) {
2900        $module = self::get_module_slug( $module );
2901        add_filter( 'jetpack_module_configurable_' . $module, '__return_true' );
2902    }
2903
2904    /**
2905     * Composes a module configure URL. It uses Jetpack settings search as default value
2906     * It is possible to redefine resulting URL by using "jetpack_module_configuration_url_$module" filter
2907     *
2908     * @param string $module Module slug.
2909     * @return string $url module configuration URL.
2910     */
2911    public static function module_configuration_url( $module ) {
2912        $module      = self::get_module_slug( $module );
2913        $default_url = self::admin_url( array( 'page' => 'jetpack-settings' ) ) . "#/settings?term=$module";
2914        /**
2915         * Allows to modify configure_url of specific module to be able to redirect to some custom location.
2916         *
2917         * @since 6.9.0
2918         *
2919         * @param string $default_url Default url, which redirects to jetpack settings page.
2920         */
2921        $url = apply_filters( 'jetpack_module_configuration_url_' . $module, $default_url );
2922
2923        return $url;
2924    }
2925
2926    /* Installation */
2927    /**
2928     * Bail on activation if there is an issue.
2929     *
2930     * @param string $message Error message.
2931     * @param bool   $deactivate Deactivate Jetpack or not.
2932     *
2933     * @return never
2934     */
2935    public static function bail_on_activation( $message, $deactivate = true ) {
2936        ?>
2937<!doctype html>
2938<html>
2939<head>
2940<meta charset="<?php bloginfo( 'charset' ); ?>">
2941<style>
2942* {
2943    text-align: center;
2944    margin: 0;
2945    padding: 0;
2946    font-family: "Lucida Grande",Verdana,Arial,"Bitstream Vera Sans",sans-serif;
2947}
2948p {
2949    margin-top: 1em;
2950    font-size: 18px;
2951}
2952</style>
2953<body>
2954<p><?php echo esc_html( $message ); ?></p>
2955</body>
2956</html>
2957        <?php
2958        if ( $deactivate ) {
2959            $plugins = get_option( 'active_plugins' );
2960            $jetpack = plugin_basename( JETPACK__PLUGIN_DIR . 'jetpack.php' );
2961            $update  = false;
2962            foreach ( $plugins as $i => $plugin ) {
2963                if ( $plugin === $jetpack ) {
2964                    $plugins[ $i ] = false;
2965                    $update        = true;
2966                }
2967            }
2968
2969            if ( $update ) {
2970                update_option( 'active_plugins', array_filter( $plugins ) );
2971            }
2972        }
2973        exit( 0 );
2974    }
2975
2976    /**
2977     * Attached to activate_{ plugin_basename( __FILES__ ) } by register_activation_hook()
2978     *
2979     * @param bool $network_wide Network-wide activation.
2980     */
2981    public static function plugin_activation( $network_wide ) {
2982        Jetpack_Options::update_option( 'activated', 1 );
2983
2984        if ( version_compare( $GLOBALS['wp_version'], JETPACK__MINIMUM_WP_VERSION, '<' ) ) {
2985            /* translators: Jetpack version number. */
2986            self::bail_on_activation( sprintf( __( 'Jetpack requires WordPress version %s or later.', 'jetpack' ), JETPACK__MINIMUM_WP_VERSION ) );
2987        }
2988
2989        if ( $network_wide ) {
2990            self::state( 'network_nag', true );
2991        }
2992
2993        // For firing one-off events (notices) immediately after activation.
2994        set_transient( 'activated_jetpack', true, 0.1 * MINUTE_IN_SECONDS );
2995
2996        update_option( 'jetpack_activation_source', self::get_activation_source( wp_get_referer() ) );
2997
2998        Health::on_jetpack_activated();
2999
3000        \Automattic\Jetpack\Reprint_Export\Reprint_Exporter::discard_credentials();
3001
3002        if ( self::is_connection_ready() && method_exists( 'Automattic\Jetpack\Sync\Actions', 'do_only_first_initial_sync' ) ) {
3003            Sync_Actions::do_only_first_initial_sync();
3004        }
3005
3006        if ( ! defined( 'WC_ANALYTICS' ) && class_exists( 'Automattic\Woocommerce_Analytics' ) ) {
3007            Woocommerce_Analytics::maybe_add_proxy_speed_module();
3008        }
3009
3010        self::plugin_initialize();
3011    }
3012
3013    /**
3014     * Returns the activation source.
3015     *
3016     * @param string $referer_url URL.
3017     *
3018     * @return array source_type, source_query.
3019     */
3020    public static function get_activation_source( $referer_url ) {
3021        if ( defined( 'WP_CLI' ) && WP_CLI ) {
3022            return array( 'wp-cli', null );
3023        }
3024
3025        $referer = wp_parse_url( $referer_url );
3026
3027        $source_type  = 'unknown';
3028        $source_query = null;
3029
3030        if ( ! is_array( $referer ) || ! isset( $referer['path'] ) ) {
3031            return array( $source_type, $source_query );
3032        }
3033
3034        $plugins_path         = wp_parse_url( admin_url( 'plugins.php' ), PHP_URL_PATH );
3035        $plugins_install_path = wp_parse_url( admin_url( 'plugin-install.php' ), PHP_URL_PATH );// /wp-admin/plugin-install.php
3036
3037        if ( isset( $referer['query'] ) ) {
3038            parse_str( $referer['query'], $query_parts );
3039        } else {
3040            $query_parts = array();
3041        }
3042
3043        if ( $plugins_path === $referer['path'] ) {
3044            $source_type = 'list';
3045        } elseif ( $plugins_install_path === $referer['path'] ) {
3046            $tab = $query_parts['tab'] ?? 'featured';
3047            switch ( $tab ) {
3048                case 'popular':
3049                    $source_type = 'popular';
3050                    break;
3051                case 'recommended':
3052                    $source_type = 'recommended';
3053                    break;
3054                case 'favorites':
3055                    $source_type = 'favorites';
3056                    break;
3057                case 'search':
3058                    $source_type  = 'search-' . ( $query_parts['type'] ?? 'term' );
3059                    $source_query = $query_parts['s'] ?? null;
3060                    break;
3061                default:
3062                    $source_type = 'featured';
3063            }
3064        }
3065
3066        return array( $source_type, $source_query );
3067    }
3068
3069    /**
3070     * Runs before bumping version numbers up to a new version.
3071     *
3072     * Only ever registered the hooks for the release post update modal, which has been removed.
3073     * No longer hooked to `updating_jetpack_version`.
3074     *
3075     * @deprecated 16.2
3076     *
3077     * @param string $version     Version:timestamp.
3078     * @param string $old_version Old Version:timestamp or false if not set yet.
3079     */
3080    public static function do_version_bump( $version, $old_version ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- Signature preserved for the deprecation shim.
3081        _deprecated_function( __METHOD__, 'jetpack-16.2' );
3082    }
3083
3084    /**
3085     * Enables the Newsletter (subscriptions) module for existing sites now that it is a default-on module.
3086     *
3087     * Fresh installs receive the module via its "Auto Activate: Yes" header, so this only handles sites
3088     * upgrading from a version where the module defaulted off. It runs once per site (guarded by the
3089     * subscriptions_default_on_migrated option). Fresh installs are marked as migrated immediately so the
3090     * migration never runs for them. After it has run, the user's choice to deactivate the module again
3091     * (for example from the My Jetpack Products page) is respected and never reverted.
3092     *
3093     * The module requires a connection, so on a disconnected site the migration is deferred without setting
3094     * the guard, allowing a later version bump to retry once the site is connected.
3095     *
3096     * @param string       $version     New Jetpack version:timestamp.
3097     * @param string|false $old_version Previous Jetpack version:timestamp, or false on a fresh install.
3098     */
3099    public static function activate_subscriptions_module_for_existing_sites( $version, $old_version ) {
3100        if ( get_option( 'jetpack_subscriptions_default_on_migrated' ) ) {
3101            return;
3102        }
3103
3104        // Fresh installs get the module via its "Auto Activate: Yes" header. Mark them as migrated so a
3105        // later opt-out is never reverted by the existing-site path on a subsequent version bump.
3106        if ( ! $old_version ) {
3107            update_option( 'jetpack_subscriptions_default_on_migrated', true );
3108            return;
3109        }
3110
3111        if ( ! self::is_connection_ready() ) {
3112            return;
3113        }
3114
3115        // Mark as migrated only once the module is active, so a transient activation failure is retried on
3116        // a later version bump rather than being silently skipped.
3117        if ( self::is_module_active( 'subscriptions' ) || self::activate_module( 'subscriptions', false, false ) ) {
3118            update_option( 'jetpack_subscriptions_default_on_migrated', true );
3119        }
3120    }
3121
3122    /**
3123     * Option flag that records the AI master-switch opt-out reconciliation has run,
3124     * so it never runs twice.
3125     *
3126     * @var string
3127     */
3128    const AI_MASTER_OPTOUT_MIGRATED_OPTION = 'jetpack_ai_master_optout_migrated';
3129
3130    /**
3131     * Register the on-upgrade init hooks whose relative ORDER matters, extracted so
3132     * the ordering can be asserted in tests without invoking plugin_upgrade() (whose
3133     * guards make it unreliable to trigger under test). activate_new_modules()
3134     * (init, default priority 10) auto-activates "Auto Activate: Yes" modules
3135     * including the `ai` master; reconcile_ai_master_optout() must run at a LATER
3136     * priority to honor an explicit AI opt-out.
3137     *
3138     * @return void
3139     */
3140    public static function register_upgrade_init_hooks() {
3141        add_action( 'init', array( __CLASS__, 'activate_new_modules' ) );
3142        add_action( 'init', array( __CLASS__, 'reconcile_ai_master_optout' ), 20 );
3143    }
3144
3145    /**
3146     * Preserves an explicit Jetpack AI opt-out when the `ai` module becomes the site-wide
3147     * master switch off WordPress.com Simple (self-hosted and Atomic).
3148     *
3149     * The `ai` module is "Auto Activate: Yes", so on upgrade {@see self::activate_new_modules()}
3150     * turns it on for connected sites â€” the desired default-on / auto-enable-on-connection
3151     * behavior, which this method deliberately leaves alone. The one case it corrects is a site
3152     * that had explicitly disabled Jetpack AI (the `jetpack_ai_enabled` option present and falsey)
3153     * before the module shipped: that opt-out must survive the module becoming the master, so the
3154     * module is deactivated for exactly those sites. An absent or truthy option is left untouched.
3155     *
3156     * Ordering is the whole point. `activate_new_modules()` is hooked on `init` at priority 10 and
3157     * auto-activates the module there; this method is hooked on `init` at priority 20 (see
3158     * {@see self::plugin_upgrade()}), so it runs AFTER the auto-activation and its deactivation is
3159     * the final state. A version-guarded block that ran inline during `plugins_loaded` would be
3160     * undone by the later auto-activation, which is why this is a late-init hook rather than an
3161     * inline upgrade step.
3162     *
3163     * WordPress.com Simple never runs modules â€” the option stays the master there â€” so this is a
3164     * no-op on Simple. The {@see self::AI_MASTER_OPTOUT_MIGRATED_OPTION} flag makes it run exactly
3165     * once, which matters because off-Simple the option is no longer the master after this runs:
3166     * a stale falsey option must not keep re-deactivating a module the user later turns back on.
3167     *
3168     * @return void
3169     */
3170    public static function reconcile_ai_master_optout() {
3171        if ( get_option( self::AI_MASTER_OPTOUT_MIGRATED_OPTION ) ) {
3172            return;
3173        }
3174
3175        // Simple keeps the `jetpack_ai_enabled` option as the master; modules don't run there.
3176        if ( ( new Host() )->is_wpcom_simple() ) {
3177            return;
3178        }
3179
3180        // A sentinel default distinguishes an absent option (leave auto-activation alone) from one
3181        // explicitly stored falsey (an opt-out to preserve).
3182        $stored = get_option( 'jetpack_ai_enabled', 'not-set' );
3183        if ( 'not-set' !== $stored && ! (bool) $stored ) {
3184            ( new Modules() )->deactivate( 'ai' );
3185        }
3186
3187        update_option( self::AI_MASTER_OPTOUT_MIGRATED_OPTION, true );
3188    }
3189
3190    /**
3191     * Deletes obsolete SEO module-state options without changing module activation.
3192     *
3193     * @since 16.3
3194     */
3195    public static function cleanup_seo_module_state_options() {
3196        delete_option( 'jetpack_seo_sitemap_enabled' );
3197        delete_option( 'jetpack_seo_canonical_urls_enabled' );
3198        delete_option( 'jetpack_seo_module_state_reconciled' );
3199    }
3200
3201    /**
3202     * Seeds the Jetpack SEO discoverability cohort once, so the new SEO surface is
3203     * auto-discoverable on fresh installs but opt-in on existing ones (JETPACK-1700).
3204     *
3205     * Hooked on `updating_jetpack_version`, which fires on every install including the
3206     * first â€” with `$old_version === false` on a brand-new site (the same signal
3207     * {@see self::activate_subscriptions_module_for_existing_sites()} keys off). Fresh
3208     * installs are seeded visible; existing installs are seeded hidden and opt in later
3209     * via the legacy Traffic page or My Jetpack. Deactivation deletes the stored version,
3210     * so a reactivation before this option exists counts as fresh. `add_option()` makes
3211     * this seed-once: it never overrides a value a later opt-in (or opt-out) has set.
3212     * WordPress.com sites ignore this option entirely (always visible) â€” see
3213     * {@see \Automattic\Jetpack\SEO\Initializer::is_seo_surface_visible()}.
3214     *
3215     * @param string       $version     The new Jetpack version (unused).
3216     * @param string|false $old_version The previous version, or false on a fresh install.
3217     */
3218    public static function seed_seo_visibility_cohort( $version, $old_version ) {
3219        // Drop the superseded key (see VISIBILITY_OPTION); it plays no part in the seed.
3220        delete_option( 'jetpack_seo_surface_visible' );
3221        add_option( Jetpack_SEO_Initializer::VISIBILITY_OPTION, ! $old_version );
3222    }
3223
3224    /**
3225     * Sets the display_update_modal state.
3226     *
3227     * The release post update modal that read this state has been removed. The write is kept so the
3228     * method still behaves as documented for the deprecation window. When this is deleted, also drop
3229     * the matching `display_update_modal` guard in Automattic\Jetpack\CookieState::should_set_cookie(),
3230     * which exists only to keep this key out of the cookie on the Jetpack admin screen.
3231     *
3232     * @deprecated 16.2
3233     */
3234    public static function set_update_modal_display() {
3235        _deprecated_function( __METHOD__, 'jetpack-16.2' );
3236        self::state( 'display_update_modal', true );
3237    }
3238
3239    /**
3240     * Enqueues the block library styles.
3241     *
3242     * Only ever used by the release post update modal, which has been removed.
3243     *
3244     * @deprecated 16.2
3245     *
3246     * @param string $hook The current admin page.
3247     */
3248    public static function enqueue_block_style( $hook ) {
3249        _deprecated_function( __METHOD__, 'jetpack-16.2' );
3250        if ( 'toplevel_page_jetpack' === $hook ) {
3251            wp_enqueue_style( 'wp-block-library' );
3252        }
3253    }
3254
3255    /**
3256     * Sets the internal version number and activation state.
3257     *
3258     * @static
3259     */
3260    public static function plugin_initialize() {
3261        if ( ! Jetpack_Options::get_option( 'activated' ) ) {
3262            Jetpack_Options::update_option( 'activated', 2 );
3263        }
3264
3265        if ( ! Jetpack_Options::get_option( 'version' ) ) {
3266            $old_version = JETPACK__VERSION . ':' . time();
3267            $version     = $old_version;
3268            /** This action is documented in class.jetpack.php */
3269            do_action( 'updating_jetpack_version', $version, false );
3270            Jetpack_Options::update_options( compact( 'version', 'old_version' ) );
3271        }
3272
3273        if ( self::is_connection_ready() ) {
3274            self::handle_default_module_activation( true );
3275        }
3276
3277        self::load_modules();
3278
3279        Jetpack_Options::delete_option( 'do_activate' );
3280    }
3281
3282    /**
3283     * Handles the activation of the default modules depending on the current state of the site:
3284     *  - If the site already has the jetpack_active_modules option, activate those.
3285     *  - If the site has a site-only connection, only activate the default modules that require only a site connection.
3286     *  - If the site has a user connection, activate the default modules that require a user connection.
3287     *
3288     * @param bool $should_activate_user_modules Whether the status of the user connection should be checked and the default modules that
3289     *                                           require a user connection activated.
3290     */
3291    private static function handle_default_module_activation( $should_activate_user_modules ) {
3292        $active_modules = Jetpack_Options::get_option( 'active_modules' );
3293        if ( $active_modules ) {
3294            self::delete_active_modules();
3295
3296            /**
3297             * Previously active modules could mean two things. First, it could mean
3298             * that Jetpack was previously active on the site. In this case we would like
3299             * to only activate the modules that were set to active.
3300             * Another case could be that the module option was set by a standalone
3301             * plugin. In that case the `active_modules_initalized` option will not
3302             * be set, so we need to enable default Jetpack modules as well.
3303             */
3304            if ( ! Jetpack_Options::get_option( 'active_modules_initialized' ) ) {
3305                $default_modules = self::get_default_modules();
3306                $active_modules  = array_merge( $active_modules, $default_modules );
3307                Jetpack_Options::update_option( 'active_modules_initialized', true );
3308            }
3309
3310            self::activate_default_modules(
3311                999, // This version trick basically excludes every default module.
3312                1,
3313                $active_modules,
3314                false
3315            );
3316        } elseif ( $should_activate_user_modules && ( new Connection_Manager() )->get_connection_owner_id() ) { // Check for a user connection.
3317            self::activate_default_modules( false, false, array(), false, null, null, null );
3318            Jetpack_Options::update_option( 'active_modules_initialized', true );
3319        } else {
3320            self::activate_default_modules( false, false, array(), false, null, null, false );
3321        }
3322    }
3323
3324    /**
3325     * Removes all connection options
3326     *
3327     * @static
3328     */
3329    public static function plugin_deactivation() {
3330        require_once ABSPATH . '/wp-admin/includes/plugin.php';
3331        $tracking = new Tracking();
3332        $tracking->record_user_event( 'deactivate_plugin', array() );
3333        if ( is_plugin_active_for_network( 'jetpack/jetpack.php' ) ) {
3334            Jetpack_Network::init()->deactivate();
3335        } else {
3336            add_filter( 'jetpack_update_activated_state_on_disconnect', '__return_false' );
3337            self::disconnect();
3338            Jetpack_Options::delete_option( 'version' );
3339        }
3340
3341        if ( ! defined( 'WC_ANALYTICS' ) && class_exists( 'Automattic\Woocommerce_Analytics' ) ) {
3342            Woocommerce_Analytics::maybe_remove_proxy_speed_module();
3343        }
3344    }
3345
3346    /**
3347     * Set activated option to 4 on jetpack_idc_disconnect action.
3348     */
3349    public static function on_idc_disconnect() {
3350        \Jetpack_Options::update_option( 'activated', 4 );
3351    }
3352
3353    /**
3354     * Disconnects from the Jetpack servers.
3355     * Forgets all connection details and tells the Jetpack servers to do the same.
3356     *
3357     * Will not disconnect if there are other plugins using the connection.
3358     *
3359     * @since 11.0 Do not disconnect if other plugins are using the connection.
3360     *
3361     * @static
3362     */
3363    public static function disconnect() {
3364
3365        $connection = self::connection();
3366
3367        // If the site is in an IDC because sync is not allowed,
3368        // let's make sure to not disconnect the production site.
3369        $connection->remove_connection( ! Identity_Crisis::validate_sync_error_idc_option() );
3370    }
3371
3372    /**
3373     * Happens after a successful disconnection.
3374     *
3375     * @static
3376     */
3377    public static function jetpack_site_disconnected() {
3378        Identity_Crisis::clear_all_idc_options();
3379
3380        \Automattic\Jetpack\Reprint_Export\Reprint_Exporter::discard_credentials();
3381
3382        // Delete all the sync related data. Since it could be taking up space.
3383        Sender::get_instance()->uninstall();
3384
3385        /**
3386         * Filters whether the Jetpack activated state should be updated after disconnecting.
3387         *
3388         * @since 10.0.0
3389         *
3390         * @param bool $update_activated_state Whether activated state should be updated after disconnecting, defaults to true.
3391         */
3392        $update_activated_state = apply_filters( 'jetpack_update_activated_state_on_disconnect', true );
3393
3394        if ( $update_activated_state ) {
3395            Jetpack_Options::update_option( 'activated', 4 );
3396        }
3397    }
3398
3399    /**
3400     * Disconnects the user.
3401     *
3402     * @deprecated 13.4
3403     * @see \Automattic\Jetpack\Connection\Manager::disconnect_user()
3404     *
3405     * @param int $user_id The user ID to disconnect.
3406     */
3407    public function disconnect_user( $user_id ) {
3408        $this->connection_manager->disconnect_user( $user_id );
3409    }
3410
3411    /**
3412     * Checking the domain names in beta versions.
3413     * If this is a development version, before attempting to connect, let's make sure that the domains are viable.
3414     *
3415     * @param null|\WP_Error $error The domain validation error, or `null` if everything's fine.
3416     *
3417     * @return null|\WP_Error The domain validation error, or `null` if everything's fine.
3418     */
3419    public static function registration_check_domains( $error ) {
3420        if ( static::is_development_version() ) {
3421            $domains_to_check = array_unique(
3422                array(
3423                    'siteurl' => wp_parse_url( get_site_url(), PHP_URL_HOST ),
3424                    'homeurl' => wp_parse_url( get_home_url(), PHP_URL_HOST ),
3425                )
3426            );
3427            foreach ( $domains_to_check as $domain ) {
3428                $result = static::connection()->is_usable_domain( $domain );
3429                if ( is_wp_error( $result ) ) {
3430                    return $result;
3431                }
3432            }
3433        }
3434
3435        return $error;
3436    }
3437
3438    /**
3439     * Tracking an internal event log. Try not to put too much chaff in here.
3440     *
3441     * [Everyone Loves a Log!](https://www.youtube.com/watch?v=2C7mNr5WMjA)
3442     *
3443     * @param mixed $code Error code to log.
3444     * @param mixed $data Data to log.
3445     */
3446    public static function log( $code, $data = null ) {
3447
3448        $raw_log = Jetpack_Options::get_option( 'log', array() );
3449        // This can be modified by the `jetpack_options` filter, so abort if we don't have an array.
3450        if ( ! is_array( $raw_log ) ) {
3451            return;
3452        }
3453
3454        // only grab the latest 200 entries.
3455        $log = array_slice( $raw_log, -199, 199 );
3456
3457        // Append our event to the log.
3458        $log_entry = array(
3459            'time'    => time(),
3460            'user_id' => get_current_user_id(),
3461            'blog_id' => Jetpack_Options::get_option( 'id' ),
3462            'code'    => $code,
3463        );
3464        // Don't bother storing it unless we've got some.
3465        if ( $data !== null ) {
3466            $log_entry['data'] = $data;
3467        }
3468        $log[] = $log_entry;
3469
3470        // Try add_option first, to make sure it's not autoloaded.
3471        // @todo: Add an add_option method to Jetpack_Options.
3472        if ( ! add_option( 'jetpack_log', $log, '', 'no' ) ) {
3473            Jetpack_Options::update_option( 'log', $log );
3474        }
3475
3476        /**
3477         * Fires when Jetpack logs an internal event.
3478         *
3479         * @since 3.0.0
3480         *
3481         * @param array $log_entry {
3482         *  Array of details about the log entry.
3483         *
3484         *  @param string time Time of the event.
3485         *  @param int user_id ID of the user who trigerred the event.
3486         *  @param int blog_id Jetpack Blog ID.
3487         *  @param string code Unique name for the event.
3488         *  @param string data Data about the event.
3489         * }
3490         */
3491        do_action( 'jetpack_log_entry', $log_entry );
3492    }
3493
3494    /**
3495     * Get the internal event log.
3496     *
3497     * @param string $event only return the specific log events.
3498     * @param int    $num - get specific number of latest results, limited to 200.
3499     *
3500     * @return array of log events || WP_Error for invalid params
3501     */
3502    public static function get_log( $event = false, $num = false ) {
3503        if ( $event && ! is_string( $event ) ) {
3504            return new WP_Error( __( 'First param must be string or empty', 'jetpack' ) );
3505        }
3506
3507        if ( $num && ! is_numeric( $num ) ) {
3508            return new WP_Error( __( 'Second param must be numeric or empty', 'jetpack' ) );
3509        }
3510
3511        $entire_log = Jetpack_Options::get_option( 'log', array() );
3512
3513        // If nothing set - act as it did before, otherwise let's start customizing the output.
3514        if ( ! $num && ! $event ) {
3515            return $entire_log;
3516        } else {
3517            $entire_log = array_reverse( $entire_log );
3518        }
3519
3520        $custom_log_output = array();
3521
3522        if ( $event ) {
3523            foreach ( $entire_log as $log_event ) {
3524                if ( $event === $log_event['code'] ) {
3525                    $custom_log_output[] = $log_event;
3526                }
3527            }
3528        } else {
3529            $custom_log_output = $entire_log;
3530        }
3531
3532        if ( $num ) {
3533            $custom_log_output = array_slice( $custom_log_output, 0, $num );
3534        }
3535
3536        return $custom_log_output;
3537    }
3538
3539    /**
3540     * Log modification of important settings.
3541     *
3542     * @param string $option Option name.
3543     * @param string $old_value Old value of option.
3544     * @param string $value New value of option.
3545     */
3546    public static function log_settings_change( $option, $old_value, $value ) {
3547        switch ( $option ) {
3548            case 'jetpack_sync_non_public_post_stati':
3549                self::log( $option, $value );
3550                break;
3551        }
3552    }
3553
3554    /**
3555     * Return stat data for WPCOM sync.
3556     *
3557     * The Sync stats module was this method's last caller and moved to the Connection package's
3558     * `Heartbeat::generate_stats_array()`, which assembles the heartbeat data through the
3559     * `jetpack_heartbeat_stats_array` filter. Note the package method does not include the extended
3560     * data from `get_additional_stat_data()`, so callers relying on `$extended` need to add it themselves.
3561     *
3562     * @deprecated 16.2
3563     *
3564     * @param bool $encode JSON encode the result.
3565     * @param bool $extended Adds additional stats data.
3566     *
3567     * @return array|string Stats data. Array if $encode is false. JSON-encoded string is $encode is true.
3568     */
3569    public static function get_stat_data( $encode = true, $extended = true ) {
3570        _deprecated_function( __METHOD__, 'jetpack-16.2', 'Automattic\\Jetpack\\Heartbeat::generate_stats_array' );
3571
3572        $env_stats = method_exists( Heartbeat::class, 'get_environment_stats' )
3573            ? Heartbeat::get_environment_stats()
3574            : array();
3575        $data      = array_merge( Jetpack_Heartbeat::generate_stats_array(), $env_stats );
3576
3577        if ( $extended ) {
3578            $additional_data = self::get_additional_stat_data();
3579            $data            = array_merge( $data, $additional_data );
3580        }
3581
3582        if ( $encode ) {
3583            return wp_json_encode( $data, JSON_UNESCAPED_SLASHES );
3584        }
3585
3586        return $data;
3587    }
3588
3589    /**
3590     * Get additional stat data to sync to WPCOM
3591     *
3592     * @param string $prefix Stats prefix.
3593     *
3594     * @return array stats values.
3595     */
3596    public static function get_additional_stat_data( $prefix = '' ) {
3597        $return                             = array();
3598        $return[ "{$prefix}themes" ]        = self::get_parsed_theme_data();
3599        $return[ "{$prefix}plugins-extra" ] = self::get_parsed_plugin_data();
3600        $return[ "{$prefix}users" ]         = (int) self::get_site_user_count();
3601        $return[ "{$prefix}site-count" ]    = 0;
3602
3603        if ( function_exists( 'get_blog_count' ) ) {
3604            $return[ "{$prefix}site-count" ] = get_blog_count();
3605        }
3606        return $return;
3607    }
3608
3609    /**
3610     * Get current site's user count.
3611     *
3612     * @return int|string|null Number of users on the site. -1 for a large network.
3613     */
3614    private static function get_site_user_count() {
3615        global $wpdb;
3616
3617        if ( function_exists( 'wp_is_large_network' ) ) {
3618            if ( wp_is_large_network( 'users' ) ) {
3619                return -1; // Not a real value but should tell us that we are dealing with a large network.
3620            }
3621        }
3622        $user_count = get_transient( 'jetpack_site_user_count' );
3623        if ( false === ( $user_count ) ) {
3624            // It wasn't there, so regenerate the data and save the transient.
3625            $user_count = $wpdb->get_var( "SELECT COUNT(*) FROM $wpdb->usermeta WHERE meta_key = '{$wpdb->prefix}capabilities'" );
3626            set_transient( 'jetpack_site_user_count', $user_count, DAY_IN_SECONDS );
3627        }
3628        return $user_count;
3629    }
3630
3631    /* Admin Pages */
3632
3633    /**
3634     * Admin init function.
3635     *
3636     * Runs on admin_init hook.
3637     *
3638     * @return void
3639     */
3640    public function admin_init() {
3641        // If the plugin is not connected, display a connect message.
3642        if (
3643            // the plugin was auto-activated and needs its candy.
3644            Jetpack_Options::get_option_and_ensure_autoload( 'do_activate', '0' )
3645        ||
3646            // the plugin is active, but was never activated.  Probably came from a site-wide network activation.
3647            ! Jetpack_Options::get_option( 'activated' )
3648        ) {
3649            self::plugin_initialize();
3650        }
3651
3652        $is_offline_mode              = ( new Status() )->is_offline_mode();
3653        $fallback_no_verify_ssl_certs = Jetpack_Options::get_option( 'fallback_no_verify_ssl_certs' );
3654        /** Already documented in automattic/jetpack-connection::src/class-client.php */
3655        $client_verify_ssl_certs = apply_filters( 'jetpack_client_verify_ssl_certs', false );
3656
3657        // Run post-activation actions if needed.
3658        $this->plugin_post_activation();
3659
3660        if ( ( self::is_connection_ready() || $is_offline_mode ) && false === $fallback_no_verify_ssl_certs && ! $client_verify_ssl_certs ) {
3661            // Upgrade: 1.1 -> 1.1.1
3662            // Check and see if host can verify the Jetpack servers' SSL certificate.
3663            $args = array();
3664            // @phan-suppress-next-line PhanAccessMethodInternal -- Phan is correct, but the usage is intentional.
3665            Client::_wp_remote_request( self::connection()->api_url( 'test' ), $args, true );
3666        }
3667
3668        if (
3669            current_user_can( 'manage_options' )
3670            && ! self::permit_ssl()
3671            && ! $is_offline_mode
3672        ) {
3673            add_action( 'jetpack_notices', array( $this, 'alert_auto_ssl_fail' ) );
3674        }
3675
3676        add_action( 'load-plugins.php', array( $this, 'intercept_plugin_error_scrape_init' ) );
3677        add_action( 'load-plugins.php', array( $this, 'plugins_page_init_jetpack_state' ) );
3678
3679        if ( ! ( is_multisite() && is_plugin_active_for_network( 'jetpack/jetpack.php' ) && ! is_network_admin() ) ) {
3680            add_action( 'admin_enqueue_scripts', array( $this, 'deactivate_dialog' ) );
3681        }
3682
3683        add_filter( 'plugin_action_links_' . plugin_basename( JETPACK__PLUGIN_DIR . 'jetpack.php' ), array( $this, 'plugin_action_links' ) );
3684
3685        if ( self::is_connection_ready() || $is_offline_mode ) {
3686            // Artificially throw errors in certain specific cases during plugin activation.
3687            add_action( 'activate_plugin', array( $this, 'throw_error_on_activate_plugin' ) );
3688        }
3689    }
3690
3691    /**
3692     * Adds body classes.
3693     *
3694     * @param string $admin_body_class Body classes.
3695     *
3696     * @return string
3697     */
3698    public function admin_body_class( $admin_body_class = '' ) {
3699        $classes = explode( ' ', trim( $admin_body_class ) );
3700
3701        $classes[] = self::is_connection_ready() ? 'jetpack-connected' : 'jetpack-disconnected';
3702
3703        $admin_body_class = implode( ' ', array_unique( $classes ) );
3704        return " $admin_body_class ";
3705    }
3706
3707    /**
3708     * Adds Jetpack Page styles by appending class to the admin body class.
3709     *
3710     * @param string $admin_body_class Existing admin body class string.
3711     *
3712     * @return string
3713     */
3714    public static function add_jetpack_pagestyles( $admin_body_class = '' ) {
3715        return $admin_body_class . ' jetpack-pagestyles ';
3716    }
3717
3718    /**
3719     * Sometimes a plugin can activate without causing errors, but it will cause errors on the next page load.
3720     * This function artificially throws errors for such cases (per a specific list).
3721     *
3722     * @param string $plugin The activated plugin.
3723     * @throws RuntimeException If a conflicting plugin is detected.
3724     */
3725    public function throw_error_on_activate_plugin( $plugin ) {
3726        $active_modules = self::get_active_modules();
3727
3728        // The Shortlinks module and the Stats plugin conflict, but won't cause errors on activation because of some function_exists() checks.
3729        if ( function_exists( 'stats_get_api_key' ) && in_array( 'shortlinks', $active_modules, true ) ) {
3730            $throw = false;
3731
3732            // Try and make sure it really was the stats plugin.
3733            if ( ! class_exists( 'ReflectionFunction' ) ) {
3734                if ( 'stats.php' === basename( $plugin ) ) {
3735                    $throw = true;
3736                }
3737            } else {
3738                // @phan-suppress-next-line PhanUndeclaredFunctionInCallable -- Checked above. See also https://github.com/phan/phan/issues/1204.
3739                $reflection = new ReflectionFunction( 'stats_get_api_key' );
3740                if ( basename( $plugin ) === basename( $reflection->getFileName() ) ) {
3741                    $throw = true;
3742                }
3743            }
3744
3745            if ( $throw ) {
3746                /* translators: Plugin name to deactivate. */
3747                throw new RuntimeException( sprintf( __( 'Jetpack contains the most recent version of the old "%1$s" plugin.', 'jetpack' ), 'WordPress.com Stats' ) );
3748            }
3749        }
3750    }
3751
3752    /**
3753     * Call to Jetpack::state on the load-plugins.php hook.
3754     * In case the jetpackState cookie is populated, this call will read and re-set the cookie before HTTP headers are sent.
3755     */
3756    public function plugins_page_init_jetpack_state() {
3757        self::state( 'message' );
3758    }
3759
3760    /**
3761     * Adds the intercept action to the check_admin_referer hook.
3762     *
3763     * @return void
3764     */
3765    public function intercept_plugin_error_scrape_init() {
3766        add_action( 'check_admin_referer', array( $this, 'intercept_plugin_error_scrape' ), 10, 2 );
3767    }
3768
3769    /**
3770     * Detect if conflicting plugin is being deactivated.
3771     *
3772     * @param string   $action The nonce action.
3773     * @param bool|int $result False if the nonce is invalid, 1 if the nonce is valid and generated between 0-12 hours ago, 2 if the nonce is valid and generated between 12-24 hours ago.
3774     *
3775     * @return void
3776     */
3777    public function intercept_plugin_error_scrape( $action, $result ) {
3778        if ( ! $result ) {
3779            return;
3780        }
3781
3782        foreach ( $this->plugins_to_deactivate as $deactivate_us ) {
3783            foreach ( $deactivate_us as $deactivate_me ) {
3784                if ( "plugin-activation-error_{$deactivate_me[0]}" === $action ) {
3785                    /* translators: Plugin name to deactivate. */
3786                    self::bail_on_activation( sprintf( __( 'Jetpack contains the most recent version of the old &#8220;%1$s&#8221; plugin.', 'jetpack' ), $deactivate_me[1] ), false );
3787                }
3788            }
3789        }
3790    }
3791
3792    /**
3793     * Register the remote file upload request handlers, if needed.
3794     *
3795     * @access public
3796     */
3797    public function add_remote_request_handlers() {
3798        // Remote file uploads are allowed only via AJAX requests.
3799        if ( ! is_admin() || ! Constants::get_constant( 'DOING_AJAX' ) ) {
3800            return;
3801        }
3802
3803        // Remote file uploads are allowed only for a set of specific AJAX actions.
3804        $remote_request_actions = array(
3805            'jetpack_upload_file',
3806            'jetpack_update_file',
3807        );
3808
3809        // phpcs:ignore WordPress.Security.NonceVerification
3810        if ( ! isset( $_POST['action'] ) || ! in_array( $_POST['action'], $remote_request_actions, true ) ) {
3811            return;
3812        }
3813
3814        // Require Jetpack authentication for the remote file upload AJAX requests.
3815        if ( ! $this->connection_manager ) {
3816            $this->connection_manager = new Connection_Manager();
3817        }
3818
3819        $this->connection_manager->require_jetpack_authentication();
3820
3821        // Register the remote file upload AJAX handlers.
3822        foreach ( $remote_request_actions as $action ) {
3823            add_action( "wp_ajax_nopriv_{$action}", array( $this, 'remote_request_handlers' ) );
3824        }
3825    }
3826
3827    /**
3828     * Handler for Jetpack remote file uploads.
3829     *
3830     * @access public
3831     * @return never
3832     */
3833    public function remote_request_handlers() {
3834        switch ( current_filter() ) {
3835            case 'wp_ajax_nopriv_jetpack_upload_file':
3836                $response = $this->upload_handler();
3837                break;
3838
3839            case 'wp_ajax_nopriv_jetpack_update_file':
3840                $response = $this->upload_handler( true );
3841                break;
3842            default:
3843                $response = new WP_Error( 'unknown_handler', 'Unknown Handler', 400 );
3844                break;
3845        }
3846
3847        if ( ! $response ) {
3848            $response = new WP_Error( 'unknown_error', 'Unknown Error', 400 );
3849        }
3850
3851        if ( is_wp_error( $response ) ) {
3852            $status_code       = $response->get_error_data();
3853            $error             = $response->get_error_code();
3854            $error_description = $response->get_error_message();
3855
3856            if ( ! is_int( $status_code ) ) {
3857                $status_code = 400;
3858            }
3859
3860            wp_send_json( (object) compact( 'error', 'error_description' ), $status_code, JSON_UNESCAPED_SLASHES );
3861        }
3862
3863        if ( true === $response ) {
3864            status_header( 200 );
3865            exit( 0 );
3866        }
3867
3868        wp_send_json( (object) $response, 200, JSON_UNESCAPED_SLASHES );
3869    }
3870
3871    /**
3872     * Uploads a file gotten from the global $_FILES.
3873     * If `$update_media_item` is true and `post_id` is defined
3874     * the attachment file of the media item (gotten through of the post_id)
3875     * will be updated instead of add a new one.
3876     *
3877     * @param  boolean $update_media_item - update media attachment.
3878     * @return array|WP_Error - An array describing the uploading files process.
3879     */
3880    public function upload_handler( $update_media_item = false ) {
3881        if ( isset( $_SERVER['REQUEST_METHOD'] ) && 'POST' !== strtoupper( sanitize_text_field( wp_unslash( $_SERVER['REQUEST_METHOD'] ) ) ) ) {
3882            return new WP_Error( 405, get_status_header_desc( 405 ), 405 );
3883        }
3884
3885        $user = wp_authenticate( '', '' );
3886        if ( ! $user || is_wp_error( $user ) ) {
3887            return new WP_Error( 403, get_status_header_desc( 403 ), 403 );
3888        }
3889
3890        wp_set_current_user( $user->ID );
3891
3892        if ( ! current_user_can( 'upload_files' ) ) {
3893            return new WP_Error( 'cannot_upload_files', 'User does not have permission to upload files', 403 );
3894        }
3895
3896        if ( empty( $_FILES ) ) {
3897            return new WP_Error( 'no_files_uploaded', 'No files were uploaded: nothing to process', 400 );
3898        }
3899
3900        foreach ( array_keys( $_FILES ) as $files_key ) {
3901            if ( ! isset( $_POST[ "_jetpack_file_hmac_{$files_key}" ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing -- no site changes here.
3902                return new WP_Error( 'missing_hmac', 'An HMAC for one or more files is missing', 400 );
3903            }
3904        }
3905
3906        $media_keys = isset( $_FILES['media'] ) ? array_keys( $_FILES['media'] ) : array(); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Unslash is not needed for `$_FILES`, the sniff is wrong. Sanitization should happen below.
3907
3908        $token = ( new Tokens() )->get_access_token( get_current_user_id() );
3909        if ( ! $token || is_wp_error( $token ) ) {
3910            return new WP_Error( 'unknown_token', 'Unknown Jetpack token', 403 );
3911        }
3912
3913        /**
3914         * Optionally block uploads processed through Jetpack's upload_handler().
3915         * The filter may return false or WP_Error to block this particular upload.
3916         *
3917         * @since 10.8
3918         *
3919         * @param bool|WP_Error $allowed If false or WP_Error, block the upload. If true, allow the upload.
3920         * @param mixed $_FILES The $_FILES attempting to be uploaded.
3921         */
3922        $can_upload = apply_filters( 'jetpack_upload_handler_can_upload', true, $_FILES );
3923        if ( ! $can_upload || is_wp_error( $can_upload ) ) {
3924            if ( is_wp_error( $can_upload ) ) {
3925                return $can_upload;
3926            }
3927            return new WP_Error( 'handler_cannot_upload', __( 'The upload handler cannot upload files', 'jetpack' ), 400 );
3928        }
3929
3930        $uploaded_files = array();
3931        $global_post    = $GLOBALS['post'] ?? null;
3932        unset( $GLOBALS['post'] );
3933        if ( empty( $_FILES['media']['name'] ) ) {
3934            // Nothing to process, just return.
3935            return $uploaded_files;
3936        }
3937        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.
3938            $file = array();
3939            foreach ( $media_keys as $media_key ) {
3940                $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.
3941            }
3942
3943            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.
3944
3945            $hmac_file = hash_hmac_file( 'sha1', $file['tmp_name'], $salt . $token->secret );
3946            if ( $hmac_provided !== $hmac_file ) {
3947                $uploaded_files[ $index ] = (object) array(
3948                    'error'             => 'invalid_hmac',
3949                    'error_description' => 'The corresponding HMAC for this file does not match',
3950                );
3951                continue;
3952            }
3953
3954            $_FILES['.jetpack.upload.'] = $file;
3955            $post_id                    = isset( $_POST['post_id'][ $index ] ) ? absint( $_POST['post_id'][ $index ] ) : 0; // phpcs:ignore WordPress.Security.NonceVerification.Missing -- caller should have checked a nonce.
3956            if ( ! current_user_can( 'edit_post', $post_id ) ) {
3957                $post_id = 0;
3958            }
3959
3960            if ( $update_media_item ) {
3961                if ( ! isset( $post_id ) || 0 === $post_id ) {
3962                    return new WP_Error( 'invalid_input', 'Media ID must be defined.', 400 );
3963                }
3964
3965                $media_array = $_FILES['media']; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.MissingUnslash, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
3966
3967                $file_array             = array();
3968                $file_array['name']     = $media_array['name'][0];
3969                $file_array['type']     = $media_array['type'][0];
3970                $file_array['tmp_name'] = $media_array['tmp_name'][0];
3971                $file_array['error']    = $media_array['error'][0];
3972                $file_array['size']     = $media_array['size'][0];
3973
3974                $edited_media_item = Jetpack_Media::edit_media_file( $post_id, $file_array );
3975
3976                if ( is_wp_error( $edited_media_item ) ) {
3977                    return $edited_media_item;
3978                }
3979
3980                $response = (object) array(
3981                    'id'   => (string) $post_id,
3982                    'file' => (string) $edited_media_item->post_title,
3983                    'url'  => (string) wp_get_attachment_url( $post_id ),
3984                    'type' => (string) $edited_media_item->post_mime_type,
3985                    'meta' => (array) wp_get_attachment_metadata( $post_id ),
3986                );
3987
3988                return array( $response );
3989            }
3990
3991            $attachment_id = media_handle_upload(
3992                '.jetpack.upload.',
3993                $post_id,
3994                array(),
3995                array(
3996                    'action' => 'jetpack_upload_file',
3997                )
3998            );
3999
4000            if ( ! $attachment_id ) {
4001                $uploaded_files[ $index ] = (object) array(
4002                    'error'             => 'unknown',
4003                    'error_description' => 'An unknown problem occurred processing the upload on the Jetpack site',
4004                );
4005            } elseif ( is_wp_error( $attachment_id ) ) {
4006                $uploaded_files[ $index ] = (object) array(
4007                    'error'             => 'attachment_' . $attachment_id->get_error_code(),
4008                    'error_description' => $attachment_id->get_error_message(),
4009                );
4010            } else {
4011                $attachment               = get_post( $attachment_id );
4012                $uploaded_files[ $index ] = (object) array(
4013                    'id'   => (string) $attachment_id,
4014                    'file' => $attachment->post_title,
4015                    'url'  => wp_get_attachment_url( $attachment_id ),
4016                    'type' => $attachment->post_mime_type,
4017                    'meta' => wp_get_attachment_metadata( $attachment_id ),
4018                );
4019            }
4020        }
4021        if ( $global_post !== null ) {
4022            $GLOBALS['post'] = $global_post; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
4023        }
4024
4025        return $uploaded_files;
4026    }
4027
4028    /**
4029     * Add action links for the Jetpack plugin.
4030     *
4031     * @param array $actions Plugin actions.
4032     *
4033     * @return array
4034     */
4035    public function plugin_action_links( $actions ) {
4036        if ( current_user_can( 'jetpack_manage_modules' ) && ( self::is_connection_ready() || ( new Status() )->is_offline_mode() ) ) {
4037            return array_merge(
4038                array( 'settings' => sprintf( '<a href="%s">%s</a>', esc_url( self::admin_url( 'page=jetpack-settings#/settings' ) ), __( 'Settings', 'jetpack' ) ) ),
4039                $actions
4040            );
4041        }
4042
4043        return $actions;
4044    }
4045
4046    /**
4047     * Adds the deactivation warning modal for Jetpack.
4048     *
4049     * @param string $hook The current admin page.
4050     *
4051     * @return void
4052     */
4053    public function deactivate_dialog( $hook ) {
4054        if (
4055            'plugins.php' === $hook
4056            && self::is_connection_ready()
4057        ) {
4058
4059            // Register jp-tracks-functions dependency.
4060            Tracking::register_tracks_functions_scripts( true );
4061
4062            // add a deactivation script that will pick up deactivation actions for the Jetpack plugin.
4063            Assets::register_script(
4064                'jetpack-plugins-page-js',
4065                '_inc/build/plugins-page.js',
4066                JETPACK__PLUGIN_FILE,
4067                array(
4068                    'in_footer'  => true,
4069                    'textdomain' => 'jetpack',
4070                )
4071            );
4072            Assets::enqueue_script( 'jetpack-plugins-page-js' );
4073
4074            // Add objects to be passed to the initial state of the app.
4075            // Use wp_add_inline_script instead of wp_localize_script, see https://core.trac.wordpress.org/ticket/25280.
4076            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' );
4077
4078            add_action( 'admin_footer', array( $this, 'jetpack_plugin_portal_containers' ) );
4079        }
4080    }
4081
4082    /**
4083     * Outputs the wrapper for the plugin modal
4084     * Contents are loaded by React script
4085     *
4086     * @return void
4087     */
4088    public function jetpack_plugin_portal_containers() {
4089        $this->load_view( 'admin/jetpack-plugin-portal-containers.php' );
4090    }
4091
4092    /**
4093     * Filters the login URL to include the registration flow in case the user isn't logged in.
4094     *
4095     * @param string $login_url The wp-login URL.
4096     * @param string $redirect  URL to redirect users after logging in.
4097     * @since Jetpack 8.4
4098     * @return string
4099     */
4100    public function login_url( $login_url, $redirect ) {
4101        parse_str( (string) wp_parse_url( $redirect, PHP_URL_QUERY ), $redirect_parts );
4102        if ( ! empty( $redirect_parts[ self::$jetpack_redirect_login ] ) ) {
4103            $login_url = add_query_arg( self::$jetpack_redirect_login, 'true', $login_url );
4104        }
4105        return $login_url;
4106    }
4107
4108    /**
4109     * Redirects non-authenticated users to authenticate with Calypso if redirect flag is set.
4110     *
4111     * @since Jetpack 8.4
4112     */
4113    public function login_init() {
4114        // phpcs:ignore WordPress.Security.NonceVerification
4115        if ( ! empty( $_GET[ self::$jetpack_redirect_login ] ) ) {
4116            add_filter( 'allowed_redirect_hosts', array( Host::class, 'allow_wpcom_environments' ) );
4117            wp_safe_redirect(
4118                add_query_arg(
4119                    array(
4120                        'forceInstall' => 1,
4121                        'url'          => rawurlencode( get_site_url() ),
4122                    ),
4123                    // @todo provide way to go to specific calypso env.
4124                    self::get_calypso_host() . 'jetpack/connect'
4125                )
4126            );
4127            exit( 0 );
4128        }
4129    }
4130
4131    /*
4132     * Registration flow:
4133     * 1 - ::admin_page_load() action=register
4134     * 2 - ::try_registration()
4135     * 3 - ::register()
4136     *     - Creates jetpack_register option containing two secrets and a timestamp
4137     *     - Calls https://jetpack.wordpress.com/jetpack.register/1/ with
4138     *       siteurl, home, gmt_offset, timezone_string, site_name, secret_1, secret_2, site_lang, timeout, stats_id
4139     *     - That request to jetpack.wordpress.com does not immediately respond.  It first makes a request BACK to this site's
4140     *       xmlrpc.php?for=jetpack: RPC method: jetpack.verifyRegistration, Parameters: secret_1
4141     *     - The XML-RPC request verifies secret_1, deletes both secrets and responds with: secret_2
4142     *     - https://jetpack.wordpress.com/jetpack.register/1/ verifies that XML-RPC response (secret_2) then finally responds itself with
4143     *       jetpack_id, jetpack_secret, jetpack_public
4144     *     - ::register() then stores jetpack_options: id => jetpack_id, blog_token => jetpack_secret
4145     * 4 - redirect to https://wordpress.com/start/jetpack-connect
4146     * 5 - user logs in with WP.com account
4147     * 6 - remote request to this site's xmlrpc.php with action remoteAuthorize, Jetpack_XMLRPC_Server->remote_authorize
4148     *      - Manager::authorize()
4149     *      - Manager::get_token()
4150     *      - GET https://jetpack.wordpress.com/jetpack.token/1/ with
4151     *        client_id, client_secret, grant_type, code, redirect_uri:action=authorize, state, scope, user_email, user_login
4152     *          - which responds with access_token, token_type, scope
4153     *      - Manager::authorize() stores jetpack_options: user_token => access_token.$user_id
4154     *      - Jetpack::activate_default_modules()
4155     *          - Deactivates deprecated plugins
4156     *          - Activates all default modules
4157     *      - Responds with either error, or 'connected' for new connection, or 'linked' for additional linked users
4158     * 7 - For a new connection, user selects a Jetpack plan on wordpress.com
4159     * 8 - User is redirected back to wp-admin/index.php?page=jetpack with state:message=authorized
4160     *     Done!
4161     */
4162
4163    /**
4164     * Build the user-facing description stored alongside a registration error code.
4165     *
4166     * @since 16.2
4167     *
4168     * @see Automattic\Jetpack\Connection\Utils::get_registration_error_description()
4169     *
4170     * @param string $error_code The WP_Error code.
4171     * @param string $message    The WP_Error message.
4172     * @return string The description, empty when the message is not user-facing copy.
4173     */
4174    public static function get_registration_error_description( $error_code, $message ) {
4175        if ( method_exists( Connection_Utils::class, 'get_registration_error_description' ) ) {
4176            return Connection_Utils::get_registration_error_description( $error_code, $message );
4177        }
4178
4179        // Fallback for connection packages that predate it. A raw body would also overflow the state cookie.
4180        if ( 'jetpack_id' === $error_code || is_numeric( $message ) ) {
4181            return '';
4182        }
4183
4184        return mb_substr( (string) $message, 0, 250 );
4185    }
4186
4187    /**
4188     * Handles the page load events for the Jetpack admin page
4189     */
4190    public function admin_page_load() {
4191        $error = false;
4192
4193        // Make sure we have the right body class to hook stylings for subpages off of.
4194        add_filter( 'admin_body_class', array( __CLASS__, 'add_jetpack_pagestyles' ), 20 );
4195
4196        if ( ! empty( $_GET['jetpack_restate'] ) ) {
4197            // Should only be used in intermediate redirects to preserve state across redirects.
4198            self::restate();
4199        }
4200
4201        if ( isset( $_GET['action'] ) ) {
4202            switch ( $_GET['action'] ) {
4203                /**
4204                 * Cases authorize and authorize_redirect are now handled by Connection package Webhooks
4205                 */
4206                case 'authorize_redirect':
4207                case 'authorize':
4208                    break;
4209                case 'register':
4210                    if ( ! current_user_can( 'jetpack_connect' ) ) {
4211                        $error = 'cheatin';
4212                        break;
4213                    }
4214                    check_admin_referer( 'jetpack-register' );
4215                    self::log( 'register' );
4216                    self::maybe_set_version_option();
4217                    $from = isset( $_GET['from'] ) ? sanitize_text_field( wp_unslash( $_GET['from'] ) ) : false;
4218                    if ( $from ) {
4219                        static::connection()->add_register_request_param( 'from', (string) $from );
4220                    }
4221                    $registered = static::connection()->try_registration( true, true );
4222                    if ( is_wp_error( $registered ) ) {
4223                        $error = $registered->get_error_code();
4224                        self::state( 'error', $error );
4225
4226                        self::state( 'error_description', self::get_registration_error_description( $error, $registered->get_error_message() ) );
4227
4228                        /**
4229                         * Jetpack registration Error.
4230                         *
4231                         * @since 7.5.0
4232                         *
4233                         * @param string|int $error The error code.
4234                         * @param \WP_Error $registered The error object.
4235                         */
4236                        do_action( 'jetpack_connection_register_fail', $error, $registered );
4237                        break;
4238                    }
4239
4240                    $redirect = isset( $_GET['redirect'] ) ? wp_unslash( $_GET['redirect'] ) : false; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
4241
4242                    /**
4243                     * Jetpack registration Success.
4244                     *
4245                     * @since 7.5.0
4246                     *
4247                     * @param string $from 'from' GET parameter;
4248                     */
4249                    do_action( 'jetpack_connection_register_success', $from );
4250
4251                    $url = $this->build_connect_url( true, $redirect, $from );
4252
4253                    if ( ! empty( $_GET['auth_approved'] ) && 'true' === $_GET['auth_approved'] ) {
4254                        $url = add_query_arg( 'auth_approved', 'true', $url );
4255                    }
4256
4257                    add_filter( 'allowed_redirect_hosts', array( Host::class, 'allow_wpcom_environments' ) );
4258                    wp_safe_redirect( $url );
4259                    exit( 0 );
4260                case 'activate':
4261                    if ( ! current_user_can( 'jetpack_activate_modules' ) ) {
4262                        $error = 'cheatin';
4263                        break;
4264                    }
4265
4266                    $module = isset( $_GET['module'] ) ? sanitize_text_field( wp_unslash( $_GET['module'] ) ) : '';
4267                    check_admin_referer( "jetpack_activate-$module" );
4268                    self::log( 'activate', $module );
4269                    if ( ! self::activate_module( $module ) ) {
4270                        /* translators: module/feature name */
4271                        self::state( 'error', sprintf( __( 'Could not activate %s', 'jetpack' ), $module ) );
4272                    }
4273                    // The following two lines will rarely happen, as Jetpack::activate_module normally exits at the end.
4274                    wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4275                    exit( 0 );
4276                case 'activate_default_modules':
4277                    check_admin_referer( 'activate_default_modules' );
4278                    self::log( 'activate_default_modules' );
4279                    self::restate();
4280                    $min_version   = isset( $_GET['min_version'] ) ? sanitize_text_field( wp_unslash( $_GET['min_version'] ) ) : false;
4281                    $max_version   = isset( $_GET['max_version'] ) ? sanitize_text_field( wp_unslash( $_GET['max_version'] ) ) : false;
4282                    $other_modules = isset( $_GET['other_modules'] ) && is_array( $_GET['other_modules'] ) ? array_map( 'sanitize_text_field', wp_unslash( $_GET['other_modules'] ) ) : array();
4283                    self::activate_default_modules( $min_version, $max_version, $other_modules );
4284                    wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4285                    exit( 0 );
4286                case 'disconnect':
4287                    if ( ! current_user_can( 'jetpack_disconnect' ) ) {
4288                        $error = 'cheatin';
4289                        break;
4290                    }
4291
4292                    check_admin_referer( 'jetpack-disconnect' );
4293                    self::log( 'disconnect' );
4294                    self::disconnect();
4295                    wp_safe_redirect( self::admin_url( 'disconnected=true' ) );
4296                    exit( 0 );
4297                case 'reconnect':
4298                    if ( ! current_user_can( 'jetpack_reconnect' ) ) {
4299                        $error = 'cheatin';
4300                        break;
4301                    }
4302
4303                    check_admin_referer( 'jetpack-reconnect' );
4304                    self::log( 'reconnect' );
4305                    self::disconnect();
4306
4307                    add_filter( 'allowed_redirect_hosts', array( Host::class, 'allow_wpcom_environments' ) );
4308                    wp_safe_redirect( $this->build_connect_url( true, false, 'reconnect' ) );
4309                    exit( 0 );
4310                case 'deactivate':
4311                    if ( ! current_user_can( 'jetpack_deactivate_modules' ) ) {
4312                        $error = 'cheatin';
4313                        break;
4314                    }
4315
4316                    $modules = sanitize_text_field( wp_unslash( $_GET['module'] ) );
4317                    check_admin_referer( "jetpack_deactivate-$modules" );
4318                    foreach ( explode( ',', $modules ) as $module ) {
4319                        self::log( 'deactivate', $module );
4320                        self::deactivate_module( $module );
4321                        self::state( 'message', 'module_deactivated' );
4322                    }
4323                    self::state( 'module', $modules );
4324                    wp_safe_redirect( self::admin_url( 'page=jetpack' ) );
4325                    exit( 0 );
4326                case 'unlink':
4327                    $redirect = isset( $_GET['redirect'] ) ? sanitize_text_field( wp_unslash( $_GET['redirect'] ) ) : '';
4328                    check_admin_referer( 'jetpack-unlink' );
4329                    self::log( 'unlink' );
4330                    $this->connection_manager->disconnect_user();
4331                    self::state( 'message', 'unlinked' );
4332                    if ( 'sub-unlink' === $redirect ) {
4333                        wp_safe_redirect( admin_url() );
4334                    } else {
4335                        wp_safe_redirect( self::admin_url( array( 'page' => rawurlencode( $redirect ) ) ) );
4336                    }
4337                    exit( 0 );
4338                default:
4339                    /**
4340                     * Fires when a Jetpack admin page is loaded with an unrecognized parameter.
4341                     *
4342                     * @since 2.6.0
4343                     *
4344                     * @param string sanitize_key( $_GET['action'] ) Unrecognized URL parameter.
4345                     */
4346                    do_action( 'jetpack_unrecognized_action', sanitize_key( $_GET['action'] ) );
4347            }
4348        }
4349
4350        $error = $error ? $error : self::state( 'error' );
4351        if ( ! $error ) {
4352            self::activate_new_modules( true );
4353        }
4354
4355        $activated_manage = false;
4356        $message_code     = self::state( 'message' );
4357        if ( self::state( 'optin-manage' ) ) {
4358            $activated_manage = $message_code;
4359            $message_code     = 'jetpack-manage';
4360        }
4361
4362        switch ( $message_code ) {
4363            case 'jetpack-manage':
4364                $sites_url = esc_url( Redirect::get_url( 'calypso-sites' ) );
4365                // translators: %s is the URL to the "Sites" panel on wordpress.com.
4366                $this->message = '<strong>' . sprintf( __( 'You are all set! Your site can now be managed from <a href="%s" target="_blank">wordpress.com/sites</a>.', 'jetpack' ), $sites_url ) . '</strong>';
4367                if ( $activated_manage ) {
4368                    $this->message .= '<br /><strong>' . __( 'Manage has been activated for you!', 'jetpack' ) . '</strong>';
4369                }
4370                break;
4371
4372        }
4373
4374        $deactivated_plugins = self::state( 'deactivated_plugins' );
4375
4376        if ( ! empty( $deactivated_plugins ) ) {
4377            $deactivated_plugins = explode( ',', $deactivated_plugins );
4378            $deactivated_titles  = array();
4379            foreach ( $deactivated_plugins as $deactivated_plugin ) {
4380                list( $module, $idx ) = explode( ':', $deactivated_plugin );
4381                if ( ! isset( $this->plugins_to_deactivate[ $module ][ $idx ] ) ) {
4382                    continue;
4383                }
4384
4385                $deactivated_titles[] = '<strong>' . str_replace( ' ', '&nbsp;', $this->plugins_to_deactivate[ $module ][ $idx ][1] ) . '</strong>';
4386            }
4387
4388            if ( $deactivated_titles ) {
4389                if ( $this->message ) {
4390                    $this->message .= "<br /><br />\n";
4391                }
4392
4393                $this->message .= wp_sprintf(
4394                    _n(
4395                        'Jetpack contains the most recent version of the old %l plugin.',
4396                        'Jetpack contains the most recent versions of the old %l plugins.',
4397                        count( $deactivated_titles ),
4398                        'jetpack'
4399                    ),
4400                    $deactivated_titles
4401                );
4402
4403                $this->message .= "<br />\n";
4404
4405                $this->message .= _n(
4406                    'The old version has been deactivated and can be removed from your site.',
4407                    'The old versions have been deactivated and can be removed from your site.',
4408                    count( $deactivated_titles ),
4409                    'jetpack'
4410                );
4411            }
4412        }
4413
4414        $this->privacy_checks = self::state( 'privacy_checks' );
4415
4416        if ( $this->message || $this->error || $this->privacy_checks ) {
4417            add_action( 'jetpack_notices', array( $this, 'admin_notices' ) );
4418        }
4419
4420        add_filter( 'jetpack_short_module_description', 'wptexturize' );
4421    }
4422
4423    /**
4424     * Display admin notice upon error.
4425     *
4426     * @return void
4427     */
4428    public function admin_notices() {
4429
4430        if ( $this->error ) {
4431            ?>
4432<div id="message" class="jetpack-message jetpack-err">
4433    <div class="squeezer">
4434        <h2>
4435            <?php
4436            echo wp_kses(
4437                $this->error,
4438                array(
4439                    'a'      => array( 'href' => array() ),
4440                    'small'  => true,
4441                    'code'   => true,
4442                    'strong' => true,
4443                    'br'     => true,
4444                    'b'      => true,
4445                )
4446            );
4447            ?>
4448            </h2>
4449            <?php
4450            $desc = self::state( 'error_description' );
4451            if ( $desc ) :
4452                ?>
4453        <p><?php echo esc_html( stripslashes( $desc ) ); ?></p>
4454<?php    endif; ?>
4455    </div>
4456</div>
4457            <?php
4458        }
4459
4460        if ( $this->message ) {
4461            ?>
4462<div id="message" class="jetpack-message">
4463    <div class="squeezer">
4464        <h2>
4465            <?php
4466            echo wp_kses(
4467                $this->message,
4468                array(
4469                    'strong' => array(),
4470                    'a'      => array( 'href' => true ),
4471                    'br'     => true,
4472                )
4473            );
4474            ?>
4475            </h2>
4476    </div>
4477</div>
4478            <?php
4479        }
4480
4481        if ( $this->privacy_checks ) :
4482            $module_names = array();
4483            $module_slugs = array();
4484
4485            $privacy_checks = explode( ',', $this->privacy_checks );
4486            $privacy_checks = array_filter( $privacy_checks, array( 'Jetpack', 'is_module' ) );
4487            foreach ( $privacy_checks as $module_slug ) {
4488                $module = self::get_module( $module_slug );
4489                if ( ! $module ) {
4490                    continue;
4491                }
4492
4493                $module_slugs[] = $module_slug;
4494                $module_names[] = "<strong>{$module['name']}</strong>";
4495            }
4496
4497            $module_slugs = implode( ',', $module_slugs );
4498            ?>
4499<div id="message" class="jetpack-message jetpack-err">
4500    <div class="squeezer">
4501        <h2><strong><?php esc_html_e( 'Is this site private?', 'jetpack' ); ?></strong></h2><br />
4502        <p>
4503            <?php
4504            echo wp_kses(
4505                wptexturize(
4506                    wp_sprintf(
4507                        _nx(
4508                            "Like your site's RSS feeds, %l allows access to your posts and other content to third parties.",
4509                            "Like your site's RSS feeds, %l allow access to your posts and other content to third parties.",
4510                            count( $privacy_checks ),
4511                            '%l = list of Jetpack module/feature names',
4512                            'jetpack'
4513                        ),
4514                        $module_names
4515                    )
4516                ),
4517                array( 'strong' => true )
4518            );
4519
4520            echo "\n<br />\n";
4521
4522            echo wp_kses(
4523                sprintf(
4524                        /* translators: URL to deactivate Jetpack features. */
4525                    _nx(
4526                        'If your site is not publicly accessible, consider <a href="%1$s" title="%2$s">deactivating this feature</a>.',
4527                        'If your site is not publicly accessible, consider <a href="%1$s" title="%2$s">deactivating these features</a>.',
4528                        count( $privacy_checks ),
4529                        '%1$s = deactivation URL, %2$s = "Deactivate {list of Jetpack module/feature names}',
4530                        'jetpack'
4531                    ),
4532                    esc_url(
4533                        wp_nonce_url(
4534                            self::admin_url(
4535                                array(
4536                                    'page'   => 'jetpack',
4537                                    'action' => 'deactivate',
4538                                    'module' => rawurlencode( $module_slugs ),
4539                                )
4540                            ),
4541                            "jetpack_deactivate-$module_slugs"
4542                        )
4543                    ),
4544                    esc_attr( wp_kses( wp_sprintf( _x( 'Deactivate %l', '%l = list of Jetpack module/feature names', 'jetpack' ), $module_names ), array() ) )
4545                ),
4546                array(
4547                    'a' => array(
4548                        'href'  => true,
4549                        'title' => true,
4550                    ),
4551                )
4552            );
4553            ?>
4554        </p>
4555    </div>
4556</div>
4557            <?php
4558endif;
4559    }
4560
4561    /**
4562     * Initialize the jetpack stats instance only when needed
4563     *
4564     * @return void
4565     */
4566    private function initialize_stats() {
4567        if ( $this->a8c_mc_stats_instance === null ) {
4568            $this->a8c_mc_stats_instance = new Automattic\Jetpack\A8c_Mc_Stats();
4569        }
4570    }
4571
4572    /**
4573     * Record a stat for later output.  This will only currently output in the admin_footer.
4574     *
4575     * @param string $group Stats group.
4576     * @param string $detail Stats detail.
4577     */
4578    public function stat( $group, $detail ) {
4579        $this->initialize_stats();
4580        $this->a8c_mc_stats_instance->add( $group, $detail );
4581
4582        // Keep a local copy for backward compatibility (there are some direct checks on this).
4583        $this->stats = $this->a8c_mc_stats_instance->get_current_stats();
4584    }
4585
4586    /**
4587     * Load stats pixels. $group is auto-prefixed with "x_jetpack-"
4588     *
4589     * @param string $method Used to check if method is "server-side".
4590     */
4591    public function do_stats( $method = '' ) {
4592        $this->initialize_stats();
4593        if ( 'server_side' === $method ) {
4594            $this->a8c_mc_stats_instance->do_server_side_stats();
4595        } else {
4596            $this->a8c_mc_stats_instance->do_stats();
4597        }
4598
4599        // Keep a local copy for backward compatibility (there are some direct checks on this).
4600        $this->stats = array();
4601    }
4602
4603    /**
4604     * Runs stats code for a one-off, server-side.
4605     *
4606     * @param array|string $args The arguments to append to the URL. Should include `x_jetpack-{$group}={$stats}` or whatever we want to store.
4607     *
4608     * @return bool If it worked.
4609     */
4610    public static function do_server_side_stat( $args ) {
4611        $url                   = self::build_stats_url( $args );
4612        $a8c_mc_stats_instance = new Automattic\Jetpack\A8c_Mc_Stats();
4613        return $a8c_mc_stats_instance->do_server_side_stat( $url );
4614    }
4615
4616    /**
4617     * Builds the stats url.
4618     *
4619     * @param array|string $args The arguments to append to the URL.
4620     *
4621     * @return string The URL to be pinged.
4622     */
4623    public static function build_stats_url( $args ) {
4624
4625        $a8c_mc_stats_instance = new Automattic\Jetpack\A8c_Mc_Stats();
4626        return $a8c_mc_stats_instance->build_stats_url( $args );
4627    }
4628
4629    /**
4630     * Builds a URL to the Jetpack connection auth page
4631     *
4632     * @since 3.9.5
4633     *
4634     * @param bool        $raw If true, URL will not be escaped.
4635     * @param bool|string $redirect If true, will redirect back to Jetpack wp-admin landing page after connection.
4636     *                              If string, will be a custom redirect.
4637     * @param bool|string $from If not false, adds 'from=$from' param to the connect URL.
4638     * @param bool        $register If true, will generate a register URL regardless of the existing token, since 4.9.0.
4639     *
4640     * @return string Connect URL
4641     */
4642    public function build_connect_url( $raw = false, $redirect = false, $from = false, $register = false ) {
4643        $site_id    = Jetpack_Options::get_option( 'id' );
4644        $blog_token = ( new Tokens() )->get_access_token();
4645
4646        if ( $register || ! $blog_token || ! $site_id ) {
4647            $url = self::nonce_url_no_esc( self::admin_url( 'action=register' ), 'jetpack-register' );
4648
4649            if ( ! empty( $redirect ) ) {
4650                $url = add_query_arg(
4651                    'redirect',
4652                    rawurlencode( wp_validate_redirect( esc_url_raw( $redirect ) ) ),
4653                    $url
4654                );
4655            }
4656
4657            if ( is_network_admin() ) {
4658                $url = add_query_arg( 'is_multisite', network_admin_url( 'admin.php?page=jetpack-settings' ), $url );
4659            }
4660
4661            $calypso_env = ( new Host() )->get_calypso_env();
4662
4663            if ( ! empty( $calypso_env ) ) {
4664                $url = add_query_arg( 'calypso_env', $calypso_env, $url );
4665            }
4666        } else {
4667
4668            // Let's check the existing blog token to see if we need to re-register. We only check once per minute
4669            // because otherwise this logic can get us in to a loop.
4670            $last_connect_url_check = (int) Jetpack_Options::get_raw_option( 'jetpack_last_connect_url_check' );
4671            if ( ! $last_connect_url_check || ( time() - $last_connect_url_check ) > MINUTE_IN_SECONDS ) {
4672                Jetpack_Options::update_raw_option( 'jetpack_last_connect_url_check', time() );
4673
4674                $response = Client::wpcom_json_api_request_as_blog(
4675                    sprintf( '/sites/%d', $site_id ) . '?force=wpcom',
4676                    '1.1'
4677                );
4678
4679                if ( 200 !== wp_remote_retrieve_response_code( $response ) ) {
4680
4681                    // Generating a register URL instead to refresh the existing token.
4682                    return $this->build_connect_url( $raw, $redirect, $from, true );
4683                }
4684            }
4685
4686            $url = ( new Authorize_Redirect( static::connection() ) )->build_authorize_url( $redirect );
4687        }
4688
4689        if ( $from ) {
4690            $url = add_query_arg( 'from', $from, $url );
4691        }
4692
4693        $url = $raw ? esc_url_raw( $url ) : esc_url( $url );
4694        /**
4695         * Filter the URL used when connecting a user to a WordPress.com account.
4696         *
4697         * @since 8.1.0
4698         *
4699         * @param string $url Connection URL.
4700         * @param bool   $raw If true, URL will not be escaped.
4701         */
4702        return apply_filters( 'jetpack_build_connection_url', $url, $raw );
4703    }
4704
4705    /**
4706     * Create the Jetpack authorization URL.
4707     *
4708     * @param bool|string $redirect URL to redirect to.
4709     * @param null        $deprecated Deprecated since Jetpack 10.9.
4710     *
4711     * @todo Update default value for redirect since the called function expects a string.
4712     *
4713     * @deprecated 13.4
4714     *
4715     * @return mixed|void
4716     */
4717    public static function build_authorize_url( $redirect = false, $deprecated = null ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
4718        _deprecated_function( __METHOD__, 'jetpack-13.4', 'Authorize_Redirect::build_authorize_url' );
4719
4720        return ( new Authorize_Redirect( static::connection() ) )->build_authorize_url( $redirect );
4721    }
4722
4723    /**
4724     * Filters the connection URL parameter array.
4725     *
4726     * @deprecated 13.4
4727     *
4728     * @param array $args default URL parameters used by the package.
4729     * @return array the modified URL arguments array.
4730     */
4731    public static function filter_connect_request_body( $args ) {
4732        _deprecated_function( __METHOD__, 'jetpack-13.4', 'Authorize_Redirect::filter_connect_request_body' );
4733
4734        return Authorize_Redirect::filter_connect_request_body( $args );
4735    }
4736
4737    /**
4738     * Filters the `jetpack/v4/connection/data` API response of the Connection package in order to
4739     * add Jetpack-the-plugin related permissions.
4740     *
4741     * @since 10.0
4742     *
4743     * @param array $current_user_connection_data An array containing the current user connection data.
4744     * @return array
4745     */
4746    public static function filter_jetpack_current_user_connection_data( $current_user_connection_data ) {
4747        $jetpack_permissions = array(
4748            'admin_page'         => current_user_can( 'jetpack_admin_page' ),
4749            'manage_modules'     => current_user_can( 'jetpack_manage_modules' ),
4750            'network_admin'      => current_user_can( 'jetpack_network_admin_page' ),
4751            'network_sites_page' => current_user_can( 'jetpack_network_sites_page' ),
4752            'edit_posts'         => current_user_can( 'edit_posts' ),
4753            'publish_posts'      => current_user_can( 'publish_posts' ),
4754            'manage_options'     => current_user_can( 'manage_options' ),
4755            'view_stats'         => current_user_can( 'view_stats' ),
4756            'manage_plugins'     => current_user_can( 'install_plugins' )
4757                                    && current_user_can( 'activate_plugins' )
4758                                    && current_user_can( 'update_plugins' )
4759                                    && current_user_can( 'delete_plugins' ),
4760        );
4761
4762        if ( isset( $current_user_connection_data['permissions'] ) &&
4763            is_array( $current_user_connection_data['permissions'] ) ) {
4764                $current_user_connection_data['permissions'] = array_merge( $current_user_connection_data['permissions'], $jetpack_permissions );
4765        } else {
4766            $current_user_connection_data['permissions'] = $jetpack_permissions;
4767        }
4768
4769        return $current_user_connection_data;
4770    }
4771
4772    /**
4773     * Filters the redirection URL that is used for connect requests. The redirect
4774     * URL should return the user back to the Jetpack console.
4775     *
4776     * @deprecated 13.4
4777     *
4778     * @param String $redirect the default redirect URL used by the package.
4779     * @return String the modified URL.
4780     */
4781    public static function filter_connect_redirect_url( $redirect ) {
4782        _deprecated_function( __METHOD__, 'jetpack-13.4', 'Authorize_Redirect::filter_connect_redirect_url' );
4783        return Authorize_Redirect::filter_connect_redirect_url( $redirect );
4784    }
4785
4786    /**
4787     * This action fires at the beginning of the Manager::authorize method.
4788     */
4789    public static function authorize_starting() {
4790        $jetpack_unique_connection = Jetpack_Options::get_option( 'unique_connection' );
4791        // Checking if site has been active/connected previously before recording unique connection.
4792        if ( ! $jetpack_unique_connection ) {
4793            // jetpack_unique_connection option has never been set.
4794            $jetpack_unique_connection = array(
4795                'connected'    => 0,
4796                'disconnected' => 0,
4797                'version'      => '3.6.1',
4798            );
4799
4800            update_option( 'jetpack_unique_connection', $jetpack_unique_connection );
4801
4802            // Track unique connection.
4803            $jetpack = self::init();
4804
4805            $jetpack->stat( 'connections', 'unique-connection' );
4806            $jetpack->do_stats( 'server_side' );
4807        }
4808
4809        // Increment number of times connected.
4810        $jetpack_unique_connection['connected'] += 1;
4811        Jetpack_Options::update_option( 'unique_connection', $jetpack_unique_connection );
4812    }
4813
4814    /**
4815     * This action fires when the site is registered (connected at a site level).
4816     */
4817    public function handle_unique_registrations_stats() {
4818        $jetpack_unique_registrations = Jetpack_Options::get_option( 'unique_registrations' );
4819        // Checking if site has been registered previously before recording unique connection.
4820        if ( ! $jetpack_unique_registrations ) {
4821
4822            $jetpack_unique_registrations = 0;
4823
4824            $this->stat( 'connections', 'unique-registrations' );
4825            $this->do_stats( 'server_side' );
4826        }
4827
4828        // Increment number of times connected.
4829        ++$jetpack_unique_registrations;
4830        Jetpack_Options::update_option( 'unique_registrations', $jetpack_unique_registrations );
4831    }
4832
4833    /**
4834     * This action fires at the end of the Manager::authorize method when a secondary user is
4835     * linked.
4836     */
4837    public static function authorize_ending_linked() {
4838        // Don't activate anything since we are just connecting a user.
4839        self::state( 'message', 'linked' );
4840    }
4841
4842    /**
4843     * This action fires at the end of the Manager::authorize method when the master user is
4844     * authorized.
4845     *
4846     * @param array $data The request data.
4847     */
4848    public static function authorize_ending_authorized( $data ) {
4849        // If redirect_uri is SSO, ensure SSO module is enabled.
4850        parse_str( wp_parse_url( $data['redirect_uri'], PHP_URL_QUERY ), $redirect_options );
4851
4852        /** This filter is documented in class.jetpack-cli.php */
4853        $jetpack_start_enable_sso = apply_filters( 'jetpack_start_enable_sso', true );
4854
4855        $activate_sso = (
4856            isset( $redirect_options['action'] ) &&
4857            'jetpack-sso' === $redirect_options['action'] &&
4858            $jetpack_start_enable_sso
4859        );
4860
4861        $do_redirect_on_error = ( 'client' === $data['auth_type'] );
4862
4863        self::handle_post_authorization_actions( $activate_sso, $do_redirect_on_error );
4864    }
4865
4866    /**
4867     * Fires on the jetpack_site_registered hook and acitvates default modules
4868     */
4869    public static function activate_default_modules_on_site_register() {
4870        self::handle_default_module_activation( false );
4871
4872        // Since this is a fresh connection, be sure to clear out IDC options.
4873        Identity_Crisis::clear_all_idc_options();
4874    }
4875
4876    /**
4877     * This action fires at the end of the REST_Connector connection_reconnect method when the
4878     * reconnect process is completed.
4879     * Note that this currently only happens when we don't need the user to re-authorize
4880     * their WP.com account, eg in cases where we are restoring a connection with
4881     * unhealthy blog token.
4882     */
4883    public static function reconnection_completed() {
4884        self::state( 'message', 'reconnection_completed' );
4885    }
4886
4887    /**
4888     * Apply activation source to a query string array.
4889     *
4890     * @param array $args Args used for a query string.
4891     *
4892     * @return void
4893     */
4894    public static function apply_activation_source_to_args( &$args ) {
4895        list( $activation_source_name, $activation_source_keyword ) = get_option( 'jetpack_activation_source' );
4896
4897        if ( $activation_source_name ) {
4898            $args['_as'] = rawurlencode( $activation_source_name );
4899        }
4900
4901        if ( $activation_source_keyword ) {
4902            $args['_ak'] = rawurlencode( $activation_source_keyword );
4903        }
4904    }
4905
4906    /**
4907     * Returns the reconnection URL.
4908     *
4909     * @param bool $raw True to return an unescaped URL. False returns value after `esc_url`.
4910     *
4911     * @return string|null
4912     */
4913    public function build_reconnect_url( $raw = false ) {
4914        $url = wp_nonce_url( self::admin_url( 'action=reconnect' ), 'jetpack-reconnect' );
4915        return $raw ? $url : esc_url( $url );
4916    }
4917
4918    /**
4919     * Jetpack Admin URL.
4920     *
4921     * @param array $args Query string args.
4922     *
4923     * @return string Jetpack admin URL.
4924     */
4925    public static function admin_url( $args = null ) {
4926        return ( new Paths() )->admin_url( $args );
4927    }
4928
4929    /**
4930     * Creates a nonce from an URL.
4931     *
4932     * @param string $actionurl URL for action.
4933     * @param string $action Nonce action.
4934     * @param string $name Query arg name.
4935     *
4936     * @return string
4937     */
4938    public static function nonce_url_no_esc( $actionurl, $action = -1, $name = '_wpnonce' ) {
4939        $actionurl = str_replace( '&amp;', '&', $actionurl );
4940        return add_query_arg( $name, wp_create_nonce( $action ), $actionurl );
4941    }
4942
4943    /**
4944     * Dismiss Jetpack notices.
4945     *
4946     * @return void
4947     */
4948    public function dismiss_jetpack_notice() {
4949        if ( ! isset( $_GET['jetpack-notice'] ) ) {
4950            return;
4951        }
4952
4953        switch ( $_GET['jetpack-notice'] ) {
4954            case 'dismiss':
4955                if ( check_admin_referer( 'jetpack-deactivate' ) && ! is_plugin_active_for_network( plugin_basename( JETPACK__PLUGIN_DIR . 'jetpack.php' ) ) ) {
4956
4957                    require_once ABSPATH . 'wp-admin/includes/plugin.php';
4958                    deactivate_plugins( JETPACK__PLUGIN_DIR . 'jetpack.php', false, false );
4959                    wp_safe_redirect( admin_url() . 'plugins.php?deactivate=true&plugin_status=all&paged=1&s=' );
4960                }
4961                break;
4962        }
4963    }
4964
4965    /**
4966     * Determines which module has a higher sort order.
4967     *
4968     * @param array $a Modules array.
4969     * @param array $b Modules array.
4970     *
4971     * @return int 0 if the same sort or (+/-) to indicate which is greater.
4972     */
4973    public static function sort_modules( $a, $b ) {
4974        return $a['sort'] <=> $b['sort'];
4975    }
4976
4977    /**
4978     * Recheck SSL status for use via an AJAX call.
4979     *
4980     * Sends data back via `wp_send_json`.
4981     *
4982     * @return void
4983     */
4984    public function ajax_recheck_ssl() {
4985        check_ajax_referer( 'recheck-ssl', 'ajax-nonce' );
4986        $result = self::permit_ssl( true );
4987        wp_send_json(
4988            array(
4989                'enabled' => $result,
4990                'message' => self::get_ssl_test_message(),
4991            ),
4992            null, // @phan-suppress-current-line PhanTypeMismatchArgumentProbablyReal -- It takes null, but its phpdoc only says int.
4993            JSON_UNESCAPED_SLASHES
4994        );
4995    }
4996
4997    /* Client API */
4998
4999    /**
5000     * Verify the onboarding token.
5001     *
5002     * @deprecated since 13.9
5003     *
5004     * @param array  $token_data Token data.
5005     * @param string $token Token value.
5006     * @param string $request_data JSON-encoded request data.
5007     *
5008     * @return mixed
5009     */
5010    public static function verify_onboarding_token( $token_data, $token, $request_data ) {
5011        _deprecated_function( __METHOD__, '13.9' );
5012        // Default to a blog token.
5013        $token_type = 'blog';
5014
5015        // Let's see if this is onboarding. In such case, use user token type and the provided user id.
5016        if ( isset( $request_data ) || ! empty( $_GET['onboarding'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- no site changes, if caller is changing the site the nonce should be verified there.
5017            if ( ! empty( $_GET['onboarding'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- no site changes.
5018                $jpo = $_GET; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- no site changes.
5019            } else {
5020                $jpo = json_decode( $request_data, true );
5021            }
5022
5023            $jpo_token = ! empty( $jpo['onboarding']['token'] ) ? $jpo['onboarding']['token'] : null;
5024            $jpo_user  = ! empty( $jpo['onboarding']['jpUser'] ) ? $jpo['onboarding']['jpUser'] : null;
5025
5026            if (
5027                isset( $jpo_user )
5028                && isset( $jpo_token )
5029                && is_email( $jpo_user )
5030                && ctype_alnum( $jpo_token )
5031                && isset( $_GET['rest_route'] ) // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- no site changes.
5032                && self::validate_onboarding_token_action(
5033                    $jpo_token,
5034                    wp_unslash( $_GET['rest_route'] ) // phpcs:ignore WordPress.Security.NonceVerification.Recommended, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- no site changes.
5035                )
5036            ) {
5037                $jp_user = get_user_by( 'email', $jpo_user );
5038                if ( $jp_user instanceof \WP_User ) {
5039                    wp_set_current_user( $jp_user->ID );
5040                    $user_can = is_multisite()
5041                        ? current_user_can_for_site( get_current_blog_id(), 'manage_options' )
5042                        : current_user_can( 'manage_options' );
5043                    if ( $user_can ) {
5044                        $token_type              = 'user';
5045                        $token->external_user_id = $jp_user->ID;
5046                    }
5047                }
5048            }
5049
5050            $token_data['type']    = $token_type;
5051            $token_data['user_id'] = $token->external_user_id;
5052        }
5053
5054        return $token_data;
5055    }
5056
5057    /**
5058     * Create a random secret for validating onboarding payload
5059     *
5060     * @deprecated since 13.9
5061     * @return string Secret token
5062     */
5063    public static function create_onboarding_token() {
5064        _deprecated_function( __METHOD__, '13.9' );
5065        $token = Jetpack_Options::get_option( 'onboarding' );
5066        if ( false === ( $token ) ) {
5067            $token = wp_generate_password( 32, false );
5068            Jetpack_Options::update_option( 'onboarding', $token );
5069        }
5070
5071        return $token;
5072    }
5073
5074    /**
5075     * Remove the onboarding token
5076     *
5077     * @deprecated since 13.9
5078     * @return bool True on success, false on failure
5079     */
5080    public static function invalidate_onboarding_token() {
5081        _deprecated_function( __METHOD__, '13.9' );
5082        return Jetpack_Options::delete_option( 'onboarding' );
5083    }
5084
5085    /**
5086     * Validate an onboarding token for a specific action
5087     *
5088     * @deprecated since 13.9
5089     *
5090     * @param string $token Onboarding token.
5091     * @param string $action Action name.
5092     *
5093     * @return boolean True if token/action pair is accepted, false if not
5094     */
5095    public static function validate_onboarding_token_action( $token, $action ) {
5096        _deprecated_function( __METHOD__, '13.9' );
5097        // Compare tokens, bail if tokens do not match.
5098        if ( ! hash_equals( $token, Jetpack_Options::get_option( 'onboarding' ) ) ) {
5099            return false;
5100        }
5101
5102        // List of valid actions we can take.
5103        $valid_actions = array(
5104            '/jetpack/v4/settings',
5105        );
5106
5107        // Only allow valid actions.
5108        if ( ! in_array( $action, $valid_actions, true ) ) {
5109            return false;
5110        }
5111
5112        return true;
5113    }
5114
5115    /**
5116     * Checks to see if the URL is using SSL to connect with Jetpack
5117     *
5118     * @param bool $force_recheck Force SSL recheck.
5119     *
5120     * @return boolean
5121     * @since 2.3.3
5122     */
5123    public static function permit_ssl( $force_recheck = false ) {
5124        if ( ! method_exists( Heartbeat::class, 'permit_ssl' ) ) {
5125            // Skip the SSL-fail notice when the check cannot run.
5126            return true;
5127        }
5128
5129        return Heartbeat::permit_ssl( $force_recheck );
5130    }
5131
5132    /**
5133     * Returns a localized message describing the last SSL connectivity failure, if any.
5134     *
5135     * The Connection package's canonical SSL check stores a neutral reason code; this maps it to
5136     * a translated, `jetpack`-domain message for display in the admin notice and AJAX recheck.
5137     *
5138     * @since 16.1
5139     *
5140     * @return string The localized message, or an empty string when there is no failure.
5141     */
5142    public static function get_ssl_test_message() {
5143        if ( ! method_exists( Heartbeat::class, 'get_ssl_test_error' ) ) {
5144            return '';
5145        }
5146
5147        $error = Heartbeat::get_ssl_test_error();
5148
5149        switch ( $error['code'] ) {
5150            case 'no_ssl_support':
5151                return __( 'WordPress reports no SSL support', 'jetpack' );
5152            case 'bad_response':
5153                return __( 'Response was not OK: ', 'jetpack' ) . $error['detail'];
5154            default:
5155                return '';
5156        }
5157    }
5158
5159    /**
5160     * Displays an admin_notice, alerting the user that outbound SSL isn't working.
5161     */
5162    public function alert_auto_ssl_fail() {
5163        if ( ! current_user_can( 'manage_options' ) ) {
5164            return;
5165        }
5166
5167        $ajax_nonce = wp_create_nonce( 'recheck-ssl' );
5168        ?>
5169
5170        <div id="jetpack-ssl-warning" class="error jp-identity-crisis">
5171            <div class="jp-banner__content">
5172                <h2><?php esc_html_e( 'Outbound HTTPS not working', 'jetpack' ); ?></h2>
5173                <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>
5174                <p>
5175                    <?php esc_html_e( 'Jetpack will re-test for HTTPS support once a day, but you can click here to try again immediately: ', 'jetpack' ); ?>
5176                    <a href="#" id="jetpack-recheck-ssl-button"><?php esc_html_e( 'Try again', 'jetpack' ); ?></a>
5177                    <span id="jetpack-recheck-ssl-output"><?php echo esc_html( self::get_ssl_test_message() ); ?></span>
5178                </p>
5179                <p>
5180                    <?php
5181                    printf(
5182                            /* translators: Both are URLs. First for the connection debug tool and the second for a support page. */
5183                        __( 'For more help, try our <a href="%1$s">connection debugger</a> or <a href="%2$s" target="_blank">troubleshooting tips</a>.', 'jetpack' ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- we're building known HTML.
5184                        esc_url( self::admin_url( array( 'page' => 'jetpack-debugger' ) ) ),
5185                        esc_url( Redirect::get_url( 'jetpack-support-getting-started-troubleshooting-tips' ) )
5186                    );
5187                    ?>
5188                </p>
5189            </div>
5190        </div>
5191        <style>
5192            #jetpack-recheck-ssl-output { margin-left: 5px; color: red; }
5193        </style>
5194        <script type="text/javascript">
5195            jQuery( document ).ready( function( $ ) {
5196                $( '#jetpack-recheck-ssl-button' ).click( function( e ) {
5197                    var $this = $( this );
5198                    $this.html( <?php echo wp_json_encode( esc_html__( 'Checking', 'jetpack' ), JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP ); ?> );
5199                    $( '#jetpack-recheck-ssl-output' ).html( '' );
5200                    e.preventDefault();
5201                    var data = { action: 'jetpack-recheck-ssl', 'ajax-nonce': <?php echo wp_json_encode( $ajax_nonce, JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP ); ?> };
5202                    $.post( ajaxurl, data )
5203                    .done( function( response ) {
5204                        if ( response.enabled ) {
5205                            $( '#jetpack-ssl-warning' ).hide();
5206                        } else {
5207                            this.html( <?php echo wp_json_encode( esc_html__( 'Try again', 'jetpack' ), JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP ); ?> );
5208                            $( '#jetpack-recheck-ssl-output' ).html( 'SSL Failed: ' + response.message );
5209                        }
5210                    }.bind( $this ) );
5211                } );
5212            } );
5213        </script>
5214
5215        <?php
5216    }
5217
5218    /**
5219     * Returns the connection manager object.
5220     *
5221     * @return Automattic\Jetpack\Connection\Manager
5222     */
5223    public static function connection() {
5224        $jetpack = static::init();
5225
5226        // If the connection manager hasn't been instantiated, do that now.
5227        if ( ! $jetpack->connection_manager ) {
5228            $jetpack->connection_manager = new Connection_Manager( 'jetpack' );
5229        }
5230
5231        return $jetpack->connection_manager;
5232    }
5233
5234    /**
5235     * Get verification secrets.
5236     *
5237     * @param string $action Action name.
5238     * @param int    $user_id User ID.
5239     *
5240     * @return array|string|WP_Error
5241     */
5242    public static function get_secrets( $action, $user_id ) {
5243        $secrets = ( new Secrets() )->get( $action, $user_id );
5244
5245        if ( Secrets::SECRETS_MISSING === $secrets ) {
5246            return new WP_Error( 'verify_secrets_missing', 'Verification secrets not found' );
5247        }
5248
5249        if ( Secrets::SECRETS_EXPIRED === $secrets ) {
5250            return new WP_Error( 'verify_secrets_expired', 'Verification took too long' );
5251        }
5252
5253        return $secrets;
5254    }
5255
5256    /**
5257     * Filters the token request body to include tracking properties.
5258     *
5259     * @param array $properties Token request properties.
5260     *
5261     * @return array amended properties.
5262     */
5263    public static function filter_token_request_body( $properties ) {
5264        $tracking        = new Tracking();
5265        $tracks_identity = $tracking->tracks_get_identity( get_current_user_id() );
5266
5267        return array_merge(
5268            $properties,
5269            array(
5270                '_ui' => $tracks_identity['_ui'],
5271                '_ut' => $tracks_identity['_ut'],
5272            )
5273        );
5274    }
5275
5276    /**
5277     * If the db version is showing something other that what we've got now, bump it to current.
5278     *
5279     * @return bool True if the option was incorrect and updated, false if nothing happened.
5280     */
5281    public static function maybe_set_version_option() {
5282        list( $version ) = explode( ':', Jetpack_Options::get_option( 'version' ) );
5283        if ( JETPACK__VERSION !== $version ) {
5284            Jetpack_Options::update_option( 'version', JETPACK__VERSION . ':' . time() );
5285
5286            if ( version_compare( JETPACK__VERSION, $version, '>' ) ) {
5287                /** This action is documented in class.jetpack.php */
5288                do_action( 'updating_jetpack_version', JETPACK__VERSION, $version );
5289            }
5290
5291            return true;
5292        }
5293        return false;
5294    }
5295
5296    /* Client Server API */
5297
5298    /**
5299     * State is passed via cookies from one request to the next, but never to subsequent requests.
5300     * SET: state( $key, $value );
5301     * GET: $value = state( $key );
5302     *
5303     * @param string $key State key.
5304     * @param string $value Value.
5305     * @param bool   $restate Reset the cookie (private).
5306     */
5307    public static function state( $key = null, $value = null, $restate = false ) {
5308        return ( new CookieState() )->state( $key, $value, $restate );
5309    }
5310
5311    /**
5312     * Set an empty state.
5313     *
5314     * @return void
5315     */
5316    public static function restate() {
5317        self::state( null, null, true );
5318    }
5319
5320    /**
5321     * Determines whether the jetpackState[$key] value should be added to the
5322     * cookie.
5323     *
5324     * @param string $key The state key.
5325     *
5326     * @return boolean Whether the value should be added to the cookie.
5327     */
5328    public static function should_set_cookie( $key ) {
5329        return ( new CookieState() )->should_set_cookie( $key );
5330    }
5331
5332    /**
5333     * Check if site is publicly accessible.
5334     *
5335     * @param string $file Module file.
5336     *
5337     * @return void
5338     */
5339    public static function check_privacy( $file ) {
5340        static $is_site_publicly_accessible = null;
5341
5342        if ( $is_site_publicly_accessible === null ) {
5343            $is_site_publicly_accessible = false;
5344
5345            $rpc = new Jetpack_IXR_Client();
5346
5347            $success = $rpc->query( 'jetpack.isSitePubliclyAccessible', home_url() );
5348            if ( $success ) {
5349                $response = $rpc->getResponse();
5350                if ( $response ) {
5351                    $is_site_publicly_accessible = true;
5352                }
5353            }
5354
5355            Jetpack_Options::update_option( 'public', (int) $is_site_publicly_accessible );
5356        }
5357
5358        if ( $is_site_publicly_accessible ) {
5359            return;
5360        }
5361
5362        $module_slug = self::get_module_slug( $file );
5363
5364        $privacy_checks = self::state( 'privacy_checks' );
5365        if ( ! $privacy_checks ) {
5366            $privacy_checks = $module_slug;
5367        } else {
5368            $privacy_checks .= ",$module_slug";
5369        }
5370
5371        self::state( 'privacy_checks', $privacy_checks );
5372    }
5373
5374    /* JSON API Authorization */
5375
5376    /**
5377     * Handles the login action for Authorizing the JSON API
5378     */
5379    public function login_form_json_api_authorization() {
5380        $authorize_json_api = new Authorize_Json_Api();
5381        $authorize_json_api->verify_json_api_authorization_request();
5382
5383        add_action( 'wp_login', array( $authorize_json_api, 'store_json_api_authorization_token' ), 10, 2 );
5384
5385        add_action( 'login_message', array( $authorize_json_api, 'login_message_json_api_authorization' ) );
5386        add_action( 'login_form', array( $this, 'preserve_action_in_login_form_for_json_api_authorization' ) );
5387        add_filter( 'site_url', array( $this, 'post_login_form_to_signed_url' ), 10, 3 );
5388    }
5389
5390    /**
5391     * Make sure the login form is POSTed to the signed URL so we can reverify the request.
5392     *
5393     * @param string $url Redirect URL.
5394     * @param string $path Path.
5395     * @param string $scheme URL Scheme.
5396     */
5397    public function post_login_form_to_signed_url( $url, $path, $scheme ) {
5398        if ( 'wp-login.php' !== $path || ( 'login_post' !== $scheme && 'login' !== $scheme ) ) {
5399            return $url;
5400        }
5401        $query_string = isset( $_SERVER['QUERY_STRING'] ) ? wp_unslash( $_SERVER['QUERY_STRING'] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
5402        $parsed_url   = wp_parse_url( $url );
5403        $url          = strtok( $url, '?' );
5404        $url          = "$url?{$query_string}";
5405        if ( ! empty( $parsed_url['query'] ) ) {
5406            $url .= "&{$parsed_url['query']}";
5407        }
5408
5409        return $url;
5410    }
5411
5412    /**
5413     * Make sure the POSTed request is handled by the same action.
5414     */
5415    public function preserve_action_in_login_form_for_json_api_authorization() {
5416        $http_host   = isset( $_SERVER['HTTP_HOST'] ) ? wp_unslash( $_SERVER['HTTP_HOST'] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- escaped with esc_url below.
5417        $request_uri = isset( $_SERVER['REQUEST_URI'] ) ? wp_unslash( $_SERVER['REQUEST_URI'] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- escaped with esc_url below.
5418        echo "<input type='hidden' name='action' value='jetpack_json_api_authorization' />\n";
5419        echo "<input type='hidden' name='jetpack_json_api_original_query' value='" . esc_url( set_url_scheme( $http_host . $request_uri ) ) . "' />\n";
5420    }
5421
5422    /**
5423     * If someone logs in to approve API access, store the Access Code in usermeta.
5424     *
5425     * @deprecated 13.4
5426     *
5427     * @param string  $user_login Unused.
5428     * @param WP_User $user User logged in.
5429     */
5430    public function store_json_api_authorization_token( $user_login, $user ) {
5431        _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Connection\\Authorize_Json_Api::store_json_api_authorization_token' );
5432
5433        return ( new Authorize_Json_Api() )->store_json_api_authorization_token( $user_login, $user );
5434    }
5435
5436    /**
5437     * Add public-api.wordpress.com to the safe redirect allowed list - only added when someone allows API access.
5438     *
5439     * To be used with a filter of allowed domains for a redirect.
5440     *
5441     * @deprecated 13.4
5442     *
5443     * @param array $domains Allowed WP.com Environments.
5444     */
5445    public function allow_wpcom_public_api_domain( $domains ) {
5446        _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Status\\Host::allow_wpcom_public_api_domain' );
5447
5448        return Host::allow_wpcom_public_api_domain( $domains );
5449    }
5450
5451    /**
5452     * Check if the redirect is encoded.
5453     *
5454     * @deprecated 13.4
5455     *
5456     * @param string $redirect_url Redirect URL.
5457     *
5458     * @return bool If redirect has been encoded.
5459     */
5460    public static function is_redirect_encoded( $redirect_url ) {
5461        _deprecated_function( __METHOD__, 'jetpack-13.4' );
5462        return preg_match( '/https?%3A%2F%2F/i', $redirect_url ) > 0;
5463    }
5464
5465    /**
5466     * Add all wordpress.com environments to the safe redirect allowed list.
5467     *
5468     * To be used with a filter of allowed domains for a redirect.
5469     *
5470     * @param array $domains Allowed WP.com Environments.
5471     *
5472     * @deprecated since 11.1
5473     */
5474    public function allow_wpcom_environments( $domains ) {
5475        return Host::allow_wpcom_environments( $domains );
5476    }
5477
5478    /**
5479     * Add the Access Code details to the public-api.wordpress.com redirect.
5480     *
5481     * @deprecated 13.4
5482     *
5483     * @param string  $redirect_to URL.
5484     * @param string  $original_redirect_to URL.
5485     * @param WP_User $user WP_User for the redirect.
5486     *
5487     * @return string
5488     */
5489    public function add_token_to_login_redirect_json_api_authorization( $redirect_to, $original_redirect_to, $user ) {
5490        _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Connection\\Authorize_Json_Api::add_token_to_login_redirect_json_api_authorization' );
5491
5492        return ( new Authorize_Json_Api() )->add_token_to_login_redirect_json_api_authorization( $redirect_to, $original_redirect_to, $user );
5493    }
5494
5495    /**
5496     * Verifies the request by checking the signature
5497     *
5498     * @deprecated 13.4
5499     *
5500     * @since 4.6.0 Method was updated to use `$_REQUEST` instead of `$_GET` and `$_POST`. Method also updated to allow
5501     * passing in an `$environment` argument that overrides `$_REQUEST`. This was useful for integrating with SSO.
5502     *
5503     * @param null|array $environment Value to override $_REQUEST.
5504     */
5505    public function verify_json_api_authorization_request( $environment = null ) {
5506        _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Connection\\Authorize_Json_Api::verify_json_api_authorization_request' );
5507
5508        return ( new Authorize_Json_Api() )->verify_json_api_authorization_request( $environment );
5509    }
5510
5511    /**
5512     * HTML for the JSON API authorization notice.
5513     *
5514     * @deprecated 13.4
5515     *
5516     * @return string
5517     */
5518    public function login_message_json_api_authorization() {
5519        _deprecated_function( __METHOD__, 'jetpack-13.4', 'Automattic\\Jetpack\\Connection\\Authorize_Json_Api::login_message_json_api_authorization' );
5520
5521        return ( new Authorize_Json_Api() )->login_message_json_api_authorization();
5522    }
5523
5524    /**
5525     * Get $content_width, but with a <s>twist</s> filter.
5526     */
5527    public static function get_content_width() {
5528        $content_width = ( isset( $GLOBALS['content_width'] ) && is_numeric( $GLOBALS['content_width'] ) )
5529            ? $GLOBALS['content_width']
5530            : false;
5531        /**
5532         * Filter the Content Width value.
5533         *
5534         * @since 2.2.3
5535         *
5536         * @param string $content_width Content Width value.
5537         */
5538        return apply_filters( 'jetpack_content_width', $content_width );
5539    }
5540
5541    /**
5542     * Pings the WordPress.com Mirror Site for the specified options.
5543     *
5544     * @param string|array $option_names The option names to request from the WordPress.com Mirror Site.
5545     *
5546     * @return array An associative array of the option values as stored in the WordPress.com Mirror Site
5547     */
5548    public function get_cloud_site_options( $option_names ) {
5549        $option_names = array_filter( (array) $option_names, 'is_string' );
5550
5551        $xml = new Jetpack_IXR_Client();
5552        $xml->query( 'jetpack.fetchSiteOptions', $option_names );
5553        if ( $xml->isError() ) {
5554            return array(
5555                'error_code' => $xml->getErrorCode(),
5556                'error_msg'  => $xml->getErrorMessage(),
5557            );
5558        }
5559        $cloud_site_options = $xml->getResponse();
5560
5561        return $cloud_site_options;
5562    }
5563
5564    /**
5565     * Checks if the site is currently in an identity crisis.
5566     *
5567     * Now delegates to the Connection package so this matches what the heartbeat itself reports.
5568     * Note the package guards on `Connection\Manager::is_connected()` where this used to guard on
5569     * `Jetpack::is_connection_ready()`, so the `jetpack_is_connection_ready` filter no longer applies.
5570     *
5571     * @deprecated 16.2
5572     *
5573     * @return array|bool Array of options that are in a crisis, or false if everything is OK.
5574     */
5575    public static function check_identity_crisis() {
5576        _deprecated_function( __METHOD__, 'jetpack-16.2', 'Automattic\\Jetpack\\Identity_Crisis::check_identity_crisis' );
5577
5578        return Identity_Crisis::check_identity_crisis();
5579    }
5580
5581    /**
5582     * Normalizes a url by doing three things:
5583     *  - Strips protocol
5584     *  - Strips www
5585     *  - Adds a trailing slash
5586     *
5587     * @since 4.4.0
5588     * @param string $url URL.
5589     * @return WP_Error|string
5590     */
5591    public static function normalize_url_protocol_agnostic( $url ) {
5592        $parsed_url = wp_parse_url( trailingslashit( esc_url_raw( $url ) ) );
5593        if ( ! $parsed_url || empty( $parsed_url['host'] ) || empty( $parsed_url['path'] ) ) {
5594            /* translators: URL string */
5595            return new WP_Error( 'cannot_parse_url', sprintf( esc_html__( 'Cannot parse URL %s', 'jetpack' ), $url ) );
5596        }
5597
5598        // Strip www and protocols.
5599        $url = preg_replace( '/^www\./i', '', $parsed_url['host'] . $parsed_url['path'] );
5600        return $url;
5601    }
5602
5603    /**
5604     * Maybe Use a .min.css stylesheet, maybe not.
5605     *
5606     * Hooks onto `plugins_url` filter at priority 1, and accepts all 3 args.
5607     *
5608     * @param string $url URL.
5609     * @param string $path File path.
5610     * @param string $plugin Plugin.
5611     *
5612     * @return mixed
5613     */
5614    public static function maybe_min_asset( $url, $path, $plugin ) {
5615        // Short out on things trying to find actual paths.
5616        if ( ! $path || empty( $plugin ) ) {
5617            return $url;
5618        }
5619
5620        $path = ltrim( $path, '/' );
5621
5622        // Strip out the abspath.
5623        $base = dirname( plugin_basename( $plugin ) );
5624
5625        // Short out on non-Jetpack assets.
5626        if ( ! str_starts_with( $base, 'jetpack/' ) ) {
5627            return $url;
5628        }
5629
5630        // File name parsing.
5631        $file              = "{$base}/{$path}";
5632        $full_path         = JETPACK__PLUGIN_DIR . substr( $file, 8 );
5633        $file_name         = substr( $full_path, strrpos( $full_path, '/' ) + 1 );
5634        $file_name_parts_r = array_reverse( explode( '.', $file_name ) );
5635        $extension         = array_shift( $file_name_parts_r );
5636
5637        if ( in_array( strtolower( $extension ), array( 'css', 'js' ), true ) ) {
5638            // Already pointing at the minified version.
5639            if ( 'min' === $file_name_parts_r[0] ) {
5640                return $url;
5641            }
5642
5643            $min_full_path = preg_replace( "#\.{$extension}$#", ".min.{$extension}", $full_path );
5644            if ( file_exists( $min_full_path ) ) {
5645                $url = preg_replace( "#\.{$extension}$#", ".min.{$extension}", $url );
5646                // If it's a CSS file, stash it so we can set the .min suffix for rtl-ing.
5647                if ( 'css' === $extension ) {
5648                    $key                      = str_replace( JETPACK__PLUGIN_DIR, 'jetpack/', $min_full_path );
5649                    self::$min_assets[ $key ] = $path;
5650                }
5651            }
5652        }
5653
5654        return $url;
5655    }
5656
5657    /**
5658     * If the asset is minified, let's flag .min as the suffix.
5659     *
5660     * Attached to `style_loader_src` filter.
5661     *
5662     * @param string $src source file.
5663     * @param string $handle The registered handle of the script in question.
5664     *
5665     * @return mixed
5666     */
5667    public static function set_suffix_on_min( $src, $handle ) {
5668        if ( ! is_string( $src ) || ! str_contains( $src, '.min.css' ) ) {
5669            return $src;
5670        }
5671
5672        if ( ! empty( self::$min_assets ) ) {
5673            foreach ( self::$min_assets as $file => $path ) {
5674                if ( str_contains( $src, $file ) ) {
5675                    wp_style_add_data( $handle, 'suffix', '.min' );
5676                    return $src;
5677                }
5678            }
5679        }
5680
5681        return $src;
5682    }
5683
5684    /**
5685     * Maybe inlines a stylesheet.
5686     *
5687     * @deprecated since 11.7.
5688     *
5689     * @param string $tag The tag that would link to the external asset.
5690     * @param string $handle The registered handle of the script in question.
5691     *
5692     * @return string
5693     */
5694    public static function maybe_inline_style( $tag, $handle ) { //phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
5695        _deprecated_function( __METHOD__, '11.7', 'wp_maybe_inline_styles' );
5696
5697        return $tag;
5698    }
5699
5700    /**
5701     * Loads a view file from the views
5702     *
5703     * Data passed in with the $data parameter will be available in the
5704     * template file as $data['value']
5705     *
5706     * @html-template-var array $data
5707     *
5708     * @param string $template - Template file to load.
5709     * @param array  $data - Any data to pass along to the template.
5710     * @return boolean - If template file was found.
5711     **/
5712    public function load_view( $template, $data = array() ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable -- This is used via the required files.
5713        $views_dir = JETPACK__PLUGIN_DIR . 'views/';
5714
5715        if ( file_exists( $views_dir . $template ) ) {
5716            require_once $views_dir . $template;
5717            return true;
5718        }
5719
5720        if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
5721            trigger_error( sprintf( 'Jetpack: Unable to find view file: %s', esc_html( $views_dir . $template ) ), E_USER_WARNING ); // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_trigger_error
5722        }
5723        return false;
5724    }
5725
5726    /**
5727     * Register Jetpack-specific tests on the connection package's health test suite.
5728     *
5729     * @param \Automattic\Jetpack\Connection\Connection_Health_Tests $connection_tests The test suite instance.
5730     */
5731    public function register_jetpack_connection_tests( $connection_tests ) {
5732        require_once JETPACK__PLUGIN_DIR . '_inc/lib/debugger/class-jetpack-cxn-tests.php';
5733        $jetpack_tests = new Jetpack_Cxn_Tests();
5734        $jetpack_tests->register_tests_on( $connection_tests );
5735    }
5736
5737    /**
5738     * Throws warnings for deprecated hooks to be removed from Jetpack that cannot remain in the original place in the code.
5739     */
5740    public function deprecated_hooks() {
5741        $filter_deprecated_list = array(
5742            'jetpack_bail_on_shortcode'                    => array(
5743                'replacement' => 'jetpack_shortcodes_to_include',
5744                'version'     => 'jetpack-3.1.0',
5745            ),
5746            'wpl_sharing_2014_1'                           => array(
5747                'replacement' => null,
5748                'version'     => 'jetpack-3.6.0',
5749            ),
5750            'jetpack-tools-to-include'                     => array(
5751                'replacement' => 'jetpack_tools_to_include',
5752                'version'     => 'jetpack-3.9.0',
5753            ),
5754            'jetpack_identity_crisis_options_to_check'     => array(
5755                'replacement' => null,
5756                'version'     => 'jetpack-4.0.0',
5757            ),
5758            'update_option_jetpack_single_user_site'       => array(
5759                'replacement' => null,
5760                'version'     => 'jetpack-4.3.0',
5761            ),
5762            'audio_player_default_colors'                  => array(
5763                'replacement' => null,
5764                'version'     => 'jetpack-4.3.0',
5765            ),
5766            'add_option_jetpack_featured_images_enabled'   => array(
5767                'replacement' => null,
5768                'version'     => 'jetpack-4.3.0',
5769            ),
5770            'add_option_jetpack_update_details'            => array(
5771                'replacement' => null,
5772                'version'     => 'jetpack-4.3.0',
5773            ),
5774            'add_option_jetpack_updates'                   => array(
5775                'replacement' => null,
5776                'version'     => 'jetpack-4.3.0',
5777            ),
5778            'add_option_jetpack_network_name'              => array(
5779                'replacement' => null,
5780                'version'     => 'jetpack-4.3.0',
5781            ),
5782            'add_option_jetpack_network_allow_new_registrations' => array(
5783                'replacement' => null,
5784                'version'     => 'jetpack-4.3.0',
5785            ),
5786            'add_option_jetpack_network_add_new_users'     => array(
5787                'replacement' => null,
5788                'version'     => 'jetpack-4.3.0',
5789            ),
5790            'add_option_jetpack_network_site_upload_space' => array(
5791                'replacement' => null,
5792                'version'     => 'jetpack-4.3.0',
5793            ),
5794            'add_option_jetpack_network_upload_file_types' => array(
5795                'replacement' => null,
5796                'version'     => 'jetpack-4.3.0',
5797            ),
5798            'add_option_jetpack_network_enable_administration_menus' => array(
5799                'replacement' => null,
5800                'version'     => 'jetpack-4.3.0',
5801            ),
5802            'add_option_jetpack_is_multi_site'             => array(
5803                'replacement' => null,
5804                'version'     => 'jetpack-4.3.0',
5805            ),
5806            'add_option_jetpack_is_main_network'           => array(
5807                'replacement' => null,
5808                'version'     => 'jetpack-4.3.0',
5809            ),
5810            'add_option_jetpack_main_network_site'         => array(
5811                'replacement' => null,
5812                'version'     => 'jetpack-4.3.0',
5813            ),
5814            'jetpack_sync_all_registered_options'          => array(
5815                'replacement' => null,
5816                'version'     => 'jetpack-4.3.0',
5817            ),
5818            'jetpack_has_identity_crisis'                  => array(
5819                'replacement' => 'jetpack_sync_error_idc_validation',
5820                'version'     => 'jetpack-4.4.0',
5821            ),
5822            'jetpack_is_post_mailable'                     => array(
5823                'replacement' => null,
5824                'version'     => 'jetpack-4.4.0',
5825            ),
5826            'jetpack_seo_site_host'                        => array(
5827                'replacement' => null,
5828                'version'     => 'jetpack-5.1.0',
5829            ),
5830            'jetpack_installed_plugin'                     => array(
5831                'replacement' => 'jetpack_plugin_installed',
5832                'version'     => 'jetpack-6.0.0',
5833            ),
5834            'jetpack_holiday_snow_option_name'             => array(
5835                'replacement' => null,
5836                'version'     => 'jetpack-6.0.0',
5837            ),
5838            'jetpack_holiday_chance_of_snow'               => array(
5839                'replacement' => null,
5840                'version'     => 'jetpack-6.0.0',
5841            ),
5842            'jetpack_holiday_snow_js_url'                  => array(
5843                'replacement' => null,
5844                'version'     => 'jetpack-6.0.0',
5845            ),
5846            'jetpack_is_holiday_snow_season'               => array(
5847                'replacement' => null,
5848                'version'     => 'jetpack-6.0.0',
5849            ),
5850            'jetpack_holiday_snow_option_updated'          => array(
5851                'replacement' => null,
5852                'version'     => 'jetpack-6.0.0',
5853            ),
5854            'jetpack_holiday_snowing'                      => array(
5855                'replacement' => null,
5856                'version'     => 'jetpack-6.0.0',
5857            ),
5858            'jetpack_sso_auth_cookie_expirtation'          => array(
5859                'replacement' => 'jetpack_sso_auth_cookie_expiration',
5860                'version'     => 'jetpack-6.1.0',
5861            ),
5862            'jetpack_cache_plans'                          => array(
5863                'replacement' => null,
5864                'version'     => 'jetpack-6.1.0',
5865            ),
5866            'jetpack_enable_site_verification'             => array(
5867                'replacement' => null,
5868                'version'     => 'jetpack-6.5.0',
5869            ),
5870            'can_display_jetpack_manage_notice'            => array(
5871                'replacement' => null,
5872                'version'     => 'jetpack-7.3.0',
5873            ),
5874            'atd_http_post_timeout'                        => array(
5875                'replacement' => null,
5876                'version'     => 'jetpack-7.3.0',
5877            ),
5878            'atd_service_domain'                           => array(
5879                'replacement' => null,
5880                'version'     => 'jetpack-7.3.0',
5881            ),
5882            'atd_load_scripts'                             => array(
5883                'replacement' => null,
5884                'version'     => 'jetpack-7.3.0',
5885            ),
5886            'jetpack_widget_authors_exclude'               => array(
5887                'replacement' => 'jetpack_widget_authors_params',
5888                'version'     => 'jetpack-7.7.0',
5889            ),
5890            // Removed in Jetpack 7.9.0.
5891            'jetpack_pwa_manifest'                         => array(
5892                'replacement' => null,
5893                'version'     => 'jetpack-7.9.0',
5894            ),
5895            'jetpack_pwa_background_color'                 => array(
5896                'replacement' => null,
5897                'version'     => 'jetpack-7.9.0',
5898            ),
5899            'jetpack_check_mobile'                         => array(
5900                'replacement' => null,
5901                'version'     => 'jetpack-8.3.0',
5902            ),
5903            'jetpack_mobile_stylesheet'                    => array(
5904                'replacement' => null,
5905                'version'     => 'jetpack-8.3.0',
5906            ),
5907            'jetpack_mobile_template'                      => array(
5908                'replacement' => null,
5909                'version'     => 'jetpack-8.3.0',
5910            ),
5911            'jetpack_mobile_theme_menu'                    => array(
5912                'replacement' => null,
5913                'version'     => 'jetpack-8.3.0',
5914            ),
5915            'minileven_show_featured_images'               => array(
5916                'replacement' => null,
5917                'version'     => 'jetpack-8.3.0',
5918            ),
5919            'minileven_attachment_size'                    => array(
5920                'replacement' => null,
5921                'version'     => 'jetpack-8.3.0',
5922            ),
5923            'instagram_cache_oembed_api_response_body'     => array(
5924                'replacement' => null,
5925                'version'     => 'jetpack-9.1.0',
5926            ),
5927            'jetpack_can_make_outbound_https'              => array(
5928                'replacement' => null,
5929                'version'     => 'jetpack-9.1.0',
5930            ),
5931            'sharing_email_can_send'                       => array(
5932                'replacement' => null,
5933                'version'     => 'jetpack-11.0.0',
5934            ),
5935            'sharing_email_check'                          => array(
5936                'replacement' => null,
5937                'version'     => 'jetpack-11.0.0',
5938            ),
5939            'sharing_services_email'                       => array(
5940                'replacement' => null,
5941                'version'     => 'jetpack-11.0.0',
5942            ),
5943            'jetpack_dsp_promote_posts_enabled'            => array(
5944                'replacement' => null,
5945                'version'     => 'jetpack-11.8.0',
5946            ),
5947            'jetpack_are_blogging_prompts_enabled'         => array(
5948                'replacement' => null,
5949                'version'     => 'jetpack-11.8.0',
5950            ),
5951            'jetpack_subscriptions_modal_enabled'          => array(
5952                'replacement' => null,
5953                'version'     => 'jetpack-12.7.0',
5954            ),
5955            'jetpack_pre_connection_prompt_helpers'        => array(
5956                'replacement' => null,
5957                'version'     => 'jetpack-13.2.0',
5958            ),
5959            'jetpack_contact_form_use_package'             => array(
5960                'replacement' => null,
5961                'version'     => 'jetpack-13.4.0',
5962            ),
5963            // jetpack_implode_frontend_css has been removed, but is not listed here. The updated behavior is exactly the only use of the filter.
5964            // We can reassess formally deprecating it here later; for now, it would be noise with no functional difference.
5965        );
5966
5967        foreach ( $filter_deprecated_list as $tag => $args ) {
5968            if ( has_filter( $tag ) ) {
5969                apply_filters_deprecated( $tag, array( null ), $args['version'], $args['replacement'] );
5970            }
5971        }
5972
5973        $action_deprecated_list = array(
5974            'jetpack_updated_theme'        => array(
5975                'replacement' => 'jetpack_updated_themes',
5976                'version'     => 'jetpack-6.2.0',
5977            ),
5978            'atd_http_post_error'          => array(
5979                'replacement' => null,
5980                'version'     => 'jetpack-7.3.0',
5981            ),
5982            'mobile_reject_mobile'         => array(
5983                'replacement' => null,
5984                'version'     => 'jetpack-8.3.0',
5985            ),
5986            'mobile_force_mobile'          => array(
5987                'replacement' => null,
5988                'version'     => 'jetpack-8.3.0',
5989            ),
5990            'mobile_app_promo_download'    => array(
5991                'replacement' => null,
5992                'version'     => 'jetpack-8.3.0',
5993            ),
5994            'mobile_setup'                 => array(
5995                'replacement' => null,
5996                'version'     => 'jetpack-8.3.0',
5997            ),
5998            'jetpack_mobile_footer_before' => array(
5999                'replacement' => null,
6000                'version'     => 'jetpack-8.3.0',
6001            ),
6002            'wp_mobile_theme_footer'       => array(
6003                'replacement' => null,
6004                'version'     => 'jetpack-8.3.0',
6005            ),
6006            'minileven_credits'            => array(
6007                'replacement' => null,
6008                'version'     => 'jetpack-8.3.0',
6009            ),
6010            'jetpack_mobile_header_before' => array(
6011                'replacement' => null,
6012                'version'     => 'jetpack-8.3.0',
6013            ),
6014            'jetpack_mobile_header_after'  => array(
6015                'replacement' => null,
6016                'version'     => 'jetpack-8.3.0',
6017            ),
6018            'sharing_email_dialog'         => array(
6019                'replacement' => null,
6020                'version'     => 'jetpack-11.0.0',
6021            ),
6022            'sharing_email_send_post'      => array(
6023                'replacement' => null,
6024                'version'     => 'jetpack-11.0.0',
6025            ),
6026        );
6027
6028        foreach ( $action_deprecated_list as $tag => $args ) {
6029            if ( has_action( $tag ) ) {
6030                do_action_deprecated( $tag, array(), $args['version'], $args['replacement'] );
6031            }
6032        }
6033    }
6034
6035    /**
6036     * Converts any url in a stylesheet, to the correct absolute url.
6037     *
6038     * Considerations:
6039     *  - Normal, relative URLs     `feh.png`
6040     *  - Data URLs                 `data:image/gif;base64,eh129ehiuehjdhsa==`
6041     *  - Schema-agnostic URLs      `//domain.com/feh.png`
6042     *  - Absolute URLs             `http://domain.com/feh.png`
6043     *  - Domain root relative URLs `/feh.png`
6044     *
6045     * @param string $css The raw CSS -- should be read in directly from the file.
6046     * @param string $css_file_url The URL that the file can be accessed at, for calculating paths from.
6047     *
6048     * @return mixed|string
6049     */
6050    public static function absolutize_css_urls( $css, $css_file_url ) {
6051        $pattern = '#url\((?P<path>[^)]*)\)#i';
6052        $css_dir = dirname( $css_file_url );
6053        $p       = wp_parse_url( $css_dir );
6054        $domain  = sprintf(
6055            '%1$s//%2$s%3$s%4$s',
6056            isset( $p['scheme'] ) ? "{$p['scheme']}:" : '',
6057            isset( $p['user'], $p['pass'] ) ? "{$p['user']}:{$p['pass']}@" : '',
6058            $p['host'],
6059            isset( $p['port'] ) ? ":{$p['port']}" : ''
6060        );
6061
6062        if ( preg_match_all( $pattern, $css, $matches, PREG_SET_ORDER ) ) {
6063            $replace = array();
6064            $find    = array();
6065            foreach ( $matches as $match ) {
6066                $url = trim( $match['path'], "'\" \t" );
6067
6068                // If this is a data url, we don't want to mess with it.
6069                if ( str_starts_with( $url, 'data:' ) ) {
6070                    continue;
6071                }
6072
6073                // If this is an absolute or protocol-agnostic url,
6074                // we don't want to mess with it.
6075                if ( preg_match( '#^(https?:)?//#i', $url ) ) {
6076                    continue;
6077                }
6078
6079                switch ( substr( $url, 0, 1 ) ) {
6080                    case '/':
6081                        $absolute = $domain . $url;
6082                        break;
6083                    default:
6084                        $absolute = $css_dir . '/' . $url;
6085                }
6086
6087                $find[]    = $match[0];
6088                $replace[] = sprintf( 'url("%s")', $absolute );
6089            }
6090            $css = str_replace( $find, $replace, $css );
6091        }
6092
6093        return $css;
6094    }
6095
6096    /**
6097     * Check the heartbeat data
6098     *
6099     * Organizes the heartbeat data by severity.  For example, if the site
6100     * is in an ID crisis, it will be in the $filtered_data['bad'] array.
6101     *
6102     * Data will be added to "caution" array, if it either:
6103     *  - Out of date Jetpack version
6104     *  - Out of date WP version
6105     *  - Out of date PHP version
6106     *
6107     * $return array $filtered_data
6108     */
6109    public static function jetpack_check_heartbeat_data() {
6110        /*
6111         * Site environment stats (incl. wp-version/php-version checked below) now live in the Connection package,
6112         * and the IDC stat is contributed by the Connection package's `jetpack_heartbeat_stats_array` filter
6113         * callback. We rebuild the stat here rather than running that filter: the filter's callbacks have side
6114         * effects (Connection\Manager::add_stats_to_heartbeat() consumes and deletes the `xmlrpc_errors` option)
6115         * and return non-scalar values, neither of which is appropriate for this read-only diagnostic.
6116         */
6117        $env_stats = method_exists( Heartbeat::class, 'get_environment_stats' )
6118            ? Heartbeat::get_environment_stats()
6119            : array();
6120        $raw_data  = array_merge(
6121            Jetpack_Heartbeat::generate_stats_array(),
6122            $env_stats,
6123            array( 'identitycrisis' => Identity_Crisis::check_identity_crisis() ? 'yes' : 'no' )
6124        );
6125
6126        $good    = array();
6127        $caution = array();
6128        $bad     = array();
6129
6130        foreach ( $raw_data as $stat => $value ) {
6131
6132            // Check jetpack version.
6133            if ( 'version' === $stat ) {
6134                if ( version_compare( $value, JETPACK__VERSION, '<' ) ) {
6135                    $caution[ $stat ] = $value . ' - min supported is ' . JETPACK__VERSION;
6136                    continue;
6137                }
6138            }
6139
6140            // Check WP version.
6141            if ( 'wp-version' === $stat ) {
6142                if ( version_compare( $value, JETPACK__MINIMUM_WP_VERSION, '<' ) ) {
6143                    $caution[ $stat ] = $value . ' - min supported is ' . JETPACK__MINIMUM_WP_VERSION;
6144                    continue;
6145                }
6146            }
6147
6148            // Check PHP version.
6149            if ( 'php-version' === $stat ) {
6150                if ( version_compare( PHP_VERSION, JETPACK__MINIMUM_PHP_VERSION, '<' ) ) {
6151                    $caution[ $stat ] = $value . ' - min supported is ' . JETPACK__MINIMUM_PHP_VERSION;
6152                    continue;
6153                }
6154            }
6155
6156            // Check ID crisis.
6157            if ( 'identitycrisis' === $stat ) {
6158                if ( 'yes' === $value ) {
6159                    $bad[ $stat ] = $value;
6160                    continue;
6161                }
6162            }
6163
6164            // The rest are good :).
6165            $good[ $stat ] = $value;
6166        }
6167
6168        $filtered_data = array(
6169            'good'    => $good,
6170            'caution' => $caution,
6171            'bad'     => $bad,
6172        );
6173
6174        return $filtered_data;
6175    }
6176
6177    /**
6178     * This method is used to organize all options that can be reset
6179     * without disconnecting Jetpack.
6180     *
6181     * It is used in class.jetpack-cli.php to reset options
6182     *
6183     * @since 5.4.0 Logic moved to Jetpack_Options class. Method left in Jetpack class for backwards compat.
6184     *
6185     * @return array of options to delete.
6186     */
6187    public static function get_jetpack_options_for_reset() {
6188        return Jetpack_Options::get_options_for_reset();
6189    }
6190
6191    /**
6192     * Get the user's meta box order.
6193     *
6194     * @param array $sorted Value for the user's option.
6195     * @return mixed
6196     */
6197    public function get_user_option_meta_box_order_dashboard( $sorted ) {
6198        if ( ! is_array( $sorted ) ) {
6199            return $sorted;
6200        }
6201
6202        foreach ( $sorted as $box_context => $ids ) {
6203            if ( ! str_contains( $ids, 'dashboard_stats' ) ) {
6204                // If the old id isn't anywhere in the ids, don't bother exploding and fail out.
6205                continue;
6206            }
6207
6208            $ids_array = explode( ',', $ids );
6209            $key       = array_search( 'dashboard_stats', $ids_array, true );
6210
6211            if ( false !== $key ) {
6212                // If we've found that exact value in the option (and not `google_dashboard_stats` for example).
6213                $ids_array[ $key ]      = 'jetpack_summary_widget';
6214                $sorted[ $box_context ] = implode( ',', $ids_array );
6215                // We've found it, stop searching, and just return.
6216                break;
6217            }
6218        }
6219
6220        return $sorted;
6221    }
6222    /**
6223     * Checks if Akismet is active and working.
6224     *
6225     * We dropped support for Akismet 3.0 with Jetpack 6.1.1 while introducing a check for an Akismet valid key
6226     * that implied usage of methods present since more recent version.
6227     * See https://github.com/Automattic/jetpack/pull/9585
6228     *
6229     * @since  5.1.0
6230     *
6231     * @return bool True = Akismet available. False = Aksimet not available.
6232     */
6233    public static function is_akismet_active() {
6234        static $status = null;
6235
6236        if ( $status !== null ) {
6237            return $status;
6238        }
6239
6240        // Check if a modern version of Akismet is active.
6241        if ( ! method_exists( 'Akismet', 'http_post' ) ) {
6242            $status = false;
6243            return $status;
6244        }
6245
6246        // Make sure there is a key known to Akismet at all before verifying key.
6247        $akismet_key = Akismet::get_api_key();
6248        if ( ! $akismet_key ) {
6249            $status = false;
6250            return $status;
6251        }
6252
6253        // Possible values: valid, invalid, failure via Akismet. false if no status is cached.
6254        $akismet_key_state = get_transient( 'jetpack_akismet_key_is_valid' );
6255
6256        // Do not used the cache result in wp-admin or REST API requests if the key isn't valid, in case someone is actively renewing, etc.
6257        $recheck = ( is_admin() || ( defined( 'REST_REQUEST' ) && REST_REQUEST ) ) && 'valid' !== $akismet_key_state;
6258        // We cache the result of the Akismet key verification for ten minutes.
6259        if ( ! $akismet_key_state || $recheck ) {
6260            $akismet_key_state = Akismet::verify_key( $akismet_key );
6261            set_transient( 'jetpack_akismet_key_is_valid', $akismet_key_state, 10 * MINUTE_IN_SECONDS );
6262        }
6263
6264        $status = 'valid' === $akismet_key_state;
6265
6266        return $status;
6267    }
6268
6269    /**
6270     * Given a minified path, and a non-minified path, will return
6271     * a minified or non-minified file URL based on whether SCRIPT_DEBUG is set and truthy.
6272     *
6273     * Both `$min_base` and `$non_min_base` are expected to be relative to the
6274     * root Jetpack directory.
6275     *
6276     * @since 5.6.0
6277     *
6278     * @param string $min_path Minimized path.
6279     * @param string $non_min_path Non-minimized path.
6280     * @return string The URL to the file
6281     */
6282    public static function get_file_url_for_environment( $min_path, $non_min_path ) {
6283        return Assets::get_file_url_for_environment( $min_path, $non_min_path );
6284    }
6285
6286    /**
6287     * Checks for whether Jetpack Backup is enabled.
6288     * Will return true if the state of Backup is anything except "unavailable".
6289     *
6290     * @return bool|int|mixed
6291     */
6292    public static function is_rewind_enabled() {
6293        // Rewind is a paid feature, therefore requires a user-level connection.
6294        if ( ! static::connection()->has_connected_owner() ) {
6295            return false;
6296        }
6297        $rewind_enabled = get_transient( 'jetpack_rewind_enabled' );
6298        $recheck        = ( is_admin() || ( defined( 'REST_REQUEST' ) && REST_REQUEST ) ) && '0' === $rewind_enabled;
6299        if ( false === $rewind_enabled || $recheck ) {
6300            require_once JETPACK__PLUGIN_DIR . '_inc/lib/class.core-rest-api-endpoints.php';
6301            $rewind_data    = (array) Jetpack_Core_Json_Api_Endpoints::rewind_data();
6302            $rewind_enabled = ( ! is_wp_error( $rewind_data )
6303                && ! empty( $rewind_data['state'] )
6304                && 'active' === $rewind_data['state'] )
6305                ? 1
6306                : 0;
6307            set_transient( 'jetpack_rewind_enabled', $rewind_enabled, 10 * MINUTE_IN_SECONDS );
6308        }
6309        return $rewind_enabled;
6310    }
6311
6312    /**
6313     * Return Calypso environment value; used for developing Jetpack and pairing
6314     * it with different Calypso enrionments, such as localhost.
6315     *
6316     * @deprecated 12.4 Moved to the Status package.
6317     *
6318     * @return string Calypso environment
6319     */
6320    public static function get_calypso_env() {
6321        _deprecated_function( __METHOD__, 'jetpack-12.4', '\Automattic\Jetpack\Status\Host->get_calypso_env' );
6322        return ( new Host() )->get_calypso_env();
6323    }
6324
6325    /**
6326     * Returns the hostname with protocol for Calypso.
6327     * Used for developing Jetpack with Calypso.
6328     *
6329     * @since 8.4.0
6330     *
6331     * @return string Calypso host.
6332     */
6333    public static function get_calypso_host() {
6334        $calypso_env = ( new Host() )->get_calypso_env();
6335        switch ( $calypso_env ) {
6336            case 'development':
6337                return 'http://calypso.localhost:3000/';
6338            case 'wpcalypso':
6339                return 'https://wpcalypso.wordpress.com/';
6340            case 'horizon':
6341                return 'https://horizon.wordpress.com/';
6342            default:
6343                return 'https://wordpress.com/';
6344        }
6345    }
6346
6347    /**
6348     * Handles activating default modules as well general cleanup for the new connection.
6349     *
6350     * @param boolean $activate_sso                 Whether to activate the SSO module when activating default modules.
6351     * @param boolean $redirect_on_activation_error Whether to redirect on activation error.
6352     * @param boolean $send_state_messages          Whether to send state messages.
6353     * @return void
6354     */
6355    public static function handle_post_authorization_actions(
6356        $activate_sso = false,
6357        $redirect_on_activation_error = false,
6358        $send_state_messages = true
6359    ) {
6360        $other_modules = $activate_sso
6361            ? array( 'sso' )
6362            : array();
6363
6364        if ( Jetpack_Options::get_option( 'active_modules_initialized' ) ) {
6365            $active_modules = self::get_active_modules();
6366            self::delete_active_modules();
6367
6368            self::activate_default_modules( 999, 1, array_merge( $active_modules, $other_modules ), $redirect_on_activation_error, $send_state_messages );
6369        } else {
6370            // Default modules that don't require a user were already activated on site_register.
6371            // This time let's activate only those that require a user, this assures we don't reactivate manually deactivated modules while the site was connected only at a site level.
6372            self::activate_default_modules( false, false, $other_modules, $redirect_on_activation_error, $send_state_messages, null, true );
6373            Jetpack_Options::update_option( 'active_modules_initialized', true );
6374        }
6375
6376        // Since this is a fresh connection, be sure to clear out IDC options.
6377        Identity_Crisis::clear_all_idc_options();
6378
6379        if ( $send_state_messages ) {
6380            self::state( 'message', 'authorized' );
6381        }
6382    }
6383
6384    /**
6385     * Whether UI for backups should be displayed.
6386     *
6387     * On WPCom platforms this is gated on the backups-self-serve site feature.
6388     * On self-hosted Jetpack sites it falls back to the jetpack_show_backups filter.
6389     *
6390     * @return bool Should backups UI be displayed?
6391     */
6392    public static function show_backups_ui() {
6393        if ( ( new \Automattic\Jetpack\Status\Host() )->is_wpcom_platform() ) {
6394            return function_exists( 'wpcom_site_has_feature' ) && wpcom_site_has_feature( 'backups-self-serve' );
6395        }
6396
6397        /**
6398         * Whether UI for backups should be displayed.
6399         *
6400         * @since 6.5.0
6401         *
6402         * @param bool $show_backups Should UI for backups be displayed? True by default.
6403         */
6404        return self::is_plugin_active( 'vaultpress/vaultpress.php' ) || apply_filters( 'jetpack_show_backups', true );
6405    }
6406
6407    /**
6408     * Whether UI for security scanning should be displayed.
6409     *
6410     * On WPCom platforms this is gated on the scan-self-serve site feature.
6411     * On self-hosted Jetpack sites it always returns true.
6412     *
6413     * @return bool Should scan UI be displayed?
6414     */
6415    public static function show_scan_ui() {
6416        if ( ( new \Automattic\Jetpack\Status\Host() )->is_wpcom_platform() ) {
6417            return function_exists( 'wpcom_site_has_feature' ) && wpcom_site_has_feature( 'scan-self-serve' );
6418        }
6419
6420        return true;
6421    }
6422
6423    /**
6424     * Clean leftoveruser meta.
6425     *
6426     * Delete Jetpack-related user meta when it is no longer needed.
6427     *
6428     * @since 7.3.0
6429     *
6430     * @param int $user_id User ID being updated.
6431     */
6432    public static function user_meta_cleanup( $user_id ) {
6433        $meta_keys = array(
6434            // AtD removed from Jetpack 7.3.
6435            'AtD_options',
6436            'AtD_check_when',
6437            'AtD_guess_lang',
6438            'AtD_ignored_phrases',
6439        );
6440
6441        foreach ( $meta_keys as $meta_key ) {
6442            if ( get_user_meta( $user_id, $meta_key ) ) {
6443                delete_user_meta( $user_id, $meta_key );
6444            }
6445        }
6446    }
6447
6448    /**
6449     * Checks if a Jetpack site is both active and not in offline mode.
6450     *
6451     * This is a DRY function to avoid repeating `Jetpack::is_connection_ready && ! Automattic\Jetpack\Status->is_offline_mode`.
6452     *
6453     * @since 8.8.0
6454     *
6455     * @return bool True if Jetpack is active and not in offline mode.
6456     */
6457    public static function is_active_and_not_offline_mode() {
6458        if ( ! self::is_connection_ready() || ( new Status() )->is_offline_mode() ) {
6459            return false;
6460        }
6461        return true;
6462    }
6463
6464    /**
6465     * Returns the list of products that we have available for purchase.
6466     *
6467     * This method will not take current purchases or upgrades into account
6468     * but is instead a static list of products Jetpack offers with some
6469     * corresponding sales text/materials.
6470     *
6471     * @param bool $show_legacy Determine if we should include legacy product/plan details.
6472     * @return array
6473     */
6474    public static function get_products_for_purchase( $show_legacy = false ) {
6475        $products = array();
6476
6477        $products['backup'] = array(
6478            'title'             => __( 'Jetpack Backup', 'jetpack' ),
6479            'slug'              => 'jetpack_backup_t1_yearly',
6480            'description'       => __( 'Never lose a word, image, page, or time worrying about your site with automated backups & one-click restores.', 'jetpack' ),
6481            'show_promotion'    => true,
6482            'discount_percent'  => 50,
6483            'included_in_plans' => array( 'security' ),
6484            'features'          => array(
6485                _x( 'Real-time cloud backups', 'Backup Product Feature', 'jetpack' ),
6486                _x( '10GB of backup storage', 'Backup Product Feature', 'jetpack' ),
6487                _x( '30-day archive & activity log*', 'Backup Product Feature', 'jetpack' ),
6488                _x( 'One-click restores', 'Backup Product Feature', 'jetpack' ),
6489            ),
6490            'disclaimer'        => array(
6491                'text'      => __( '* Subject to your usage and storage limit.', 'jetpack' ),
6492                'link_text' => __( 'Learn more', 'jetpack' ),
6493                'url'       => Redirect::get_url( 'jetpack-faq-backup-disclaimer' ),
6494            ),
6495        );
6496
6497        $products['creator'] = array(
6498            'title'             => __( 'Jetpack Creator', 'jetpack' ),
6499            'slug'              => 'jetpack_creator_yearly',
6500            'description'       => __( 'Craft stunning content, boost your subscriber base, and monetize your online presence.', 'jetpack' ),
6501            'show_promotion'    => true,
6502            'discount_percent'  => 50,
6503            'included_in_plans' => array( 'complete' ),
6504            'features'          => array(
6505                _x( 'Unlimited subscriber imports', 'Creator Product Feature', 'jetpack' ),
6506                _x( 'Earn more from your content', 'Creator Product Feature', 'jetpack' ),
6507                _x( 'Accept payments with PayPal', 'Creator Product Feature', 'jetpack' ),
6508                _x( 'Increase earnings with WordAds', 'Creator Product Feature', 'jetpack' ),
6509            ),
6510        );
6511
6512        $products['growth'] = array(
6513            'title'             => __( 'Jetpack Growth', 'jetpack' ),
6514            'slug'              => 'jetpack_growth_yearly',
6515            'description'       => __( 'Essential tools to help you grow your audience, track visitor engagement, and turn leads into loyal customers and advocates.', 'jetpack' ),
6516            'show_promotion'    => true,
6517            'discount_percent'  => 50,
6518            'included_in_plans' => array( 'complete' ),
6519            'features'          => array(
6520                _x( 'Jetpack Social', 'Growth Product Feature', 'jetpack' ),
6521                _x( 'Jetpack Stats (10K site views, upgradeable)', 'Growth Product Feature', 'jetpack' ),
6522                _x( 'Unlimited subscriber imports', 'Growth Product Feature', 'jetpack' ),
6523                _x( 'Earn more from your content', 'Growth Product Feature', 'jetpack' ),
6524                _x( 'Accept payments with PayPal', 'Growth Product Feature', 'jetpack' ),
6525                _x( 'Increase earnings with WordAds', 'Growth Product Feature', 'jetpack' ),
6526            ),
6527        );
6528
6529        $products['scan'] = array(
6530            'title'             => __( 'Jetpack Scan', 'jetpack' ),
6531            'slug'              => 'jetpack_scan',
6532            'description'       => __( 'Automatic scanning and one-click fixes keep your site one step ahead of security threats and malware.', 'jetpack' ),
6533            'show_promotion'    => true,
6534            'discount_percent'  => 50,
6535            'included_in_plans' => array( 'security' ),
6536            'features'          => array(
6537                _x( 'Automated daily scanning', 'Scan Product Feature', 'jetpack' ),
6538                _x( 'One-click fixes for most issues', 'Scan Product Feature', 'jetpack' ),
6539                _x( 'Instant email notifications', 'Scan Product Feature', 'jetpack' ),
6540                _x( 'Access to latest Firewall rules', 'Scan Product Feature', 'jetpack' ),
6541            ),
6542        );
6543
6544        $products['search'] = array(
6545            'title'             => __( 'Jetpack Site Search', 'jetpack' ),
6546            'slug'              => 'jetpack_search',
6547            'description'       => __( 'Help your site visitors find answers instantly so they keep reading and buying. Great for sites with a lot of content.', 'jetpack' ),
6548            'show_promotion'    => true,
6549            'discount_percent'  => 50,
6550            'included_in_plans' => array(),
6551            'features'          => array(
6552                _x( 'Instant search and indexing', 'Search Product Feature', 'jetpack' ),
6553                _x( 'Powerful filtering', 'Search Product Feature', 'jetpack' ),
6554                _x( 'Supports 38 languages', 'Search Product Feature', 'jetpack' ),
6555                _x( 'Spelling correction', 'Search Product Feature', 'jetpack' ),
6556            ),
6557        );
6558
6559        $products['akismet'] = array(
6560            'title'             => __( 'Akismet Anti-spam', 'jetpack' ),
6561            'slug'              => 'jetpack_anti_spam',
6562            'description'       => __( 'Save time and get better responses by automatically blocking spam from your comments and forms.', 'jetpack' ),
6563            'show_promotion'    => true,
6564            'discount_percent'  => 50,
6565            'included_in_plans' => array( 'security' ),
6566            'features'          => array(
6567                _x( 'Comment and form spam protection', 'Anti-Spam Product Feature', 'jetpack' ),
6568                _x( 'Block spam without CAPTCHAs', 'Anti-Spam Product Feature', 'jetpack' ),
6569                _x( 'Advanced stats', 'Anti-Spam Product Feature', 'jetpack' ),
6570            ),
6571        );
6572
6573        $products['security'] = array(
6574            'title'             => _x( 'Security', 'Jetpack product name', 'jetpack' ),
6575            'slug'              => 'jetpack_security_t1_yearly',
6576            'description'       => __( 'Comprehensive site security, including Backup, Scan, and Anti-spam.', 'jetpack' ),
6577            'show_promotion'    => true,
6578            'discount_percent'  => 50,
6579            'included_in_plans' => array(),
6580            'features'          => array(
6581                _x( 'Real-time cloud backups with 10GB storage', 'Security Tier 1 Feature', 'jetpack' ),
6582                _x( 'Automated real-time malware scan', 'Security Daily Plan Feature', 'jetpack' ),
6583                _x( 'One-click fixes for most threats', 'Security Daily Plan Feature', 'jetpack' ),
6584                _x( 'Comment & form spam protection', 'Security Daily Plan Feature', 'jetpack' ),
6585            ),
6586        );
6587
6588        $products['videopress'] = array(
6589            'title'             => __( 'Jetpack VideoPress', 'jetpack' ),
6590            'slug'              => 'jetpack_videopress',
6591            'description'       => __( 'High-quality, ad-free video built specifically for WordPress.', 'jetpack' ),
6592            'show_promotion'    => true,
6593            'discount_percent'  => 50,
6594            'included_in_plans' => array(),
6595            'features'          => array(
6596                _x( '1TB of storage', 'VideoPress Product Feature', 'jetpack' ),
6597                _x( 'Built into WordPress editor', 'VideoPress Product Feature', 'jetpack' ),
6598                _x( 'Ad-free and customizable player', 'VideoPress Product Feature', 'jetpack' ),
6599                _x( 'Unlimited users', 'VideoPress Product Feature', 'jetpack' ),
6600            ),
6601        );
6602
6603        if ( $show_legacy ) {
6604            $products['jetpack_backup_daily'] = array(
6605                'title'             => __( 'Jetpack Backup', 'jetpack' ),
6606                'slug'              => 'jetpack_backup_daily',
6607                'description'       => __( 'Never lose a word, image, page, or time worrying about your site with automated backups & one-click restores.', 'jetpack' ),
6608                'show_promotion'    => false,
6609                'discount_percent'  => 0,
6610                'included_in_plans' => array(),
6611                'features'          => array(
6612                    _x( 'Automated daily backups (off-site)', 'Backup Product Feature', 'jetpack' ),
6613                    _x( 'One-click restores', 'Backup Product Feature', 'jetpack' ),
6614                    _x( 'Unlimited backup storage', 'Backup Product Feature', 'jetpack' ),
6615                ),
6616            );
6617        }
6618
6619        return $products;
6620    }
6621
6622    /**
6623     * Register product descriptions for partner coupon usage.
6624     *
6625     * @since 10.4.0
6626     *
6627     * @param array $products An array of registered products.
6628     *
6629     * @return array
6630     */
6631    public function get_partner_coupon_product_descriptions( $products ) {
6632        return array_merge( $products, self::get_products_for_purchase( true ) );
6633    }
6634
6635    /**
6636     * Determine if the current user is allowed to make Jetpack purchases without
6637     * a WordPress.com account
6638     *
6639     * @return boolean True if the user can make purchases, false if not
6640     */
6641    public static function current_user_can_purchase() {
6642
6643        // The site must be site-connected to Jetpack (no users connected).
6644        if ( ! self::connection()->is_site_connection() ) {
6645            return false;
6646        }
6647
6648        // Make sure only administrators can make purchases.
6649        if ( ! current_user_can( 'manage_options' ) ) {
6650            return false;
6651        }
6652
6653        return true;
6654    }
6655
6656    /**
6657     * Add 5-star review link on the Jetpack Plugin meta, in the plugins list table (on the plugins page).
6658     *
6659     * @param array  $plugin_meta An array of the plugin's metadata.
6660     * @param string $plugin_file Path to the plugin file.
6661     *
6662     * @return array $plugin_meta An array of the plugin's metadata.
6663     */
6664    public function add_5_star_review_link( $plugin_meta, $plugin_file ) {
6665        if ( $plugin_file !== 'jetpack/jetpack.php' ) {
6666            return $plugin_meta;
6667        }
6668
6669        $u    = get_current_user_id();
6670        $site = get_site_url();
6671
6672        $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">'
6673            . str_repeat( '<span class="dashicons dashicons-star-filled" style="font-size: 16px; width:16px; height: 16px"></span>', 5 )
6674            . '</a>';
6675
6676        return $plugin_meta;
6677    }
6678
6679    /**
6680     * Lazy instantiation of the Plugin_Tracking object.
6681     *
6682     * @since 13.9
6683     *
6684     * @return void
6685     */
6686    public function initialize_tracking() {
6687        if ( did_action( 'jetpack_initialize_tracking' ) > 1 ) {
6688            // Only need to run once.
6689            return;
6690        }
6691
6692        // Check the site first to avoid resolving the current user during plugins_loaded.
6693        if ( static::is_connection_ready() || ( new Tracking( 'jetpack', $this->connection_manager ) )->should_enable_tracking( new Terms_Of_Service(), new Status() ) ) {
6694            ( new Plugin_Tracking() )->init();
6695        }
6696    }
6697
6698    /**
6699     * Run the "initialize tracking" hook.
6700     *
6701     * @since 13.9
6702     */
6703    public function run_initialize_tracking_action() {
6704        /**
6705         * Fires when the tracking needs to be initialized.
6706         * Doesn't necessarily mean that will actually happen, depends if the 'jetpack_tos_agreed' option is set.
6707         *
6708         * @since 13.9
6709         */
6710        do_action( 'jetpack_initialize_tracking' );
6711    }
6712
6713    /**
6714     * Initialize REST jsonAPI if needed.
6715     *
6716     * @return void
6717     */
6718    public function maybe_initialize_rest_jsonapi() {
6719        // phpcs:ignore WordPress.Security.NonceVerification.Recommended
6720        if ( ! empty( $_GET['jsonapi'] ) && ( ! defined( 'IS_WPCOM' ) || ! IS_WPCOM ) ) {
6721            require_once ABSPATH . 'wp-admin/includes/admin.php'; // JSON API relies on WP functionality not autoloaded in REST.
6722
6723            define( 'WPCOM_JSON_API__BASE', 'public-api.wordpress.com/rest/v1' );
6724            require_once JETPACK__PLUGIN_DIR . 'class.json-api-endpoints.php';
6725        }
6726    }
6727
6728    /**
6729     * Run plugin post-activation actions if we need to.
6730     *
6731     * @return void
6732     */
6733    private function plugin_post_activation() {
6734        if ( ( new Status() )->is_offline_mode() ) {
6735            return;
6736        }
6737
6738        if ( get_transient( 'activated_jetpack' ) ) {
6739            delete_transient( 'activated_jetpack' );
6740
6741            if ( ( new Host() )->is_woa_site() ) {
6742                $redirect_url = static::admin_url( 'page=jetpack' );
6743            } elseif ( is_network_admin() ) {
6744                $redirect_url = admin_url( 'network/admin.php?page=jetpack' );
6745            } elseif ( get_transient( 'my_jetpack_product_activated' ) ) {
6746                // don't redirect if this is an activation that just came from My Jetpack
6747                // My Jetpack has its own set of post-activation redirects
6748                return;
6749            } elseif ( My_Jetpack_Initializer::should_initialize() ) {
6750                $redirect_url = static::admin_url( 'page=my-jetpack' );
6751            } else {
6752                $redirect_url = static::admin_url( 'page=jetpack' );
6753            }
6754
6755            wp_safe_redirect( $redirect_url );
6756        }
6757    }
6758}