← All changes
|
json-endpoints/class.wpcom-json-api-get-site-endpoint.php
+265
-45
12.3.2
→
16.3-a.5
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,8 +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.', | |
| 92 | + 'was_migration_trial' => '(bool) If the site ever used a migration trial.', | |
| 93 | + 'was_hosting_trial' => '(bool) If the site ever used a hosting trial.', | |
| 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.', | |
| 82 | 107 | ); |
| 83 | 108 | |
| 84 | 109 | /** |
| 85 | 110 | * No member fields. |
| @@ -111,8 +136,15 @@ | ||
| 111 | 136 | 'is_fse_eligible', |
| 112 | 137 | 'is_core_site_editor_enabled', |
| 113 | 138 | 'is_wpcom_atomic', |
| 114 | 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', | |
| 115 | 147 | ); |
| 116 | 148 | |
| 117 | 149 | /** |
| 118 | 150 | * Site options. |
| @@ -131,8 +163,9 @@ | ||
| 131 | 163 | 'is_redirect', |
| 132 | 164 | 'unmapped_url', |
| 133 | 165 | 'featured_images_enabled', |
| 134 | 166 | 'theme_slug', |
| 167 | + 'theme_errors', | |
| 135 | 168 | 'header_image', |
| 136 | 169 | 'background_color', |
| 137 | 170 | 'image_default_link_type', |
| 138 | 171 | 'image_thumbnail_width', |
| @@ -192,40 +225,57 @@ | ||
| 192 | 225 | 'was_created_with_blank_canvas_design', |
| 193 | 226 | 'videopress_storage_used', |
| 194 | 227 | 'is_difm_lite_in_progress', |
| 195 | 228 | 'difm_lite_site_options', |
| 229 | + 'is_gating_business_q1', | |
| 230 | + 'is_legacy_gating_site', | |
| 196 | 231 | 'site_intent', |
| 232 | + 'site_partner_bundle', | |
| 233 | + 'onboarding_segment', | |
| 197 | 234 | 'site_vertical_id', |
| 198 | 235 | 'blogging_prompts_settings', |
| 199 | 236 | 'launchpad_screen', |
| 200 | 237 | 'launchpad_checklist_tasks_statuses', |
| 238 | + 'migration_source_site_domain', | |
| 201 | 239 | 'wpcom_production_blog_id', |
| 202 | 240 | 'wpcom_staging_blog_ids', |
| 203 | 241 | 'can_blaze', |
| 242 | + 'wpcom_site_setup', | |
| 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', | |
| 204 | 253 | ); |
| 205 | 254 | |
| 206 | 255 | /** |
| 207 | - * List of DIFM Lite options to be displayed | |
| 208 | - * | |
| 209 | - * @var array $displayed_difm_lite_site_options | |
| 210 | - */ | |
| 211 | - protected static $displayed_difm_lite_site_options = array( | |
| 212 | - 'site_category', | |
| 213 | - 'is_website_content_submitted', | |
| 214 | - 'selected_page_titles', | |
| 215 | - ); | |
| 216 | - | |
| 217 | - /** | |
| 218 | 256 | * Jetpack response fields. |
| 219 | 257 | * |
| 220 | 258 | * @var array $jetpack_response_field_additions |
| 221 | 259 | */ |
| 222 | 260 | protected static $jetpack_response_field_additions = array( |
| 261 | + 'slug', | |
| 223 | 262 | 'subscribers_count', |
| 224 | 263 | 'site_migration', |
| 225 | 264 | 'site_owner', |
| 226 | 265 | 'is_wpcom_staging_site', |
| 227 | 266 | 'was_ecommerce_trial', |
| 267 | + 'was_migration_trial', | |
| 268 | + 'was_hosting_trial', | |
| 269 | + 'was_upgraded_from_trial', | |
| 270 | + 'is_a4a_dev_site', | |
| 271 | + 'is_garden', | |
| 272 | + 'garden_name', | |
| 273 | + 'garden_partner', | |
| 274 | + 'garden_is_provisioned', | |
| 275 | + 'is_wpcom_flex', | |
| 276 | + 'big_sky_enabled', | |
| 277 | + 'atomic_email_block', | |
| 228 | 278 | ); |
| 229 | 279 | |
| 230 | 280 | /** |
| 231 | 281 | * Jetpack response field member additions. |
| @@ -241,9 +291,9 @@ | ||
| 241 | 291 | |
| 242 | 292 | /** |
| 243 | 293 | * Jetpack response option additions. |
| 244 | 294 | * |
| 245 | - * @var array $jetpack_response_field_member_additions | |
| 295 | + * @var array $jetpack_response_option_additions | |
| 246 | 296 | */ |
| 247 | 297 | protected static $jetpack_response_option_additions = array( |
| 248 | 298 | 'publicize_permanently_disabled', |
| 249 | 299 | 'ak_vp_bundle_enabled', |
| @@ -266,15 +316,33 @@ | ||
| 266 | 316 | 'videopress_storage_used', |
| 267 | 317 | 'blogging_prompts_settings', |
| 268 | 318 | 'wpcom_production_blog_id', |
| 269 | 319 | 'wpcom_staging_blog_ids', |
| 320 | + 'is_commercial', | |
| 321 | + 'is_commercial_reasons', | |
| 322 | + 'wpcom_admin_interface', | |
| 323 | + 'wpcom_classic_early_release', | |
| 324 | + 'jetpack_recovery_mode_status', | |
| 325 | + 'jetpack_sso_require_two_step', | |
| 326 | + 'apm_enabled', | |
| 270 | 327 | ); |
| 271 | 328 | |
| 272 | 329 | /** |
| 273 | - * Site | |
| 330 | + * Current enabled trials. | |
| 274 | 331 | * |
| 275 | - * @var $site. | |
| 332 | + * @var array $jetpack_enabled_trials | |
| 276 | 333 | */ |
| 334 | + public static $jetpack_enabled_trials = array( | |
| 335 | + 'was_ecommerce_trial' => 'ecommerce', | |
| 336 | + 'was_migration_trial' => 'migration', | |
| 337 | + 'was_hosting_trial' => 'hosting', | |
| 338 | + ); | |
| 339 | + | |
| 340 | + /** | |
| 341 | + * Site. | |
| 342 | + * | |
| 343 | + * @var SAL_Site $site. | |
| 344 | + */ | |
| 277 | 345 | private $site; |
| 278 | 346 | |
| 279 | 347 | /** |
| 280 | 348 | * Fields to include. |
| @@ -296,10 +364,12 @@ | ||
| 296 | 364 | * |
| 297 | 365 | * /sites/mine |
| 298 | 366 | * /sites/%s -> $blog_id\ |
| 299 | 367 | * |
| 300 | - * @param string $path - the path. | |
| 301 | - * @param int $blog_id - the blog ID. | |
| 368 | + * @param string $path - the path. | |
| 369 | + * @param int|string $blog_id - the blog ID or the string 'mine'. | |
| 370 | + * | |
| 371 | + * @return array|\WP_Error Site response array on success, or WP_Error on failure. | |
| 302 | 372 | */ |
| 303 | 373 | public function callback( $path = '', $blog_id = 0 ) { |
| 304 | 374 | if ( 'mine' === $blog_id ) { |
| 305 | 375 | $api = WPCOM_JSON_API::init(); |
| @@ -435,8 +505,11 @@ | ||
| 435 | 505 | switch ( $key ) { |
| 436 | 506 | case 'ID': |
| 437 | 507 | $response[ $key ] = $this->site->blog_id; |
| 438 | 508 | break; |
| 509 | + case 'slug': | |
| 510 | + $response[ $key ] = $this->site->get_slug(); | |
| 511 | + break; | |
| 439 | 512 | case 'name': |
| 440 | 513 | $response[ $key ] = $this->site->get_name(); |
| 441 | 514 | break; |
| 442 | 515 | case 'description': |
| @@ -542,13 +615,9 @@ | ||
| 542 | 615 | case 'products': |
| 543 | 616 | $response[ $key ] = $this->site->get_products(); |
| 544 | 617 | break; |
| 545 | 618 | case 'zendesk_site_meta': |
| 546 | - // D59613-code only added this function to the wpcom SAL subclasses. Absent any better idea, | |
| 547 | - // we'll just omit the key entirely in Jetpack. | |
| 548 | - if ( is_callable( array( $this->site, 'get_zendesk_site_meta' ) ) ) { | |
| 549 | - $response[ $key ] = $this->site->get_zendesk_site_meta(); | |
| 550 | - } | |
| 619 | + $response[ $key ] = $this->site->get_zendesk_site_meta(); | |
| 551 | 620 | break; |
| 552 | 621 | case 'quota': |
| 553 | 622 | $response[ $key ] = $this->site->get_quota(); |
| 554 | 623 | break; |
| @@ -576,10 +645,65 @@ | ||
| 576 | 645 | case 'p2_thumbnail_elements': |
| 577 | 646 | $response[ $key ] = $this->site->get_p2_thumbnail_elements(); |
| 578 | 647 | break; |
| 579 | 648 | case 'was_ecommerce_trial': |
| 580 | - $response[ $key ] = $this->site->was_ecommerce_trial(); | |
| 649 | + $response[ $key ] = $this->site->was_trial( self::$jetpack_enabled_trials['was_ecommerce_trial'] ); | |
| 581 | 650 | break; |
| 651 | + case 'was_migration_trial': | |
| 652 | + $response[ $key ] = $this->site->was_trial( self::$jetpack_enabled_trials['was_migration_trial'] ); | |
| 653 | + break; | |
| 654 | + case 'was_hosting_trial': | |
| 655 | + $response[ $key ] = $this->site->was_trial( self::$jetpack_enabled_trials['was_hosting_trial'] ); | |
| 656 | + break; | |
| 657 | + case 'was_upgraded_from_trial': | |
| 658 | + $response[ $key ] = $this->site->was_upgraded_from_trial(); | |
| 659 | + break; | |
| 660 | + case 'is_deleted': | |
| 661 | + $response[ $key ] = $this->site->is_deleted(); | |
| 662 | + break; | |
| 663 | + case 'is_a4a_client': | |
| 664 | + $response[ $key ] = $this->site->is_a4a_client(); | |
| 665 | + break; | |
| 666 | + case 'is_a4a_dev_site': | |
| 667 | + $response[ $key ] = $this->site->is_a4a_dev_site(); | |
| 668 | + break; | |
| 669 | + case 'is_garden': | |
| 670 | + $response[ $key ] = $this->site->is_garden(); | |
| 671 | + break; | |
| 672 | + case 'garden_name': | |
| 673 | + $response[ $key ] = $this->site->garden_name(); | |
| 674 | + break; | |
| 675 | + case 'garden_partner': | |
| 676 | + $response[ $key ] = $this->site->garden_partner(); | |
| 677 | + break; | |
| 678 | + case 'garden_is_provisioned': | |
| 679 | + $response[ $key ] = $this->site->garden_is_provisioned(); | |
| 680 | + break; | |
| 681 | + case 'is_wpcom_flex': | |
| 682 | + $response[ $key ] = $this->site->is_wpcom_flex(); | |
| 683 | + break; | |
| 684 | + case 'big_sky_enabled': | |
| 685 | + $response[ $key ] = $this->site->is_big_sky_enabled(); | |
| 686 | + break; | |
| 687 | + case 'atomic_email_block': | |
| 688 | + $response[ $key ] = $this->site->get_atomic_email_block(); | |
| 689 | + break; | |
| 690 | + case 'hosting_provider_guess': | |
| 691 | + // WordPress.com platform decoration, computed only when explicitly requested | |
| 692 | + // via `fields` so default `_all` responses are unchanged. | |
| 693 | + if ( $this->is_wpcom() | |
| 694 | + && function_exists( 'get_jetpack_hosting_provider' ) | |
| 695 | + && is_array( $this->fields_to_include ) ) { | |
| 696 | + $response[ $key ] = get_jetpack_hosting_provider( get_current_blog_id() ); | |
| 697 | + } | |
| 698 | + break; | |
| 699 | + case 'environment_type': | |
| 700 | + // WordPress.com platform decoration, computed only when explicitly requested | |
| 701 | + // via `fields` so default `_all` responses are unchanged. | |
| 702 | + if ( $this->is_wpcom() && is_array( $this->fields_to_include ) ) { | |
| 703 | + $response[ $key ] = $this->get_site_environment_type(); | |
| 704 | + } | |
| 705 | + break; | |
| 582 | 706 | } |
| 583 | 707 | |
| 584 | 708 | do_action( 'post_render_site_response_key', $key ); |
| 585 | 709 | } |
| @@ -629,8 +753,11 @@ | ||
| 629 | 753 | break; |
| 630 | 754 | case 'theme_slug': |
| 631 | 755 | $options[ $key ] = $site->get_theme_slug(); |
| 632 | 756 | break; |
| 757 | + case 'theme_errors': | |
| 758 | + $options[ $key ] = $site->get_theme_errors(); | |
| 759 | + break; | |
| 633 | 760 | case 'header_image': |
| 634 | 761 | $options[ $key ] = $site->get_header_image(); |
| 635 | 762 | break; |
| 636 | 763 | case 'background_color': |
| @@ -789,13 +916,9 @@ | ||
| 789 | 916 | case 'import_engine': |
| 790 | 917 | $options[ $key ] = $site->get_import_engine(); |
| 791 | 918 | break; |
| 792 | 919 | case 'is_pending_plan': |
| 793 | - // D40032-code only added this function to the wpcom SAL subclasses. Absent any better idea, | |
| 794 | - // we'll just omit the key entirely in Jetpack. | |
| 795 | - if ( is_callable( array( $site, 'is_pending_plan' ) ) ) { | |
| 796 | - $options[ $key ] = $site->is_pending_plan(); | |
| 797 | - } | |
| 920 | + $options[ $key ] = $site->is_pending_plan(); | |
| 798 | 921 | break; |
| 799 | 922 | |
| 800 | 923 | case 'is_wpforteams_site': |
| 801 | 924 | $options[ $key ] = $site->is_wpforteams_site(); |
| @@ -837,25 +960,31 @@ | ||
| 837 | 960 | case 'is_difm_lite_in_progress': |
| 838 | 961 | $options[ $key ] = $site->is_difm_lite_in_progress(); |
| 839 | 962 | break; |
| 840 | 963 | case 'difm_lite_site_options': |
| 841 | - $difm_lite_options = $site->get_difm_lite_site_options(); | |
| 842 | - $visible_options = self::$displayed_difm_lite_site_options; | |
| 843 | - $filtered_difm_lite_options = new stdClass(); | |
| 844 | - if ( $difm_lite_options ) { | |
| 845 | - $filtered_difm_lite_options = array_filter( | |
| 846 | - $difm_lite_options, | |
| 847 | - function ( $key ) use ( $visible_options ) { | |
| 848 | - return in_array( $key, $visible_options, true ); | |
| 849 | - }, | |
| 850 | - ARRAY_FILTER_USE_KEY | |
| 851 | - ); | |
| 964 | + $difm_lite_site_options = $site->get_difm_lite_site_options(); | |
| 965 | + if ( null !== $difm_lite_site_options ) { | |
| 966 | + $options[ $key ] = (object) $difm_lite_site_options; | |
| 852 | 967 | } |
| 853 | - $options[ $key ] = $filtered_difm_lite_options; | |
| 854 | 968 | break; |
| 969 | + case 'is_gating_business_q1': | |
| 970 | + $options[ $key ] = $site->is_gating_business_q1(); | |
| 971 | + break; | |
| 972 | + case 'is_legacy_gating_site': | |
| 973 | + $options[ $key ] = $site->is_legacy_gating_site(); | |
| 974 | + break; | |
| 855 | 975 | case 'site_intent': |
| 856 | 976 | $options[ $key ] = $site->get_site_intent(); |
| 857 | 977 | break; |
| 978 | + case 'site_partner_bundle': | |
| 979 | + $options[ $key ] = $site->get_site_partner_bundle(); | |
| 980 | + break; | |
| 981 | + case 'site_goals': | |
| 982 | + $options[ $key ] = $site->get_site_goals(); | |
| 983 | + break; | |
| 984 | + case 'onboarding_segment': | |
| 985 | + $options[ $key ] = $site->get_onboarding_segment(); | |
| 986 | + break; | |
| 858 | 987 | case 'site_vertical_id': |
| 859 | 988 | $options[ $key ] = $site->get_site_vertical_id(); |
| 860 | 989 | break; |
| 861 | 990 | case 'blogging_prompts_settings': |
| @@ -868,8 +997,11 @@ | ||
| 868 | 997 | break; |
| 869 | 998 | case 'launchpad_checklist_tasks_statuses': |
| 870 | 999 | $options[ $key ] = $site->get_launchpad_checklist_tasks_statuses(); |
| 871 | 1000 | break; |
| 1001 | + case 'migration_source_site_domain': | |
| 1002 | + $options[ $key ] = $site->get_migration_source_site_domain(); | |
| 1003 | + break; | |
| 872 | 1004 | case 'wpcom_production_blog_id': |
| 873 | 1005 | $options[ $key ] = $site->get_wpcom_production_blog_id(); |
| 874 | 1006 | break; |
| 875 | 1007 | case 'wpcom_staging_blog_ids': |
| @@ -877,8 +1009,41 @@ | ||
| 877 | 1009 | break; |
| 878 | 1010 | case 'can_blaze': |
| 879 | 1011 | $options[ $key ] = $site->can_blaze(); |
| 880 | 1012 | break; |
| 1013 | + case 'wpcom_site_setup': | |
| 1014 | + $options[ $key ] = $site->get_wpcom_site_setup(); | |
| 1015 | + break; | |
| 1016 | + case 'is_commercial': | |
| 1017 | + $options[ $key ] = $site->is_commercial(); | |
| 1018 | + break; | |
| 1019 | + case 'is_commercial_reasons': | |
| 1020 | + $options[ $key ] = $site->get_is_commercial_reasons(); | |
| 1021 | + break; | |
| 1022 | + case 'wpcom_admin_interface': | |
| 1023 | + $options[ $key ] = $site->get_wpcom_admin_interface(); | |
| 1024 | + break; | |
| 1025 | + case 'wpcom_classic_early_release': | |
| 1026 | + $options[ $key ] = $site->get_wpcom_classic_early_release(); | |
| 1027 | + break; | |
| 1028 | + case 'jetpack_recovery_mode_status': | |
| 1029 | + $options[ $key ] = $site->get_jetpack_recovery_mode_status(); | |
| 1030 | + break; | |
| 1031 | + case 'jetpack_sso_require_two_step': | |
| 1032 | + $options[ $key ] = $site->get_jetpack_sso_require_two_step(); | |
| 1033 | + break; | |
| 1034 | + case 'apm_enabled': | |
| 1035 | + $options[ $key ] = $site->get_apm_enabled(); | |
| 1036 | + break; | |
| 1037 | + case 'wpcom_ai_launchpad_enabled': | |
| 1038 | + $options[ $key ] = $site->is_ai_launchpad_enabled(); | |
| 1039 | + break; | |
| 1040 | + case 'wpcom_ai_launchpad_dismissed': | |
| 1041 | + $options[ $key ] = $site->is_ai_launchpad_dismissed(); | |
| 1042 | + break; | |
| 1043 | + case 'wpcom_ai_launchpad_completed': | |
| 1044 | + $options[ $key ] = $site->is_ai_launchpad_completed(); | |
| 1045 | + break; | |
| 881 | 1046 | } |
| 882 | 1047 | } |
| 883 | 1048 | |
| 884 | 1049 | return $options; |
| @@ -910,14 +1075,20 @@ | ||
| 910 | 1075 | |
| 911 | 1076 | /** |
| 912 | 1077 | * Apply any WPCOM-only response components to a Jetpack site response. |
| 913 | 1078 | * |
| 914 | - * @param array $response - the response. | |
| 1079 | + * @param object $response - the response. | |
| 915 | 1080 | */ |
| 916 | 1081 | public function decorate_jetpack_response( &$response ) { |
| 1082 | + $this->filter_fields_and_options(); | |
| 917 | 1083 | $this->site = $this->get_platform()->get_site( $response->ID ); |
| 918 | 1084 | switch_to_blog( $this->site->get_id() ); |
| 919 | 1085 | |
| 1086 | + // Allow the SAL site to apply its own overrides to the proxied response. | |
| 1087 | + if ( method_exists( $this->site, 'decorate_jetpack_response' ) ) { | |
| 1088 | + $this->site->decorate_jetpack_response( $response ); // @phan-suppress-current-line PhanUndeclaredMethod -- checked via method_exists(). | |
| 1089 | + } | |
| 1090 | + | |
| 920 | 1091 | $wpcom_response = $this->render_response_keys( self::$jetpack_response_field_additions ); |
| 921 | 1092 | |
| 922 | 1093 | foreach ( $wpcom_response as $key => $value ) { |
| 923 | 1094 | $response->{ $key } = $value; |
| @@ -922,9 +1093,11 @@ | ||
| 922 | 1093 | foreach ( $wpcom_response as $key => $value ) { |
| 923 | 1094 | $response->{ $key } = $value; |
| 924 | 1095 | } |
| 925 | 1096 | |
| 926 | - if ( $this->has_user_access() || $this->has_blog_access( $this->api->token_details ) ) { | |
| 1097 | + $has_site_access = $this->has_user_access() || $this->has_blog_access( $this->api->token_details ); | |
| 1098 | + | |
| 1099 | + if ( $has_site_access ) { | |
| 927 | 1100 | $wpcom_member_response = $this->render_response_keys( self::$jetpack_response_field_member_additions ); |
| 928 | 1101 | |
| 929 | 1102 | foreach ( $wpcom_member_response as $key => $value ) { |
| 930 | 1103 | $response->{ $key } = $value; |
| @@ -943,22 +1116,28 @@ | ||
| 943 | 1116 | unset( $response->site_owner ); |
| 944 | 1117 | unset( $response->plan ); |
| 945 | 1118 | unset( $response->products ); |
| 946 | 1119 | unset( $response->zendesk_site_meta ); |
| 1120 | + unset( $response->atomic_email_block ); | |
| 947 | 1121 | } |
| 948 | 1122 | |
| 949 | 1123 | // render additional options. |
| 950 | - if ( $response->options ) { | |
| 1124 | + if ( isset( $response->options ) && $response->options ) { | |
| 951 | 1125 | $wpcom_options_response = $this->render_option_keys( self::$jetpack_response_option_additions ); |
| 952 | 1126 | |
| 953 | 1127 | // Remove heic from jetpack (and atomic) sites so that the iOS app know to convert the file format into a JPEG. |
| 954 | 1128 | // heic fromat is currently not supported by for uploading. |
| 955 | 1129 | // See https://jetpackp2.wordpress.com/2020/08/19/image-uploads-in-the-wp-ios-app-broken |
| 956 | - if ( $this->site->is_jetpack() && isset( $response->options['allowed_file_types'] ) ) { | |
| 1130 | + if ( | |
| 1131 | + $this->site->is_jetpack() | |
| 1132 | + && isset( $response->options['allowed_file_types'] ) | |
| 1133 | + && is_array( $response->options['allowed_file_types'] ) | |
| 1134 | + ) { | |
| 1135 | + $allowed_file_types = (array) $response->options['allowed_file_types']; | |
| 957 | 1136 | $remove_file_types = array( |
| 958 | 1137 | 'heic', |
| 959 | 1138 | ); |
| 960 | - $response->options['allowed_file_types'] = array_values( array_diff( $response->options['allowed_file_types'], $remove_file_types ) ); | |
| 1139 | + $response->options['allowed_file_types'] = array_values( array_diff( $allowed_file_types, $remove_file_types ) ); | |
| 961 | 1140 | } |
| 962 | 1141 | |
| 963 | 1142 | foreach ( $wpcom_options_response as $key => $value ) { |
| 964 | 1143 | $response->options[ $key ] = $value; |
| @@ -964,11 +1143,44 @@ | ||
| 964 | 1143 | $response->options[ $key ] = $value; |
| 965 | 1144 | } |
| 966 | 1145 | } |
| 967 | 1146 | |
| 1147 | + // WordPress.com platform fields are not part of proxied Jetpack responses; | |
| 1148 | + // add them only when explicitly requested. | |
| 1149 | + if ( $this->is_wpcom() && $has_site_access && is_array( $this->fields_to_include ) ) { | |
| 1150 | + if ( function_exists( 'get_jetpack_hosting_provider' ) && in_array( 'hosting_provider_guess', $this->fields_to_include, true ) ) { | |
| 1151 | + $response->hosting_provider_guess = get_jetpack_hosting_provider( get_current_blog_id() ); | |
| 1152 | + } | |
| 1153 | + if ( in_array( 'environment_type', $this->fields_to_include, true ) ) { | |
| 1154 | + $response->environment_type = $this->get_site_environment_type(); | |
| 1155 | + } | |
| 1156 | + } | |
| 1157 | + | |
| 968 | 1158 | restore_current_blog(); |
| 969 | 1159 | return $response; // possibly no need since it's modified in place. |
| 970 | 1160 | } |
| 1161 | + | |
| 1162 | + /** | |
| 1163 | + * Whether this request is running on the WordPress.com platform. | |
| 1164 | + * | |
| 1165 | + * @return bool | |
| 1166 | + */ | |
| 1167 | + protected function is_wpcom() { | |
| 1168 | + return ( new \Automattic\Jetpack\Status\Host() )->is_wpcom_platform(); | |
| 1169 | + } | |
| 1170 | + | |
| 1171 | + /** | |
| 1172 | + * Get the site's synced WP_ENVIRONMENT_TYPE. | |
| 1173 | + * | |
| 1174 | + * @return string|null | |
| 1175 | + */ | |
| 1176 | + protected function get_site_environment_type() { | |
| 1177 | + if ( function_exists( 'get_blog_option' ) ) { | |
| 1178 | + return get_blog_option( get_current_blog_id(), 'jetpack_callable_wp_get_environment_type', null ); | |
| 1179 | + } | |
| 1180 | + | |
| 1181 | + return get_option( 'jetpack_callable_wp_get_environment_type', null ); | |
| 1182 | + } | |
| 971 | 1183 | } |
| 972 | 1184 | |
| 973 | 1185 | new WPCOM_JSON_API_List_Post_Formats_Endpoint( |
| 974 | 1186 | array( |
| @@ -994,9 +1206,11 @@ | ||
| 994 | 1206 | ) |
| 995 | 1207 | ); |
| 996 | 1208 | |
| 997 | 1209 | /** |
| 998 | - * List Post Formates endpoint class. | |
| 1210 | + * List Post Formats endpoint class. | |
| 1211 | + * | |
| 1212 | + * @phan-constructor-used-for-side-effects | |
| 999 | 1213 | */ |
| 1000 | 1214 | class WPCOM_JSON_API_List_Post_Formats_Endpoint extends WPCOM_JSON_API_Endpoint { // phpcs:ignore |
| 1001 | 1215 | /** |
| 1002 | 1216 | * |
| @@ -1005,8 +1219,10 @@ | ||
| 1005 | 1219 | * /sites/%s/post-formats -> $blog_id |
| 1006 | 1220 | * |
| 1007 | 1221 | * @param string $path - the path. |
| 1008 | 1222 | * @param int $blog_id - the blog ID. |
| 1223 | + * | |
| 1224 | + * @return array|\WP_Error Array with 'formats' on success, or WP_Error on failure. | |
| 1009 | 1225 | */ |
| 1010 | 1226 | public function callback( $path = '', $blog_id = 0 ) { |
| 1011 | 1227 | $blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) ); |
| 1012 | 1228 | if ( is_wp_error( $blog_id ) ) { |
| @@ -1060,8 +1276,10 @@ | ||
| 1060 | 1276 | ); |
| 1061 | 1277 | |
| 1062 | 1278 | /** |
| 1063 | 1279 | * List page templates endpoint class. |
| 1280 | + * | |
| 1281 | + * @phan-constructor-used-for-side-effects | |
| 1064 | 1282 | */ |
| 1065 | 1283 | class WPCOM_JSON_API_List_Page_Templates_Endpoint extends WPCOM_JSON_API_Endpoint { // phpcs:ignore |
| 1066 | 1284 | /** |
| 1067 | 1285 | * |
| @@ -1069,8 +1287,10 @@ | ||
| 1069 | 1287 | * /sites/%s/page-templates -> $blog_id |
| 1070 | 1288 | * |
| 1071 | 1289 | * @param string $path - the path. |
| 1072 | 1290 | * @param int $blog_id - the blog ID. |
| 1291 | + * | |
| 1292 | + * @return array|\WP_Error Array with 'templates' on success, or WP_Error on failure. | |
| 1073 | 1293 | */ |
| 1074 | 1294 | public function callback( $path = '', $blog_id = 0 ) { |
| 1075 | 1295 | $blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) ); |
| 1076 | 1296 | if ( is_wp_error( $blog_id ) ) { |