IntenseWebs/WordPress
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Docs: Remove @access notations from method DocBlocks in wp-includes/* classes.

Browse Source 
Prior to about 2013, many class methods lacked even access modifiers which made the `@access` notations that much more useful. Now that we've gotten to a point where the codebase is more mature from a maintenance perspective and we can finally remove these notations. Notable exceptions to this change include standalone functions notated as private as well as some classes still considered to represent "private" APIs.

See #41452.

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


git-svn-id: http://core.svn.wordpress.org/trunk@41002 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes
2017-07-27 00:41:44 +00:00
parent 1a28ec87e1
commit 0860bb2771
136 changed files with 3 additions and 1907 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php
View File

@@ -21,7 +21,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* prepares for WP_Query.
*
* @since 4.7.0
* @access protected
*
* @param array $prepared_args Optional. Array of prepared arguments. Default empty array.
* @param WP_REST_Request $request Optional. Request to prepare items for.
@@ -59,7 +58,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Checks if a given request has access to create an attachment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|true Boolean true if the attachment may be created, or a WP_Error if not.
@@ -92,7 +90,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Creates a single attachment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, WP_Error object on failure.
@@ -200,7 +197,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Updates a single attachment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, WP_Error object on failure.
@@ -245,7 +241,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Prepares a single attachment for create or update.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Request object.
* @return WP_Error|stdClass $prepared_attachment Post object.
@@ -282,7 +277,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Prepares a single attachment output for response.
*
* @since 4.7.0
* @access public
*
* @param WP_Post $post Attachment object.
* @param WP_REST_Request $request Request object.
@@ -375,7 +369,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Retrieves the attachment's schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema as an array.
*/
@@ -481,7 +474,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Handles an upload via raw POST data.
*
* @since 4.7.0
* @access protected
*
* @param array $data Supplied file data.
* @param array $headers HTTP headers from the request.
@@ -579,7 +571,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* ext-token = <the characters in token, followed by "*">
*
* @since 4.7.0
* @access public
*
* @link http://tools.ietf.org/html/rfc2388
* @link http://tools.ietf.org/html/rfc6266
@@ -632,7 +623,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Retrieves the query params for collections of attachments.
*
* @since 4.7.0
* @access public
*
* @return array Query parameters for the attachment collection as an array.
*/
@@ -662,7 +652,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Validates whether the user can query private statuses.
*
* @since 4.7.0
* @access public
*
* @param mixed $value Status value.
* @param WP_REST_Request $request Request object.
@@ -681,7 +670,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Handles an upload via multipart/form-data ($_FILES).
*
* @since 4.7.0
* @access protected
*
* @param array $files Data from the `$_FILES` superglobal.
* @param array $headers HTTP headers from the request.
@@ -731,7 +719,6 @@ class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {
* Media types are considered the MIME type category.
*
* @since 4.7.0
* @access protected
*
* @return array Array of supported media types.
*/

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

@@ -20,7 +20,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Instance of a comment meta fields object.
*
* @since 4.7.0
* @access protected
* @var WP_REST_Comment_Meta_Fields
*/
protected $meta;
@@ -29,7 +28,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Constructor.
*
* @since 4.7.0
* @access public
*/
public function __construct() {
$this->namespace = 'wp/v2';
@@ -42,7 +40,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Registers the routes for the objects of the controller.
*
* @since 4.7.0
* @access public
*/
public function register_routes() {
@@ -111,7 +108,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Checks if a given request has access to read comments.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|bool True if the request has read access, error object otherwise.
@@ -164,7 +160,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Retrieves a list of comment items.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, or error object on failure.
@@ -339,7 +334,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Checks if a given request has access to read the comment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|bool True if the request has read access for the item, error object otherwise.
@@ -371,7 +365,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Retrieves a comment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, or error object on failure.
@@ -392,7 +385,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Checks if a given request has access to create a comment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|bool True if the request has access to create items, error object otherwise.
@@ -480,7 +472,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Creates a comment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, or error object on failure.
@@ -648,7 +639,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Checks if a given REST request has access to update a comment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|bool True if the request has access to update the item, error object otherwise.
@@ -670,7 +660,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Updates a comment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, or error object on failure.
@@ -767,7 +756,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Checks if a given request has access to delete a comment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|bool True if the request has access to delete the item, error object otherwise.
@@ -788,7 +776,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Deletes a comment.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, or error object on failure.
@@ -857,7 +844,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Prepares a single comment output for response.
*
* @since 4.7.0
* @access public
*
* @param WP_Comment $comment Comment object.
* @param WP_REST_Request $request Request object.
@@ -923,7 +909,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Prepares links for the request.
*
* @since 4.7.0
* @access protected
*
* @param WP_Comment $comment Comment object.
* @return array Links for the given comment.
@@ -992,7 +977,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Prepends internal property prefix to query parameters to match our response fields.
*
* @since 4.7.0
* @access protected
*
* @param string $query_param Query parameter.
* @return string The normalized query parameter.
@@ -1025,7 +1009,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Checks comment_approved to set comment status for single comment output.
*
* @since 4.7.0
* @access protected
*
* @param string|int $comment_approved comment status.
* @return string Comment status.
@@ -1057,7 +1040,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Prepares a single comment to be inserted into the database.
*
* @since 4.7.0
* @access protected
*
* @param WP_REST_Request $request Request object.
* @return array|WP_Error Prepared comment, otherwise WP_Error object.
@@ -1153,7 +1135,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Retrieves the comment's schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array
*/
@@ -1313,7 +1294,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Retrieves the query params for collections.
*
* @since 4.7.0
* @access public
*
* @return array Comments collection parameters.
*/
@@ -1471,7 +1451,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Sets the comment_status of a given comment object when creating or updating a comment.
*
* @since 4.7.0
* @access protected
*
* @param string|int $new_status New comment status.
* @param int $comment_id Comment ID.
@@ -1520,7 +1499,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Correctly handles posts with the inherit status.
*
* @since 4.7.0
* @access protected
*
* @param WP_Post $post Post object.
* @param WP_REST_Request $request Request data to check.
@@ -1558,7 +1536,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Checks if the comment can be read.
*
* @since 4.7.0
* @access protected
*
* @param WP_Comment $comment Comment object.
* @param WP_REST_Request $request Request data to check.
@@ -1593,7 +1570,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* Checks if a comment can be edited or deleted.
*
* @since 4.7.0
* @access protected
*
* @param object $comment Comment object.
* @return bool Whether the comment can be edited or deleted.
@@ -1618,7 +1594,6 @@ class WP_REST_Comments_Controller extends WP_REST_Controller {
* string is allowed when a comment is being updated.
*
* @since 4.7.0
* @access public
*
* @param string $value Author email value submitted.
* @param WP_REST_Request $request Full details about the request.

28
wp-includes/rest-api/endpoints/class-wp-rest-controller.php
View File

@@ -18,7 +18,6 @@ abstract class WP_REST_Controller {
* The namespace of this controller's route.
*
* @since 4.7.0
* @access protected
* @var string
*/
protected $namespace;
@@ -27,7 +26,6 @@ abstract class WP_REST_Controller {
* The base of this controller's route.
*
* @since 4.7.0
* @access protected
* @var string
*/
protected $rest_base;
@@ -36,7 +34,6 @@ abstract class WP_REST_Controller {
* Registers the routes for the objects of the controller.
*
* @since 4.7.0
* @access public
*/
public function register_routes() {
_doing_it_wrong( 'WP_REST_Controller::register_routes', __( 'The register_routes() method must be overridden' ), '4.7' );
@@ -46,7 +43,6 @@ abstract class WP_REST_Controller {
* Checks if a given request has access to get items.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|bool True if the request has read access, WP_Error object otherwise.
@@ -59,7 +55,6 @@ abstract class WP_REST_Controller {
* Retrieves a collection of items.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -72,7 +67,6 @@ abstract class WP_REST_Controller {
* Checks if a given request has access to get a specific item.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|bool True if the request has read access for the item, WP_Error object otherwise.
@@ -85,7 +79,6 @@ abstract class WP_REST_Controller {
* Retrieves one item from the collection.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -98,7 +91,6 @@ abstract class WP_REST_Controller {
* Checks if a given request has access to create items.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|bool True if the request has access to create items, WP_Error object otherwise.
@@ -111,7 +103,6 @@ abstract class WP_REST_Controller {
* Creates one item from the collection.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -124,7 +115,6 @@ abstract class WP_REST_Controller {
* Checks if a given request has access to update a specific item.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|bool True if the request has access to update the item, WP_Error object otherwise.
@@ -137,7 +127,6 @@ abstract class WP_REST_Controller {
* Updates one item from the collection.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -150,7 +139,6 @@ abstract class WP_REST_Controller {
* Checks if a given request has access to delete a specific item.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|bool True if the request has access to delete the item, WP_Error object otherwise.
@@ -163,7 +151,6 @@ abstract class WP_REST_Controller {
* Deletes one item from the collection.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_Error|WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -176,7 +163,6 @@ abstract class WP_REST_Controller {
* Prepares one item for create or update operation.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Request object.
* @return WP_Error|object The prepared item, or WP_Error object on failure.
@@ -189,7 +175,6 @@ abstract class WP_REST_Controller {
* Prepares the item for the REST response.
*
* @since 4.7.0
* @access public
*
* @param mixed $item WordPress representation of the item.
* @param WP_REST_Request $request Request object.
@@ -203,7 +188,6 @@ abstract class WP_REST_Controller {
* Prepares a response for insertion into a collection.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Response $response Response object.
* @return array|mixed Response data, ready for insertion into collection data.
@@ -233,7 +217,6 @@ abstract class WP_REST_Controller {
* Filters a response based on the context defined in the schema.
*
* @since 4.7.0
* @access public
*
* @param array $data Response data to fiter.
* @param string $context Context defined in the schema.
@@ -275,7 +258,6 @@ abstract class WP_REST_Controller {
* Retrieves the item's schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema data.
*/
@@ -287,7 +269,6 @@ abstract class WP_REST_Controller {
* Retrieves the item's schema for display / public consumption purposes.
*
* @since 4.7.0
* @access public
*
* @return array Public item schema data.
*/
@@ -306,7 +287,6 @@ abstract class WP_REST_Controller {
* Retrieves the query params for the collections.
*
* @since 4.7.0
* @access public
*
* @return array Query parameters for the collection.
*/
@@ -345,7 +325,6 @@ abstract class WP_REST_Controller {
* Ensures consistent descriptions between endpoints, and populates enum from schema.
*
* @since 4.7.0
* @access public
*
* @param array $args Optional. Additional arguments for context parameter. Default empty array.
* @return array Context parameter details.
@@ -384,7 +363,6 @@ abstract class WP_REST_Controller {
* Adds the values from additional fields to a data object.
*
* @since 4.7.0
* @access protected
*
* @param array $object Data object.
* @param WP_REST_Request $request Full details about the request.
@@ -410,7 +388,6 @@ abstract class WP_REST_Controller {
* Updates the values of additional fields added to a data object.
*
* @since 4.7.0
* @access protected
*
* @param array $object Data Object.
* @param WP_REST_Request $request Full details about the request.
@@ -445,7 +422,6 @@ abstract class WP_REST_Controller {
* The type of object is inferred from the passed schema.
*
* @since 4.7.0
* @access protected
*
* @param array $schema Schema array.
* @return array Modified Schema array.
@@ -475,7 +451,6 @@ abstract class WP_REST_Controller {
* Retrieves all of the registered additional fields for a given object-type.
*
* @since 4.7.0
* @access protected
*
* @param string $object_type Optional. The object type.
* @return array Registered additional fields (if any), empty array if none or if the object type could
@@ -504,7 +479,6 @@ abstract class WP_REST_Controller {
* Retrieves the object type this controller is responsible for managing.
*
* @since 4.7.0
* @access protected
*
* @return string Object type for the controller.
*/
@@ -522,7 +496,6 @@ abstract class WP_REST_Controller {
* Retrieves an array of endpoint arguments from the item schema for the controller.
*
* @since 4.7.0
* @access public
*
* @param string $method Optional. HTTP method of the request. The arguments for `CREATABLE` requests are
* checked for required values and may fall-back to a given default, this is not done
@@ -584,7 +557,6 @@ abstract class WP_REST_Controller {
* Sanitizes the slug value.
*
* @since 4.7.0
* @access public
*
* @internal We can't use sanitize_title() directly, as the second
* parameter is the fallback title, which would end up being set to the

10
wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php
View File

@@ -20,7 +20,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Constructor.
*
* @since 4.7.0
* @access public
*/
public function __construct() {
$this->namespace = 'wp/v2';
@@ -31,7 +30,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Registers the routes for the objects of the controller.
*
* @since 4.7.0
* @access public
*
* @see register_rest_route()
*/
@@ -70,7 +68,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Checks whether a given request has permission to read post statuses.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|bool True if the request has read access, WP_Error object otherwise.
@@ -94,7 +91,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Retrieves all post statuses, depending on user context.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -122,7 +118,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Checks if a given request has access to read a post status.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|bool True if the request has read access for the item, WP_Error object otherwise.
@@ -147,7 +142,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Checks whether a given post status should be visible.
*
* @since 4.7.0
* @access protected
*
* @param object $status Post status.
* @return bool True if the post status is visible, otherwise false.
@@ -174,7 +168,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Retrieves a specific post status.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -195,7 +188,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Prepares a post status object for serialization.
*
* @since 4.7.0
* @access public
*
* @param stdClass $status Post status data.
* @param WP_REST_Request $request Full details about the request.
@@ -243,7 +235,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Retrieves the post status' schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema data.
*/
@@ -305,7 +296,6 @@ class WP_REST_Post_Statuses_Controller extends WP_REST_Controller {
* Retrieves the query params for collections.
*
* @since 4.7.0
* @access public
*
* @return array Collection parameters.
*/

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

@@ -20,7 +20,6 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller {
* Constructor.
*
* @since 4.7.0
* @access public
*/
public function __construct() {
$this->namespace = 'wp/v2';
@@ -31,7 +30,6 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller {
* Registers the routes for the objects of the controller.
*
* @since 4.7.0
* @access public
*
* @see register_rest_route()
*/
@@ -69,7 +67,6 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller {
* Checks whether a given request has permission to read types.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|true True if the request has read access, WP_Error object otherwise.
@@ -92,7 +89,6 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller {
* Retrieves all public post types.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -116,7 +112,6 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller {
* Retrieves a specific post type.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_Error|WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -145,7 +140,6 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller {
* Prepares a post type object for serialization.
*
* @since 4.7.0
* @access public
*
* @param stdClass $post_type Post type data.
* @param WP_REST_Request $request Full details about the request.
@@ -202,7 +196,6 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller {
* Retrieves the post type's schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema data.
*/
@@ -278,7 +271,6 @@ class WP_REST_Post_Types_Controller extends WP_REST_Controller {
* Retrieves the query params for collections.
*
* @since 4.7.0
* @access public
*
* @return array Collection parameters.
*/

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

@@ -20,7 +20,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Post type.
*
* @since 4.7.0
* @access protected
* @var string
*/
protected $post_type;
@@ -29,7 +28,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Instance of a post meta fields object.
*
* @since 4.7.0
* @access protected
* @var WP_REST_Post_Meta_Fields
*/
protected $meta;
@@ -38,7 +36,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Constructor.
*
* @since 4.7.0
* @access public
*
* @param string $post_type Post type.
*/
@@ -55,7 +52,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Registers the routes for the objects of the controller.
*
* @since 4.7.0
* @access public
*
* @see register_rest_route()
*/
@@ -126,7 +122,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks if a given request has access to read posts.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has read access, WP_Error object otherwise.
@@ -146,7 +141,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Retrieves a collection of posts.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -389,7 +383,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks if a given request has access to read a post.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return bool|WP_Error True if the request has read access for the item, WP_Error object otherwise.
@@ -430,7 +423,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* check in core with a filter.
*
* @since 4.7.0
* @access public
*
* @param WP_Post $post Post to check against.
* @param WP_REST_Request $request Request data to check.
@@ -460,7 +452,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Retrieves a single post.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -485,7 +476,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks if a given request has access to create a post.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has access to create items, WP_Error object otherwise.
@@ -520,7 +510,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Creates a single post.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -624,7 +613,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks if a given request has access to update a post.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has access to update the item, WP_Error object otherwise.
@@ -660,7 +648,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Updates a single post.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -748,7 +735,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks if a given request has access to delete a post.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has access to delete the item, WP_Error object otherwise.
@@ -770,7 +756,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Deletes a single post.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -860,7 +845,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* them for WP_Query.
*
* @since 4.7.0
* @access protected
*
* @param array $prepared_args Optional. Prepared WP_Query arguments. Default empty array.
* @param WP_REST_Request $request Optional. Full details about the request.
@@ -907,7 +891,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* modified date for single post output.
*
* @since 4.7.0
* @access protected
*
* @param string $date_gmt GMT publication time.
* @param string|null $date Optional. Local publication time. Default null.
@@ -932,7 +915,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Prepares a single post for create or update.
*
* @since 4.7.0
* @access protected
*
* @param WP_REST_Request $request Request object.
* @return stdClass|WP_Error Post object or WP_Error.
@@ -1106,7 +1088,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Determines validity and normalizes the given status parameter.
*
* @since 4.7.0
* @access protected
*
* @param string $post_status Post status.
* @param object $post_type Post type.
@@ -1143,7 +1124,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Determines the featured media based on a request param.
*
* @since 4.7.0
* @access protected
*
* @param int $featured_media Featured Media ID.
* @param int $post_id Post ID.
@@ -1169,7 +1149,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Sets the template for a post.
*
* @since 4.7.0
* @access public
*
* @param string $template Page template filename.
* @param integer $post_id Post ID.
@@ -1186,7 +1165,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Updates the post's terms from a REST request.
*
* @since 4.7.0
* @access protected
*
* @param int $post_id The post ID to update the terms form.
* @param WP_REST_Request $request The request object with post and terms data.
@@ -1214,7 +1192,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks whether current user can assign all terms sent with the current request.
*
* @since 4.7.0
* @access protected
*
* @param WP_REST_Request $request The request object with post and terms data.
* @return bool Whether the current user can assign the provided terms.
@@ -1247,7 +1224,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks if a given post type can be viewed or managed.
*
* @since 4.7.0
* @access protected
*
* @param object|string $post_type Post type name or object.
* @return bool Whether the post type is allowed in REST.
@@ -1270,7 +1246,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Correctly handles posts with the inherit status.
*
* @since 4.7.0
* @access public
*
* @param object $post Post object.
* @return bool Whether the post can be read.
@@ -1314,7 +1289,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks if a post can be edited.
*
* @since 4.7.0
* @access protected
*
* @param object $post Post object.
* @return bool Whether the post can be edited.
@@ -1333,7 +1307,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks if a post can be created.
*
* @since 4.7.0
* @access protected
*
* @param object $post Post object.
* @return bool Whether the post can be created.
@@ -1352,7 +1325,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Checks if a post can be deleted.
*
* @since 4.7.0
* @access protected
*
* @param object $post Post object.
* @return bool Whether the post can be deleted.
@@ -1371,7 +1343,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Prepares a single post output for response.
*
* @since 4.7.0
* @access public
*
* @param WP_Post $post Post object.
* @param WP_REST_Request $request Request object.
@@ -1588,7 +1559,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* in a machine readable format, we remove the "Protected: " prefix.
*
* @since 4.7.0
* @access public
*
* @return string Protected title format.
*/
@@ -1600,7 +1570,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Prepares links for the request.
*
* @since 4.7.0
* @access protected
*
* @param WP_Post $post Post object.
* @return array Links for the given post.
@@ -1709,7 +1678,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Retrieves the post's schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema data.
*/
@@ -2048,7 +2016,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* Retrieves the query params for the posts collection.
*
* @since 4.7.0
* @access public
*
* @return array Collection parameters.
*/
@@ -2243,7 +2210,6 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
* user can query private statuses.
*
* @since 4.7.0
* @access public
*
* @param string|array $statuses One or more post statuses.
* @param WP_REST_Request $request Full details about the request.

16
wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php
View File

@@ -20,7 +20,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Parent post type.
*
* @since 4.7.0
* @access private
* @var string
*/
private $parent_post_type;
@@ -29,7 +28,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Parent controller.
*
* @since 4.7.0
* @access private
* @var WP_REST_Controller
*/
private $parent_controller;
@@ -38,7 +36,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* The base of the parent controller's route.
*
* @since 4.7.0
* @access private
* @var string
*/
private $parent_base;
@@ -47,7 +44,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Constructor.
*
* @since 4.7.0
* @access public
*
* @param string $parent_post_type Post type of the parent.
*/
@@ -64,7 +60,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Registers routes for revisions based on post types supporting revisions.
*
* @since 4.7.0
* @access public
*
* @see register_rest_route()
*/
@@ -148,7 +143,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Checks if a given request has access to get revisions.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return true|WP_Error True if the request has read access, WP_Error object otherwise.
@@ -193,7 +187,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Gets a collection of revisions.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -218,7 +211,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Checks if a given request has access to get a specific revision.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return bool|WP_Error True if the request has read access for the item, WP_Error object otherwise.
@@ -231,7 +223,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Retrieves one revision from the collection.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full data about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -255,7 +246,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Checks if a given request has access to delete a revision.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return bool|WP_Error True if the request has access to delete the item, WP_Error object otherwise.
@@ -284,7 +274,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Deletes a single revision.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True on success, or WP_Error object on failure.
@@ -331,7 +320,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Prepares the revision for the REST response.
*
* @since 4.7.0
* @access public
*
* @param WP_Post $post Post revision object.
* @param WP_REST_Request $request Request object.
@@ -437,7 +425,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* modified date for single post output.
*
* @since 4.7.0
* @access protected
*
* @param string $date_gmt GMT publication time.
* @param string|null $date Optional. Local publication time. Default null.
@@ -459,7 +446,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Retrieves the revision's schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema data.
*/
@@ -547,7 +533,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Retrieves the query params for collections.
*
* @since 4.7.0
* @access public
*
* @return array Collection parameters.
*/
@@ -561,7 +546,6 @@ class WP_REST_Revisions_Controller extends WP_REST_Controller {
* Checks the post excerpt and prepare it for single post output.
*
* @since 4.7.0
* @access protected
*
* @param string $excerpt The post excerpt.
* @param WP_Post $post Post revision object.

9
wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php
View File

@@ -20,7 +20,6 @@ class WP_REST_Settings_Controller extends WP_REST_Controller {
* Constructor.
*
* @since 4.7.0
* @access public
*/
public function __construct() {
$this->namespace = 'wp/v2';
@@ -31,7 +30,6 @@ class WP_REST_Settings_Controller extends WP_REST_Controller {
* Registers the routes for the objects of the controller.
*
* @since 4.7.0
* @access public
*
* @see register_rest_route()
*/
@@ -59,7 +57,6 @@ class WP_REST_Settings_Controller extends WP_REST_Controller {
* Checks if a given request has access to read and manage settings.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return bool True if the request has read access for the item, otherwise false.
@@ -72,7 +69,6 @@ class WP_REST_Settings_Controller extends WP_REST_Controller {
* Retrieves the settings.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return array|WP_Error Array on success, or WP_Error object on failure.
@@ -117,7 +113,6 @@ class WP_REST_Settings_Controller extends WP_REST_Controller {
* Prepares a value for output based off a schema array.
*
* @since 4.7.0
* @access protected
*
* @param mixed $value Value to prepare.
* @param array $schema Schema to match.
@@ -147,7 +142,6 @@ class WP_REST_Settings_Controller extends WP_REST_Controller {
* Updates settings for the settings object.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return array|WP_Error Array on success, or error object on failure.
@@ -217,7 +211,6 @@ class WP_REST_Settings_Controller extends WP_REST_Controller {
* Retrieves all of the registered options for the Settings API.
*
* @since 4.7.0
* @access protected
*
* @return array Array of registered options.
*/
@@ -274,7 +267,6 @@ class WP_REST_Settings_Controller extends WP_REST_Controller {
* Retrieves the site setting schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema data.
*/
@@ -306,7 +298,6 @@ class WP_REST_Settings_Controller extends WP_REST_Controller {
* provide a wrapper sanitizer to whitelist the use of `null`.
*
* @since 4.7.0
* @access public
*
* @param mixed $value The value for the setting.
* @param WP_REST_Request $request The request object.

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

@@ -20,7 +20,6 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
* Constructor.
*
* @since 4.7.0
* @access public
*/
public function __construct() {
$this->namespace = 'wp/v2';
@@ -31,7 +30,6 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
* Registers the routes for the objects of the controller.
*
* @since 4.7.0
* @access public
*
* @see register_rest_route()
*/
@@ -70,7 +68,6 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
* Checks whether a given request has permission to read taxonomies.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has read access, WP_Error object otherwise.
@@ -96,7 +93,6 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
* Retrieves all public taxonomies.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response Response object on success, or WP_Error object on failure.
@@ -133,7 +129,6 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
* Checks if a given request has access to a taxonomy.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has read access for the item, otherwise false or WP_Error object.
@@ -158,7 +153,6 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
* Retrieves a specific taxonomy.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -176,7 +170,6 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
* Prepares a taxonomy object for serialization.
*
* @since 4.7.0
* @access public
*
* @param stdClass $taxonomy Taxonomy data.
* @param WP_REST_Request $request Full details about the request.
@@ -230,7 +223,6 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
* Retrieves the taxonomy's schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema data.
*/
@@ -306,7 +298,6 @@ class WP_REST_Taxonomies_Controller extends WP_REST_Controller {
* Retrieves the query params for collections.
*
* @since 4.7.0
* @access public
*
* @return array Collection parameters.
*/

22
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php
View File

@@ -20,7 +20,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Taxonomy key.
*
* @since 4.7.0
* @access protected
* @var string
*/
protected $taxonomy;
@@ -29,7 +28,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Instance of a term meta fields object.
*
* @since 4.7.0
* @access protected
* @var WP_REST_Term_Meta_Fields
*/
protected $meta;
@@ -38,7 +36,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Column to have the terms be sorted by.
*
* @since 4.7.0
* @access protected
* @var string
*/
protected $sort_column;
@@ -47,7 +44,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Number of terms that were found.
*
* @since 4.7.0
* @access protected
* @var int
*/
protected $total_terms;
@@ -56,7 +52,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Constructor.
*
* @since 4.7.0
* @access public
*
* @param string $taxonomy Taxonomy key.
*/
@@ -73,7 +68,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Registers the routes for the objects of the controller.
*
* @since 4.7.0
* @access public
*
* @see register_rest_route()
*/
@@ -136,7 +130,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Checks if a request has access to read terms in the specified taxonomy.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return bool|WP_Error True if the request has read access, otherwise false or WP_Error object.
@@ -156,7 +149,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Retrieves terms associated with a taxonomy.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -324,7 +316,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Checks if a request has access to read or edit the specified term.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return bool|WP_Error True if the request has read access for the item, otherwise false or WP_Error object.
@@ -345,7 +336,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Gets a single term from a taxonomy.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -365,7 +355,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Checks if a request has access to create a term.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return bool|WP_Error True if the request has access to create items, false or WP_Error object otherwise.
@@ -388,7 +377,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Creates a single term in a taxonomy.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -467,7 +455,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Checks if a request has access to update the specified term.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return bool|WP_Error True if the request has access to update the item, false or WP_Error object otherwise.
@@ -489,7 +476,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Updates a single term from a taxonomy.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -554,7 +540,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Checks if a request has access to delete the specified term.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return bool|WP_Error True if the request has access to delete the item, otherwise false or WP_Error object.
@@ -576,7 +561,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Deletes a single term from a taxonomy.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -627,7 +611,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Prepares a single term for create or update.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Request object.
* @return object $prepared_term Term object.
@@ -680,7 +663,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Prepares a single term output for response.
*
* @since 4.7.0
* @access public
*
* @param obj $item Term object.
* @param WP_REST_Request $request Request object.
@@ -755,7 +737,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Prepares links for the request.
*
* @since 4.7.0
* @access protected
*
* @param object $term Term object.
* @return array Links for the given term.
@@ -817,7 +798,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Retrieves the term's schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema data.
*/
@@ -897,7 +877,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Retrieves the query params for collections.
*
* @since 4.7.0
* @access public
*
* @return array Collection parameters.
*/
@@ -1006,7 +985,6 @@ class WP_REST_Terms_Controller extends WP_REST_Controller {
* Checks that the taxonomy is valid.
*
* @since 4.7.0
* @access protected
*
* @param string $taxonomy Taxonomy to check.
* @return bool Whether the taxonomy is allowed for REST management.

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

@@ -20,7 +20,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Instance of a user meta fields object.
*
* @since 4.7.0
* @access protected
* @var WP_REST_User_Meta_Fields
*/
protected $meta;
@@ -29,7 +28,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Constructor.
*
* @since 4.7.0
* @access public
*/
public function __construct() {
$this->namespace = 'wp/v2';
@@ -42,7 +40,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Registers the routes for the objects of the controller.
*
* @since 4.7.0
* @access public
*
* @see register_rest_route()
*/
@@ -148,7 +145,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* The value can be an integer, 'false', false, or ''.
*
* @since 4.7.0
* @access public
*
* @param int|bool $value The value passed to the reassign parameter.
* @param WP_REST_Request $request Full details about the request.
@@ -172,7 +168,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Permissions check for getting all users.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has read access, otherwise WP_Error object.
@@ -198,7 +193,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Retrieves all users.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -357,7 +351,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Checks if a given request has access to read a user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has read access for the item, otherwise WP_Error object.
@@ -387,7 +380,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Retrieves a single user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -408,7 +400,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Retrieves the current user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -432,7 +423,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Checks if a given request has access create users.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has access to create items, WP_Error object otherwise.
@@ -450,7 +440,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Creates a single user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -559,7 +548,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Checks if a given request has access to update a user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has access to update the item, WP_Error object otherwise.
@@ -585,7 +573,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Updates a single user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -671,7 +658,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Checks if a given request has access to update the current user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has access to update the item, WP_Error object otherwise.
@@ -686,7 +672,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Updates the current user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -701,7 +686,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Checks if a given request has access delete a user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has access to delete the item, WP_Error object otherwise.
@@ -723,7 +707,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Deletes a single user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -787,7 +770,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Checks if a given request has access to delete the current user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return true|WP_Error True if the request has access to delete the item, WP_Error object otherwise.
@@ -802,7 +784,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Deletes the current user.
*
* @since 4.7.0
* @access public
*
* @param WP_REST_Request $request Full details about the request.
* @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
@@ -817,7 +798,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Prepares a single user output for response.
*
* @since 4.7.0
* @access public
*
* @param WP_User $user User object.
* @param WP_REST_Request $request Request object.
@@ -927,7 +907,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Prepares links for the user request.
*
* @since 4.7.0
* @access protected
*
* @param WP_Post $user User object.
* @return array Links for the given user.
@@ -949,7 +928,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Prepares a single user for creation or update.
*
* @since 4.7.0
* @access protected
*
* @param WP_REST_Request $request Request object.
* @return object $prepared_user User object.
@@ -1029,7 +1007,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Determines if the current user is allowed to make the desired roles change.
*
* @since 4.7.0
* @access protected
*
* @param integer $user_id User ID.
* @param array $roles New user roles.
@@ -1080,7 +1057,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Performs a couple of checks like edit_user() in wp-admin/includes/user.php.
*
* @since 4.7.0
* @access public
*
* @param mixed $value The username submitted in the request.
* @param WP_REST_Request $request Full details about the request.
@@ -1110,7 +1086,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Performs a couple of checks like edit_user() in wp-admin/includes/user.php.
*
* @since 4.7.0
* @access public
*
* @param mixed $value The password submitted in the request.
* @param WP_REST_Request $request Full details about the request.
@@ -1135,7 +1110,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Retrieves the user's schema, conforming to JSON Schema.
*
* @since 4.7.0
* @access public
*
* @return array Item schema data.
*/
@@ -1303,7 +1277,6 @@ class WP_REST_Users_Controller extends WP_REST_Controller {
* Retrieves the query params for collections.
*
* @since 4.7.0
* @access public
*
* @return array Collection parameters.
*/