REST API: Clean up argument and property types.

There's a couple of places where we were missing type notes for arguments, which mainly affects documentation.

Props jnylen0.
Fixes #38792.

Built from https://develop.svn.wordpress.org/trunk@39250


git-svn-id: http://core.svn.wordpress.org/trunk@39190 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php

@@ -1158,6 +1158,7 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
 							'description'     => __( 'HTML content for the object, transformed for display.' ),
 							'type'            => 'string',
 							'context'         => array( 'view', 'edit', 'embed' ),
+							'readonly'        => true,
 						),
 					),
 				),

wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php

@@ -205,10 +205,7 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller {
 			'properties'           => array(
 				'capabilities'     => array(
 					'description'  => __( 'All capabilities used by the resource.' ),
-					'type'         => 'array',
+					'type'         => 'object',
-					'items'        => array(
-						'type' => 'string',
-					),
 					'context'      => array( 'edit' ),
 					'readonly'     => true,
 				),

wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

@@ -86,6 +86,7 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
 					'context'  => $this->get_context_param( array( 'default' => 'view' ) ),
 					'password' => array(
 						'description' => __( 'The password for the post if it is password protected.' ),
+						'type'        => 'string',
 					),
 				),
 			),
@@ -2069,6 +2070,9 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
 		$params['slug'] = array(
 			'description'       => __( 'Limit result set to posts with one or more specific slugs.' ),
 			'type'              => 'array',
+			'items'             => array(
+				'type'          => 'string',
+			),
 			'sanitize_callback' => 'wp_parse_slug_list',
 		);
 

wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php

@@ -236,7 +236,7 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
 			'properties'           => array(
 				'capabilities'     => array(
 					'description'  => __( 'All capabilities used by the resource.' ),
-					'type'         => 'array',
+					'type'         => 'object',
 					'context'      => array( 'edit' ),
 					'readonly'     => true,
 				),

wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php

@@ -89,7 +89,10 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
 						'default'     => false,
 						'description' => __( 'Required to be true, as resource does not support trashing.' ),
 					),
-					'reassign' => array(),
+					'reassign' => array(
+						'type'        => 'integer',
+						'description' => __( 'Reassign the deleted user\'s posts and links to this user ID.' ),
+					),
 				),
 			),
 			'schema' => array( $this, 'get_public_item_schema' ),
@@ -100,7 +103,7 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
 				'methods'             => WP_REST_Server::READABLE,
 				'callback'            => array( $this, 'get_current_item' ),
 				'args'                => array(
-					'context'          => array(),
+					'context' => $this->get_context_param( array( 'default' => 'view' ) ),
 				),
 			),
 			array(
@@ -119,7 +122,10 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
 						'default'     => false,
 						'description' => __( 'Required to be true, as resource does not support trashing.' ),
 					),
-					'reassign' => array(),
+					'reassign' => array(
+						'type'        => 'integer',
+						'description' => __( 'Reassign the deleted user\'s posts and links to this user ID.' ),
+					),
 				),
 			),
 			'schema' => array( $this, 'get_public_item_schema' ),

wp-includes/version.php

@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.7-beta3-39249';
+$wp_version = '4.7-beta3-39250';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.