← All changes
|
json-endpoints/class.wpcom-json-api-get-site-endpoint.php
+196
-10
13.7.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. |
| @@ -84,8 +93,18 @@ | ||
| 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.', |
| 86 | 95 | 'is_deleted' => '(bool) If the site flagged as deleted.', |
| 87 | 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.', | |
| 88 | 107 | ); |
| 89 | 108 | |
| 90 | 109 | /** |
| 91 | 110 | * No member fields. |
| @@ -118,9 +137,14 @@ | ||
| 118 | 137 | 'is_core_site_editor_enabled', |
| 119 | 138 | 'is_wpcom_atomic', |
| 120 | 139 | 'is_wpcom_staging_site', |
| 121 | 140 | 'is_deleted', |
| 141 | + 'is_wpcom_flex', | |
| 122 | 142 | 'is_a4a_client', |
| 143 | + 'is_a4a_dev_site', | |
| 144 | + 'is_garden', | |
| 145 | + 'big_sky_enabled', | |
| 146 | + 'garden_name', | |
| 123 | 147 | ); |
| 124 | 148 | |
| 125 | 149 | /** |
| 126 | 150 | * Site options. |
| @@ -200,15 +224,19 @@ | ||
| 200 | 224 | 'anchor_podcast', |
| 201 | 225 | 'was_created_with_blank_canvas_design', |
| 202 | 226 | 'videopress_storage_used', |
| 203 | 227 | 'is_difm_lite_in_progress', |
| 228 | + 'difm_lite_site_options', | |
| 229 | + 'is_gating_business_q1', | |
| 230 | + 'is_legacy_gating_site', | |
| 204 | 231 | 'site_intent', |
| 205 | - 'site_goals', | |
| 232 | + 'site_partner_bundle', | |
| 206 | 233 | 'onboarding_segment', |
| 207 | 234 | 'site_vertical_id', |
| 208 | 235 | 'blogging_prompts_settings', |
| 209 | 236 | 'launchpad_screen', |
| 210 | 237 | 'launchpad_checklist_tasks_statuses', |
| 238 | + 'migration_source_site_domain', | |
| 211 | 239 | 'wpcom_production_blog_id', |
| 212 | 240 | 'wpcom_staging_blog_ids', |
| 213 | 241 | 'can_blaze', |
| 214 | 242 | 'wpcom_site_setup', |
| @@ -215,8 +243,15 @@ | ||
| 215 | 243 | 'is_commercial', |
| 216 | 244 | 'is_commercial_reasons', |
| 217 | 245 | 'wpcom_admin_interface', |
| 218 | 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', | |
| 219 | 254 | ); |
| 220 | 255 | |
| 221 | 256 | /** |
| 222 | 257 | * Jetpack response fields. |
| @@ -223,8 +258,9 @@ | ||
| 223 | 258 | * |
| 224 | 259 | * @var array $jetpack_response_field_additions |
| 225 | 260 | */ |
| 226 | 261 | protected static $jetpack_response_field_additions = array( |
| 262 | + 'slug', | |
| 227 | 263 | 'subscribers_count', |
| 228 | 264 | 'site_migration', |
| 229 | 265 | 'site_owner', |
| 230 | 266 | 'is_wpcom_staging_site', |
| @@ -231,8 +267,16 @@ | ||
| 231 | 267 | 'was_ecommerce_trial', |
| 232 | 268 | 'was_migration_trial', |
| 233 | 269 | 'was_hosting_trial', |
| 234 | 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', |
| @@ -277,8 +321,11 @@ | ||
| 277 | 321 | 'is_commercial', |
| 278 | 322 | 'is_commercial_reasons', |
| 279 | 323 | 'wpcom_admin_interface', |
| 280 | 324 | 'wpcom_classic_early_release', |
| 325 | + 'jetpack_recovery_mode_status', | |
| 326 | + 'jetpack_sso_require_two_step', | |
| 327 | + 'apm_enabled', | |
| 281 | 328 | ); |
| 282 | 329 | |
| 283 | 330 | /** |
| 284 | 331 | * Current enabled trials. |
| @@ -291,9 +338,9 @@ | ||
| 291 | 338 | 'was_hosting_trial' => 'hosting', |
| 292 | 339 | ); |
| 293 | 340 | |
| 294 | 341 | /** |
| 295 | - * Site | |
| 342 | + * Site. | |
| 296 | 343 | * |
| 297 | 344 | * @var SAL_Site $site. |
| 298 | 345 | */ |
| 299 | 346 | private $site; |
| @@ -318,10 +365,12 @@ | ||
| 318 | 365 | * |
| 319 | 366 | * /sites/mine |
| 320 | 367 | * /sites/%s -> $blog_id\ |
| 321 | 368 | * |
| 322 | - * @param string $path - the path. | |
| 323 | - * @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. | |
| 324 | 373 | */ |
| 325 | 374 | public function callback( $path = '', $blog_id = 0 ) { |
| 326 | 375 | if ( 'mine' === $blog_id ) { |
| 327 | 376 | $api = WPCOM_JSON_API::init(); |
| @@ -457,8 +506,11 @@ | ||
| 457 | 506 | switch ( $key ) { |
| 458 | 507 | case 'ID': |
| 459 | 508 | $response[ $key ] = $this->site->blog_id; |
| 460 | 509 | break; |
| 510 | + case 'slug': | |
| 511 | + $response[ $key ] = $this->site->get_slug(); | |
| 512 | + break; | |
| 461 | 513 | case 'name': |
| 462 | 514 | $response[ $key ] = $this->site->get_name(); |
| 463 | 515 | break; |
| 464 | 516 | case 'description': |
| @@ -611,8 +663,48 @@ | ||
| 611 | 663 | break; |
| 612 | 664 | case 'is_a4a_client': |
| 613 | 665 | $response[ $key ] = $this->site->is_a4a_client(); |
| 614 | 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; | |
| 615 | 707 | } |
| 616 | 708 | |
| 617 | 709 | do_action( 'post_render_site_response_key', $key ); |
| 618 | 710 | } |
| @@ -868,11 +960,26 @@ | ||
| 868 | 960 | break; |
| 869 | 961 | case 'is_difm_lite_in_progress': |
| 870 | 962 | $options[ $key ] = $site->is_difm_lite_in_progress(); |
| 871 | 963 | break; |
| 964 | + case 'difm_lite_site_options': | |
| 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; | |
| 968 | + } | |
| 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; | |
| 872 | 976 | case 'site_intent': |
| 873 | 977 | $options[ $key ] = $site->get_site_intent(); |
| 874 | 978 | break; |
| 979 | + case 'site_partner_bundle': | |
| 980 | + $options[ $key ] = $site->get_site_partner_bundle(); | |
| 981 | + break; | |
| 875 | 982 | case 'site_goals': |
| 876 | 983 | $options[ $key ] = $site->get_site_goals(); |
| 877 | 984 | break; |
| 878 | 985 | case 'onboarding_segment': |
| @@ -891,8 +998,11 @@ | ||
| 891 | 998 | break; |
| 892 | 999 | case 'launchpad_checklist_tasks_statuses': |
| 893 | 1000 | $options[ $key ] = $site->get_launchpad_checklist_tasks_statuses(); |
| 894 | 1001 | break; |
| 1002 | + case 'migration_source_site_domain': | |
| 1003 | + $options[ $key ] = $site->get_migration_source_site_domain(); | |
| 1004 | + break; | |
| 895 | 1005 | case 'wpcom_production_blog_id': |
| 896 | 1006 | $options[ $key ] = $site->get_wpcom_production_blog_id(); |
| 897 | 1007 | break; |
| 898 | 1008 | case 'wpcom_staging_blog_ids': |
| @@ -915,8 +1025,29 @@ | ||
| 915 | 1025 | break; |
| 916 | 1026 | case 'wpcom_classic_early_release': |
| 917 | 1027 | $options[ $key ] = $site->get_wpcom_classic_early_release(); |
| 918 | 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; | |
| 919 | 1050 | } |
| 920 | 1051 | } |
| 921 | 1052 | |
| 922 | 1053 | return $options; |
| @@ -948,14 +1079,20 @@ | ||
| 948 | 1079 | |
| 949 | 1080 | /** |
| 950 | 1081 | * Apply any WPCOM-only response components to a Jetpack site response. |
| 951 | 1082 | * |
| 952 | - * @param array $response - the response. | |
| 1083 | + * @param object $response - the response. | |
| 953 | 1084 | */ |
| 954 | 1085 | public function decorate_jetpack_response( &$response ) { |
| 1086 | + $this->filter_fields_and_options(); | |
| 955 | 1087 | $this->site = $this->get_platform()->get_site( $response->ID ); |
| 956 | 1088 | switch_to_blog( $this->site->get_id() ); |
| 957 | 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 | + | |
| 958 | 1095 | $wpcom_response = $this->render_response_keys( self::$jetpack_response_field_additions ); |
| 959 | 1096 | |
| 960 | 1097 | foreach ( $wpcom_response as $key => $value ) { |
| 961 | 1098 | $response->{ $key } = $value; |
| @@ -960,9 +1097,11 @@ | ||
| 960 | 1097 | foreach ( $wpcom_response as $key => $value ) { |
| 961 | 1098 | $response->{ $key } = $value; |
| 962 | 1099 | } |
| 963 | 1100 | |
| 964 | - 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 ) { | |
| 965 | 1104 | $wpcom_member_response = $this->render_response_keys( self::$jetpack_response_field_member_additions ); |
| 966 | 1105 | |
| 967 | 1106 | foreach ( $wpcom_member_response as $key => $value ) { |
| 968 | 1107 | $response->{ $key } = $value; |
| @@ -981,8 +1120,9 @@ | ||
| 981 | 1120 | unset( $response->site_owner ); |
| 982 | 1121 | unset( $response->plan ); |
| 983 | 1122 | unset( $response->products ); |
| 984 | 1123 | unset( $response->zendesk_site_meta ); |
| 1124 | + unset( $response->atomic_email_block ); | |
| 985 | 1125 | } |
| 986 | 1126 | |
| 987 | 1127 | // render additional options. |
| 988 | 1128 | if ( isset( $response->options ) && $response->options ) { |
| @@ -990,13 +1130,18 @@ | ||
| 990 | 1130 | |
| 991 | 1131 | // Remove heic from jetpack (and atomic) sites so that the iOS app know to convert the file format into a JPEG. |
| 992 | 1132 | // heic fromat is currently not supported by for uploading. |
| 993 | 1133 | // See https://jetpackp2.wordpress.com/2020/08/19/image-uploads-in-the-wp-ios-app-broken |
| 994 | - 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']; | |
| 995 | 1140 | $remove_file_types = array( |
| 996 | 1141 | 'heic', |
| 997 | 1142 | ); |
| 998 | - $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 ) ); | |
| 999 | 1144 | } |
| 1000 | 1145 | |
| 1001 | 1146 | foreach ( $wpcom_options_response as $key => $value ) { |
| 1002 | 1147 | $response->options[ $key ] = $value; |
| @@ -1002,11 +1147,44 @@ | ||
| 1002 | 1147 | $response->options[ $key ] = $value; |
| 1003 | 1148 | } |
| 1004 | 1149 | } |
| 1005 | 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 | + | |
| 1006 | 1162 | restore_current_blog(); |
| 1007 | 1163 | return $response; // possibly no need since it's modified in place. |
| 1008 | 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 | + } | |
| 1009 | 1187 | } |
| 1010 | 1188 | |
| 1011 | 1189 | new WPCOM_JSON_API_List_Post_Formats_Endpoint( |
| 1012 | 1190 | array( |
| @@ -1032,9 +1210,11 @@ | ||
| 1032 | 1210 | ) |
| 1033 | 1211 | ); |
| 1034 | 1212 | |
| 1035 | 1213 | /** |
| 1036 | - * List Post Formates endpoint class. | |
| 1214 | + * List Post Formats endpoint class. | |
| 1215 | + * | |
| 1216 | + * @phan-constructor-used-for-side-effects | |
| 1037 | 1217 | */ |
| 1038 | 1218 | class WPCOM_JSON_API_List_Post_Formats_Endpoint extends WPCOM_JSON_API_Endpoint { // phpcs:ignore |
| 1039 | 1219 | /** |
| 1040 | 1220 | * |
| @@ -1043,8 +1223,10 @@ | ||
| 1043 | 1223 | * /sites/%s/post-formats -> $blog_id |
| 1044 | 1224 | * |
| 1045 | 1225 | * @param string $path - the path. |
| 1046 | 1226 | * @param int $blog_id - the blog ID. |
| 1227 | + * | |
| 1228 | + * @return array|\WP_Error Array with 'formats' on success, or WP_Error on failure. | |
| 1047 | 1229 | */ |
| 1048 | 1230 | public function callback( $path = '', $blog_id = 0 ) { |
| 1049 | 1231 | $blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) ); |
| 1050 | 1232 | if ( is_wp_error( $blog_id ) ) { |
| @@ -1098,8 +1280,10 @@ | ||
| 1098 | 1280 | ); |
| 1099 | 1281 | |
| 1100 | 1282 | /** |
| 1101 | 1283 | * List page templates endpoint class. |
| 1284 | + * | |
| 1285 | + * @phan-constructor-used-for-side-effects | |
| 1102 | 1286 | */ |
| 1103 | 1287 | class WPCOM_JSON_API_List_Page_Templates_Endpoint extends WPCOM_JSON_API_Endpoint { // phpcs:ignore |
| 1104 | 1288 | /** |
| 1105 | 1289 | * |
| @@ -1107,8 +1291,10 @@ | ||
| 1107 | 1291 | * /sites/%s/page-templates -> $blog_id |
| 1108 | 1292 | * |
| 1109 | 1293 | * @param string $path - the path. |
| 1110 | 1294 | * @param int $blog_id - the blog ID. |
| 1295 | + * | |
| 1296 | + * @return array|\WP_Error Array with 'templates' on success, or WP_Error on failure. | |
| 1111 | 1297 | */ |
| 1112 | 1298 | public function callback( $path = '', $blog_id = 0 ) { |
| 1113 | 1299 | $blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) ); |
| 1114 | 1300 | if ( is_wp_error( $blog_id ) ) { |