diff options
Diffstat (limited to 'plugins/jetpack/json-endpoints/class.wpcom-json-api-update-customcss.php')
| -rw-r--r-- | plugins/jetpack/json-endpoints/class.wpcom-json-api-update-customcss.php | 93 |
1 files changed, 51 insertions, 42 deletions
diff --git a/plugins/jetpack/json-endpoints/class.wpcom-json-api-update-customcss.php b/plugins/jetpack/json-endpoints/class.wpcom-json-api-update-customcss.php index c67ac3e4..c957bd45 100644 --- a/plugins/jetpack/json-endpoints/class.wpcom-json-api-update-customcss.php +++ b/plugins/jetpack/json-endpoints/class.wpcom-json-api-update-customcss.php @@ -1,51 +1,61 @@ -<?php +<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName /** - * Custom Css update endpoint + * Custom CSS update endpoint. * - * https://public-api.wordpress.com/rest/v1.1/sites/$site/customcss/ + * Endpoint: /sites/%s/customcss */ -new WPCOM_JSON_API_Update_CustomCss_Endpoint( array ( - 'description' => 'Set custom-css data for a site.', - 'group' => '__do_not_document', - 'stat' => 'customcss:1:update', - 'method' => 'POST', - 'min_version' => '1.1', - 'path' => '/sites/%s/customcss', - 'path_labels' => array( - '$site' => '(string) Site ID or domain.', - ), - 'request_format' => array( - 'css' => '(string) Optional. The raw CSS.', - 'preprocessor' => '(string) Optional. The name of the preprocessor if any.', - 'add_to_existing' => '(bool) Optional. False to skip the existing styles.', - ), - 'response_format' => array( - 'css' => '(string) The raw CSS.', - 'preprocessor' => '(string) The name of the preprocessor if any.', - 'add_to_existing' => '(bool) False to skip the existing styles.', - ), - 'example_request' => 'https://public-api.wordpress.com/rest/v1.1/sites/12345678/customcss', - 'example_request_data' => array( - 'headers' => array( 'authorization' => 'Bearer YOUR_API_TOKEN' ), - 'body' => array( - 'css' => '.stie-title { color: #fff; }', - 'preprocessor' => 'sass' +new WPCOM_JSON_API_Update_CustomCss_Endpoint( + array( + 'description' => 'Set custom-css data for a site.', + 'group' => '__do_not_document', + 'stat' => 'customcss:1:update', + 'method' => 'POST', + 'min_version' => '1.1', + 'path' => '/sites/%s/customcss', + 'path_labels' => array( + '$site' => '(string) Site ID or domain.', ), - ), - 'example_response' => ' + 'request_format' => array( + 'css' => '(string) Optional. The raw CSS.', + 'preprocessor' => '(string) Optional. The name of the preprocessor if any.', + 'add_to_existing' => '(bool) Optional. False to skip the existing styles.', + ), + 'response_format' => array( + 'css' => '(string) The raw CSS.', + 'preprocessor' => '(string) The name of the preprocessor if any.', + 'add_to_existing' => '(bool) False to skip the existing styles.', + ), + 'example_request' => 'https://public-api.wordpress.com/rest/v1.1/sites/12345678/customcss', + 'example_request_data' => array( + 'headers' => array( 'authorization' => 'Bearer YOUR_API_TOKEN' ), + 'body' => array( + 'css' => '.stie-title { color: #fff; }', + 'preprocessor' => 'sass', + ), + ), + 'example_response' => ' { "css": ".site-title { color: #fff; }", "preprocessor": "sass", "add_to_existing": "true" - }' -) ); + }', + ) +); +/** + * Custom CSS update endpoint class. + */ class WPCOM_JSON_API_Update_CustomCss_Endpoint extends WPCOM_JSON_API_Endpoint { /** - * API callback. + * Custom CSS update endpoint API callback. + * + * @param string $path API path. + * @param int $blog_id Blog ID. + * + * @return array|WP_Error */ - function callback( $path = '', $blog_id = 0 ) { + public function callback( $path = '', $blog_id = 0 ) { // Switch to the given blog. $blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) ); if ( is_wp_error( $blog_id ) ) { @@ -61,21 +71,21 @@ class WPCOM_JSON_API_Update_CustomCss_Endpoint extends WPCOM_JSON_API_Endpoint { return new WP_Error( 'no_data', 'No data was provided.', 400 ); } $save_args = array( - 'css' => $args['css'], - 'preprocessor' => $args['preprocessor'], + 'css' => $args['css'], + 'preprocessor' => $args['preprocessor'], 'add_to_existing' => $args['add_to_existing'], ); Jetpack_Custom_CSS::save( $save_args ); $current = array( - 'css' => Jetpack_Custom_CSS::get_css(), - 'preprocessor' => Jetpack_Custom_CSS::get_preprocessor_key(), + 'css' => Jetpack_Custom_CSS::get_css(), + 'preprocessor' => Jetpack_Custom_CSS::get_preprocessor_key(), 'add_to_existing' => ! Jetpack_Custom_CSS::skip_stylesheet(), ); $defaults = array( - 'css' => '', - 'preprocessor' => '', + 'css' => '', + 'preprocessor' => '', 'add_to_existing' => true, ); return wp_parse_args( $current, $defaults ); @@ -83,4 +93,3 @@ class WPCOM_JSON_API_Update_CustomCss_Endpoint extends WPCOM_JSON_API_Endpoint { } - |