PluginProbe
Jetpack – WP Security, Backup, Speed, & Growth / 16.3-a.7
Jetpack – WP Security, Backup, Speed, & Growth v16.3-a.7
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 +198 -278 13.3.3 → 16.3-a.7 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,32 +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':
987 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':
988 1035 case 'wpcom_subscription_emails_use_excerpt':
989 1036 case 'jetpack_subscriptions_subscribe_post_end_enabled':
990 1037 case 'jetpack_subscriptions_login_navigation_enabled':
1038 + case 'jetpack_subscriptions_subscribe_navigation_enabled':
991 1039 // Convert the false value to 0. This allows the option to be updated if it doesn't exist yet.
992 1040 $sub_value = $value ? $value : 0;
993 1041 $updated = (string) get_option( $option ) !== (string) $sub_value ? update_option( $option, $sub_value ) : true;
994 1042 break;
@@ -1001,9 +1049,9 @@
1001 1049 if ( ! is_array( $value ) ) {
1002 1050 break;
1003 1051 }
1004 1052
1005 - $allowed_keys = array( 'invitation', 'comment_follow', 'welcome' );
1053 + $allowed_keys = array( 'invitation', 'comment_follow', 'welcome', 'subscribe_modal_heading', 'free_tier_description', 'hide_free_tier' );
1006 1054 $filtered_value = array_filter(
1007 1055 $value,
1008 1056 function ( $key ) use ( $allowed_keys ) {
1009 1057 return in_array( $key, $allowed_keys, true );
@@ -1014,8 +1062,17 @@
1014 1062 if ( empty( $filtered_value ) ) {
1015 1063 break;
1016 1064 }
1017 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 +
1018 1075 array_walk_recursive(
1019 1076 $filtered_value,
1020 1077 function ( &$value ) {
1021 1078 $value = wp_kses(
@@ -1020,9 +1077,15 @@
1020 1077 function ( &$value ) {
1021 1078 $value = wp_kses(
1022 1079 $value,
1023 1080 array(
1024 - 'a' => array(
1081 + 'ul' => array(),
1082 + 'li' => array(),
1083 + 'p' => array(),
1084 + 'strong' => array(),
1085 + 'ol' => array(),
1086 + 'em' => array(),
1087 + 'a' => array(
1025 1088 'href' => array(),
1026 1089 ),
1027 1090 )
1028 1091 );
@@ -1028,19 +1091,72 @@
1028 1091 );
1029 1092 }
1030 1093 );
1031 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 +
1032 1120 $old_subscription_options = get_option( 'subscription_options' );
1033 1121 if ( ! is_array( $old_subscription_options ) ) {
1034 1122 $old_subscription_options = array();
1035 1123 }
1036 1124 $new_subscription_options = array_merge( $old_subscription_options, $filtered_value );
1125 + $updated = true;
1037 1126
1038 - if ( update_option( $option, $new_subscription_options ) ) {
1039 - $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.
1040 1129 }
1130 +
1131 + if ( ! update_option( $option, $new_subscription_options ) ) {
1132 + $updated = false;
1133 + $error = esc_html__( 'Subscription Options failed to process.', 'jetpack' );
1134 + }
1041 1135 break;
1042 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 +
1043 1159 default:
1044 1160 // Boolean values are stored as 1 or 0.
1045 1161 if ( isset( $options[ $option ]['type'] ) && 'boolean' === $options[ $option ]['type'] ) {
1046 1162 $value = (int) $value;
@@ -1046,9 +1162,9 @@
1046 1162 $value = (int) $value;
1047 1163 }
1048 1164
1049 1165 // If option value was the same as it's current value, or it's default, consider it done.
1050 - $default = isset( $options[ $option ]['default'] ) ? $options[ $option ]['default'] : false;
1166 + $default = $options[ $option ]['default'] ?? false;
1051 1167 $updated = get_option( $option, $default ) != $value // phpcs:ignore Universal.Operators.StrictComparisons.LooseNotEqual -- ensure we support scalars or strings saved by update_option.
1052 1168 ? update_option( $option, $value )
1053 1169 : true;
1054 1170 break;
@@ -1102,218 +1218,30 @@
1102 1218 * Perform tasks in the site based on onboarding choices.
1103 1219 *
1104 1220 * @since 5.4.0
1105 1221 *
1222 + * @deprecated since 13.9
1223 + *
1106 1224 * @param array $data Onboarding choices made by user.
1107 1225 *
1108 1226 * @return string Result of onboarding processing and, if there is one, an error message.
1109 1227 */
1110 - private function process_onboarding( $data ) {
1111 - if ( isset( $data['end'] ) && $data['end'] ) {
1112 - return Jetpack::invalidate_onboarding_token()
1113 - ? ''
1114 - : esc_html__( "The onboarding token couldn't be deleted.", 'jetpack' );
1115 - }
1116 -
1117 - $error = array();
1118 -
1119 - if ( ! empty( $data['siteTitle'] ) ) {
1120 - // If option value was the same, consider it done.
1121 - if ( ! (
1122 - update_option( 'blogname', $data['siteTitle'] )
1123 - || get_option( 'blogname' ) === $data['siteTitle']
1124 - ) ) {
1125 - $error[] = 'siteTitle';
1126 - }
1127 - }
1128 -
1129 - if ( isset( $data['siteDescription'] ) ) {
1130 - // If option value was the same, consider it done.
1131 - if ( ! (
1132 - update_option( 'blogdescription', $data['siteDescription'] )
1133 - || get_option( 'blogdescription' ) === $data['siteDescription']
1134 - ) ) {
1135 - $error[] = 'siteDescription';
1136 - }
1137 - }
1138 -
1139 - $site_title = get_option( 'blogname' );
1140 - $author = get_current_user_id() || 1;
1141 -
1142 - if ( ! empty( $data['siteType'] ) ) {
1143 - if ( ! (
1144 - update_option( 'jpo_site_type', $data['siteType'] )
1145 - || get_option( 'jpo_site_type' ) === $data['siteType']
1146 - ) ) {
1147 - $error[] = 'siteType';
1148 - }
1149 - }
1150 -
1151 - if ( isset( $data['homepageFormat'] ) ) {
1152 - /*
1153 - * If $data['homepageFormat'] is 'posts',
1154 - * we have nothing to do since it's WordPress' default
1155 - * if it exists, just update
1156 - */
1157 - $homepage_format = get_option( 'jpo_homepage_format' );
1158 - if ( ! $homepage_format || $homepage_format !== $data['homepageFormat'] ) {
1159 - if ( 'page' === $data['homepageFormat'] ) {
1160 - if ( ! (
1161 - update_option( 'show_on_front', 'page' )
1162 - || get_option( 'show_on_front' ) === 'page'
1163 - ) ) {
1164 - $error[] = 'homepageFormat';
1165 - }
1166 -
1167 - $home = wp_insert_post(
1168 - array(
1169 - 'post_type' => 'page',
1170 - /* translators: this references the home page of a site, also called front page. */
1171 - 'post_title' => esc_html_x( 'Home Page', 'The home page of a website.', 'jetpack' ),
1172 - 'post_content' => sprintf(
1173 - /* Translators: placeholder is the site title. */
1174 - esc_html__( 'Welcome to %s.', 'jetpack' ),
1175 - $site_title
1176 - ),
1177 - 'post_status' => 'publish',
1178 - 'post_author' => $author,
1179 - )
1180 - );
1181 - if ( 0 === $home ) {
1182 - $error[] = 'home insert: 0';
1183 - } elseif ( is_wp_error( $home ) ) {
1184 - $error[] = 'home creation: ' . $home->get_error_message();
1185 - }
1186 - if ( ! (
1187 - update_option( 'page_on_front', $home )
1188 - || get_option( 'page_on_front' ) === $home
1189 - ) ) {
1190 -
1191 - $error[] = 'home set';
1192 - }
1193 -
1194 - $blog = wp_insert_post(
1195 - array(
1196 - 'post_type' => 'page',
1197 - /* translators: this references the page where blog posts are listed. */
1198 - 'post_title' => esc_html_x( 'Blog', 'The blog of a website.', 'jetpack' ),
1199 - 'post_content' => sprintf(
1200 - /* Translators: placeholder is the site title. */
1201 - esc_html__( 'These are the latest posts in %s.', 'jetpack' ),
1202 - $site_title
1203 - ),
1204 - 'post_status' => 'publish',
1205 - 'post_author' => $author,
1206 - )
1207 - );
1208 - if ( 0 === $blog ) {
1209 - $error[] = 'blog insert: 0';
1210 - } elseif ( is_wp_error( $blog ) ) {
1211 - $error[] = 'blog creation: ' . $blog->get_error_message();
1212 - }
1213 - if ( ! (
1214 - update_option( 'page_for_posts', $blog )
1215 - || get_option( 'page_for_posts' ) === $blog
1216 - ) ) {
1217 - $error[] = 'blog set';
1218 - }
1219 - } else {
1220 - $front_page = get_option( 'page_on_front' );
1221 - $posts_page = get_option( 'page_for_posts' );
1222 - if ( $posts_page && get_post( $posts_page ) ) {
1223 - wp_delete_post( $posts_page );
1224 - }
1225 - if ( $front_page && get_post( $front_page ) ) {
1226 - wp_delete_post( $front_page );
1227 - }
1228 - update_option( 'show_on_front', 'posts' );
1229 - }
1230 - }
1231 - update_option( 'jpo_homepage_format', $data['homepageFormat'] );
1232 - }
1233 -
1234 - // Setup contact page and add a form and/or business info.
1235 - $contact_page = '';
1236 - if ( ! empty( $data['addContactForm'] ) && ! get_option( 'jpo_contact_page' ) ) {
1237 - $contact_form_module_active = Jetpack::is_module_active( 'contact-form' );
1238 - if ( ! $contact_form_module_active ) {
1239 - $contact_form_module_active = Jetpack::activate_module( 'contact-form', false, false );
1240 - }
1241 -
1242 - if ( $contact_form_module_active ) {
1243 - $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]';
1244 - } else {
1245 - $error[] = 'contact-form activate';
1246 - }
1247 - }
1248 -
1249 - if ( isset( $data['businessPersonal'] ) && 'business' === $data['businessPersonal'] ) {
1250 - $contact_page .= "\n" . implode( "\n", $data['businessInfo'] );
1251 - }
1252 -
1253 - if ( ! empty( $contact_page ) ) {
1254 - $form = wp_insert_post(
1255 - array(
1256 - 'post_type' => 'page',
1257 - /* translators: this references a page with contact details and possibly a form. */
1258 - 'post_title' => esc_html_x( 'Contact us', 'Contact page for your website.', 'jetpack' ),
1259 - 'post_content' => esc_html__( 'Send us a message!', 'jetpack' ) . "\n" . $contact_page,
1260 - 'post_status' => 'publish',
1261 - 'post_author' => $author,
1262 - )
1263 - );
1264 - if ( 0 === $form ) {
1265 - $error[] = 'form insert: 0';
1266 - } elseif ( is_wp_error( $form ) ) {
1267 - $error[] = 'form creation: ' . $form->get_error_message();
1268 - } else {
1269 - update_option( 'jpo_contact_page', $form );
1270 - }
1271 - }
1272 -
1273 - if ( isset( $data['businessAddress'] ) ) {
1274 - $handled_business_address = self::handle_business_address( $data['businessAddress'] );
1275 - if ( is_wp_error( $handled_business_address ) ) {
1276 - $error[] = 'BusinessAddress';
1277 - }
1278 - }
1279 -
1280 - if ( ! empty( $data['installWooCommerce'] ) ) {
1281 - $wc_install_result = Plugins_Installer::install_and_activate_plugin( 'woocommerce' );
1282 - delete_transient( '_wc_activation_redirect' ); // Redirecting to WC setup would kill our users' flow.
1283 - if ( is_wp_error( $wc_install_result ) ) {
1284 - $error[] = 'woocommerce installation';
1285 - }
1286 - }
1287 -
1288 - if ( ! empty( $data['stats'] ) ) {
1289 - if ( Jetpack::is_connection_ready() ) {
1290 - $stats_module_active = Jetpack::is_module_active( 'stats' );
1291 - if ( ! $stats_module_active ) {
1292 - $stats_module_active = Jetpack::activate_module( 'stats', false, false );
1293 - }
1294 -
1295 - if ( ! $stats_module_active ) {
1296 - $error[] = 'stats activate';
1297 - }
1298 - } else {
1299 - $error[] = 'stats not connected';
1300 - }
1301 - }
1302 -
1303 - return empty( $error )
1304 - ? ''
1305 - : implode( ', ', $error );
1228 + private function process_onboarding( $data ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
1229 + _deprecated_function( __METHOD__, '13.9' );
1230 + return '';
1306 1231 }
1307 1232
1308 1233 /**
1309 1234 * Add or update Business Address widget.
1310 1235 *
1236 + * @deprecated since 13.9
1237 + *
1311 1238 * @param array $address Array of business address fields.
1312 1239 *
1313 1240 * @return WP_Error|true True if the data was saved correctly.
1314 1241 */
1315 1242 private static function handle_business_address( $address ) {
1243 + _deprecated_function( __METHOD__, '13.9' );
1316 1244 $first_sidebar = Jetpack_Widgets::get_first_sidebar();
1317 1245
1318 1246 $widgets_module_active = Jetpack::is_module_active( 'widgets' );
1319 1247 if ( ! $widgets_module_active ) {
@@ -1397,13 +1325,8 @@
1397 1325 *
1398 1326 * @return bool
1399 1327 */
1400 1328 public function can_request( $request ) {
1401 - $req_params = $request->get_params();
1402 - if ( ! empty( $req_params['onboarding']['token'] ) && isset( $req_params['rest_route'] ) ) {
1403 - return Jetpack::validate_onboarding_token_action( $req_params['onboarding']['token'], $req_params['rest_route'] );
1404 - }
1405 -
1406 1329 if ( 'GET' === $request->get_method() ) {
1407 1330 return current_user_can( 'jetpack_admin_page' );
1408 1331 } else {
1409 1332 $module = Jetpack_Core_Json_Api_Endpoints::get_module_requested();
@@ -1412,13 +1335,13 @@
1412 1335 if ( ! is_array( $params ) ) {
1413 1336 $params = $request->get_body_params();
1414 1337 }
1415 1338 $options = Jetpack_Core_Json_Api_Endpoints::get_updateable_data_list( $params );
1416 - foreach ( $options as $option => $definition ) {
1417 - if ( in_array( $options[ $option ]['jp_group'], array( 'post-by-email' ), true ) ) {
1418 - $module = $options[ $option ]['jp_group'];
1419 - break;
1420 - }
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';
1421 1344 }
1422 1345 }
1423 1346 // User is trying to create, regenerate or delete its PbE.
1424 1347 if ( 'post-by-email' === $module ) {
@@ -1434,9 +1357,8 @@
1434 1357 *
1435 1358 * phpcs:disable Generic.Files.OneObjectStructurePerFile.MultipleFound
1436 1359 */
1437 1360 class Jetpack_Core_API_Module_Data_Endpoint {
1438 - // phpcs:disable Generic.Files.OneObjectStructurePerFile.MultipleFound
1439 1361
1440 1362 /**
1441 1363 * Process request and return different data based on the module we are interested in.
1442 1364 *
@@ -1636,11 +1558,9 @@
1636 1558 array(
1637 1559 'general' => $initial_stats,
1638 1560
1639 1561 // Build data for 'day' as if it was $wpcom_stats ->get_visits( array( 'unit' => 'day, 'quantity' => 30).
1640 - 'day' => isset( $initial_stats->visits )
1641 - ? $initial_stats->visits
1642 - : array(),
1562 + 'day' => $initial_stats->visits ?? array(),
1643 1563 )
1644 1564 );
1645 1565 case 'week':
1646 1566 return rest_ensure_response(
@@ -1781,9 +1701,9 @@
1781 1701 $last_service = $copy_services[ $last ];
1782 1702 unset( $copy_services[ $last ] );
1783 1703 $message = esc_html(
1784 1704 sprintf(
1785 - /* 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. */
1786 1706 __( 'Your site is verified with %1$s and %2$s.', 'jetpack' ),
1787 1707 implode( ', ', $copy_services ),
1788 1708 $last_service
1789 1709 )