PluginProbe
Jetpack – WP Security, Backup, Speed, & Growth / 16.3-beta
Jetpack – WP Security, Backup, Speed, & Growth v16.3-beta
16.3-beta 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 All 507 releases
← All changes | json-endpoints/class.wpcom-json-api-get-site-endpoint.php +227 -44 13.0.2 → 16.3-beta View file →
@@ -1,6 +1,10 @@
1 1 <?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
2 2
3 +if ( ! defined( 'ABSPATH' ) ) {
4 + exit( 0 );
5 +}
6 +
3 7 new WPCOM_JSON_API_GET_Site_Endpoint(
4 8 array(
5 9 'description' => 'Get information about a site.',
6 10 'group' => 'sites',
@@ -12,8 +16,10 @@
12 16 'path' => '/sites/%s',
13 17 'path_labels' => array(
14 18 '$site' => '(int|string) Site ID or domain',
15 19 ),
20 + 'rest_route' => '/site',
21 + 'rest_min_jp_version' => '15.9',
16 22 'allow_jetpack_site_auth' => true,
17 23
18 24 'allow_fallback_to_jetpack_blog_token' => true,
19 25
@@ -29,8 +35,10 @@
29 35 );
30 36
31 37 /**
32 38 * GET Site endpoint class.
39 + *
40 + * @phan-constructor-used-for-side-effects
33 41 */
34 42 class WPCOM_JSON_API_GET_Site_Endpoint extends WPCOM_JSON_API_Endpoint {
35 43
36 44 /**
@@ -39,8 +47,9 @@
39 47 * @var array $site_format
40 48 */
41 49 public static $site_format = array(
42 50 'ID' => '(int) Site ID',
51 + 'slug' => '(string) Slug of site',
43 52 'name' => '(string) Title of site',
44 53 'description' => '(string) Tagline or description of site',
45 54 'URL' => '(string) Full URL to the site',
46 55 'user_can_manage' => '(bool) The current user can manage this site', // deprecated.
@@ -82,8 +91,20 @@
82 91 'was_upgraded_from_trial' => '(bool) If the site ever upgraded to a paid plan from a trial.',
83 92 'was_migration_trial' => '(bool) If the site ever used a migration trial.',
84 93 'was_hosting_trial' => '(bool) If the site ever used a hosting trial.',
85 94 'wpcom_site_setup' => '(string) The WP.com site setup identifier.',
95 + 'is_deleted' => '(bool) If the site flagged as deleted.',
96 + 'is_a4a_client' => '(bool) If the site is an A4A client site.',
97 + 'is_a4a_dev_site' => '(bool) If the site is an A4A dev site.',
98 + 'is_garden' => '(bool) If the site is a Garden site.',
99 + 'garden_name' => '(string) The name of the Garden site.',
100 + 'garden_partner' => '(string) The partner of the Garden site.',
101 + 'garden_is_provisioned' => '(bool) If the Garden site is provisioned.',
102 + 'is_wpcom_flex' => '(bool) If the site is a Flex site',
103 + 'big_sky_enabled' => '(bool) Whether the Big Sky AI assistant is enabled for this site.',
104 + 'atomic_email_block' => '(object) State of the block on the site\'s outgoing email, with `status` (`blocked` while a block is active, `at_risk` once it has expired), `reason` and `expires_on` keys, or null when the site has no block history. WordPress.com platform only.',
105 + 'hosting_provider_guess' => '(string) Guess of the hosting provider. WordPress.com platform only; only returned when explicitly requested via the fields parameter.',
106 + 'environment_type' => '(string) The WP_ENVIRONMENT_TYPE of the site as synced by Jetpack. WordPress.com platform only; only returned when explicitly requested via the fields parameter.',
86 107 );
87 108
88 109 /**
89 110 * No member fields.
@@ -115,8 +136,15 @@
115 136 'is_fse_eligible',
116 137 'is_core_site_editor_enabled',
117 138 'is_wpcom_atomic',
118 139 'is_wpcom_staging_site',
140 + 'is_deleted',
141 + 'is_wpcom_flex',
142 + 'is_a4a_client',
143 + 'is_a4a_dev_site',
144 + 'is_garden',
145 + 'big_sky_enabled',
146 + 'garden_name',
119 147 );
120 148
121 149 /**
122 150 * Site options.
@@ -135,8 +163,9 @@
135 163 'is_redirect',
136 164 'unmapped_url',
137 165 'featured_images_enabled',
138 166 'theme_slug',
167 + 'theme_errors',
139 168 'header_image',
140 169 'background_color',
141 170 'image_default_link_type',
142 171 'image_thumbnail_width',
@@ -196,38 +225,42 @@
196 225 'was_created_with_blank_canvas_design',
197 226 'videopress_storage_used',
198 227 'is_difm_lite_in_progress',
199 228 'difm_lite_site_options',
229 + 'is_gating_business_q1',
230 + 'is_legacy_gating_site',
200 231 'site_intent',
232 + 'site_partner_bundle',
233 + 'onboarding_segment',
201 234 'site_vertical_id',
202 235 'blogging_prompts_settings',
203 236 'launchpad_screen',
204 237 'launchpad_checklist_tasks_statuses',
238 + 'migration_source_site_domain',
205 239 'wpcom_production_blog_id',
206 240 'wpcom_staging_blog_ids',
207 241 'can_blaze',
208 242 'wpcom_site_setup',
209 243 'is_commercial',
244 + 'is_commercial_reasons',
210 245 'wpcom_admin_interface',
246 + 'wpcom_classic_early_release',
247 + 'jetpack_recovery_mode_status',
248 + 'jetpack_sso_require_two_step',
249 + 'apm_enabled',
250 + 'wpcom_ai_launchpad_enabled',
251 + 'wpcom_ai_launchpad_dismissed',
252 + 'wpcom_ai_launchpad_completed',
253 + 'wpcom_ai_launchpad_no_guidance',
211 254 );
212 255
213 256 /**
214 - * List of DIFM Lite options to be displayed
215 - *
216 - * @var array $displayed_difm_lite_site_options
217 - */
218 - protected static $displayed_difm_lite_site_options = array(
219 - 'site_category',
220 - 'is_website_content_submitted',
221 - 'selected_page_titles',
222 - );
223 -
224 - /**
225 257 * Jetpack response fields.
226 258 *
227 259 * @var array $jetpack_response_field_additions
228 260 */
229 261 protected static $jetpack_response_field_additions = array(
262 + 'slug',
230 263 'subscribers_count',
231 264 'site_migration',
232 265 'site_owner',
233 266 'is_wpcom_staging_site',
@@ -234,8 +267,16 @@
234 267 'was_ecommerce_trial',
235 268 'was_migration_trial',
236 269 'was_hosting_trial',
237 270 'was_upgraded_from_trial',
271 + 'is_a4a_dev_site',
272 + 'is_garden',
273 + 'garden_name',
274 + 'garden_partner',
275 + 'garden_is_provisioned',
276 + 'is_wpcom_flex',
277 + 'big_sky_enabled',
278 + 'atomic_email_block',
238 279 );
239 280
240 281 /**
241 282 * Jetpack response field member additions.
@@ -251,9 +292,9 @@
251 292
252 293 /**
253 294 * Jetpack response option additions.
254 295 *
255 - * @var array $jetpack_response_field_member_additions
296 + * @var array $jetpack_response_option_additions
256 297 */
257 298 protected static $jetpack_response_option_additions = array(
258 299 'publicize_permanently_disabled',
259 300 'ak_vp_bundle_enabled',
@@ -277,9 +318,14 @@
277 318 'blogging_prompts_settings',
278 319 'wpcom_production_blog_id',
279 320 'wpcom_staging_blog_ids',
280 321 'is_commercial',
322 + 'is_commercial_reasons',
281 323 'wpcom_admin_interface',
324 + 'wpcom_classic_early_release',
325 + 'jetpack_recovery_mode_status',
326 + 'jetpack_sso_require_two_step',
327 + 'apm_enabled',
282 328 );
283 329
284 330 /**
285 331 * Current enabled trials.
@@ -292,11 +338,11 @@
292 338 'was_hosting_trial' => 'hosting',
293 339 );
294 340
295 341 /**
296 - * Site
342 + * Site.
297 343 *
298 - * @var $site.
344 + * @var SAL_Site $site.
299 345 */
300 346 private $site;
301 347
302 348 /**
@@ -319,10 +365,12 @@
319 365 *
320 366 * /sites/mine
321 367 * /sites/%s -> $blog_id\
322 368 *
323 - * @param string $path - the path.
324 - * @param int $blog_id - the blog ID.
369 + * @param string $path - the path.
370 + * @param int|string $blog_id - the blog ID or the string 'mine'.
371 + *
372 + * @return array|\WP_Error Site response array on success, or WP_Error on failure.
325 373 */
326 374 public function callback( $path = '', $blog_id = 0 ) {
327 375 if ( 'mine' === $blog_id ) {
328 376 $api = WPCOM_JSON_API::init();
@@ -458,8 +506,11 @@
458 506 switch ( $key ) {
459 507 case 'ID':
460 508 $response[ $key ] = $this->site->blog_id;
461 509 break;
510 + case 'slug':
511 + $response[ $key ] = $this->site->get_slug();
512 + break;
462 513 case 'name':
463 514 $response[ $key ] = $this->site->get_name();
464 515 break;
465 516 case 'description':
@@ -565,13 +616,9 @@
565 616 case 'products':
566 617 $response[ $key ] = $this->site->get_products();
567 618 break;
568 619 case 'zendesk_site_meta':
569 - // D59613-code only added this function to the wpcom SAL subclasses. Absent any better idea,
570 - // we'll just omit the key entirely in Jetpack.
571 - if ( is_callable( array( $this->site, 'get_zendesk_site_meta' ) ) ) {
572 - $response[ $key ] = $this->site->get_zendesk_site_meta();
573 - }
620 + $response[ $key ] = $this->site->get_zendesk_site_meta();
574 621 break;
575 622 case 'quota':
576 623 $response[ $key ] = $this->site->get_quota();
577 624 break;
@@ -610,8 +657,54 @@
610 657 break;
611 658 case 'was_upgraded_from_trial':
612 659 $response[ $key ] = $this->site->was_upgraded_from_trial();
613 660 break;
661 + case 'is_deleted':
662 + $response[ $key ] = $this->site->is_deleted();
663 + break;
664 + case 'is_a4a_client':
665 + $response[ $key ] = $this->site->is_a4a_client();
666 + break;
667 + case 'is_a4a_dev_site':
668 + $response[ $key ] = $this->site->is_a4a_dev_site();
669 + break;
670 + case 'is_garden':
671 + $response[ $key ] = $this->site->is_garden();
672 + break;
673 + case 'garden_name':
674 + $response[ $key ] = $this->site->garden_name();
675 + break;
676 + case 'garden_partner':
677 + $response[ $key ] = $this->site->garden_partner();
678 + break;
679 + case 'garden_is_provisioned':
680 + $response[ $key ] = $this->site->garden_is_provisioned();
681 + break;
682 + case 'is_wpcom_flex':
683 + $response[ $key ] = $this->site->is_wpcom_flex();
684 + break;
685 + case 'big_sky_enabled':
686 + $response[ $key ] = $this->site->is_big_sky_enabled();
687 + break;
688 + case 'atomic_email_block':
689 + $response[ $key ] = $this->site->get_atomic_email_block();
690 + break;
691 + case 'hosting_provider_guess':
692 + // WordPress.com platform decoration, computed only when explicitly requested
693 + // via `fields` so default `_all` responses are unchanged.
694 + if ( $this->is_wpcom()
695 + && function_exists( 'get_jetpack_hosting_provider' )
696 + && is_array( $this->fields_to_include ) ) {
697 + $response[ $key ] = get_jetpack_hosting_provider( get_current_blog_id() );
698 + }
699 + break;
700 + case 'environment_type':
701 + // WordPress.com platform decoration, computed only when explicitly requested
702 + // via `fields` so default `_all` responses are unchanged.
703 + if ( $this->is_wpcom() && is_array( $this->fields_to_include ) ) {
704 + $response[ $key ] = $this->get_site_environment_type();
705 + }
706 + break;
614 707 }
615 708
616 709 do_action( 'post_render_site_response_key', $key );
617 710 }
@@ -661,8 +754,11 @@
661 754 break;
662 755 case 'theme_slug':
663 756 $options[ $key ] = $site->get_theme_slug();
664 757 break;
758 + case 'theme_errors':
759 + $options[ $key ] = $site->get_theme_errors();
760 + break;
665 761 case 'header_image':
666 762 $options[ $key ] = $site->get_header_image();
667 763 break;
668 764 case 'background_color':
@@ -821,13 +917,9 @@
821 917 case 'import_engine':
822 918 $options[ $key ] = $site->get_import_engine();
823 919 break;
824 920 case 'is_pending_plan':
825 - // D40032-code only added this function to the wpcom SAL subclasses. Absent any better idea,
826 - // we'll just omit the key entirely in Jetpack.
827 - if ( is_callable( array( $site, 'is_pending_plan' ) ) ) {
828 - $options[ $key ] = $site->is_pending_plan();
829 - }
921 + $options[ $key ] = $site->is_pending_plan();
830 922 break;
831 923
832 924 case 'is_wpforteams_site':
833 925 $options[ $key ] = $site->is_wpforteams_site();
@@ -869,25 +961,31 @@
869 961 case 'is_difm_lite_in_progress':
870 962 $options[ $key ] = $site->is_difm_lite_in_progress();
871 963 break;
872 964 case 'difm_lite_site_options':
873 - $difm_lite_options = $site->get_difm_lite_site_options();
874 - $visible_options = self::$displayed_difm_lite_site_options;
875 - $filtered_difm_lite_options = new stdClass();
876 - if ( $difm_lite_options ) {
877 - $filtered_difm_lite_options = array_filter(
878 - $difm_lite_options,
879 - function ( $key ) use ( $visible_options ) {
880 - return in_array( $key, $visible_options, true );
881 - },
882 - ARRAY_FILTER_USE_KEY
883 - );
965 + $difm_lite_site_options = $site->get_difm_lite_site_options();
966 + if ( null !== $difm_lite_site_options ) {
967 + $options[ $key ] = (object) $difm_lite_site_options;
884 968 }
885 - $options[ $key ] = $filtered_difm_lite_options;
886 969 break;
970 + case 'is_gating_business_q1':
971 + $options[ $key ] = $site->is_gating_business_q1();
972 + break;
973 + case 'is_legacy_gating_site':
974 + $options[ $key ] = $site->is_legacy_gating_site();
975 + break;
887 976 case 'site_intent':
888 977 $options[ $key ] = $site->get_site_intent();
889 978 break;
979 + case 'site_partner_bundle':
980 + $options[ $key ] = $site->get_site_partner_bundle();
981 + break;
982 + case 'site_goals':
983 + $options[ $key ] = $site->get_site_goals();
984 + break;
985 + case 'onboarding_segment':
986 + $options[ $key ] = $site->get_onboarding_segment();
987 + break;
890 988 case 'site_vertical_id':
891 989 $options[ $key ] = $site->get_site_vertical_id();
892 990 break;
893 991 case 'blogging_prompts_settings':
@@ -900,8 +998,11 @@
900 998 break;
901 999 case 'launchpad_checklist_tasks_statuses':
902 1000 $options[ $key ] = $site->get_launchpad_checklist_tasks_statuses();
903 1001 break;
1002 + case 'migration_source_site_domain':
1003 + $options[ $key ] = $site->get_migration_source_site_domain();
1004 + break;
904 1005 case 'wpcom_production_blog_id':
905 1006 $options[ $key ] = $site->get_wpcom_production_blog_id();
906 1007 break;
907 1008 case 'wpcom_staging_blog_ids':
@@ -915,11 +1016,38 @@
915 1016 break;
916 1017 case 'is_commercial':
917 1018 $options[ $key ] = $site->is_commercial();
918 1019 break;
1020 + case 'is_commercial_reasons':
1021 + $options[ $key ] = $site->get_is_commercial_reasons();
1022 + break;
919 1023 case 'wpcom_admin_interface':
920 1024 $options[ $key ] = $site->get_wpcom_admin_interface();
921 1025 break;
1026 + case 'wpcom_classic_early_release':
1027 + $options[ $key ] = $site->get_wpcom_classic_early_release();
1028 + break;
1029 + case 'jetpack_recovery_mode_status':
1030 + $options[ $key ] = $site->get_jetpack_recovery_mode_status();
1031 + break;
1032 + case 'jetpack_sso_require_two_step':
1033 + $options[ $key ] = $site->get_jetpack_sso_require_two_step();
1034 + break;
1035 + case 'apm_enabled':
1036 + $options[ $key ] = $site->get_apm_enabled();
1037 + break;
1038 + case 'wpcom_ai_launchpad_enabled':
1039 + $options[ $key ] = $site->is_ai_launchpad_enabled();
1040 + break;
1041 + case 'wpcom_ai_launchpad_dismissed':
1042 + $options[ $key ] = $site->is_ai_launchpad_dismissed();
1043 + break;
1044 + case 'wpcom_ai_launchpad_completed':
1045 + $options[ $key ] = $site->is_ai_launchpad_completed();
1046 + break;
1047 + case 'wpcom_ai_launchpad_no_guidance':
1048 + $options[ $key ] = $site->is_ai_launchpad_no_guidance();
1049 + break;
922 1050 }
923 1051 }
924 1052
925 1053 return $options;
@@ -951,14 +1079,20 @@
951 1079
952 1080 /**
953 1081 * Apply any WPCOM-only response components to a Jetpack site response.
954 1082 *
955 - * @param array $response - the response.
1083 + * @param object $response - the response.
956 1084 */
957 1085 public function decorate_jetpack_response( &$response ) {
1086 + $this->filter_fields_and_options();
958 1087 $this->site = $this->get_platform()->get_site( $response->ID );
959 1088 switch_to_blog( $this->site->get_id() );
960 1089
1090 + // Allow the SAL site to apply its own overrides to the proxied response.
1091 + if ( method_exists( $this->site, 'decorate_jetpack_response' ) ) {
1092 + $this->site->decorate_jetpack_response( $response ); // @phan-suppress-current-line PhanUndeclaredMethod -- checked via method_exists().
1093 + }
1094 +
961 1095 $wpcom_response = $this->render_response_keys( self::$jetpack_response_field_additions );
962 1096
963 1097 foreach ( $wpcom_response as $key => $value ) {
964 1098 $response->{ $key } = $value;
@@ -963,9 +1097,11 @@
963 1097 foreach ( $wpcom_response as $key => $value ) {
964 1098 $response->{ $key } = $value;
965 1099 }
966 1100
967 - if ( $this->has_user_access() || $this->has_blog_access( $this->api->token_details ) ) {
1101 + $has_site_access = $this->has_user_access() || $this->has_blog_access( $this->api->token_details );
1102 +
1103 + if ( $has_site_access ) {
968 1104 $wpcom_member_response = $this->render_response_keys( self::$jetpack_response_field_member_additions );
969 1105
970 1106 foreach ( $wpcom_member_response as $key => $value ) {
971 1107 $response->{ $key } = $value;
@@ -984,22 +1120,28 @@
984 1120 unset( $response->site_owner );
985 1121 unset( $response->plan );
986 1122 unset( $response->products );
987 1123 unset( $response->zendesk_site_meta );
1124 + unset( $response->atomic_email_block );
988 1125 }
989 1126
990 1127 // render additional options.
991 - if ( $response->options ) {
1128 + if ( isset( $response->options ) && $response->options ) {
992 1129 $wpcom_options_response = $this->render_option_keys( self::$jetpack_response_option_additions );
993 1130
994 1131 // Remove heic from jetpack (and atomic) sites so that the iOS app know to convert the file format into a JPEG.
995 1132 // heic fromat is currently not supported by for uploading.
996 1133 // See https://jetpackp2.wordpress.com/2020/08/19/image-uploads-in-the-wp-ios-app-broken
997 - if ( $this->site->is_jetpack() && isset( $response->options['allowed_file_types'] ) ) {
1134 + if (
1135 + $this->site->is_jetpack()
1136 + && isset( $response->options['allowed_file_types'] )
1137 + && is_array( $response->options['allowed_file_types'] )
1138 + ) {
1139 + $allowed_file_types = (array) $response->options['allowed_file_types'];
998 1140 $remove_file_types = array(
999 1141 'heic',
1000 1142 );
1001 - $response->options['allowed_file_types'] = array_values( array_diff( $response->options['allowed_file_types'], $remove_file_types ) );
1143 + $response->options['allowed_file_types'] = array_values( array_diff( $allowed_file_types, $remove_file_types ) );
1002 1144 }
1003 1145
1004 1146 foreach ( $wpcom_options_response as $key => $value ) {
1005 1147 $response->options[ $key ] = $value;
@@ -1005,11 +1147,44 @@
1005 1147 $response->options[ $key ] = $value;
1006 1148 }
1007 1149 }
1008 1150
1151 + // WordPress.com platform fields are not part of proxied Jetpack responses;
1152 + // add them only when explicitly requested.
1153 + if ( $this->is_wpcom() && $has_site_access && is_array( $this->fields_to_include ) ) {
1154 + if ( function_exists( 'get_jetpack_hosting_provider' ) && in_array( 'hosting_provider_guess', $this->fields_to_include, true ) ) {
1155 + $response->hosting_provider_guess = get_jetpack_hosting_provider( get_current_blog_id() );
1156 + }
1157 + if ( in_array( 'environment_type', $this->fields_to_include, true ) ) {
1158 + $response->environment_type = $this->get_site_environment_type();
1159 + }
1160 + }
1161 +
1009 1162 restore_current_blog();
1010 1163 return $response; // possibly no need since it's modified in place.
1011 1164 }
1165 +
1166 + /**
1167 + * Whether this request is running on the WordPress.com platform.
1168 + *
1169 + * @return bool
1170 + */
1171 + protected function is_wpcom() {
1172 + return ( new \Automattic\Jetpack\Status\Host() )->is_wpcom_platform();
1173 + }
1174 +
1175 + /**
1176 + * Get the site's synced WP_ENVIRONMENT_TYPE.
1177 + *
1178 + * @return string|null
1179 + */
1180 + protected function get_site_environment_type() {
1181 + if ( function_exists( 'get_blog_option' ) ) {
1182 + return get_blog_option( get_current_blog_id(), 'jetpack_callable_wp_get_environment_type', null );
1183 + }
1184 +
1185 + return get_option( 'jetpack_callable_wp_get_environment_type', null );
1186 + }
1012 1187 }
1013 1188
1014 1189 new WPCOM_JSON_API_List_Post_Formats_Endpoint(
1015 1190 array(
@@ -1035,9 +1210,11 @@
1035 1210 )
1036 1211 );
1037 1212
1038 1213 /**
1039 - * List Post Formates endpoint class.
1214 + * List Post Formats endpoint class.
1215 + *
1216 + * @phan-constructor-used-for-side-effects
1040 1217 */
1041 1218 class WPCOM_JSON_API_List_Post_Formats_Endpoint extends WPCOM_JSON_API_Endpoint { // phpcs:ignore
1042 1219 /**
1043 1220 *
@@ -1046,8 +1223,10 @@
1046 1223 * /sites/%s/post-formats -> $blog_id
1047 1224 *
1048 1225 * @param string $path - the path.
1049 1226 * @param int $blog_id - the blog ID.
1227 + *
1228 + * @return array|\WP_Error Array with 'formats' on success, or WP_Error on failure.
1050 1229 */
1051 1230 public function callback( $path = '', $blog_id = 0 ) {
1052 1231 $blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) );
1053 1232 if ( is_wp_error( $blog_id ) ) {
@@ -1101,8 +1280,10 @@
1101 1280 );
1102 1281
1103 1282 /**
1104 1283 * List page templates endpoint class.
1284 + *
1285 + * @phan-constructor-used-for-side-effects
1105 1286 */
1106 1287 class WPCOM_JSON_API_List_Page_Templates_Endpoint extends WPCOM_JSON_API_Endpoint { // phpcs:ignore
1107 1288 /**
1108 1289 *
@@ -1110,8 +1291,10 @@
1110 1291 * /sites/%s/page-templates -> $blog_id
1111 1292 *
1112 1293 * @param string $path - the path.
1113 1294 * @param int $blog_id - the blog ID.
1295 + *
1296 + * @return array|\WP_Error Array with 'templates' on success, or WP_Error on failure.
1114 1297 */
1115 1298 public function callback( $path = '', $blog_id = 0 ) {
1116 1299 $blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) );
1117 1300 if ( is_wp_error( $blog_id ) ) {