class.wpcom-json-api-site-settings-v1-3-endpoint.php — Jetpack – WP Security, Backup, Speed, & Growth 13.2.4

jetpack / json-endpoints / class.wpcom-json-api-site-settings-v1-3-endpoint.php

jetpack / json-endpoints Last commit date

class.wpcom-json-api-site-settings-v1-3-endpoint.php

192 lines

1	<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
2
3	new WPCOM_JSON_API_Site_Settings_V1_3_Endpoint(
4	array(
5	'description' => 'Get detailed settings information about a site.',
6	'group' => '__do_not_document',
7	'stat' => 'sites:X',
8	'min_version' => '1.3',
9	'method' => 'GET',
10	'path' => '/sites/%s/settings',
11	'path_labels' => array(
12	'$site' => '(int\|string) Site ID or domain',
13	),
14
15	'query_parameters' => array(
16	'context' => false,
17	),
18
19	'response_format' => WPCOM_JSON_API_Site_Settings_Endpoint::$site_format,
20
21	'example_request' => 'https://public-api.wordpress.com/rest/v1.3/sites/en.blog.wordpress.com/settings?pretty=1',
22	)
23	);
24
25	new WPCOM_JSON_API_Site_Settings_V1_3_Endpoint(
26	array(
27	'description' => 'Update settings for a site.',
28	'group' => '__do_not_document',
29	'stat' => 'sites:X',
30	'min_version' => '1.3',
31	'method' => 'POST',
32	'path' => '/sites/%s/settings',
33	'path_labels' => array(
34	'$site' => '(int\|string) Site ID or domain',
35	),
36
37	'request_format' => array(
38	'blogname' => '(string) Blog name',
39	'blogdescription' => '(string) Blog description',
40	'default_pingback_flag' => '(bool) Notify blogs linked from article?',
41	'default_ping_status' => '(bool) Allow link notifications from other blogs?',
42	'default_comment_status' => '(bool) Allow comments on new articles?',
43	'blog_public' => '(string) Site visibility; -1: private, 0: discourage search engines, 1: allow search engines',
44	'jetpack_sync_non_public_post_stati' => '(bool) allow sync of post and pages with non-public posts stati',
45	'jetpack_relatedposts_enabled' => '(bool) Enable related posts?',
46	'jetpack_relatedposts_show_context' => '(bool) Show post\'s tags and category in related posts?',
47	'jetpack_relatedposts_show_date' => '(bool) Show date in related posts?',
48	'jetpack_relatedposts_show_headline' => '(bool) Show headline in related posts?',
49	'jetpack_relatedposts_show_thumbnails' => '(bool) Show thumbnails in related posts?',
50	'instant_search_enabled' => '(bool) Enable the new Jetpack Instant Search interface',
51	'jetpack_search_enabled' => '(bool) Enable Jetpack Search',
52	'jetpack_search_supported' => '(bool) Jetpack Search supported',
53	'jetpack_protect_whitelist' => '(array) List of IP addresses to always allow',
54	'infinite_scroll' => '(bool) Support infinite scroll of posts?',
55	'default_category' => '(int) Default post category',
56	'default_post_format' => '(string) Default post format',
57	'require_name_email' => '(bool) Require comment authors to fill out name and email?',
58	'comment_registration' => '(bool) Require users to be registered and logged in to comment?',
59	'close_comments_for_old_posts' => '(bool) Automatically close comments on old posts?',
60	'close_comments_days_old' => '(int) Age at which to close comments',
61	'thread_comments' => '(bool) Enable threaded comments?',
62	'thread_comments_depth' => '(int) Depth to thread comments',
63	'page_comments' => '(bool) Break comments into pages?',
64	'comments_per_page' => '(int) Number of comments to display per page',
65	'default_comments_page' => '(string) newest\|oldest Which page of comments to display first',
66	'comment_order' => '(string) asc\|desc Order to display comments within page',
67	'comments_notify' => '(bool) Email me when someone comments?',
68	'moderation_notify' => '(bool) Email me when a comment is helf for moderation?',
69	'social_notifications_like' => '(bool) Email me when someone likes my post?',
70	'social_notifications_reblog' => '(bool) Email me when someone reblogs my post?',
71	'social_notifications_subscribe' => '(bool) Email me when someone subscribes to my blog?',
72	'comment_moderation' => '(bool) Moderate comments for manual approval?',
73	'comment_previously_approved' => '(bool) Moderate comments unless author has a previously-approved comment?',
74	'comment_max_links' => '(int) Moderate comments that contain X or more links',
75	'moderation_keys' => '(string) Words or phrases that trigger comment moderation, one per line',
76	'disallowed_keys' => '(string) Words or phrases that mark comment spam, one per line',
77	'lang_id' => '(int) ID for language blog is written in',
78	'locale' => '(string) locale code for language blog is written in',
79	'wga' => '(array) Google Analytics Settings',
80	'disabled_likes' => '(bool) Are likes globally disabled (they can still be turned on per post)?',
81	'disabled_reblogs' => '(bool) Are reblogs disabled on posts?',
82	'jetpack_comment_likes_enabled' => '(bool) Are comment likes enabled for all comments?',
83	'sharing_button_style' => '(string) Style to use for sharing buttons (icon-text, icon, text, or official)',
84	'sharing_label' => '(string) Label to use for sharing buttons, e.g. "Share this:"',
85	'sharing_show' => '(string\|array:string) Post type or array of types where sharing buttons are to be displayed',
86	'sharing_open_links' => '(string) Link target for sharing buttons (same or new)',
87	'twitter_via' => '(string) Twitter username to include in tweets when people share using the Twitter button',
88	'jetpack-twitter-cards-site-tag' => '(string) The Twitter username of the owner of the site\'s domain.',
89	'eventbrite_api_token' => '(int) The Keyring token ID for an Eventbrite token to associate with the site',
90	'timezone_string' => '(string) PHP-compatible timezone string like \'UTC-5\'',
91	'gmt_offset' => '(int) Site offset from UTC in hours',
92	'date_format' => '(string) PHP Date-compatible date format',
93	'time_format' => '(string) PHP Date-compatible time format',
94	'start_of_week' => '(int) Starting day of week (0 = Sunday, 6 = Saturday)',
95	'jetpack_testimonial' => '(bool) Whether testimonial custom post type is enabled for the site',
96	'jetpack_testimonial_posts_per_page' => '(int) Number of testimonials to show per page',
97	'jetpack_portfolio' => '(bool) Whether portfolio custom post type is enabled for the site',
98	'jetpack_portfolio_posts_per_page' => '(int) Number of portfolio projects to show per page',
99	Jetpack_SEO_Utils::FRONT_PAGE_META_OPTION => '(string) The SEO meta description for the site.',
100	Jetpack_SEO_Titles::TITLE_FORMATS_OPTION => '(array) SEO meta title formats. Allowed keys: front_page, posts, pages, groups, archives',
101	'verification_services_codes' => '(array) Website verification codes. Allowed keys: google, pinterest, bing, yandex, facebook',
102	'podcasting_archive' => '(string) The post category, if any, used for publishing podcasts',
103	'site_icon' => '(int) Media attachment ID to use as site icon. Set to zero or an otherwise empty value to clear',
104	'api_cache' => '(bool) Turn on/off the Jetpack JSON API cache',
105	'posts_per_page' => '(int) Number of posts to show on blog pages',
106	'posts_per_rss' => '(int) Number of posts to show in the RSS feed',
107	'rss_use_excerpt' => '(bool) Whether the RSS feed will use post excerpts',
108	'wpcom_publish_posts_with_markdown' => '(bool) Whether markdown is enabled for posts',
109	'wpcom_publish_comments_with_markdown' => '(bool) Whether markdown is enabled for comments',
110	),
111
112	'response_format' => array(
113	'updated' => '(array)',
114	),
115
116	'example_request' => 'https://public-api.wordpress.com/rest/v1/sites/en.blog.wordpress.com/settings?pretty=1',
117	)
118	);
119
120	/**
121	* Site settings v1_3 endpoint class.
122	*/
123	class WPCOM_JSON_API_Site_Settings_V1_3_Endpoint extends WPCOM_JSON_API_Site_Settings_V1_2_Endpoint {
124
125	/**
126	* Get defaults.
127	*
128	* @return array
129	*/
130	protected function get_defaults() {
131	return array(
132	'code' => '',
133	'anonymize_ip' => false,
134	'ec_track_purchases' => false,
135	'ec_track_add_to_cart' => false,
136	);
137	}
138
139	/**
140	* API Callback
141	*
142	* @param string $path - the path.
143	* @param int $blog_id - the blog ID.
144	*
145	* @return array\|WP_Error
146	*/
147	public function callback( $path = '', $blog_id = 0 ) {
148	add_filter( 'site_settings_endpoint_get', array( $this, 'filter_site_settings_endpoint_get' ) );
149	add_filter( 'site_settings_update_wga', array( $this, 'filter_update_google_analytics' ), 10, 2 );
150	return parent::callback( $path, $blog_id );
151	}
152
153	/**
154	* Filter the parent's response to include the fields
155	* added to 1.3 (and their defaults)
156	*
157	* @param array $settings - the settings array.
158	*
159	* @return array
160	*/
161	public function filter_site_settings_endpoint_get( $settings ) {
162	$option_name = $this->get_google_analytics_option_name();
163	$option = get_option( $option_name, array() );
164	$settings['wga'] = wp_parse_args( $option, $this->get_defaults() );
165	return $settings;
166	}
167
168	/**
169	* Filter the parent's response to consume our new fields
170	*
171	* @param array $wga - Array of existing Google Analytics settings.
172	* @param array $new_values - the new values we're adding.
173	*
174	* @return array
175	*/
176	public function filter_update_google_analytics( $wga, $new_values ) {
177	$wga_keys = array_keys( $this->get_defaults() );
178	foreach ( $wga_keys as $wga_key ) {
179	// Skip code since the parent class has handled it
180	if ( 'code' === $wga_key ) {
181	continue;
182	}
183	// All our new keys are booleans, so let's coerce each key's value
184	// before updating the value in settings
185	if ( array_key_exists( $wga_key, $new_values ) ) {
186	$wga[ $wga_key ] = WPCOM_JSON_API::is_truthy( $new_values[ $wga_key ] );
187	}
188	}
189	return $wga;
190	}
191	}
192