PluginProbe
Jetpack – WP Security, Backup, Speed, & Growth / 16.3-a.5
Jetpack – WP Security, Backup, Speed, & Growth v16.3-a.5
16.3-a.5 16.3-a.7 16.3-a.3 16.3-a.1 16.2 16.2-beta 12.0.3 12.1.3 12.2.3 12.3.2 12.4.2 12.5.2 12.6.4 12.7.3 12.8.3 12.9.5 13.0.2 13.1.5 13.2.4 13.3.3 13.4.5 13.5.2 13.6.2 13.7.2 13.8.3 All 506 releases
← All changes | _inc/lib/core-api/class.jetpack-core-api-module-endpoints.php +201 -278 13.2.4 → 16.3-a.5 View file →
@@ -6,9 +6,8 @@
6 6 */
7 7
8 8 use Automattic\Jetpack\Connection\REST_Connector;
9 9 use Automattic\Jetpack\Current_Plan as Jetpack_Plan;
10 -use Automattic\Jetpack\Plugins_Installer;
11 10 use Automattic\Jetpack\Stats\WPCOM_Stats;
12 11 use Automattic\Jetpack\Stats_Admin\Main as Stats_Admin_Main;
13 12 use Automattic\Jetpack\Status;
14 13 use Automattic\Jetpack\Waf\Brute_Force_Protection\Brute_Force_Protection;
@@ -13,8 +12,12 @@
13 12 use Automattic\Jetpack\Status;
14 13 use Automattic\Jetpack\Waf\Brute_Force_Protection\Brute_Force_Protection;
15 14 use Automattic\Jetpack\Waf\Brute_Force_Protection\Brute_Force_Protection_Shared_Functions;
16 15
16 +if ( ! defined( 'ABSPATH' ) ) {
17 + exit( 0 );
18 +}
19 +
17 20 /**
18 21 * This is the base class for every Core API endpoint Jetpack uses.
19 22 */
20 23 class Jetpack_Core_API_Module_Toggle_Endpoint extends Jetpack_Core_API_XMLRPC_Consumer_Endpoint {
@@ -88,8 +91,16 @@
88 91 );
89 92 }
90 93
91 94 if ( Jetpack::activate_module( $module_slug, false, false ) ) {
95 + if ( ! Jetpack::is_module_active( $module_slug ) ) {
96 + return new WP_Error(
97 + 'module_forced',
98 + esc_html__( 'The requested Jetpack module is disabled by your host or site administrator, so it stays off.', 'jetpack' ),
99 + array( 'status' => 409 )
100 + );
101 + }
102 +
92 103 return rest_ensure_response(
93 104 array(
94 105 'code' => 'success',
95 106 'message' => esc_html__( 'The requested Jetpack module was activated.', 'jetpack' ),
@@ -149,9 +160,20 @@
149 160 array( 'status' => 409 )
150 161 );
151 162 }
152 163
153 - if ( Jetpack::deactivate_module( $module_slug ) ) {
164 + $deactivated = Jetpack::deactivate_module( $module_slug );
165 +
166 + // A module that was never saved as active leaves nothing to change, so check the outcome.
167 + if ( Jetpack::is_module_active( $module_slug ) ) {
168 + return new WP_Error(
169 + 'module_forced',
170 + esc_html__( 'The requested Jetpack module is enabled by your host or site administrator, so it stays on.', 'jetpack' ),
171 + array( 'status' => 409 )
172 + );
173 + }
174 +
175 + if ( $deactivated ) {
154 176 return rest_ensure_response(
155 177 array(
156 178 'code' => 'success',
157 179 'message' => esc_html__( 'The requested Jetpack module was deactivated.', 'jetpack' ),
@@ -259,9 +281,9 @@
259 281 $activated = array();
260 282 $failed = array();
261 283
262 284 foreach ( $request['modules'] as $module ) {
263 - if ( Jetpack::activate_module( $module, false, false ) ) {
285 + if ( Jetpack::activate_module( $module, false, false ) && Jetpack::is_module_active( $module ) ) {
264 286 $activated[] = $module;
265 287 } else {
266 288 $failed[] = $module;
267 289 }
@@ -402,15 +424,17 @@
402 424 $module['activated'] = false;
403 425 }
404 426
405 427 $i18n = jetpack_get_module_i18n( $request['slug'] );
406 - if ( isset( $module['name'] ) ) {
407 - $module['name'] = $i18n['name'];
428 + if ( $i18n ) {
429 + if ( isset( $module['name'] ) ) {
430 + $module['name'] = $i18n['name'];
431 + }
432 + if ( isset( $module['description'] ) ) {
433 + $module['description'] = $i18n['description'];
434 + $module['short_description'] = $i18n['description'];
435 + }
408 436 }
409 - if ( isset( $module['description'] ) ) {
410 - $module['description'] = $i18n['description'];
411 - $module['short_description'] = $i18n['description'];
412 - }
413 437 if ( isset( $module['module_tags'] ) ) {
414 438 $module['module_tags'] = array_map( 'jetpack_get_module_i18n_tag', $module['module_tags'] );
415 439 }
416 440
@@ -447,9 +471,11 @@
447 471 $response[ $module ] = Jetpack::is_module_active( $module );
448 472 }
449 473 }
450 474
451 - $settings = Jetpack_Core_Json_Api_Endpoints::get_updateable_data_list( 'settings' );
475 + $settings = Jetpack_Core_Json_Api_Endpoints::filter_options_for_response(
476 + Jetpack_Core_Json_Api_Endpoints::get_updateable_data_list( 'settings' )
477 + );
452 478
453 479 if ( ! function_exists( 'is_plugin_active' ) ) {
454 480 require_once ABSPATH . 'wp-admin/includes/plugin.php';
455 481 }
@@ -485,24 +511,8 @@
485 511 $response[ $setting ] = class_exists( 'Akismet' ) ? Akismet::get_api_key() : '';
486 512 }
487 513 break;
488 514
489 - case 'onboarding':
490 - $business_address = get_option( 'jpo_business_address' );
491 - $business_address = is_array( $business_address ) ? array_map( array( $this, 'decode_special_characters' ), $business_address ) : $business_address;
492 -
493 - $response[ $setting ] = array(
494 - 'siteTitle' => $this->decode_special_characters( get_option( 'blogname' ) ),
495 - 'siteDescription' => $this->decode_special_characters( get_option( 'blogdescription' ) ),
496 - 'siteType' => get_option( 'jpo_site_type' ),
497 - 'homepageFormat' => get_option( 'jpo_homepage_format' ),
498 - 'addContactForm' => (int) get_option( 'jpo_contact_page' ),
499 - 'businessAddress' => $business_address,
500 - 'installWooCommerce' => is_plugin_active( 'woocommerce/woocommerce.php' ),
501 - 'stats' => Jetpack::is_connection_ready() && Jetpack::is_module_active( 'stats' ),
502 - );
503 - break;
504 -
505 515 case 'search_auto_config':
506 516 // Only writable.
507 517 $response[ $setting ] = 1;
508 518 break;
@@ -507,9 +517,9 @@
507 517 $response[ $setting ] = 1;
508 518 break;
509 519
510 520 default:
511 - $default = isset( $settings[ $setting ]['default'] ) ? $settings[ $setting ]['default'] : false;
521 + $default = $settings[ $setting ]['default'] ?? false;
512 522 $response[ $setting ] = Jetpack_Core_Json_Api_Endpoints::cast_value( get_option( $setting, $default ), $settings[ $setting ] );
513 523 break;
514 524 }
515 525 }
@@ -515,25 +525,23 @@
515 525 }
516 526
517 527 $response['akismet'] = is_plugin_active( 'akismet/akismet.php' );
518 528
529 + require_once JETPACK__PLUGIN_DIR . '/modules/memberships/class-jetpack-memberships.php';
530 + if ( class_exists( 'Jetpack_Memberships' ) ) {
531 + $response['newsletter_has_active_plan'] = count( Jetpack_Memberships::get_all_newsletter_plan_ids( false ) ) > 0;
532 + }
533 +
534 + // Make sure we are returning a consistent type
535 + if ( ! class_exists( 'Jetpack_Newsletter_Category_Helper' ) ) {
536 + require_once JETPACK__PLUGIN_DIR . '_inc/lib/class-jetpack-newsletter-category-helper.php';
537 + }
538 + $response['wpcom_newsletter_categories'] = Jetpack_Newsletter_Category_Helper::get_category_ids();
539 +
519 540 return rest_ensure_response( $response );
520 541 }
521 542
522 543 /**
523 - * Decode the special HTML characters in a certain value.
524 - *
525 - * @since 5.8
526 - *
527 - * @param string $value Value to decode.
528 - *
529 - * @return string Value with decoded HTML characters.
530 - */
531 - private function decode_special_characters( $value ) {
532 - return (string) htmlspecialchars_decode( $value, ENT_QUOTES );
533 - }
534 -
535 - /**
536 544 * If it's a valid Jetpack module and configuration parameters have been sent, update it.
537 545 *
538 546 * @since 4.3.0
539 547 *
@@ -542,9 +550,9 @@
542 550 *
543 551 * @type string $slug Module slug.
544 552 * }
545 553 *
546 - * @return bool|WP_Error True if module was updated. Otherwise, a WP_Error instance with the corresponding error.
554 + * @return bool|WP_REST_Response|WP_Error True or a WP_REST_Response if module was updated. Otherwise, a WP_Error instance with the corresponding error.
547 555 */
548 556 public function update_data( $request ) {
549 557
550 558 // If it's null, we're trying to update many module options from different modules.
@@ -564,9 +572,9 @@
564 572 }
565 573
566 574 /*
567 575 * Get parameters to update the module.
568 - * We can not simply use $request->get_params() because when we registered this route,
576 + * We cannot simply use $request->get_params() because when we registered this route,
569 577 * we are adding the entire output of Jetpack_Core_Json_Api_Endpoints::get_updateable_data_list()
570 578 * to the current request object's params. We are interested in body of the actual request.
571 579 * This may be JSON:
572 580 */
@@ -651,13 +659,22 @@
651 659 if ( ! $updated ) {
652 660 $not_updated[ $option ] = $error;
653 661 }
654 662
663 + if ( $updated ) {
664 + // Return the module state.
665 + $response[ $option ] = $value;
666 + }
667 +
655 668 // Remove module from list so we don't go through it again.
656 669 unset( $params[ $option ] );
657 670 }
658 671 }
659 672
673 + if ( ! class_exists( 'Jetpack_Newsletter_Category_Helper' ) ) {
674 + require_once JETPACK__PLUGIN_DIR . '_inc/lib/class-jetpack-newsletter-category-helper.php';
675 + }
676 +
660 677 foreach ( $params as $option => $value ) {
661 678
662 679 // Used if there was an error. Can be overwritten with specific error messages.
663 680 $error = '';
@@ -667,8 +684,14 @@
667 684
668 685 // Get option attributes, including the group it belongs to.
669 686 $option_attrs = $options[ $option ];
670 687
688 + // Everything outside the Post by Email group requires the admin capability.
689 + if ( 'post-by-email' !== $option_attrs['jp_group'] && ! current_user_can( 'jetpack_configure_modules' ) ) {
690 + $not_updated[ $option ] = REST_Connector::get_user_permissions_error_msg();
691 + continue;
692 + }
693 +
671 694 // If this is a module option and the related module isn't active for any reason, continue with the next one.
672 695 if ( 'settings' !== $option_attrs['jp_group'] ) {
673 696 if ( ! Jetpack::is_module( $option_attrs['jp_group'] ) ) {
674 697 $not_updated[ $option ] = esc_html__( 'The requested Jetpack module was not found.', 'jetpack' );
@@ -719,8 +742,13 @@
719 742 $updated = get_option( 'WPLANG' ) === $language ? true : update_option( 'WPLANG', $language );
720 743 break;
721 744
722 745 case 'monitor_receive_notifications':
746 + if ( ! class_exists( 'Jetpack_Monitor' ) ) {
747 + $updated = false;
748 + break;
749 + }
750 +
723 751 $monitor = new Jetpack_Monitor();
724 752
725 753 // If we got true as response, consider it done.
726 754 $updated = true === $monitor->update_option_receive_jetpack_monitor_notification( $value );
@@ -726,8 +754,13 @@
726 754 $updated = true === $monitor->update_option_receive_jetpack_monitor_notification( $value );
727 755 break;
728 756
729 757 case 'post_by_email_address':
758 + if ( ! class_exists( 'Jetpack_Post_By_Email' ) ) {
759 + $updated = false;
760 + break;
761 + }
762 +
730 763 $result = Jetpack_Post_By_Email::init()->process_api_request( $value );
731 764
732 765 // If we got an email address (create or regenerate) or 1 (delete), consider it done.
733 766 if ( is_string( $result ) && preg_match( '/[a-z0-9][email protected]/', $result ) ) {
@@ -748,9 +781,9 @@
748 781 $result = false;
749 782 }
750 783
751 784 // If we got one of Protect keys, consider it done.
752 - if ( preg_match( '/[a-z0-9]{40,}/i', $result ) ) {
785 + if ( is_string( $result ) && preg_match( '/[a-z0-9]{40,}/i', $result ) ) {
753 786 $response[ $option ] = $result;
754 787 $updated = true;
755 788 }
756 789 break;
@@ -801,15 +834,16 @@
801 834 case 'facebook':
802 835 $grouped_options_current = (array) get_option( 'verification_services_codes' );
803 836 $grouped_options = $grouped_options_current;
804 837
805 - // Extracts the content attribute from the HTML meta tag if needed.
806 - if ( preg_match( '#.*<meta name="(?:[^"]+)" content="([^"]+)" />.*#i', $value, $matches ) ) {
807 - $grouped_options[ $option ] = $matches[1];
808 - } else {
809 - $grouped_options[ $option ] = $value;
838 + $validated_code = jetpack_verification_validate_code( $value );
839 + if ( false === $validated_code ) {
840 + $error = esc_html__( 'The site verification code is invalid.', 'jetpack' );
841 + break;
810 842 }
811 843
844 + $grouped_options[ $option ] = $validated_code;
845 +
812 846 // If option value was the same, consider it done.
813 847 $updated = $grouped_options_current !== $grouped_options
814 848 ? update_option( 'verification_services_codes', $grouped_options )
815 849 : true;
@@ -814,8 +848,17 @@
814 848 ? update_option( 'verification_services_codes', $grouped_options )
815 849 : true;
816 850 break;
817 851
852 + case Jetpack_SEO_Utils::FRONT_PAGE_META_OPTION:
853 + Jetpack_SEO_Utils::update_front_page_meta_description( $value );
854 + $response[ $option ] = Jetpack_SEO_Utils::get_front_page_meta_description();
855 + // The helper returns an empty string for a successful clear or
856 + // same-value write, so use its authoritative getter for the response
857 + // and treat every valid request reaching this switch as handled.
858 + $updated = true;
859 + break;
860 +
818 861 case 'sharing_services':
819 862 if ( ! class_exists( 'Sharing_Service' ) && ! include_once JETPACK__PLUGIN_DIR . 'modules/sharedaddy/sharing-service.php' ) {
820 863 break;
821 864 }
@@ -963,29 +1006,37 @@
963 1006 ? update_option( $option, (bool) $value )
964 1007 : true;
965 1008 break;
966 1009
967 - case 'onboarding':
968 - require_once JETPACK__PLUGIN_DIR . '_inc/lib/widgets.php';
969 - // Break apart and set Jetpack onboarding options.
970 - $result = $this->process_onboarding( (array) $value );
971 - if ( empty( $result ) ) {
972 - $updated = true;
973 - } else {
974 - $error = sprintf(
975 - /* Translators: placeholder is a list of error codes. */
976 - esc_html__( 'Onboarding failed to process: %s', 'jetpack' ),
977 - $result
978 - );
979 - $updated = false;
980 - }
1010 + case 'jetpack_subscriptions_reply_to':
1011 + // If option value was the same, consider it done.
1012 + require_once JETPACK__PLUGIN_DIR . 'modules/subscriptions/class-settings.php';
1013 + $sub_value = Automattic\Jetpack\Modules\Subscriptions\Settings::is_valid_reply_to( $value )
1014 + ? $value
1015 + : Automattic\Jetpack\Modules\Subscriptions\Settings::$default_reply_to;
1016 +
1017 + $updated = (string) get_option( $option ) !== (string) $sub_value ? update_option( $option, $sub_value ) : true;
981 1018 break;
1019 + case 'jetpack_subscriptions_from_name':
1020 + // If option value was the same, consider it done.
1021 + $sub_value = sanitize_text_field( $value );
1022 + $updated = (string) get_option( $option ) !== (string) $sub_value ? update_option( $option, $sub_value ) : true;
1023 + break;
982 1024
983 1025 case 'stb_enabled':
984 1026 case 'stc_enabled':
985 1027 case 'sm_enabled':
1028 + case 'jetpack_subscribe_overlay_enabled':
1029 + case 'jetpack_subscribe_floating_button_enabled':
986 1030 case 'wpcom_newsletter_categories_enabled':
1031 + case 'wpcom_featured_image_in_email':
1032 + case 'jetpack_gravatar_in_email':
1033 + case 'jetpack_author_in_email':
1034 + case 'jetpack_post_date_in_email':
1035 + case 'wpcom_subscription_emails_use_excerpt':
987 1036 case 'jetpack_subscriptions_subscribe_post_end_enabled':
1037 + case 'jetpack_subscriptions_login_navigation_enabled':
1038 + case 'jetpack_subscriptions_subscribe_navigation_enabled':
988 1039 // Convert the false value to 0. This allows the option to be updated if it doesn't exist yet.
989 1040 $sub_value = $value ? $value : 0;
990 1041 $updated = (string) get_option( $option ) !== (string) $sub_value ? update_option( $option, $sub_value ) : true;
991 1042 break;
@@ -998,9 +1049,9 @@
998 1049 if ( ! is_array( $value ) ) {
999 1050 break;
1000 1051 }
1001 1052
1002 - $allowed_keys = array( 'invitation', 'comment_follow', 'welcome' );
1053 + $allowed_keys = array( 'invitation', 'comment_follow', 'welcome', 'subscribe_modal_heading', 'free_tier_description', 'hide_free_tier' );
1003 1054 $filtered_value = array_filter(
1004 1055 $value,
1005 1056 function ( $key ) use ( $allowed_keys ) {
1006 1057 return in_array( $key, $allowed_keys, true );
@@ -1011,8 +1062,17 @@
1011 1062 if ( empty( $filtered_value ) ) {
1012 1063 break;
1013 1064 }
1014 1065
1066 + // `hide_free_tier` is a boolean flag, so pull it out before the HTML
1067 + // sanitization below (which expects strings). Sanitize it with
1068 + // rest_sanitize_boolean() so stringy booleans (e.g. "false", "0")
1069 + // are interpreted correctly rather than being treated as truthy by a
1070 + // plain `! empty()`.
1071 + $has_hide_free_tier = array_key_exists( 'hide_free_tier', $filtered_value );
1072 + $hide_free_tier = $has_hide_free_tier && rest_sanitize_boolean( $filtered_value['hide_free_tier'] );
1073 + unset( $filtered_value['hide_free_tier'] );
1074 +
1015 1075 array_walk_recursive(
1016 1076 $filtered_value,
1017 1077 function ( &$value ) {
1018 1078 $value = wp_kses(
@@ -1017,9 +1077,15 @@
1017 1077 function ( &$value ) {
1018 1078 $value = wp_kses(
1019 1079 $value,
1020 1080 array(
1021 - 'a' => array(
1081 + 'ul' => array(),
1082 + 'li' => array(),
1083 + 'p' => array(),
1084 + 'strong' => array(),
1085 + 'ol' => array(),
1086 + 'em' => array(),
1087 + 'a' => array(
1022 1088 'href' => array(),
1023 1089 ),
1024 1090 )
1025 1091 );
@@ -1025,19 +1091,72 @@
1025 1091 );
1026 1092 }
1027 1093 );
1028 1094
1095 + // Normalize whitespace-only `subscribe_modal_heading` input to empty so
1096 + // the modal template's `empty()` fallback fires. PHP's `empty()` treats
1097 + // `" "` as non-empty, which would otherwise render a blank heading.
1098 + if ( isset( $filtered_value['subscribe_modal_heading'] ) ) {
1099 + $filtered_value['subscribe_modal_heading'] = trim( $filtered_value['subscribe_modal_heading'] );
1100 + }
1101 +
1102 + // The free tier description is stored as plain markdown source, so strip
1103 + // all HTML and cap its length to match the paid-tier description field.
1104 + // WordPress core guarantees mb_substr() (polyfilled in wp-includes/compat.php
1105 + // when the mbstring extension is unavailable), so it's safe to use directly.
1106 + // A JSON payload could supply a non-scalar (array/object) for this field,
1107 + // which would fatal in wp_kses()/mb_substr() on PHP 8+, so drop invalid values.
1108 + if ( isset( $filtered_value['free_tier_description'] ) ) {
1109 + if ( is_scalar( $filtered_value['free_tier_description'] ) ) {
1110 + $filtered_value['free_tier_description'] = mb_substr( wp_kses( (string) $filtered_value['free_tier_description'], array() ), 0, 500 );
1111 + } else {
1112 + unset( $filtered_value['free_tier_description'] );
1113 + }
1114 + }
1115 +
1116 + if ( $has_hide_free_tier ) {
1117 + $filtered_value['hide_free_tier'] = $hide_free_tier;
1118 + }
1119 +
1029 1120 $old_subscription_options = get_option( 'subscription_options' );
1030 1121 if ( ! is_array( $old_subscription_options ) ) {
1031 1122 $old_subscription_options = array();
1032 1123 }
1033 1124 $new_subscription_options = array_merge( $old_subscription_options, $filtered_value );
1125 + $updated = true;
1034 1126
1035 - if ( update_option( $option, $new_subscription_options ) ) {
1036 - $updated[ $option ] = true;
1127 + if ( serialize( $old_subscription_options ) === serialize( $new_subscription_options ) ) { // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.serialize_serialize
1128 + break; // This prevents the option update to fail when the values are the same.
1037 1129 }
1130 +
1131 + if ( ! update_option( $option, $new_subscription_options ) ) {
1132 + $updated = false;
1133 + $error = esc_html__( 'Subscription Options failed to process.', 'jetpack' );
1134 + }
1038 1135 break;
1039 1136
1137 + case Jetpack_Newsletter_Category_Helper::NEWSLETTER_CATEGORIES_OPTION:
1138 + if ( ! is_array( $value ) || empty( $value ) ) {
1139 + $updated = true;
1140 + break;
1141 + }
1142 +
1143 + // If we are already current, do nothing
1144 + $current_value = Jetpack_Newsletter_Category_Helper::get_category_ids();
1145 + if ( $value === $current_value ) {
1146 + $updated = true;
1147 + break;
1148 + }
1149 +
1150 + if ( Jetpack_Newsletter_Category_Helper::save_category_ids( $value ) ) {
1151 + $updated = true;
1152 + } else {
1153 + $updated = false;
1154 + $error = esc_html__( 'Newsletter category did not update.', 'jetpack' );
1155 + }
1156 +
1157 + break;
1158 +
1040 1159 default:
1041 1160 // Boolean values are stored as 1 or 0.
1042 1161 if ( isset( $options[ $option ]['type'] ) && 'boolean' === $options[ $option ]['type'] ) {
1043 1162 $value = (int) $value;
@@ -1043,9 +1162,9 @@
1043 1162 $value = (int) $value;
1044 1163 }
1045 1164
1046 1165 // If option value was the same as it's current value, or it's default, consider it done.
1047 - $default = isset( $options[ $option ]['default'] ) ? $options[ $option ]['default'] : false;
1166 + $default = $options[ $option ]['default'] ?? false;
1048 1167 $updated = get_option( $option, $default ) != $value // phpcs:ignore Universal.Operators.StrictComparisons.LooseNotEqual -- ensure we support scalars or strings saved by update_option.
1049 1168 ? update_option( $option, $value )
1050 1169 : true;
1051 1170 break;
@@ -1099,218 +1218,30 @@
1099 1218 * Perform tasks in the site based on onboarding choices.
1100 1219 *
1101 1220 * @since 5.4.0
1102 1221 *
1222 + * @deprecated since 13.9
1223 + *
1103 1224 * @param array $data Onboarding choices made by user.
1104 1225 *
1105 1226 * @return string Result of onboarding processing and, if there is one, an error message.
1106 1227 */
1107 - private function process_onboarding( $data ) {
1108 - if ( isset( $data['end'] ) && $data['end'] ) {
1109 - return Jetpack::invalidate_onboarding_token()
1110 - ? ''
1111 - : esc_html__( "The onboarding token couldn't be deleted.", 'jetpack' );
1112 - }
1113 -
1114 - $error = array();
1115 -
1116 - if ( ! empty( $data['siteTitle'] ) ) {
1117 - // If option value was the same, consider it done.
1118 - if ( ! (
1119 - update_option( 'blogname', $data['siteTitle'] )
1120 - || get_option( 'blogname' ) === $data['siteTitle']
1121 - ) ) {
1122 - $error[] = 'siteTitle';
1123 - }
1124 - }
1125 -
1126 - if ( isset( $data['siteDescription'] ) ) {
1127 - // If option value was the same, consider it done.
1128 - if ( ! (
1129 - update_option( 'blogdescription', $data['siteDescription'] )
1130 - || get_option( 'blogdescription' ) === $data['siteDescription']
1131 - ) ) {
1132 - $error[] = 'siteDescription';
1133 - }
1134 - }
1135 -
1136 - $site_title = get_option( 'blogname' );
1137 - $author = get_current_user_id() || 1;
1138 -
1139 - if ( ! empty( $data['siteType'] ) ) {
1140 - if ( ! (
1141 - update_option( 'jpo_site_type', $data['siteType'] )
1142 - || get_option( 'jpo_site_type' ) === $data['siteType']
1143 - ) ) {
1144 - $error[] = 'siteType';
1145 - }
1146 - }
1147 -
1148 - if ( isset( $data['homepageFormat'] ) ) {
1149 - /*
1150 - * If $data['homepageFormat'] is 'posts',
1151 - * we have nothing to do since it's WordPress' default
1152 - * if it exists, just update
1153 - */
1154 - $homepage_format = get_option( 'jpo_homepage_format' );
1155 - if ( ! $homepage_format || $homepage_format !== $data['homepageFormat'] ) {
1156 - if ( 'page' === $data['homepageFormat'] ) {
1157 - if ( ! (
1158 - update_option( 'show_on_front', 'page' )
1159 - || get_option( 'show_on_front' ) === 'page'
1160 - ) ) {
1161 - $error[] = 'homepageFormat';
1162 - }
1163 -
1164 - $home = wp_insert_post(
1165 - array(
1166 - 'post_type' => 'page',
1167 - /* translators: this references the home page of a site, also called front page. */
1168 - 'post_title' => esc_html_x( 'Home Page', 'The home page of a website.', 'jetpack' ),
1169 - 'post_content' => sprintf(
1170 - /* Translators: placeholder is the site title. */
1171 - esc_html__( 'Welcome to %s.', 'jetpack' ),
1172 - $site_title
1173 - ),
1174 - 'post_status' => 'publish',
1175 - 'post_author' => $author,
1176 - )
1177 - );
1178 - if ( 0 === $home ) {
1179 - $error[] = 'home insert: 0';
1180 - } elseif ( is_wp_error( $home ) ) {
1181 - $error[] = 'home creation: ' . $home->get_error_message();
1182 - }
1183 - if ( ! (
1184 - update_option( 'page_on_front', $home )
1185 - || get_option( 'page_on_front' ) === $home
1186 - ) ) {
1187 -
1188 - $error[] = 'home set';
1189 - }
1190 -
1191 - $blog = wp_insert_post(
1192 - array(
1193 - 'post_type' => 'page',
1194 - /* translators: this references the page where blog posts are listed. */
1195 - 'post_title' => esc_html_x( 'Blog', 'The blog of a website.', 'jetpack' ),
1196 - 'post_content' => sprintf(
1197 - /* Translators: placeholder is the site title. */
1198 - esc_html__( 'These are the latest posts in %s.', 'jetpack' ),
1199 - $site_title
1200 - ),
1201 - 'post_status' => 'publish',
1202 - 'post_author' => $author,
1203 - )
1204 - );
1205 - if ( 0 === $blog ) {
1206 - $error[] = 'blog insert: 0';
1207 - } elseif ( is_wp_error( $blog ) ) {
1208 - $error[] = 'blog creation: ' . $blog->get_error_message();
1209 - }
1210 - if ( ! (
1211 - update_option( 'page_for_posts', $blog )
1212 - || get_option( 'page_for_posts' ) === $blog
1213 - ) ) {
1214 - $error[] = 'blog set';
1215 - }
1216 - } else {
1217 - $front_page = get_option( 'page_on_front' );
1218 - $posts_page = get_option( 'page_for_posts' );
1219 - if ( $posts_page && get_post( $posts_page ) ) {
1220 - wp_delete_post( $posts_page );
1221 - }
1222 - if ( $front_page && get_post( $front_page ) ) {
1223 - wp_delete_post( $front_page );
1224 - }
1225 - update_option( 'show_on_front', 'posts' );
1226 - }
1227 - }
1228 - update_option( 'jpo_homepage_format', $data['homepageFormat'] );
1229 - }
1230 -
1231 - // Setup contact page and add a form and/or business info.
1232 - $contact_page = '';
1233 - if ( ! empty( $data['addContactForm'] ) && ! get_option( 'jpo_contact_page' ) ) {
1234 - $contact_form_module_active = Jetpack::is_module_active( 'contact-form' );
1235 - if ( ! $contact_form_module_active ) {
1236 - $contact_form_module_active = Jetpack::activate_module( 'contact-form', false, false );
1237 - }
1238 -
1239 - if ( $contact_form_module_active ) {
1240 - $contact_page = '[contact-form][contact-field label="' . esc_html__( 'Name', 'jetpack' ) . '" type="name" required="true" /][contact-field label="' . esc_html__( 'Email', 'jetpack' ) . '" type="email" required="true" /][contact-field label="' . esc_html__( 'Website', 'jetpack' ) . '" type="url" /][contact-field label="' . esc_html__( 'Message', 'jetpack' ) . '" type="textarea" /][/contact-form]';
1241 - } else {
1242 - $error[] = 'contact-form activate';
1243 - }
1244 - }
1245 -
1246 - if ( isset( $data['businessPersonal'] ) && 'business' === $data['businessPersonal'] ) {
1247 - $contact_page .= "\n" . implode( "\n", $data['businessInfo'] );
1248 - }
1249 -
1250 - if ( ! empty( $contact_page ) ) {
1251 - $form = wp_insert_post(
1252 - array(
1253 - 'post_type' => 'page',
1254 - /* translators: this references a page with contact details and possibly a form. */
1255 - 'post_title' => esc_html_x( 'Contact us', 'Contact page for your website.', 'jetpack' ),
1256 - 'post_content' => esc_html__( 'Send us a message!', 'jetpack' ) . "\n" . $contact_page,
1257 - 'post_status' => 'publish',
1258 - 'post_author' => $author,
1259 - )
1260 - );
1261 - if ( 0 === $form ) {
1262 - $error[] = 'form insert: 0';
1263 - } elseif ( is_wp_error( $form ) ) {
1264 - $error[] = 'form creation: ' . $form->get_error_message();
1265 - } else {
1266 - update_option( 'jpo_contact_page', $form );
1267 - }
1268 - }
1269 -
1270 - if ( isset( $data['businessAddress'] ) ) {
1271 - $handled_business_address = self::handle_business_address( $data['businessAddress'] );
1272 - if ( is_wp_error( $handled_business_address ) ) {
1273 - $error[] = 'BusinessAddress';
1274 - }
1275 - }
1276 -
1277 - if ( ! empty( $data['installWooCommerce'] ) ) {
1278 - $wc_install_result = Plugins_Installer::install_and_activate_plugin( 'woocommerce' );
1279 - delete_transient( '_wc_activation_redirect' ); // Redirecting to WC setup would kill our users' flow.
1280 - if ( is_wp_error( $wc_install_result ) ) {
1281 - $error[] = 'woocommerce installation';
1282 - }
1283 - }
1284 -
1285 - if ( ! empty( $data['stats'] ) ) {
1286 - if ( Jetpack::is_connection_ready() ) {
1287 - $stats_module_active = Jetpack::is_module_active( 'stats' );
1288 - if ( ! $stats_module_active ) {
1289 - $stats_module_active = Jetpack::activate_module( 'stats', false, false );
1290 - }
1291 -
1292 - if ( ! $stats_module_active ) {
1293 - $error[] = 'stats activate';
1294 - }
1295 - } else {
1296 - $error[] = 'stats not connected';
1297 - }
1298 - }
1299 -
1300 - return empty( $error )
1301 - ? ''
1302 - : implode( ', ', $error );
1228 + private function process_onboarding( $data ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
1229 + _deprecated_function( __METHOD__, '13.9' );
1230 + return '';
1303 1231 }
1304 1232
1305 1233 /**
1306 1234 * Add or update Business Address widget.
1307 1235 *
1236 + * @deprecated since 13.9
1237 + *
1308 1238 * @param array $address Array of business address fields.
1309 1239 *
1310 1240 * @return WP_Error|true True if the data was saved correctly.
1311 1241 */
1312 1242 private static function handle_business_address( $address ) {
1243 + _deprecated_function( __METHOD__, '13.9' );
1313 1244 $first_sidebar = Jetpack_Widgets::get_first_sidebar();
1314 1245
1315 1246 $widgets_module_active = Jetpack::is_module_active( 'widgets' );
1316 1247 if ( ! $widgets_module_active ) {
@@ -1394,13 +1325,8 @@
1394 1325 *
1395 1326 * @return bool
1396 1327 */
1397 1328 public function can_request( $request ) {
1398 - $req_params = $request->get_params();
1399 - if ( ! empty( $req_params['onboarding']['token'] ) && isset( $req_params['rest_route'] ) ) {
1400 - return Jetpack::validate_onboarding_token_action( $req_params['onboarding']['token'], $req_params['rest_route'] );
1401 - }
1402 -
1403 1329 if ( 'GET' === $request->get_method() ) {
1404 1330 return current_user_can( 'jetpack_admin_page' );
1405 1331 } else {
1406 1332 $module = Jetpack_Core_Json_Api_Endpoints::get_module_requested();
@@ -1409,13 +1335,13 @@
1409 1335 if ( ! is_array( $params ) ) {
1410 1336 $params = $request->get_body_params();
1411 1337 }
1412 1338 $options = Jetpack_Core_Json_Api_Endpoints::get_updateable_data_list( $params );
1413 - foreach ( $options as $option => $definition ) {
1414 - if ( in_array( $options[ $option ]['jp_group'], array( 'post-by-email' ), true ) ) {
1415 - $module = $options[ $option ]['jp_group'];
1416 - break;
1417 - }
1339 +
1340 + // The Post by Email gate applies only when the request contains nothing else.
1341 + $groups = array_values( array_unique( array_column( $options, 'jp_group' ) ) );
1342 + if ( array( 'post-by-email' ) === $groups ) {
1343 + $module = 'post-by-email';
1418 1344 }
1419 1345 }
1420 1346 // User is trying to create, regenerate or delete its PbE.
1421 1347 if ( 'post-by-email' === $module ) {
@@ -1431,9 +1357,8 @@
1431 1357 *
1432 1358 * phpcs:disable Generic.Files.OneObjectStructurePerFile.MultipleFound
1433 1359 */
1434 1360 class Jetpack_Core_API_Module_Data_Endpoint {
1435 - // phpcs:disable Generic.Files.OneObjectStructurePerFile.MultipleFound
1436 1361
1437 1362 /**
1438 1363 * Process request and return different data based on the module we are interested in.
1439 1364 *
@@ -1633,11 +1558,9 @@
1633 1558 array(
1634 1559 'general' => $initial_stats,
1635 1560
1636 1561 // Build data for 'day' as if it was $wpcom_stats ->get_visits( array( 'unit' => 'day, 'quantity' => 30).
1637 - 'day' => isset( $initial_stats->visits )
1638 - ? $initial_stats->visits
1639 - : array(),
1562 + 'day' => $initial_stats->visits ?? array(),
1640 1563 )
1641 1564 );
1642 1565 case 'week':
1643 1566 return rest_ensure_response(
@@ -1778,9 +1701,9 @@
1778 1701 $last_service = $copy_services[ $last ];
1779 1702 unset( $copy_services[ $last ] );
1780 1703 $message = esc_html(
1781 1704 sprintf(
1782 - /* translators: %1$s is a comma separated list of services, and %2$s is a single service name like Google, Bing, Pinterest, etc. */
1705 + /* translators: %1$s is a comma-separated list of services, and %2$s is a single service name like Google, Bing, Pinterest, etc. */
1783 1706 __( 'Your site is verified with %1$s and %2$s.', 'jetpack' ),
1784 1707 implode( ', ', $copy_services ),
1785 1708 $last_service
1786 1709 )