From cc95428f75c81e686aece8c439637d245c9fd10b Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Tue, 25 May 2021 13:12:58 +0000 Subject: [PATCH] =?UTF-8?q?REST=20API:=20Update=20=E2=80=9Cobject=E2=80=9D?= =?UTF-8?q?=20strings=20to=20use=20the=20appropriate=20nouns.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This updates route arguments and schema descriptions to use more specific object types for clarity. Follow-up to [39342]. Props lephleg, jnylen0. Fixes #40720. Built from https://develop.svn.wordpress.org/trunk@51000 git-svn-id: http://core.svn.wordpress.org/trunk@50609 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- ...-rest-application-passwords-controller.php | 2 +- .../class-wp-rest-attachments-controller.php | 6 +- .../class-wp-rest-autosaves-controller.php | 6 +- .../class-wp-rest-block-types-controller.php | 2 +- .../class-wp-rest-comments-controller.php | 38 +++++----- ...class-wp-rest-post-statuses-controller.php | 2 +- .../class-wp-rest-post-types-controller.php | 2 +- .../class-wp-rest-posts-controller.php | 74 +++++++++---------- .../class-wp-rest-revisions-controller.php | 24 +++--- .../class-wp-rest-search-controller.php | 2 +- .../class-wp-rest-settings-controller.php | 2 +- .../class-wp-rest-taxonomies-controller.php | 2 +- .../class-wp-rest-terms-controller.php | 2 +- .../class-wp-rest-themes-controller.php | 2 +- .../class-wp-rest-users-controller.php | 4 +- .../class-wp-rest-comment-meta-fields.php | 4 +- .../fields/class-wp-rest-post-meta-fields.php | 4 +- .../fields/class-wp-rest-term-meta-fields.php | 4 +- .../fields/class-wp-rest-user-meta-fields.php | 4 +- wp-includes/version.php | 2 +- 20 files changed, 94 insertions(+), 94 deletions(-) diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-application-passwords-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-application-passwords-controller.php index 84fa144800..765b65714a 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-application-passwords-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-application-passwords-controller.php @@ -642,7 +642,7 @@ class WP_REST_Application_Passwords_Controller extends WP_REST_Controller { } /** - * Prepares links for the object. + * Prepares links for the request. * * @since 5.6.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php index 007cee774b..3519b0ad2b 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php @@ -34,7 +34,7 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller { 'permission_callback' => array( $this, 'post_process_item_permissions_check' ), 'args' => array( 'id' => array( - 'description' => __( 'Unique identifier for the object.' ), + 'description' => __( 'Unique identifier for the attachment.' ), 'type' => 'integer', ), 'action' => array( @@ -888,12 +888,12 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller { ), 'properties' => array( 'raw' => array( - 'description' => __( 'Description for the object, as it exists in the database.' ), + 'description' => __( 'Description for the attachment, as it exists in the database.' ), 'type' => 'string', 'context' => array( 'edit' ), ), 'rendered' => array( - 'description' => __( 'HTML description for the object, transformed for display.' ), + 'description' => __( 'HTML description for the attachment, transformed for display.' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), 'readonly' => true, diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php index 893a7e08ee..ef95ab89c2 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php @@ -86,7 +86,7 @@ class WP_REST_Autosaves_Controller extends WP_REST_Revisions_Controller { array( 'args' => array( 'parent' => array( - 'description' => __( 'The ID for the parent of the object.' ), + 'description' => __( 'The ID for the parent of the autosave.' ), 'type' => 'integer', ), ), @@ -112,11 +112,11 @@ class WP_REST_Autosaves_Controller extends WP_REST_Revisions_Controller { array( 'args' => array( 'parent' => array( - 'description' => __( 'The ID for the parent of the object.' ), + 'description' => __( 'The ID for the parent of the autosave.' ), 'type' => 'integer', ), 'id' => array( - 'description' => __( 'The ID for the object.' ), + 'description' => __( 'The ID for the autosave.' ), 'type' => 'integer', ), ), diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-block-types-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-block-types-controller.php index 1eea4d1aba..3d8672325f 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-block-types-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-block-types-controller.php @@ -45,7 +45,7 @@ class WP_REST_Block_Types_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for block types. * * @since 5.5.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php index 9f36e3b386..7fe58d8191 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php @@ -37,7 +37,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for comments. * * @since 4.7.0 * @@ -71,7 +71,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { array( 'args' => array( 'id' => array( - 'description' => __( 'Unique identifier for the object.' ), + 'description' => __( 'Unique identifier for the comment.' ), 'type' => 'integer', ), ), @@ -1381,7 +1381,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { 'type' => 'object', 'properties' => array( 'id' => array( - 'description' => __( 'Unique identifier for the object.' ), + 'description' => __( 'Unique identifier for the comment.' ), 'type' => 'integer', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, @@ -1392,7 +1392,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { 'context' => array( 'view', 'edit', 'embed' ), ), 'author_email' => array( - 'description' => __( 'Email address for the object author.' ), + 'description' => __( 'Email address for the comment author.' ), 'type' => 'string', 'format' => 'email', 'context' => array( 'edit' ), @@ -1402,13 +1402,13 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { ), ), 'author_ip' => array( - 'description' => __( 'IP address for the object author.' ), + 'description' => __( 'IP address for the comment author.' ), 'type' => 'string', 'format' => 'ip', 'context' => array( 'edit' ), ), 'author_name' => array( - 'description' => __( 'Display name for the object author.' ), + 'description' => __( 'Display name for the comment author.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'arg_options' => array( @@ -1416,13 +1416,13 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { ), ), 'author_url' => array( - 'description' => __( 'URL for the object author.' ), + 'description' => __( 'URL for the comment author.' ), 'type' => 'string', 'format' => 'uri', 'context' => array( 'view', 'edit', 'embed' ), ), 'author_user_agent' => array( - 'description' => __( 'User agent for the object author.' ), + 'description' => __( 'User agent for the comment author.' ), 'type' => 'string', 'context' => array( 'edit' ), 'arg_options' => array( @@ -1430,7 +1430,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { ), ), 'content' => array( - 'description' => __( 'The content for the object.' ), + 'description' => __( 'The content for the comment.' ), 'type' => 'object', 'context' => array( 'view', 'edit', 'embed' ), 'arg_options' => array( @@ -1439,12 +1439,12 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { ), 'properties' => array( 'raw' => array( - 'description' => __( 'Content for the object, as it exists in the database.' ), + 'description' => __( 'Content for the comment, as it exists in the database.' ), 'type' => 'string', 'context' => array( 'edit' ), ), 'rendered' => array( - 'description' => __( 'HTML content for the object, transformed for display.' ), + 'description' => __( 'HTML content for the comment, transformed for display.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, @@ -1452,26 +1452,26 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { ), ), 'date' => array( - 'description' => __( "The date the object was published, in the site's timezone." ), + 'description' => __( "The date the comment was published, in the site's timezone." ), 'type' => 'string', 'format' => 'date-time', 'context' => array( 'view', 'edit', 'embed' ), ), 'date_gmt' => array( - 'description' => __( 'The date the object was published, as GMT.' ), + 'description' => __( 'The date the comment was published, as GMT.' ), 'type' => 'string', 'format' => 'date-time', 'context' => array( 'view', 'edit' ), ), 'link' => array( - 'description' => __( 'URL to the object.' ), + 'description' => __( 'URL to the comment.' ), 'type' => 'string', 'format' => 'uri', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'parent' => array( - 'description' => __( 'The ID for the parent of the object.' ), + 'description' => __( 'The ID for the parent of the comment.' ), 'type' => 'integer', 'context' => array( 'view', 'edit', 'embed' ), 'default' => 0, @@ -1483,7 +1483,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { 'default' => 0, ), 'status' => array( - 'description' => __( 'State of the object.' ), + 'description' => __( 'State of the comment.' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), 'arg_options' => array( @@ -1491,7 +1491,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { ), ), 'type' => array( - 'description' => __( 'Type of Comment for the object.' ), + 'description' => __( 'Type of the comment.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, @@ -1515,7 +1515,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { } $schema['properties']['author_avatar_urls'] = array( - 'description' => __( 'Avatar URLs for the object author.' ), + 'description' => __( 'Avatar URLs for the comment author.' ), 'type' => 'object', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, @@ -1611,7 +1611,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller { ); $query_params['orderby'] = array( - 'description' => __( 'Sort collection by object attribute.' ), + 'description' => __( 'Sort collection by comment attribute.' ), 'type' => 'string', 'default' => 'date_gmt', 'enum' => array( diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php index 25223386e4..588bfcaf41 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php @@ -27,7 +27,7 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for post statuses. * * @since 4.7.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php index c4297a37c6..5d1d327f4f 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php @@ -27,7 +27,7 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for post types. * * @since 4.7.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php index 16e3c91edf..6c09277617 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php @@ -56,7 +56,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for posts. * * @since 4.7.0 * @@ -100,7 +100,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { array( 'args' => array( 'id' => array( - 'description' => __( 'Unique identifier for the object.' ), + 'description' => __( 'Unique identifier for the post.' ), 'type' => 'integer', ), ), @@ -2153,31 +2153,31 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { // Base properties for every Post. 'properties' => array( 'date' => array( - 'description' => __( "The date the object was published, in the site's timezone." ), + 'description' => __( "The date the post was published, in the site's timezone." ), 'type' => array( 'string', 'null' ), 'format' => 'date-time', 'context' => array( 'view', 'edit', 'embed' ), ), 'date_gmt' => array( - 'description' => __( 'The date the object was published, as GMT.' ), + 'description' => __( 'The date the post was published, as GMT.' ), 'type' => array( 'string', 'null' ), 'format' => 'date-time', 'context' => array( 'view', 'edit' ), ), 'guid' => array( - 'description' => __( 'The globally unique identifier for the object.' ), + 'description' => __( 'The globally unique identifier for the post.' ), 'type' => 'object', 'context' => array( 'view', 'edit' ), 'readonly' => true, 'properties' => array( 'raw' => array( - 'description' => __( 'GUID for the object, as it exists in the database.' ), + 'description' => __( 'GUID for the post, as it exists in the database.' ), 'type' => 'string', 'context' => array( 'edit' ), 'readonly' => true, ), 'rendered' => array( - 'description' => __( 'GUID for the object, transformed for display.' ), + 'description' => __( 'GUID for the post, transformed for display.' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), 'readonly' => true, @@ -2185,34 +2185,34 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { ), ), 'id' => array( - 'description' => __( 'Unique identifier for the object.' ), + 'description' => __( 'Unique identifier for the post.' ), 'type' => 'integer', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'link' => array( - 'description' => __( 'URL to the object.' ), + 'description' => __( 'URL to the post.' ), 'type' => 'string', 'format' => 'uri', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'modified' => array( - 'description' => __( "The date the object was last modified, in the site's timezone." ), + 'description' => __( "The date the post was last modified, in the site's timezone." ), 'type' => 'string', 'format' => 'date-time', 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'modified_gmt' => array( - 'description' => __( 'The date the object was last modified, as GMT.' ), + 'description' => __( 'The date the post was last modified, as GMT.' ), 'type' => 'string', 'format' => 'date-time', 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'slug' => array( - 'description' => __( 'An alphanumeric identifier for the object unique to its type.' ), + 'description' => __( 'An alphanumeric identifier for the post unique to its type.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'arg_options' => array( @@ -2220,7 +2220,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { ), ), 'status' => array( - 'description' => __( 'A named status for the object.' ), + 'description' => __( 'A named status for the post.' ), 'type' => 'string', 'enum' => array_keys( get_post_stati( array( 'internal' => false ) ) ), 'context' => array( 'view', 'edit' ), @@ -2229,7 +2229,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { ), ), 'type' => array( - 'description' => __( 'Type of Post for the object.' ), + 'description' => __( 'Type of post.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, @@ -2245,14 +2245,14 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { $post_type_obj = get_post_type_object( $this->post_type ); if ( is_post_type_viewable( $post_type_obj ) && $post_type_obj->public ) { $schema['properties']['permalink_template'] = array( - 'description' => __( 'Permalink template for the object.' ), + 'description' => __( 'Permalink template for the post.' ), 'type' => 'string', 'context' => array( 'edit' ), 'readonly' => true, ); $schema['properties']['generated_slug'] = array( - 'description' => __( 'Slug automatically generated from the object title.' ), + 'description' => __( 'Slug automatically generated from the post title.' ), 'type' => 'string', 'context' => array( 'edit' ), 'readonly' => true, @@ -2261,7 +2261,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { if ( $post_type_obj->hierarchical ) { $schema['properties']['parent'] = array( - 'description' => __( 'The ID for the parent of the object.' ), + 'description' => __( 'The ID for the parent of the post.' ), 'type' => 'integer', 'context' => array( 'view', 'edit' ), ); @@ -2322,7 +2322,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { case 'title': $schema['properties']['title'] = array( - 'description' => __( 'The title for the object.' ), + 'description' => __( 'The title for the post.' ), 'type' => 'object', 'context' => array( 'view', 'edit', 'embed' ), 'arg_options' => array( @@ -2331,12 +2331,12 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { ), 'properties' => array( 'raw' => array( - 'description' => __( 'Title for the object, as it exists in the database.' ), + 'description' => __( 'Title for the post, as it exists in the database.' ), 'type' => 'string', 'context' => array( 'edit' ), ), 'rendered' => array( - 'description' => __( 'HTML title for the object, transformed for display.' ), + 'description' => __( 'HTML title for the post, transformed for display.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, @@ -2347,7 +2347,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { case 'editor': $schema['properties']['content'] = array( - 'description' => __( 'The content for the object.' ), + 'description' => __( 'The content for the post.' ), 'type' => 'object', 'context' => array( 'view', 'edit' ), 'arg_options' => array( @@ -2356,18 +2356,18 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { ), 'properties' => array( 'raw' => array( - 'description' => __( 'Content for the object, as it exists in the database.' ), + 'description' => __( 'Content for the post, as it exists in the database.' ), 'type' => 'string', 'context' => array( 'edit' ), ), 'rendered' => array( - 'description' => __( 'HTML content for the object, transformed for display.' ), + 'description' => __( 'HTML content for the post, transformed for display.' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'block_version' => array( - 'description' => __( 'Version of the content block format used by the object.' ), + 'description' => __( 'Version of the content block format used by the post.' ), 'type' => 'integer', 'context' => array( 'edit' ), 'readonly' => true, @@ -2384,7 +2384,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { case 'author': $schema['properties']['author'] = array( - 'description' => __( 'The ID for the author of the object.' ), + 'description' => __( 'The ID for the author of the post.' ), 'type' => 'integer', 'context' => array( 'view', 'edit', 'embed' ), ); @@ -2392,7 +2392,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { case 'excerpt': $schema['properties']['excerpt'] = array( - 'description' => __( 'The excerpt for the object.' ), + 'description' => __( 'The excerpt for the post.' ), 'type' => 'object', 'context' => array( 'view', 'edit', 'embed' ), 'arg_options' => array( @@ -2401,12 +2401,12 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { ), 'properties' => array( 'raw' => array( - 'description' => __( 'Excerpt for the object, as it exists in the database.' ), + 'description' => __( 'Excerpt for the post, as it exists in the database.' ), 'type' => 'string', 'context' => array( 'edit' ), ), 'rendered' => array( - 'description' => __( 'HTML excerpt for the object, transformed for display.' ), + 'description' => __( 'HTML excerpt for the post, transformed for display.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, @@ -2423,7 +2423,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { case 'thumbnail': $schema['properties']['featured_media'] = array( - 'description' => __( 'The ID of the featured media for the object.' ), + 'description' => __( 'The ID of the featured media for the post.' ), 'type' => 'integer', 'context' => array( 'view', 'edit', 'embed' ), ); @@ -2431,13 +2431,13 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { case 'comments': $schema['properties']['comment_status'] = array( - 'description' => __( 'Whether or not comments are open on the object.' ), + 'description' => __( 'Whether or not comments are open on the post.' ), 'type' => 'string', 'enum' => array( 'open', 'closed' ), 'context' => array( 'view', 'edit' ), ); $schema['properties']['ping_status'] = array( - 'description' => __( 'Whether or not the object can be pinged.' ), + 'description' => __( 'Whether or not the post can be pinged.' ), 'type' => 'string', 'enum' => array( 'open', 'closed' ), 'context' => array( 'view', 'edit' ), @@ -2446,7 +2446,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { case 'page-attributes': $schema['properties']['menu_order'] = array( - 'description' => __( 'The order of the object in relation to other object of its type.' ), + 'description' => __( 'The order of the post in relation to other posts.' ), 'type' => 'integer', 'context' => array( 'view', 'edit' ), ); @@ -2457,7 +2457,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { $formats = array_values( get_post_format_slugs() ); $schema['properties']['format'] = array( - 'description' => __( 'The format for the object.' ), + 'description' => __( 'The format for the post.' ), 'type' => 'string', 'enum' => $formats, 'context' => array( 'view', 'edit' ), @@ -2473,14 +2473,14 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { if ( 'post' === $this->post_type ) { $schema['properties']['sticky'] = array( - 'description' => __( 'Whether or not the object should be treated as sticky.' ), + 'description' => __( 'Whether or not the post should be treated as sticky.' ), 'type' => 'boolean', 'context' => array( 'view', 'edit' ), ); } $schema['properties']['template'] = array( - 'description' => __( 'The theme file to use to display the object.' ), + 'description' => __( 'The theme file to use to display the post.' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), 'arg_options' => array( @@ -2510,7 +2510,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { $schema['properties'][ $base ] = array( /* translators: %s: Taxonomy name. */ - 'description' => sprintf( __( 'The terms assigned to the object in the %s taxonomy.' ), $taxonomy->name ), + 'description' => sprintf( __( 'The terms assigned to the post in the %s taxonomy.' ), $taxonomy->name ), 'type' => 'array', 'items' => array( 'type' => 'integer', @@ -2780,7 +2780,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller { ); $query_params['orderby'] = array( - 'description' => __( 'Sort collection by object attribute.' ), + 'description' => __( 'Sort collection by post attribute.' ), 'type' => 'string', 'default' => 'date', 'enum' => array( diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php index ef22922abf..09f9981d2b 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php @@ -75,7 +75,7 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller { array( 'args' => array( 'parent' => array( - 'description' => __( 'The ID for the parent of the object.' ), + 'description' => __( 'The ID for the parent of the revision.' ), 'type' => 'integer', ), ), @@ -95,11 +95,11 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller { array( 'args' => array( 'parent' => array( - 'description' => __( 'The ID for the parent of the object.' ), + 'description' => __( 'The ID for the parent of the revision.' ), 'type' => 'integer', ), 'id' => array( - 'description' => __( 'Unique identifier for the object.' ), + 'description' => __( 'Unique identifier for the revision.' ), 'type' => 'integer', ), ), @@ -675,51 +675,51 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller { // Base properties for every Revision. 'properties' => array( 'author' => array( - 'description' => __( 'The ID for the author of the object.' ), + 'description' => __( 'The ID for the author of the revision.' ), 'type' => 'integer', 'context' => array( 'view', 'edit', 'embed' ), ), 'date' => array( - 'description' => __( "The date the object was published, in the site's timezone." ), + 'description' => __( "The date the revision was published, in the site's timezone." ), 'type' => 'string', 'format' => 'date-time', 'context' => array( 'view', 'edit', 'embed' ), ), 'date_gmt' => array( - 'description' => __( 'The date the object was published, as GMT.' ), + 'description' => __( 'The date the revision was published, as GMT.' ), 'type' => 'string', 'format' => 'date-time', 'context' => array( 'view', 'edit' ), ), 'guid' => array( - 'description' => __( 'GUID for the object, as it exists in the database.' ), + 'description' => __( 'GUID for the revision, as it exists in the database.' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), ), 'id' => array( - 'description' => __( 'Unique identifier for the object.' ), + 'description' => __( 'Unique identifier for the revision.' ), 'type' => 'integer', 'context' => array( 'view', 'edit', 'embed' ), ), 'modified' => array( - 'description' => __( "The date the object was last modified, in the site's timezone." ), + 'description' => __( "The date the revision was last modified, in the site's timezone." ), 'type' => 'string', 'format' => 'date-time', 'context' => array( 'view', 'edit' ), ), 'modified_gmt' => array( - 'description' => __( 'The date the object was last modified, as GMT.' ), + 'description' => __( 'The date the revision was last modified, as GMT.' ), 'type' => 'string', 'format' => 'date-time', 'context' => array( 'view', 'edit' ), ), 'parent' => array( - 'description' => __( 'The ID for the parent of the object.' ), + 'description' => __( 'The ID for the parent of the revision.' ), 'type' => 'integer', 'context' => array( 'view', 'edit', 'embed' ), ), 'slug' => array( - 'description' => __( 'An alphanumeric identifier for the object unique to its type.' ), + 'description' => __( 'An alphanumeric identifier for the revision unique to its type.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), ), diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php index 6572ad27c9..0e223ffb77 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php @@ -82,7 +82,7 @@ class WP_REST_Search_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for the search controller. * * @since 5.0.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php index 6b41725d8c..157c49acbe 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php @@ -27,7 +27,7 @@ class WP_REST_Settings_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for the site's settings. * * @since 4.7.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php index 89544b9365..0089afbfb1 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php @@ -27,7 +27,7 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for taxonomies. * * @since 4.7.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php index 0af8712f07..951973ca8d 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php @@ -65,7 +65,7 @@ class WP_REST_Terms_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for terms. * * @since 4.7.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php index 212288d476..f1e8a8bd12 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php @@ -27,7 +27,7 @@ class WP_REST_Themes_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for themes. * * @since 5.0.0 * diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php index 58071fde6e..962ff4b3d9 100644 --- a/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php +++ b/wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php @@ -37,7 +37,7 @@ class WP_REST_Users_Controller extends WP_REST_Controller { } /** - * Registers the routes for the objects of the controller. + * Registers the routes for users. * * @since 4.7.0 * @@ -1520,7 +1520,7 @@ class WP_REST_Users_Controller extends WP_REST_Controller { $query_params['orderby'] = array( 'default' => 'name', - 'description' => __( 'Sort collection by object attribute.' ), + 'description' => __( 'Sort collection by user attribute.' ), 'enum' => array( 'id', 'include', diff --git a/wp-includes/rest-api/fields/class-wp-rest-comment-meta-fields.php b/wp-includes/rest-api/fields/class-wp-rest-comment-meta-fields.php index c3a810f33c..033ef9cd87 100644 --- a/wp-includes/rest-api/fields/class-wp-rest-comment-meta-fields.php +++ b/wp-includes/rest-api/fields/class-wp-rest-comment-meta-fields.php @@ -17,7 +17,7 @@ class WP_REST_Comment_Meta_Fields extends WP_REST_Meta_Fields { /** - * Retrieves the object type for comment meta. + * Retrieves the comment type for comment meta. * * @since 4.7.0 * @@ -28,7 +28,7 @@ class WP_REST_Comment_Meta_Fields extends WP_REST_Meta_Fields { } /** - * Retrieves the object meta subtype. + * Retrieves the comment meta subtype. * * @since 4.9.8 * diff --git a/wp-includes/rest-api/fields/class-wp-rest-post-meta-fields.php b/wp-includes/rest-api/fields/class-wp-rest-post-meta-fields.php index cddc50dcd4..4b1dc23b30 100644 --- a/wp-includes/rest-api/fields/class-wp-rest-post-meta-fields.php +++ b/wp-includes/rest-api/fields/class-wp-rest-post-meta-fields.php @@ -36,7 +36,7 @@ class WP_REST_Post_Meta_Fields extends WP_REST_Meta_Fields { } /** - * Retrieves the object meta type. + * Retrieves the post meta type. * * @since 4.7.0 * @@ -47,7 +47,7 @@ class WP_REST_Post_Meta_Fields extends WP_REST_Meta_Fields { } /** - * Retrieves the object meta subtype. + * Retrieves the post meta subtype. * * @since 4.9.8 * diff --git a/wp-includes/rest-api/fields/class-wp-rest-term-meta-fields.php b/wp-includes/rest-api/fields/class-wp-rest-term-meta-fields.php index 237a4c01e0..281e1316c9 100644 --- a/wp-includes/rest-api/fields/class-wp-rest-term-meta-fields.php +++ b/wp-includes/rest-api/fields/class-wp-rest-term-meta-fields.php @@ -36,7 +36,7 @@ class WP_REST_Term_Meta_Fields extends WP_REST_Meta_Fields { } /** - * Retrieves the object meta type. + * Retrieves the term meta type. * * @since 4.7.0 * @@ -47,7 +47,7 @@ class WP_REST_Term_Meta_Fields extends WP_REST_Meta_Fields { } /** - * Retrieves the object meta subtype. + * Retrieves the term meta subtype. * * @since 4.9.8 * diff --git a/wp-includes/rest-api/fields/class-wp-rest-user-meta-fields.php b/wp-includes/rest-api/fields/class-wp-rest-user-meta-fields.php index d35cb2ba59..fb1513c58a 100644 --- a/wp-includes/rest-api/fields/class-wp-rest-user-meta-fields.php +++ b/wp-includes/rest-api/fields/class-wp-rest-user-meta-fields.php @@ -17,7 +17,7 @@ class WP_REST_User_Meta_Fields extends WP_REST_Meta_Fields { /** - * Retrieves the object meta type. + * Retrieves the user meta type. * * @since 4.7.0 * @@ -28,7 +28,7 @@ class WP_REST_User_Meta_Fields extends WP_REST_Meta_Fields { } /** - * Retrieves the object meta subtype. + * Retrieves the user meta subtype. * * @since 4.9.8 * diff --git a/wp-includes/version.php b/wp-includes/version.php index a0148edb0d..628311e769 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -13,7 +13,7 @@ * * @global string $wp_version */ -$wp_version = '5.8-alpha-50999'; +$wp_version = '5.8-alpha-51000'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.