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 +237 -44 12.7.3 → 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.
@@ -78,11 +87,24 @@
78 87 'is_wpcom_atomic' => '(bool) If the site is a WP.com Atomic one.',
79 88 'is_wpcom_staging_site' => '(bool) If the site is a WP.com staging site.',
80 89 'user_interactions' => '(array) An array of user interactions with a site.',
81 90 'was_ecommerce_trial' => '(bool) If the site ever used an eCommerce trial.',
91 + 'was_upgraded_from_trial' => '(bool) If the site ever upgraded to a paid plan from a trial.',
82 92 'was_migration_trial' => '(bool) If the site ever used a migration trial.',
83 93 'was_hosting_trial' => '(bool) If the site ever used a hosting trial.',
84 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.',
85 107 );
86 108
87 109 /**
88 110 * No member fields.
@@ -114,8 +136,15 @@
114 136 'is_fse_eligible',
115 137 'is_core_site_editor_enabled',
116 138 'is_wpcom_atomic',
117 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',
118 147 );
119 148
120 149 /**
121 150 * Site options.
@@ -134,8 +163,9 @@
134 163 'is_redirect',
135 164 'unmapped_url',
136 165 'featured_images_enabled',
137 166 'theme_slug',
167 + 'theme_errors',
138 168 'header_image',
139 169 'background_color',
140 170 'image_default_link_type',
141 171 'image_thumbnail_width',
@@ -195,37 +225,42 @@
195 225 'was_created_with_blank_canvas_design',
196 226 'videopress_storage_used',
197 227 'is_difm_lite_in_progress',
198 228 'difm_lite_site_options',
229 + 'is_gating_business_q1',
230 + 'is_legacy_gating_site',
199 231 'site_intent',
232 + 'site_partner_bundle',
233 + 'onboarding_segment',
200 234 'site_vertical_id',
201 235 'blogging_prompts_settings',
202 236 'launchpad_screen',
203 237 'launchpad_checklist_tasks_statuses',
238 + 'migration_source_site_domain',
204 239 'wpcom_production_blog_id',
205 240 'wpcom_staging_blog_ids',
206 241 'can_blaze',
207 242 'wpcom_site_setup',
208 243 'is_commercial',
244 + 'is_commercial_reasons',
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',
209 254 );
210 255
211 256 /**
212 - * List of DIFM Lite options to be displayed
213 - *
214 - * @var array $displayed_difm_lite_site_options
215 - */
216 - protected static $displayed_difm_lite_site_options = array(
217 - 'site_category',
218 - 'is_website_content_submitted',
219 - 'selected_page_titles',
220 - );
221 -
222 - /**
223 257 * Jetpack response fields.
224 258 *
225 259 * @var array $jetpack_response_field_additions
226 260 */
227 261 protected static $jetpack_response_field_additions = array(
262 + 'slug',
228 263 'subscribers_count',
229 264 'site_migration',
230 265 'site_owner',
231 266 'is_wpcom_staging_site',
@@ -231,8 +266,17 @@
231 266 'is_wpcom_staging_site',
232 267 'was_ecommerce_trial',
233 268 'was_migration_trial',
234 269 'was_hosting_trial',
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',
235 279 );
236 280
237 281 /**
238 282 * Jetpack response field member additions.
@@ -248,9 +292,9 @@
248 292
249 293 /**
250 294 * Jetpack response option additions.
251 295 *
252 - * @var array $jetpack_response_field_member_additions
296 + * @var array $jetpack_response_option_additions
253 297 */
254 298 protected static $jetpack_response_option_additions = array(
255 299 'publicize_permanently_disabled',
256 300 'ak_vp_bundle_enabled',
@@ -274,8 +318,14 @@
274 318 'blogging_prompts_settings',
275 319 'wpcom_production_blog_id',
276 320 'wpcom_staging_blog_ids',
277 321 'is_commercial',
322 + 'is_commercial_reasons',
323 + 'wpcom_admin_interface',
324 + 'wpcom_classic_early_release',
325 + 'jetpack_recovery_mode_status',
326 + 'jetpack_sso_require_two_step',
327 + 'apm_enabled',
278 328 );
279 329
280 330 /**
281 331 * Current enabled trials.
@@ -288,11 +338,11 @@
288 338 'was_hosting_trial' => 'hosting',
289 339 );
290 340
291 341 /**
292 - * Site
342 + * Site.
293 343 *
294 - * @var $site.
344 + * @var SAL_Site $site.
295 345 */
296 346 private $site;
297 347
298 348 /**
@@ -315,10 +365,12 @@
315 365 *
316 366 * /sites/mine
317 367 * /sites/%s -> $blog_id\
318 368 *
319 - * @param string $path - the path.
320 - * @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.
321 373 */
322 374 public function callback( $path = '', $blog_id = 0 ) {
323 375 if ( 'mine' === $blog_id ) {
324 376 $api = WPCOM_JSON_API::init();
@@ -454,8 +506,11 @@
454 506 switch ( $key ) {
455 507 case 'ID':
456 508 $response[ $key ] = $this->site->blog_id;
457 509 break;
510 + case 'slug':
511 + $response[ $key ] = $this->site->get_slug();
512 + break;
458 513 case 'name':
459 514 $response[ $key ] = $this->site->get_name();
460 515 break;
461 516 case 'description':
@@ -561,13 +616,9 @@
561 616 case 'products':
562 617 $response[ $key ] = $this->site->get_products();
563 618 break;
564 619 case 'zendesk_site_meta':
565 - // D59613-code only added this function to the wpcom SAL subclasses. Absent any better idea,
566 - // we'll just omit the key entirely in Jetpack.
567 - if ( is_callable( array( $this->site, 'get_zendesk_site_meta' ) ) ) {
568 - $response[ $key ] = $this->site->get_zendesk_site_meta();
569 - }
620 + $response[ $key ] = $this->site->get_zendesk_site_meta();
570 621 break;
571 622 case 'quota':
572 623 $response[ $key ] = $this->site->get_quota();
573 624 break;
@@ -603,8 +654,57 @@
603 654 break;
604 655 case 'was_hosting_trial':
605 656 $response[ $key ] = $this->site->was_trial( self::$jetpack_enabled_trials['was_hosting_trial'] );
606 657 break;
658 + case 'was_upgraded_from_trial':
659 + $response[ $key ] = $this->site->was_upgraded_from_trial();
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;
607 707 }
608 708
609 709 do_action( 'post_render_site_response_key', $key );
610 710 }
@@ -654,8 +754,11 @@
654 754 break;
655 755 case 'theme_slug':
656 756 $options[ $key ] = $site->get_theme_slug();
657 757 break;
758 + case 'theme_errors':
759 + $options[ $key ] = $site->get_theme_errors();
760 + break;
658 761 case 'header_image':
659 762 $options[ $key ] = $site->get_header_image();
660 763 break;
661 764 case 'background_color':
@@ -814,13 +917,9 @@
814 917 case 'import_engine':
815 918 $options[ $key ] = $site->get_import_engine();
816 919 break;
817 920 case 'is_pending_plan':
818 - // D40032-code only added this function to the wpcom SAL subclasses. Absent any better idea,
819 - // we'll just omit the key entirely in Jetpack.
820 - if ( is_callable( array( $site, 'is_pending_plan' ) ) ) {
821 - $options[ $key ] = $site->is_pending_plan();
822 - }
921 + $options[ $key ] = $site->is_pending_plan();
823 922 break;
824 923
825 924 case 'is_wpforteams_site':
826 925 $options[ $key ] = $site->is_wpforteams_site();
@@ -862,25 +961,31 @@
862 961 case 'is_difm_lite_in_progress':
863 962 $options[ $key ] = $site->is_difm_lite_in_progress();
864 963 break;
865 964 case 'difm_lite_site_options':
866 - $difm_lite_options = $site->get_difm_lite_site_options();
867 - $visible_options = self::$displayed_difm_lite_site_options;
868 - $filtered_difm_lite_options = new stdClass();
869 - if ( $difm_lite_options ) {
870 - $filtered_difm_lite_options = array_filter(
871 - $difm_lite_options,
872 - function ( $key ) use ( $visible_options ) {
873 - return in_array( $key, $visible_options, true );
874 - },
875 - ARRAY_FILTER_USE_KEY
876 - );
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;
877 968 }
878 - $options[ $key ] = $filtered_difm_lite_options;
879 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;
880 976 case 'site_intent':
881 977 $options[ $key ] = $site->get_site_intent();
882 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;
883 988 case 'site_vertical_id':
884 989 $options[ $key ] = $site->get_site_vertical_id();
885 990 break;
886 991 case 'blogging_prompts_settings':
@@ -893,8 +998,11 @@
893 998 break;
894 999 case 'launchpad_checklist_tasks_statuses':
895 1000 $options[ $key ] = $site->get_launchpad_checklist_tasks_statuses();
896 1001 break;
1002 + case 'migration_source_site_domain':
1003 + $options[ $key ] = $site->get_migration_source_site_domain();
1004 + break;
897 1005 case 'wpcom_production_blog_id':
898 1006 $options[ $key ] = $site->get_wpcom_production_blog_id();
899 1007 break;
900 1008 case 'wpcom_staging_blog_ids':
@@ -908,8 +1016,38 @@
908 1016 break;
909 1017 case 'is_commercial':
910 1018 $options[ $key ] = $site->is_commercial();
911 1019 break;
1020 + case 'is_commercial_reasons':
1021 + $options[ $key ] = $site->get_is_commercial_reasons();
1022 + break;
1023 + case 'wpcom_admin_interface':
1024 + $options[ $key ] = $site->get_wpcom_admin_interface();
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;
912 1050 }
913 1051 }
914 1052
915 1053 return $options;
@@ -941,14 +1079,20 @@
941 1079
942 1080 /**
943 1081 * Apply any WPCOM-only response components to a Jetpack site response.
944 1082 *
945 - * @param array $response - the response.
1083 + * @param object $response - the response.
946 1084 */
947 1085 public function decorate_jetpack_response( &$response ) {
1086 + $this->filter_fields_and_options();
948 1087 $this->site = $this->get_platform()->get_site( $response->ID );
949 1088 switch_to_blog( $this->site->get_id() );
950 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 +
951 1095 $wpcom_response = $this->render_response_keys( self::$jetpack_response_field_additions );
952 1096
953 1097 foreach ( $wpcom_response as $key => $value ) {
954 1098 $response->{ $key } = $value;
@@ -953,9 +1097,11 @@
953 1097 foreach ( $wpcom_response as $key => $value ) {
954 1098 $response->{ $key } = $value;
955 1099 }
956 1100
957 - 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 ) {
958 1104 $wpcom_member_response = $this->render_response_keys( self::$jetpack_response_field_member_additions );
959 1105
960 1106 foreach ( $wpcom_member_response as $key => $value ) {
961 1107 $response->{ $key } = $value;
@@ -974,22 +1120,28 @@
974 1120 unset( $response->site_owner );
975 1121 unset( $response->plan );
976 1122 unset( $response->products );
977 1123 unset( $response->zendesk_site_meta );
1124 + unset( $response->atomic_email_block );
978 1125 }
979 1126
980 1127 // render additional options.
981 - if ( $response->options ) {
1128 + if ( isset( $response->options ) && $response->options ) {
982 1129 $wpcom_options_response = $this->render_option_keys( self::$jetpack_response_option_additions );
983 1130
984 1131 // Remove heic from jetpack (and atomic) sites so that the iOS app know to convert the file format into a JPEG.
985 1132 // heic fromat is currently not supported by for uploading.
986 1133 // See https://jetpackp2.wordpress.com/2020/08/19/image-uploads-in-the-wp-ios-app-broken
987 - 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'];
988 1140 $remove_file_types = array(
989 1141 'heic',
990 1142 );
991 - $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 ) );
992 1144 }
993 1145
994 1146 foreach ( $wpcom_options_response as $key => $value ) {
995 1147 $response->options[ $key ] = $value;
@@ -995,11 +1147,44 @@
995 1147 $response->options[ $key ] = $value;
996 1148 }
997 1149 }
998 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 +
999 1162 restore_current_blog();
1000 1163 return $response; // possibly no need since it's modified in place.
1001 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 + }
1002 1187 }
1003 1188
1004 1189 new WPCOM_JSON_API_List_Post_Formats_Endpoint(
1005 1190 array(
@@ -1025,9 +1210,11 @@
1025 1210 )
1026 1211 );
1027 1212
1028 1213 /**
1029 - * List Post Formates endpoint class.
1214 + * List Post Formats endpoint class.
1215 + *
1216 + * @phan-constructor-used-for-side-effects
1030 1217 */
1031 1218 class WPCOM_JSON_API_List_Post_Formats_Endpoint extends WPCOM_JSON_API_Endpoint { // phpcs:ignore
1032 1219 /**
1033 1220 *
@@ -1036,8 +1223,10 @@
1036 1223 * /sites/%s/post-formats -> $blog_id
1037 1224 *
1038 1225 * @param string $path - the path.
1039 1226 * @param int $blog_id - the blog ID.
1227 + *
1228 + * @return array|\WP_Error Array with 'formats' on success, or WP_Error on failure.
1040 1229 */
1041 1230 public function callback( $path = '', $blog_id = 0 ) {
1042 1231 $blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) );
1043 1232 if ( is_wp_error( $blog_id ) ) {
@@ -1091,8 +1280,10 @@
1091 1280 );
1092 1281
1093 1282 /**
1094 1283 * List page templates endpoint class.
1284 + *
1285 + * @phan-constructor-used-for-side-effects
1095 1286 */
1096 1287 class WPCOM_JSON_API_List_Page_Templates_Endpoint extends WPCOM_JSON_API_Endpoint { // phpcs:ignore
1097 1288 /**
1098 1289 *
@@ -1100,8 +1291,10 @@
1100 1291 * /sites/%s/page-templates -> $blog_id
1101 1292 *
1102 1293 * @param string $path - the path.
1103 1294 * @param int $blog_id - the blog ID.
1295 + *
1296 + * @return array|\WP_Error Array with 'templates' on success, or WP_Error on failure.
1104 1297 */
1105 1298 public function callback( $path = '', $blog_id = 0 ) {
1106 1299 $blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) );
1107 1300 if ( is_wp_error( $blog_id ) ) {