WordPress-C
/
WordPress
mirror of https://github.com/WordPress/WordPress.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
wp-includes/cache.php
View File

@ -291,7 +291,6 @@ class WP_Object_Cache {
* Holds the cached objects. * Holds the cached objects.
* *
* @since 2.0.0 * @since 2.0.0
* @access private
* @var array * @var array
*/ */
private $cache = array(); private $cache = array();
@ -300,7 +299,6 @@ class WP_Object_Cache {
* The amount of times the cache data was already stored in the cache. * The amount of times the cache data was already stored in the cache.
* *
* @since 2.5.0 * @since 2.5.0
* @access public
* @var int * @var int
*/ */
public $cache_hits = 0; public $cache_hits = 0;
@ -309,7 +307,6 @@ class WP_Object_Cache {
* Amount of times the cache did not have the request in cache. * Amount of times the cache did not have the request in cache.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var int * @var int
*/ */
public $cache_misses = 0; public $cache_misses = 0;
@ -318,7 +315,6 @@ class WP_Object_Cache {
* List of global cache groups. * List of global cache groups.
* *
* @since 3.0.0 * @since 3.0.0
* @access protected
* @var array * @var array
*/ */
protected $global_groups = array(); protected $global_groups = array();
@ -327,7 +323,6 @@ class WP_Object_Cache {
* The blog prefix to prepend to keys in non-global groups. * The blog prefix to prepend to keys in non-global groups.
* *
* @since 3.5.0 * @since 3.5.0
* @access private
* @var int * @var int
*/ */
private $blog_prefix; private $blog_prefix;
@ -336,7 +331,6 @@ class WP_Object_Cache {
* Holds the value of is_multisite(). * Holds the value of is_multisite().
* *
* @since 3.5.0 * @since 3.5.0
* @access private
* @var bool * @var bool
*/ */
private $multisite; private $multisite;
@ -345,7 +339,6 @@ class WP_Object_Cache {
* Makes private properties readable for backward compatibility. * Makes private properties readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to get. * @param string $name Property to get.
* @return mixed Property. * @return mixed Property.
@ -358,7 +351,6 @@ class WP_Object_Cache {
* Makes private properties settable for backward compatibility. * Makes private properties settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to set. * @param string $name Property to set.
* @param mixed $value Property value. * @param mixed $value Property value.
@ -372,7 +364,6 @@ class WP_Object_Cache {
* Makes private properties checkable for backward compatibility. * Makes private properties checkable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to check if set. * @param string $name Property to check if set.
* @return bool Whether the property is set. * @return bool Whether the property is set.
@ -385,7 +376,6 @@ class WP_Object_Cache {
* Makes private properties un-settable for backward compatibility. * Makes private properties un-settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to unset. * @param string $name Property to unset.
*/ */
@ -397,7 +387,6 @@ class WP_Object_Cache {
* Adds data to the cache if it doesn't already exist. * Adds data to the cache if it doesn't already exist.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @uses WP_Object_Cache::_exists() Checks to see if the cache already has data. * @uses WP_Object_Cache::_exists() Checks to see if the cache already has data.
* @uses WP_Object_Cache::set() Sets the data after the checking the cache * @uses WP_Object_Cache::set() Sets the data after the checking the cache
@ -430,7 +419,6 @@ class WP_Object_Cache {
* Sets the list of global cache groups. * Sets the list of global cache groups.
* *
* @since 3.0.0 * @since 3.0.0
* @access public
* *
* @param array $groups List of groups that are global. * @param array $groups List of groups that are global.
*/ */
@ -445,7 +433,6 @@ class WP_Object_Cache {
* Decrements numeric cache item's value. * Decrements numeric cache item's value.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* *
* @param int|string $key The cache key to decrement. * @param int|string $key The cache key to decrement.
* @param int $offset Optional. The amount by which to decrement the item's value. Default 1. * @param int $offset Optional. The amount by which to decrement the item's value. Default 1.
@ -481,7 +468,6 @@ class WP_Object_Cache {
* If the cache key does not exist in the group, then nothing will happen. * If the cache key does not exist in the group, then nothing will happen.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param int|string $key What the contents in the cache are called. * @param int|string $key What the contents in the cache are called.
* @param string $group Optional. Where the cache contents are grouped. Default 'default'. * @param string $group Optional. Where the cache contents are grouped. Default 'default'.
@ -506,7 +492,6 @@ class WP_Object_Cache {
* Clears the object cache of all data. * Clears the object cache of all data.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @return true Always returns true. * @return true Always returns true.
*/ */
@ -526,7 +511,6 @@ class WP_Object_Cache {
* On failure, the number of cache misses will be incremented. * On failure, the number of cache misses will be incremented.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param int|string $key What the contents in the cache are called. * @param int|string $key What the contents in the cache are called.
* @param string $group Optional. Where the cache contents are grouped. Default 'default'. * @param string $group Optional. Where the cache contents are grouped. Default 'default'.
@ -561,7 +545,6 @@ class WP_Object_Cache {
* Increments numeric cache item's value. * Increments numeric cache item's value.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* *
* @param int|string $key The cache key to increment * @param int|string $key The cache key to increment
* @param int $offset Optional. The amount by which to increment the item's value. Default 1. * @param int $offset Optional. The amount by which to increment the item's value. Default 1.
@ -595,7 +578,6 @@ class WP_Object_Cache {
* Replaces the contents in the cache, if contents already exist. * Replaces the contents in the cache, if contents already exist.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @see WP_Object_Cache::set() * @see WP_Object_Cache::set()
* *
@ -623,7 +605,6 @@ class WP_Object_Cache {
* Resets cache keys. * Resets cache keys.
* *
* @since 3.0.0 * @since 3.0.0
* @access public
* *
* @deprecated 3.5.0 Use switch_to_blog() * @deprecated 3.5.0 Use switch_to_blog()
* @see switch_to_blog() * @see switch_to_blog()
@ -651,7 +632,6 @@ class WP_Object_Cache {
* more for cache plugins which use files. * more for cache plugins which use files.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param int|string $key What to call the contents in the cache. * @param int|string $key What to call the contents in the cache.
* @param mixed $data The contents to store in the cache. * @param mixed $data The contents to store in the cache.
@ -680,7 +660,6 @@ class WP_Object_Cache {
* key and the data. * key and the data.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
*/ */
public function stats() { public function stats() {
echo "<p>"; echo "<p>";
@ -700,7 +679,6 @@ class WP_Object_Cache {
* This changes the blog ID used to create keys in blog specific groups. * This changes the blog ID used to create keys in blog specific groups.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param int $blog_id Blog ID. * @param int $blog_id Blog ID.
*/ */
@ -713,7 +691,6 @@ class WP_Object_Cache {
* Serves as a utility function to determine whether a key exists in the cache. * Serves as a utility function to determine whether a key exists in the cache.
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* *
* @param int|string $key Cache key to check for existence. * @param int|string $key Cache key to check for existence.
* @param string $group Cache group for the key existence check. * @param string $group Cache group for the key existence check.

17
wp-includes/class-http.php
View File

@ -98,7 +98,6 @@ class WP_Http {
* Please note: The only URI that are supported in the HTTP Transport implementation * Please note: The only URI that are supported in the HTTP Transport implementation
* are the HTTP and HTTPS protocols. * are the HTTP and HTTPS protocols.
* *
* @access public
* @since 2.7.0 * @since 2.7.0
* *
* @param string $url The request URL. * @param string $url The request URL.
@ -428,7 +427,6 @@ class WP_Http {
* Normalizes cookies for using in Requests. * Normalizes cookies for using in Requests.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @static * @static
* *
* @param array $cookies List of cookies to send with the request. * @param array $cookies List of cookies to send with the request.
@ -456,7 +454,6 @@ class WP_Http {
* specification for compatibility purposes. * specification for compatibility purposes.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @static * @static
* *
* @param string $location URL to redirect to. * @param string $location URL to redirect to.
@ -489,7 +486,6 @@ class WP_Http {
* Tests which transports are capable of supporting the request. * Tests which transports are capable of supporting the request.
* *
* @since 3.2.0 * @since 3.2.0
* @access public
* *
* @param array $args Request arguments * @param array $args Request arguments
* @param string $url URL to Request * @param string $url URL to Request
@ -539,7 +535,6 @@ class WP_Http {
* @since 3.2.0 * @since 3.2.0
* *
* @static * @static
* @access private
* *
* @param string $url URL to Request * @param string $url URL to Request
* @param array $args Request arguments * @param array $args Request arguments
@ -581,7 +576,6 @@ class WP_Http {
* *
* Used for sending data that is expected to be in the body. * Used for sending data that is expected to be in the body.
* *
* @access public
* @since 2.7.0 * @since 2.7.0
* *
* @param string $url The request URL. * @param string $url The request URL.
@ -599,7 +593,6 @@ class WP_Http {
* *
* Used for sending data that is expected to be in the body. * Used for sending data that is expected to be in the body.
* *
* @access public
* @since 2.7.0 * @since 2.7.0
* *
* @param string $url The request URL. * @param string $url The request URL.
@ -617,7 +610,6 @@ class WP_Http {
* *
* Used for sending data that is expected to be in the body. * Used for sending data that is expected to be in the body.
* *
* @access public
* @since 2.7.0 * @since 2.7.0
* *
* @param string $url The request URL. * @param string $url The request URL.
@ -633,7 +625,6 @@ class WP_Http {
/** /**
* Parses the responses and splits the parts into headers and body. * Parses the responses and splits the parts into headers and body.
* *
* @access public
* @static * @static
* @since 2.7.0 * @since 2.7.0
* *
@ -652,7 +643,6 @@ class WP_Http {
* If an array is given then it is assumed to be raw header data with numeric keys with the * If an array is given then it is assumed to be raw header data with numeric keys with the
* headers as the values. No headers must be passed that were already processed. * headers as the values. No headers must be passed that were already processed.
* *
* @access public
* @static * @static
* @since 2.7.0 * @since 2.7.0
* *
@ -730,7 +720,6 @@ class WP_Http {
* which are each parsed into strings and added to the Cookie: header (within the arguments array). * which are each parsed into strings and added to the Cookie: header (within the arguments array).
* Edits the array by reference. * Edits the array by reference.
* *
* @access public
* @since 2.8.0 * @since 2.8.0
* @static * @static
* *
@ -761,7 +750,6 @@ class WP_Http {
* *
* @link https://tools.ietf.org/html/rfc2616#section-19.4.6 Process for chunked decoding. * @link https://tools.ietf.org/html/rfc2616#section-19.4.6 Process for chunked decoding.
* *
* @access public
* @since 2.7.0 * @since 2.7.0
* @static * @static
* *
@ -811,7 +799,6 @@ class WP_Http {
* are supported, eg *.wordpress.org will allow for all subdomains of wordpress.org to be contacted. * are supported, eg *.wordpress.org will allow for all subdomains of wordpress.org to be contacted.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @link https://core.trac.wordpress.org/ticket/8927 Allow preventing external requests. * @link https://core.trac.wordpress.org/ticket/8927 Allow preventing external requests.
* @link https://core.trac.wordpress.org/ticket/14636 Allow wildcard domains in WP_ACCESSIBLE_HOSTS * @link https://core.trac.wordpress.org/ticket/14636 Allow wildcard domains in WP_ACCESSIBLE_HOSTS
* *
@ -871,7 +858,6 @@ class WP_Http {
/** /**
* Used as a wrapper for PHP's parse_url() function that handles edgecases in < PHP 5.4.7. * Used as a wrapper for PHP's parse_url() function that handles edgecases in < PHP 5.4.7.
* *
* @access protected
* @deprecated 4.4.0 Use wp_parse_url() * @deprecated 4.4.0 Use wp_parse_url()
* @see wp_parse_url() * @see wp_parse_url()
* *
@ -892,7 +878,6 @@ class WP_Http {
* @since 3.4.0 * @since 3.4.0
* *
* @static * @static
* @access public
* *
* @param string $maybe_relative_path The URL which might be relative * @param string $maybe_relative_path The URL which might be relative
* @param string $url The URL which $maybe_relative_path is relative to * @param string $url The URL which $maybe_relative_path is relative to
@ -963,7 +948,6 @@ class WP_Http {
* Handles HTTP Redirects and follows them if appropriate. * Handles HTTP Redirects and follows them if appropriate.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* @static * @static
* *
* @param string $url The URL which was requested. * @param string $url The URL which was requested.
@ -1020,7 +1004,6 @@ class WP_Http {
* @link http://home.deds.nl/~aeron/regex/ for IPv6 regex * @link http://home.deds.nl/~aeron/regex/ for IPv6 regex
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* @static * @static
* *
* @param string $maybe_ip A suspected IP address * @param string $maybe_ip A suspected IP address

18
wp-includes/class-oembed.php
View File

@ -22,7 +22,6 @@ class WP_oEmbed {
* A list of oEmbed providers. * A list of oEmbed providers.
* *
* @since 2.9.0 * @since 2.9.0
* @access public
* @var array * @var array
*/ */
public $providers = array(); public $providers = array();
@ -31,7 +30,6 @@ class WP_oEmbed {
* A list of an early oEmbed providers. * A list of an early oEmbed providers.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @static * @static
* @var array * @var array
*/ */
@ -41,7 +39,6 @@ class WP_oEmbed {
* A list of private/protected methods, used for backward compatibility. * A list of private/protected methods, used for backward compatibility.
* *
* @since 4.2.0 * @since 4.2.0
* @access private
* @var array * @var array
*/ */
private $compat_methods = array( '_fetch_with_format', '_parse_json', '_parse_xml', '_parse_xml_body' ); private $compat_methods = array( '_fetch_with_format', '_parse_json', '_parse_xml', '_parse_xml_body' );
@ -50,7 +47,6 @@ class WP_oEmbed {
* Constructor. * Constructor.
* *
* @since 2.9.0 * @since 2.9.0
* @access public
*/ */
public function __construct() { public function __construct() {
$host = urlencode( home_url() ); $host = urlencode( home_url() );
@ -211,7 +207,6 @@ class WP_oEmbed {
* Exposes private/protected methods for backward compatibility. * Exposes private/protected methods for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param callable $name Method to call. * @param callable $name Method to call.
* @param array $arguments Arguments to pass when calling. * @param array $arguments Arguments to pass when calling.
@ -228,7 +223,6 @@ class WP_oEmbed {
* Takes a URL and returns the corresponding oEmbed provider's URL, if there is one. * Takes a URL and returns the corresponding oEmbed provider's URL, if there is one.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @see WP_oEmbed::discover() * @see WP_oEmbed::discover()
* *
@ -275,7 +269,6 @@ class WP_oEmbed {
* *
* @static * @static
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @see wp_oembed_add_provider() * @see wp_oembed_add_provider()
* *
@ -302,7 +295,6 @@ class WP_oEmbed {
* The just-in-time removal is for the benefit of the {@see 'oembed_providers'} filter. * The just-in-time removal is for the benefit of the {@see 'oembed_providers'} filter.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @static * @static
* *
* @see wp_oembed_remove_provider() * @see wp_oembed_remove_provider()
@ -324,7 +316,6 @@ class WP_oEmbed {
* @see WP_oEmbed::fetch() * @see WP_oEmbed::fetch()
* *
* @since 4.8.0 * @since 4.8.0
* @access public
* *
* @param string $url The URL to the content that should be attempted to be embedded. * @param string $url The URL to the content that should be attempted to be embedded.
* @param array|string $args Optional. Arguments, usually passed from a shortcode. Default empty. * @param array|string $args Optional. Arguments, usually passed from a shortcode. Default empty.
@ -355,7 +346,6 @@ class WP_oEmbed {
* @see WP_oEmbed::data2html() * @see WP_oEmbed::data2html()
* *
* @since 2.9.0 * @since 2.9.0
* @access public
* *
* @param string $url The URL to the content that should be attempted to be embedded. * @param string $url The URL to the content that should be attempted to be embedded.
* @param array|string $args Optional. Arguments, usually passed from a shortcode. Default empty. * @param array|string $args Optional. Arguments, usually passed from a shortcode. Default empty.
@ -405,7 +395,6 @@ class WP_oEmbed {
* Attempts to discover link tags at the given URL for an oEmbed provider. * Attempts to discover link tags at the given URL for an oEmbed provider.
* *
* @since 2.9.0 * @since 2.9.0
* @access public
* *
* @param string $url The URL that should be inspected for discovery `<link>` tags. * @param string $url The URL that should be inspected for discovery `<link>` tags.
* @return false|string False on failure, otherwise the oEmbed provider URL. * @return false|string False on failure, otherwise the oEmbed provider URL.
@ -489,7 +478,6 @@ class WP_oEmbed {
* Connects to a oEmbed provider and returns the result. * Connects to a oEmbed provider and returns the result.
* *
* @since 2.9.0 * @since 2.9.0
* @access public
* *
* @param string $provider The URL to the oEmbed provider. * @param string $provider The URL to the oEmbed provider.
* @param string $url The URL to the content that is desired to be embedded. * @param string $url The URL to the content that is desired to be embedded.
@ -527,7 +515,6 @@ class WP_oEmbed {
* Fetches result from an oEmbed provider for a specific format and complete provider URL * Fetches result from an oEmbed provider for a specific format and complete provider URL
* *
* @since 3.0.0 * @since 3.0.0
* @access private
* *
* @param string $provider_url_with_args URL to the provider with full arguments list (url, maxheight, etc.) * @param string $provider_url_with_args URL to the provider with full arguments list (url, maxheight, etc.)
* @param string $format Format to use * @param string $format Format to use
@ -552,7 +539,6 @@ class WP_oEmbed {
* Parses a json response body. * Parses a json response body.
* *
* @since 3.0.0 * @since 3.0.0
* @access private
* *
* @param string $response_body * @param string $response_body
* @return object|false * @return object|false
@ -566,7 +552,6 @@ class WP_oEmbed {
* Parses an XML response body. * Parses an XML response body.
* *
* @since 3.0.0 * @since 3.0.0
* @access private
* *
* @param string $response_body * @param string $response_body
* @return object|false * @return object|false
@ -590,7 +575,6 @@ class WP_oEmbed {
* Serves as a helper function for parsing an XML response body. * Serves as a helper function for parsing an XML response body.
* *
* @since 3.6.0 * @since 3.6.0
* @access private
* *
* @param string $response_body * @param string $response_body
* @return stdClass|false * @return stdClass|false
@ -628,7 +612,6 @@ class WP_oEmbed {
* Converts a data object from WP_oEmbed::fetch() and returns the HTML. * Converts a data object from WP_oEmbed::fetch() and returns the HTML.
* *
* @since 2.9.0 * @since 2.9.0
* @access public
* *
* @param object $data A data object result from an oEmbed provider. * @param object $data A data object result from an oEmbed provider.
* @param string $url The URL to the content that is desired to be embedded. * @param string $url The URL to the content that is desired to be embedded.
@ -685,7 +668,6 @@ class WP_oEmbed {
* *
* @since 2.9.0 as strip_scribd_newlines() * @since 2.9.0 as strip_scribd_newlines()
* @since 3.0.0 * @since 3.0.0
* @access public
* *
* @param string $html Existing HTML. * @param string $html Existing HTML.
* @param object $data Data object from WP_oEmbed::data2html() * @param object $data Data object from WP_oEmbed::data2html()

3
wp-includes/class-walker-category-dropdown.php
View File

@ -20,7 +20,6 @@ class Walker_CategoryDropdown extends Walker {
* What the class handles. * What the class handles.
* *
* @since 2.1.0 * @since 2.1.0
* @access private
* @var string * @var string
* *
* @see Walker::$tree_type * @see Walker::$tree_type
@ -31,7 +30,6 @@ class Walker_CategoryDropdown extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @todo Decouple this * @todo Decouple this
* @var array * @var array
* *
@ -43,7 +41,6 @@ class Walker_CategoryDropdown extends Walker {
* Starts the element output. * Starts the element output.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see Walker::start_el() * @see Walker::start_el()
* *

6
wp-includes/class-walker-category.php
View File

@ -20,7 +20,6 @@ class Walker_Category extends Walker {
* What the class handles. * What the class handles.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var string * @var string
* *
* @see Walker::$tree_type * @see Walker::$tree_type
@ -31,7 +30,6 @@ class Walker_Category extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var array * @var array
* *
* @see Walker::$db_fields * @see Walker::$db_fields
@ -43,7 +41,6 @@ class Walker_Category extends Walker {
* Starts the list before the elements are added. * Starts the list before the elements are added.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see Walker::start_lvl() * @see Walker::start_lvl()
* *
@ -64,7 +61,6 @@ class Walker_Category extends Walker {
* Ends the list of after the elements are added. * Ends the list of after the elements are added.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see Walker::end_lvl() * @see Walker::end_lvl()
* *
@ -85,7 +81,6 @@ class Walker_Category extends Walker {
* Starts the element output. * Starts the element output.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see Walker::start_el() * @see Walker::start_el()
* *
@ -215,7 +210,6 @@ class Walker_Category extends Walker {
* Ends the element output, if needed. * Ends the element output, if needed.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see Walker::end_el() * @see Walker::end_el()
* *

10
wp-includes/class-walker-comment.php
View File

@ -20,7 +20,6 @@ class Walker_Comment extends Walker {
* What the class handles. * What the class handles.
* *
* @since 2.7.0 * @since 2.7.0
* @access public
* @var string * @var string
* *
* @see Walker::$tree_type * @see Walker::$tree_type
@ -31,7 +30,6 @@ class Walker_Comment extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 2.7.0 * @since 2.7.0
* @access public
* @var array * @var array
* *
* @see Walker::$db_fields * @see Walker::$db_fields
@ -43,7 +41,6 @@ class Walker_Comment extends Walker {
* Starts the list before the elements are added. * Starts the list before the elements are added.
* *
* @since 2.7.0 * @since 2.7.0
* @access public
* *
* @see Walker::start_lvl() * @see Walker::start_lvl()
* @global int $comment_depth * @global int $comment_depth
@ -72,7 +69,6 @@ class Walker_Comment extends Walker {
* Ends the list of items after the elements are added. * Ends the list of items after the elements are added.
* *
* @since 2.7.0 * @since 2.7.0
* @access public
* *
* @see Walker::end_lvl() * @see Walker::end_lvl()
* @global int $comment_depth * @global int $comment_depth
@ -118,7 +114,6 @@ class Walker_Comment extends Walker {
* 2.2 * 2.2
* *
* @since 2.7.0 * @since 2.7.0
* @access public
* *
* @see Walker::display_element() * @see Walker::display_element()
* @see wp_list_comments() * @see wp_list_comments()
@ -157,7 +152,6 @@ class Walker_Comment extends Walker {
* Starts the element output. * Starts the element output.
* *
* @since 2.7.0 * @since 2.7.0
* @access public
* *
* @see Walker::start_el() * @see Walker::start_el()
* @see wp_list_comments() * @see wp_list_comments()
@ -201,7 +195,6 @@ class Walker_Comment extends Walker {
* Ends the element output, if needed. * Ends the element output, if needed.
* *
* @since 2.7.0 * @since 2.7.0
* @access public
* *
* @see Walker::end_el() * @see Walker::end_el()
* @see wp_list_comments() * @see wp_list_comments()
@ -228,7 +221,6 @@ class Walker_Comment extends Walker {
* Outputs a pingback comment. * Outputs a pingback comment.
* *
* @since 3.6.0 * @since 3.6.0
* @access protected
* *
* @see wp_list_comments() * @see wp_list_comments()
* *
@ -250,7 +242,6 @@ class Walker_Comment extends Walker {
* Outputs a single comment. * Outputs a single comment.
* *
* @since 3.6.0 * @since 3.6.0
* @access protected
* *
* @see wp_list_comments() * @see wp_list_comments()
* *
@ -314,7 +305,6 @@ class Walker_Comment extends Walker {
* Outputs a comment in the HTML5 format. * Outputs a comment in the HTML5 format.
* *
* @since 3.6.0 * @since 3.6.0
* @access protected
* *
* @see wp_list_comments() * @see wp_list_comments()
* *

2
wp-includes/class-walker-nav-menu.php
View File

@ -19,7 +19,6 @@ class Walker_Nav_Menu extends Walker {
* What the class handles. * What the class handles.
* *
* @since 3.0.0 * @since 3.0.0
* @access public
* @var string * @var string
* *
* @see Walker::$tree_type * @see Walker::$tree_type
@ -30,7 +29,6 @@ class Walker_Nav_Menu extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 3.0.0 * @since 3.0.0
* @access public
* @todo Decouple this. * @todo Decouple this.
* @var array * @var array
* *

3
wp-includes/class-walker-page-dropdown.php
View File

@ -20,7 +20,6 @@ class Walker_PageDropdown extends Walker {
* What the class handles. * What the class handles.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var string * @var string
* *
* @see Walker::$tree_type * @see Walker::$tree_type
@ -31,7 +30,6 @@ class Walker_PageDropdown extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var array * @var array
* *
* @see Walker::$db_fields * @see Walker::$db_fields
@ -43,7 +41,6 @@ class Walker_PageDropdown extends Walker {
* Starts the element output. * Starts the element output.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see Walker::start_el() * @see Walker::start_el()
* *

6
wp-includes/class-walker-page.php
View File

@ -20,7 +20,6 @@ class Walker_Page extends Walker {
* What the class handles. * What the class handles.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var string * @var string
* *
* @see Walker::$tree_type * @see Walker::$tree_type
@ -31,7 +30,6 @@ class Walker_Page extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 2.1.0 * @since 2.1.0
* @access private
* @var array * @var array
* *
* @see Walker::$db_fields * @see Walker::$db_fields
@ -43,7 +41,6 @@ class Walker_Page extends Walker {
* Outputs the beginning of the current level in the tree before elements are output. * Outputs the beginning of the current level in the tree before elements are output.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see Walker::start_lvl() * @see Walker::start_lvl()
* *
@ -68,7 +65,6 @@ class Walker_Page extends Walker {
* Outputs the end of the current level in the tree after elements are output. * Outputs the end of the current level in the tree after elements are output.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see Walker::end_lvl() * @see Walker::end_lvl()
* *
@ -94,7 +90,6 @@ class Walker_Page extends Walker {
* *
* @see Walker::start_el() * @see Walker::start_el()
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string $output Used to append additional content. Passed by reference. * @param string $output Used to append additional content. Passed by reference.
* @param WP_Post $page Page data object. * @param WP_Post $page Page data object.
@ -214,7 +209,6 @@ class Walker_Page extends Walker {
* Outputs the end of the current element in the tree. * Outputs the end of the current element in the tree.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see Walker::end_el() * @see Walker::end_el()
* *

4
wp-includes/class-wp-admin-bar.php
View File

@ -33,7 +33,6 @@ class WP_Admin_Bar {
} }
/** /**
* @access public
*/ */
public function initialize() { public function initialize() {
$this->user = new stdClass; $this->user = new stdClass;
@ -100,7 +99,6 @@ class WP_Admin_Bar {
* *
* @since 3.1.0 * @since 3.1.0
* @since 4.5.0 Added the ability to pass 'lang' and 'dir' meta data. * @since 4.5.0 Added the ability to pass 'lang' and 'dir' meta data.
* @access public
* *
* @param array $args { * @param array $args {
* Arguments for adding a node. * Arguments for adding a node.
@ -258,7 +256,6 @@ class WP_Admin_Bar {
} }
/** /**
* @access public
*/ */
public function render() { public function render() {
$root = $this->_bind(); $root = $this->_bind();
@ -572,7 +569,6 @@ class WP_Admin_Bar {
} }
/** /**
* @access public
*/ */
public function add_menus() { public function add_menus() {
// User related, aligned right. // User related, aligned right.

1
wp-includes/class-wp-ajax-response.php
View File

@ -39,7 +39,6 @@ class WP_Ajax_Response {
* </response> * </response>
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string|array $args { * @param string|array $args {
* Optional. An array or string of XML response arguments. * Optional. An array or string of XML response arguments.

22
wp-includes/class-wp-comment-query.php
View File

@ -20,7 +20,6 @@ class WP_Comment_Query {
* SQL for database query. * SQL for database query.
* *
* @since 4.0.1 * @since 4.0.1
* @access public
* @var string * @var string
*/ */
public $request; public $request;
@ -29,7 +28,6 @@ class WP_Comment_Query {
* Metadata query container * Metadata query container
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var object WP_Meta_Query * @var object WP_Meta_Query
*/ */
public $meta_query = false; public $meta_query = false;
@ -38,7 +36,6 @@ class WP_Comment_Query {
* Metadata query clauses. * Metadata query clauses.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var array * @var array
*/ */
protected $meta_query_clauses; protected $meta_query_clauses;
@ -47,7 +44,6 @@ class WP_Comment_Query {
* SQL query clauses. * SQL query clauses.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var array * @var array
*/ */
protected $sql_clauses = array( protected $sql_clauses = array(
@ -65,7 +61,6 @@ class WP_Comment_Query {
* Stored after the {@see 'comments_clauses'} filter is run on the compiled WHERE sub-clauses. * Stored after the {@see 'comments_clauses'} filter is run on the compiled WHERE sub-clauses.
* *
* @since 4.4.2 * @since 4.4.2
* @access protected
* @var string * @var string
*/ */
protected $filtered_where_clause; protected $filtered_where_clause;
@ -74,7 +69,6 @@ class WP_Comment_Query {
* Date query container * Date query container
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* @var object WP_Date_Query * @var object WP_Date_Query
*/ */
public $date_query = false; public $date_query = false;
@ -83,7 +77,6 @@ class WP_Comment_Query {
* Query vars set by the user. * Query vars set by the user.
* *
* @since 3.1.0 * @since 3.1.0
* @access public
* @var array * @var array
*/ */
public $query_vars; public $query_vars;
@ -92,7 +85,6 @@ class WP_Comment_Query {
* Default values for query vars. * Default values for query vars.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* @var array * @var array
*/ */
public $query_var_defaults; public $query_var_defaults;
@ -101,7 +93,6 @@ class WP_Comment_Query {
* List of comments located by the query. * List of comments located by the query.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var array * @var array
*/ */
public $comments; public $comments;
@ -110,7 +101,6 @@ class WP_Comment_Query {
* The amount of found comments for the current query. * The amount of found comments for the current query.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $found_comments = 0; public $found_comments = 0;
@ -119,7 +109,6 @@ class WP_Comment_Query {
* The number of pages. * The number of pages.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $max_num_pages = 0; public $max_num_pages = 0;
@ -128,7 +117,6 @@ class WP_Comment_Query {
* Make private/protected methods readable for backward compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param callable $name Method to call. * @param callable $name Method to call.
* @param array $arguments Arguments to pass when calling. * @param array $arguments Arguments to pass when calling.
@ -152,7 +140,6 @@ class WP_Comment_Query {
* `$hierarchical`, and `$update_comment_post_cache` were added. * `$hierarchical`, and `$update_comment_post_cache` were added.
* @since 4.5.0 Introduced the `$author_url` argument. * @since 4.5.0 Introduced the `$author_url` argument.
* @since 4.6.0 Introduced the `$cache_domain` argument. * @since 4.6.0 Introduced the `$cache_domain` argument.
* @access public
* *
* @param string|array $query { * @param string|array $query {
* Optional. Array or query string of comment query parameters. Default empty. * Optional. Array or query string of comment query parameters. Default empty.
@ -317,7 +304,6 @@ class WP_Comment_Query {
* *
* @since 4.2.0 Extracted from WP_Comment_Query::query(). * @since 4.2.0 Extracted from WP_Comment_Query::query().
* *
* @access public
* *
* @param string|array $query WP_Comment_Query arguments. See WP_Comment_Query::__construct() * @param string|array $query WP_Comment_Query arguments. See WP_Comment_Query::__construct()
*/ */
@ -347,7 +333,6 @@ class WP_Comment_Query {
* 'post__not_in', 'include_unapproved', 'type__in', and 'type__not_in' * 'post__not_in', 'include_unapproved', 'type__in', and 'type__not_in'
* arguments to $query_vars. * arguments to $query_vars.
* @since 4.2.0 Moved parsing to WP_Comment_Query::parse_query(). * @since 4.2.0 Moved parsing to WP_Comment_Query::parse_query().
* @access public
* *
* @param string|array $query Array or URL query string of parameters. * @param string|array $query Array or URL query string of parameters.
* @return array|int List of comments, or number of comments when 'count' is passed as a query var. * @return array|int List of comments, or number of comments when 'count' is passed as a query var.
@ -361,7 +346,6 @@ class WP_Comment_Query {
* Get a list of comments matching the query vars. * Get a list of comments matching the query vars.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -476,7 +460,6 @@ class WP_Comment_Query {
* Used internally to get a list of comment IDs matching the query vars. * Used internally to get a list of comment IDs matching the query vars.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
*/ */
@ -906,7 +889,6 @@ class WP_Comment_Query {
* query if the limit clause was used. * query if the limit clause was used.
* *
* @since 4.6.0 * @since 4.6.0
* @access private
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
*/ */
@ -935,7 +917,6 @@ class WP_Comment_Query {
* the descendant trees for all matched top-level comments. * the descendant trees for all matched top-level comments.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -1050,7 +1031,6 @@ class WP_Comment_Query {
* Used internally to generate an SQL string for searching across multiple columns * Used internally to generate an SQL string for searching across multiple columns
* *
* @since 3.1.0 * @since 3.1.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -1075,7 +1055,6 @@ class WP_Comment_Query {
* Parse and sanitize 'orderby' keys passed to the comment query. * Parse and sanitize 'orderby' keys passed to the comment query.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -1139,7 +1118,6 @@ class WP_Comment_Query {
* Parse an 'order' query variable and cast it to ASC or DESC as necessary. * Parse an 'order' query variable and cast it to ASC or DESC as necessary.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
* *
* @param string $order The 'order' query variable. * @param string $order The 'order' query variable.
* @return string The sanitized 'order' query variable. * @return string The sanitized 'order' query variable.

26
wp-includes/class-wp-comment.php
View File

@ -18,7 +18,6 @@ final class WP_Comment {
* Comment ID. * Comment ID.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $comment_ID; public $comment_ID;
@ -27,7 +26,6 @@ final class WP_Comment {
* ID of the post the comment is associated with. * ID of the post the comment is associated with.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $comment_post_ID = 0; public $comment_post_ID = 0;
@ -36,7 +34,6 @@ final class WP_Comment {
* Comment author name. * Comment author name.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_author = ''; public $comment_author = '';
@ -45,7 +42,6 @@ final class WP_Comment {
* Comment author email address. * Comment author email address.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_author_email = ''; public $comment_author_email = '';
@ -54,7 +50,6 @@ final class WP_Comment {
* Comment author URL. * Comment author URL.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_author_url = ''; public $comment_author_url = '';
@ -63,7 +58,6 @@ final class WP_Comment {
* Comment author IP address (IPv4 format). * Comment author IP address (IPv4 format).
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_author_IP = ''; public $comment_author_IP = '';
@ -72,7 +66,6 @@ final class WP_Comment {
* Comment date in YYYY-MM-DD HH:MM:SS format. * Comment date in YYYY-MM-DD HH:MM:SS format.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_date = '0000-00-00 00:00:00'; public $comment_date = '0000-00-00 00:00:00';
@ -81,7 +74,6 @@ final class WP_Comment {
* Comment GMT date in YYYY-MM-DD HH::MM:SS format. * Comment GMT date in YYYY-MM-DD HH::MM:SS format.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_date_gmt = '0000-00-00 00:00:00'; public $comment_date_gmt = '0000-00-00 00:00:00';
@ -90,7 +82,6 @@ final class WP_Comment {
* Comment content. * Comment content.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_content; public $comment_content;
@ -99,7 +90,6 @@ final class WP_Comment {
* Comment karma count. * Comment karma count.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $comment_karma = 0; public $comment_karma = 0;
@ -108,7 +98,6 @@ final class WP_Comment {
* Comment approval status. * Comment approval status.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_approved = '1'; public $comment_approved = '1';
@ -117,7 +106,6 @@ final class WP_Comment {
* Comment author HTTP user agent. * Comment author HTTP user agent.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_agent = ''; public $comment_agent = '';
@ -126,7 +114,6 @@ final class WP_Comment {
* Comment type. * Comment type.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $comment_type = ''; public $comment_type = '';
@ -135,7 +122,6 @@ final class WP_Comment {
* Parent comment ID. * Parent comment ID.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $comment_parent = 0; public $comment_parent = 0;
@ -144,7 +130,6 @@ final class WP_Comment {
* Comment author ID. * Comment author ID.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $user_id = 0; public $user_id = 0;
@ -153,7 +138,6 @@ final class WP_Comment {
* Comment children. * Comment children.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var array * @var array
*/ */
protected $children; protected $children;
@ -162,7 +146,6 @@ final class WP_Comment {
* Whether children have been populated for this comment object. * Whether children have been populated for this comment object.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var bool * @var bool
*/ */
protected $populated_children = false; protected $populated_children = false;
@ -171,7 +154,6 @@ final class WP_Comment {
* Post fields. * Post fields.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var array * @var array
*/ */
protected $post_fields = array( 'post_author', 'post_date', 'post_date_gmt', 'post_content', 'post_title', 'post_excerpt', 'post_status', 'comment_status', 'ping_status', 'post_name', 'to_ping', 'pinged', 'post_modified', 'post_modified_gmt', 'post_content_filtered', 'post_parent', 'guid', 'menu_order', 'post_type', 'post_mime_type', 'comment_count' ); protected $post_fields = array( 'post_author', 'post_date', 'post_date_gmt', 'post_content', 'post_title', 'post_excerpt', 'post_status', 'comment_status', 'ping_status', 'post_name', 'to_ping', 'pinged', 'post_modified', 'post_modified_gmt', 'post_content_filtered', 'post_parent', 'guid', 'menu_order', 'post_type', 'post_mime_type', 'comment_count' );
@ -180,7 +162,6 @@ final class WP_Comment {
* Retrieves a WP_Comment instance. * Retrieves a WP_Comment instance.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @static * @static
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
@ -217,7 +198,6 @@ final class WP_Comment {
* Populates properties with object vars. * Populates properties with object vars.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param WP_Comment $comment Comment object. * @param WP_Comment $comment Comment object.
*/ */
@ -231,7 +211,6 @@ final class WP_Comment {
* Convert object to array. * Convert object to array.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Object as array. * @return array Object as array.
*/ */
@ -243,7 +222,6 @@ final class WP_Comment {
* Get the children of a comment. * Get the children of a comment.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $args { * @param array $args {
* Array of arguments used to pass to get_comments() and determine format. * Array of arguments used to pass to get_comments() and determine format.
@ -318,7 +296,6 @@ final class WP_Comment {
* Used by `WP_Comment_Query` when bulk-filling descendants. * Used by `WP_Comment_Query` when bulk-filling descendants.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param WP_Comment $child Child comment. * @param WP_Comment $child Child comment.
*/ */
@ -330,7 +307,6 @@ final class WP_Comment {
* Get a child comment by ID. * Get a child comment by ID.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param int $child_id ID of the child. * @param int $child_id ID of the child.
* @return WP_Comment|bool Returns the comment object if found, otherwise false. * @return WP_Comment|bool Returns the comment object if found, otherwise false.
@ -363,7 +339,6 @@ final class WP_Comment {
* If `$name` matches a post field, the comment post will be loaded and the post's value checked. * If `$name` matches a post field, the comment post will be loaded and the post's value checked.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $name Property name. * @param string $name Property name.
* @return bool * @return bool
@ -381,7 +356,6 @@ final class WP_Comment {
* If `$name` matches a post field, the comment post will be loaded and the post's value returned. * If `$name` matches a post field, the comment post will be loaded and the post's value returned.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $name * @param string $name
* @return mixed * @return mixed

17
wp-includes/class-wp-customize-control.php
View File

@ -22,7 +22,6 @@ class WP_Customize_Control {
* @since 4.1.0 * @since 4.1.0
* *
* @static * @static
* @access protected
* @var int * @var int
*/ */
protected static $instance_count = 0; protected static $instance_count = 0;
@ -31,7 +30,6 @@ class WP_Customize_Control {
* Order in which this instance was created in relation to other instances. * Order in which this instance was created in relation to other instances.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var int * @var int
*/ */
public $instance_number; public $instance_number;
@ -40,7 +38,6 @@ class WP_Customize_Control {
* Customizer manager. * Customizer manager.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var WP_Customize_Manager * @var WP_Customize_Manager
*/ */
public $manager; public $manager;
@ -49,7 +46,6 @@ class WP_Customize_Control {
* Control ID. * Control ID.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $id; public $id;
@ -58,7 +54,6 @@ class WP_Customize_Control {
* All settings tied to the control. * All settings tied to the control.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var array * @var array
*/ */
public $settings; public $settings;
@ -67,7 +62,6 @@ class WP_Customize_Control {
* The primary setting for the control (if there is one). * The primary setting for the control (if there is one).
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $setting = 'default'; public $setting = 'default';
@ -79,7 +73,6 @@ class WP_Customize_Control {
* of the associated `$settings`. * of the associated `$settings`.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $capability; public $capability;
@ -88,7 +81,6 @@ class WP_Customize_Control {
* Order priority to load the control in Customizer. * Order priority to load the control in Customizer.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var int * @var int
*/ */
public $priority = 10; public $priority = 10;
@ -97,7 +89,6 @@ class WP_Customize_Control {
* Section the control belongs to. * Section the control belongs to.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $section = ''; public $section = '';
@ -106,7 +97,6 @@ class WP_Customize_Control {
* Label for the control. * Label for the control.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $label = ''; public $label = '';
@ -115,7 +105,6 @@ class WP_Customize_Control {
* Description for the control. * Description for the control.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var string * @var string
*/ */
public $description = ''; public $description = '';
@ -124,7 +113,6 @@ class WP_Customize_Control {
* List of choices for 'radio' or 'select' type controls, where values are the keys, and labels are the values. * List of choices for 'radio' or 'select' type controls, where values are the keys, and labels are the values.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var array * @var array
*/ */
public $choices = array(); public $choices = array();
@ -135,7 +123,6 @@ class WP_Customize_Control {
* Not used for 'checkbox', 'radio', 'select', 'textarea', or 'dropdown-pages' control types. * Not used for 'checkbox', 'radio', 'select', 'textarea', or 'dropdown-pages' control types.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var array * @var array
*/ */
public $input_attrs = array(); public $input_attrs = array();
@ -144,7 +131,6 @@ class WP_Customize_Control {
* Show UI for adding new content, currently only used for the dropdown-pages control. * Show UI for adding new content, currently only used for the dropdown-pages control.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $allow_addition = false; public $allow_addition = false;
@ -152,7 +138,6 @@ class WP_Customize_Control {
/** /**
* @deprecated It is better to just call the json() method * @deprecated It is better to just call the json() method
* @since 3.4.0 * @since 3.4.0
* @access public
* @var array * @var array
*/ */
public $json = array(); public $json = array();
@ -161,7 +146,6 @@ class WP_Customize_Control {
* Control's Type. * Control's Type.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $type = 'text'; public $type = 'text';
@ -170,7 +154,6 @@ class WP_Customize_Control {
* Callback. * Callback.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @see WP_Customize_Control::active() * @see WP_Customize_Control::active()
* *

70
wp-includes/class-wp-customize-manager.php
View File

@ -25,7 +25,6 @@ final class WP_Customize_Manager {
* An instance of the theme being previewed. * An instance of the theme being previewed.
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* @var WP_Theme * @var WP_Theme
*/ */
protected $theme; protected $theme;
@ -34,7 +33,6 @@ final class WP_Customize_Manager {
* The directory name of the previously active theme (within the theme_root). * The directory name of the previously active theme (within the theme_root).
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* @var string * @var string
*/ */
protected $original_stylesheet; protected $original_stylesheet;
@ -43,7 +41,6 @@ final class WP_Customize_Manager {
* Whether this is a Customizer pageload. * Whether this is a Customizer pageload.
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* @var bool * @var bool
*/ */
protected $previewing = false; protected $previewing = false;
@ -52,7 +49,6 @@ final class WP_Customize_Manager {
* Methods and properties dealing with managing widgets in the Customizer. * Methods and properties dealing with managing widgets in the Customizer.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* @var WP_Customize_Widgets * @var WP_Customize_Widgets
*/ */
public $widgets; public $widgets;
@ -61,7 +57,6 @@ final class WP_Customize_Manager {
* Methods and properties dealing with managing nav menus in the Customizer. * Methods and properties dealing with managing nav menus in the Customizer.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var WP_Customize_Nav_Menus * @var WP_Customize_Nav_Menus
*/ */
public $nav_menus; public $nav_menus;
@ -70,7 +65,6 @@ final class WP_Customize_Manager {
* Methods and properties dealing with selective refresh in the Customizer preview. * Methods and properties dealing with selective refresh in the Customizer preview.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var WP_Customize_Selective_Refresh * @var WP_Customize_Selective_Refresh
*/ */
public $selective_refresh; public $selective_refresh;
@ -79,7 +73,6 @@ final class WP_Customize_Manager {
* Registered instances of WP_Customize_Setting. * Registered instances of WP_Customize_Setting.
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* @var array * @var array
*/ */
protected $settings = array(); protected $settings = array();
@ -88,7 +81,6 @@ final class WP_Customize_Manager {
* Sorted top-level instances of WP_Customize_Panel and WP_Customize_Section. * Sorted top-level instances of WP_Customize_Panel and WP_Customize_Section.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* @var array * @var array
*/ */
protected $containers = array(); protected $containers = array();
@ -97,7 +89,6 @@ final class WP_Customize_Manager {
* Registered instances of WP_Customize_Panel. * Registered instances of WP_Customize_Panel.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* @var array * @var array
*/ */
protected $panels = array(); protected $panels = array();
@ -106,7 +97,6 @@ final class WP_Customize_Manager {
* List of core components. * List of core components.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var array * @var array
*/ */
protected $components = array( 'widgets', 'nav_menus' ); protected $components = array( 'widgets', 'nav_menus' );
@ -115,7 +105,6 @@ final class WP_Customize_Manager {
* Registered instances of WP_Customize_Section. * Registered instances of WP_Customize_Section.
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* @var array * @var array
*/ */
protected $sections = array(); protected $sections = array();
@ -124,7 +113,6 @@ final class WP_Customize_Manager {
* Registered instances of WP_Customize_Control. * Registered instances of WP_Customize_Control.
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* @var array * @var array
*/ */
protected $controls = array(); protected $controls = array();
@ -133,7 +121,6 @@ final class WP_Customize_Manager {
* Panel types that may be rendered from JS templates. * Panel types that may be rendered from JS templates.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* @var array * @var array
*/ */
protected $registered_panel_types = array(); protected $registered_panel_types = array();
@ -142,7 +129,6 @@ final class WP_Customize_Manager {
* Section types that may be rendered from JS templates. * Section types that may be rendered from JS templates.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* @var array * @var array
*/ */
protected $registered_section_types = array(); protected $registered_section_types = array();
@ -151,7 +137,6 @@ final class WP_Customize_Manager {
* Control types that may be rendered from JS templates. * Control types that may be rendered from JS templates.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* @var array * @var array
*/ */
protected $registered_control_types = array(); protected $registered_control_types = array();
@ -160,7 +145,6 @@ final class WP_Customize_Manager {
* Initial URL being previewed. * Initial URL being previewed.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var string * @var string
*/ */
protected $preview_url; protected $preview_url;
@ -169,7 +153,6 @@ final class WP_Customize_Manager {
* URL to link the user to when closing the Customizer. * URL to link the user to when closing the Customizer.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var string * @var string
*/ */
protected $return_url; protected $return_url;
@ -178,7 +161,6 @@ final class WP_Customize_Manager {
* Mapping of 'panel', 'section', 'control' to the ID which should be autofocused. * Mapping of 'panel', 'section', 'control' to the ID which should be autofocused.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var array * @var array
*/ */
protected $autofocus = array(); protected $autofocus = array();
@ -187,7 +169,6 @@ final class WP_Customize_Manager {
* Messenger channel. * Messenger channel.
* *
* @since 4.7.0 * @since 4.7.0
* @access protected
* @var string * @var string
*/ */
protected $messenger_channel; protected $messenger_channel;
@ -203,7 +184,6 @@ final class WP_Customize_Manager {
* Changeset UUID. * Changeset UUID.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var string * @var string
*/ */
private $_changeset_uuid; private $_changeset_uuid;
@ -212,7 +192,6 @@ final class WP_Customize_Manager {
* Changeset post ID. * Changeset post ID.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var int|false * @var int|false
*/ */
private $_changeset_post_id; private $_changeset_post_id;
@ -221,7 +200,6 @@ final class WP_Customize_Manager {
* Changeset data loaded from a customize_changeset post. * Changeset data loaded from a customize_changeset post.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var array * @var array
*/ */
private $_changeset_data; private $_changeset_data;
@ -373,7 +351,6 @@ final class WP_Customize_Manager {
* *
* @since 3.4.0 * @since 3.4.0
* @since 4.2.0 Added `$action` param. * @since 4.2.0 Added `$action` param.
* @access public
* *
* @param string|null $action Whether the supplied Ajax action is being run. * @param string|null $action Whether the supplied Ajax action is being run.
* @return bool True if it's an Ajax request, false otherwise. * @return bool True if it's an Ajax request, false otherwise.
@ -648,7 +625,6 @@ final class WP_Customize_Manager {
* Get the changeset UUID. * Get the changeset UUID.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return string UUID. * @return string UUID.
*/ */
@ -718,7 +694,6 @@ final class WP_Customize_Manager {
* Get the registered panels. * Get the registered panels.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @return array Panels. * @return array Panels.
*/ */
@ -798,7 +773,6 @@ final class WP_Customize_Manager {
* Find the changeset post ID for a given changeset UUID. * Find the changeset post ID for a given changeset UUID.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param string $uuid Changeset UUID. * @param string $uuid Changeset UUID.
* @return int|null Returns post ID on success and null on failure. * @return int|null Returns post ID on success and null on failure.
@ -835,7 +809,6 @@ final class WP_Customize_Manager {
* Get the changeset post id for the loaded changeset. * Get the changeset post id for the loaded changeset.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return int|null Post ID on success or null if there is no post yet saved. * @return int|null Post ID on success or null if there is no post yet saved.
*/ */
@ -857,7 +830,6 @@ final class WP_Customize_Manager {
* Get the data stored in a changeset post. * Get the data stored in a changeset post.
* *
* @since 4.7.0 * @since 4.7.0
* @access protected
* *
* @param int $post_id Changeset post ID. * @param int $post_id Changeset post ID.
* @return array|WP_Error Changeset data or WP_Error on error. * @return array|WP_Error Changeset data or WP_Error on error.
@ -887,7 +859,6 @@ final class WP_Customize_Manager {
* Get changeset data. * Get changeset data.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return array Changeset data. * @return array Changeset data.
*/ */
@ -913,7 +884,6 @@ final class WP_Customize_Manager {
* Starter content setting IDs. * Starter content setting IDs.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var array * @var array
*/ */
protected $pending_starter_content_settings_ids = array(); protected $pending_starter_content_settings_ids = array();
@ -922,7 +892,6 @@ final class WP_Customize_Manager {
* Import theme starter content into the customized state. * Import theme starter content into the customized state.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param array $starter_content Starter content. Defaults to `get_theme_starter_content()`. * @param array $starter_content Starter content. Defaults to `get_theme_starter_content()`.
*/ */
@ -1315,7 +1284,6 @@ final class WP_Customize_Manager {
* Ensure that the attachments are valid and that they have slugs and file name/path. * Ensure that the attachments are valid and that they have slugs and file name/path.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @param array $attachments Attachments. * @param array $attachments Attachments.
* @return array Prepared attachments. * @return array Prepared attachments.
@ -1376,7 +1344,6 @@ final class WP_Customize_Manager {
* Save starter content changeset. * Save starter content changeset.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
*/ */
public function _save_starter_content_changeset() { public function _save_starter_content_changeset() {
@ -1485,7 +1452,6 @@ final class WP_Customize_Manager {
* @since 3.4.0 * @since 3.4.0
* @since 4.1.1 Introduced the `$default` parameter. * @since 4.1.1 Introduced the `$default` parameter.
* @since 4.6.0 `$default` is now returned early when the setting post value is invalid. * @since 4.6.0 `$default` is now returned early when the setting post value is invalid.
* @access public
* *
* @see WP_REST_Server::dispatch() * @see WP_REST_Server::dispatch()
* @see WP_Rest_Request::sanitize_params() * @see WP_Rest_Request::sanitize_params()
@ -1520,7 +1486,6 @@ final class WP_Customize_Manager {
* exclusively sourced from `$_POST['customized']`. * exclusively sourced from `$_POST['customized']`.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* *
* @param string $setting_id ID for the WP_Customize_Setting instance. * @param string $setting_id ID for the WP_Customize_Setting instance.
* @param mixed $value Post value. * @param mixed $value Post value.
@ -1618,7 +1583,6 @@ final class WP_Customize_Manager {
* Filter the X-Frame-Options and Content-Security-Policy headers to ensure frontend can load in customizer. * Filter the X-Frame-Options and Content-Security-Policy headers to ensure frontend can load in customizer.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param array $headers Headers. * @param array $headers Headers.
* @return array Headers. * @return array Headers.
@ -1634,7 +1598,6 @@ final class WP_Customize_Manager {
* Add customize state query params to a given URL if preview is allowed. * Add customize state query params to a given URL if preview is allowed.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @see wp_redirect() * @see wp_redirect()
* @see WP_Customize_Manager::get_allowed_url() * @see WP_Customize_Manager::get_allowed_url()
* *
@ -1680,7 +1643,6 @@ final class WP_Customize_Manager {
* *
* @since 4.0.0 * @since 4.0.0
* @deprecated 4.7.0 * @deprecated 4.7.0
* @access public
*/ */
public function customize_preview_override_404_status() { public function customize_preview_override_404_status() {
_deprecated_function( __METHOD__, '4.7.0' ); _deprecated_function( __METHOD__, '4.7.0' );
@ -1710,7 +1672,6 @@ final class WP_Customize_Manager {
* Print CSS for loading indicators for the Customizer preview. * Print CSS for loading indicators for the Customizer preview.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
*/ */
public function customize_preview_loading_style() { public function customize_preview_loading_style() {
?><style> ?><style>
@ -1741,7 +1702,6 @@ final class WP_Customize_Manager {
* work as expected since the parent frame is not being sent the URL to navigate to. * work as expected since the parent frame is not being sent the URL to navigate to.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
*/ */
public function remove_frameless_preview_messenger_channel() { public function remove_frameless_preview_messenger_channel() {
if ( ! $this->messenger_channel ) { if ( ! $this->messenger_channel ) {
@ -1991,7 +1951,6 @@ final class WP_Customize_Manager {
* after sanitizing are marked invalid. * after sanitizing are marked invalid.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @see WP_REST_Request::has_valid_params() * @see WP_REST_Request::has_valid_params()
* @see WP_Customize_Setting::validate() * @see WP_Customize_Setting::validate()
@ -2058,7 +2017,6 @@ final class WP_Customize_Manager {
* `wp.customize.Notification` JS model. * `wp.customize.Notification` JS model.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param true|WP_Error $validity Setting validity. * @param true|WP_Error $validity Setting validity.
* @return true|array If `$validity` was a WP_Error, the error codes will be array-mapped * @return true|array If `$validity` was a WP_Error, the error codes will be array-mapped
@ -2225,7 +2183,6 @@ final class WP_Customize_Manager {
* Save the post for the loaded changeset. * Save the post for the loaded changeset.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param array $args { * @param array $args {
* Args for changeset post. * Args for changeset post.
@ -2569,7 +2526,6 @@ final class WP_Customize_Manager {
* Whether a changeset revision should be made. * Whether a changeset revision should be made.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var bool * @var bool
*/ */
protected $store_changeset_revision; protected $store_changeset_revision;
@ -2580,7 +2536,6 @@ final class WP_Customize_Manager {
* Note that this will not be called while a changeset post remains in auto-draft status. * Note that this will not be called while a changeset post remains in auto-draft status.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @param bool $post_has_changed Whether the post has changed. * @param bool $post_has_changed Whether the post has changed.
* @param WP_Post $last_revision The last revision post object. * @param WP_Post $last_revision The last revision post object.
@ -2610,7 +2565,6 @@ final class WP_Customize_Manager {
* invoking this method. * invoking this method.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @see _wp_customize_publish_changeset() * @see _wp_customize_publish_changeset()
* *
* @param int $changeset_post_id ID for customize_changeset post. Defaults to the changeset for the current manager instance. * @param int $changeset_post_id ID for customize_changeset post. Defaults to the changeset for the current manager instance.
@ -2761,7 +2715,6 @@ final class WP_Customize_Manager {
* Update stashed theme mod settings. * Update stashed theme mod settings.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @param array $inactive_theme_mod_settings Mapping of stylesheet to arrays of theme mod settings. * @param array $inactive_theme_mod_settings Mapping of stylesheet to arrays of theme mod settings.
* @return array|false Returns array of updated stashed theme mods or false if the update failed or there were no changes. * @return array|false Returns array of updated stashed theme mods or false if the update failed or there were no changes.
@ -2865,7 +2818,6 @@ final class WP_Customize_Manager {
* even though they are not directly created statically with code. * even though they are not directly created statically with code.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* *
* @param array $setting_ids The setting IDs to add. * @param array $setting_ids The setting IDs to add.
* @return array The WP_Customize_Setting objects added. * @return array The WP_Customize_Setting objects added.
@ -2977,7 +2929,6 @@ final class WP_Customize_Manager {
* Retrieve a customize panel. * Retrieve a customize panel.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $id Panel ID to get. * @param string $id Panel ID to get.
* @return WP_Customize_Panel|void Requested panel instance, if set. * @return WP_Customize_Panel|void Requested panel instance, if set.
@ -2992,7 +2943,6 @@ final class WP_Customize_Manager {
* Remove a customize panel. * Remove a customize panel.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $id Panel ID to remove. * @param string $id Panel ID to remove.
*/ */
@ -3016,7 +2966,6 @@ final class WP_Customize_Manager {
* Registered types are eligible to be rendered via JS and created dynamically. * Registered types are eligible to be rendered via JS and created dynamically.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see WP_Customize_Panel * @see WP_Customize_Panel
* *
@ -3030,7 +2979,6 @@ final class WP_Customize_Manager {
* Render JS templates for all registered panel types. * Render JS templates for all registered panel types.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function render_panel_templates() { public function render_panel_templates() {
foreach ( $this->registered_panel_types as $panel_type ) { foreach ( $this->registered_panel_types as $panel_type ) {
@ -3044,7 +2992,6 @@ final class WP_Customize_Manager {
* *
* @since 3.4.0 * @since 3.4.0
* @since 4.5.0 Return added WP_Customize_Section instance. * @since 4.5.0 Return added WP_Customize_Section instance.
* @access public
* *
* @param WP_Customize_Section|string $id Customize Section object, or Section ID. * @param WP_Customize_Section|string $id Customize Section object, or Section ID.
* @param array $args { * @param array $args {
@ -3103,7 +3050,6 @@ final class WP_Customize_Manager {
* Registered types are eligible to be rendered via JS and created dynamically. * Registered types are eligible to be rendered via JS and created dynamically.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see WP_Customize_Section * @see WP_Customize_Section
* *
@ -3117,7 +3063,6 @@ final class WP_Customize_Manager {
* Render JS templates for all registered section types. * Render JS templates for all registered section types.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function render_section_templates() { public function render_section_templates() {
foreach ( $this->registered_section_types as $section_type ) { foreach ( $this->registered_section_types as $section_type ) {
@ -3131,7 +3076,6 @@ final class WP_Customize_Manager {
* *
* @since 3.4.0 * @since 3.4.0
* @since 4.5.0 Return added WP_Customize_Control instance. * @since 4.5.0 Return added WP_Customize_Control instance.
* @access public
* *
* @param WP_Customize_Control|string $id Customize Control object, or ID. * @param WP_Customize_Control|string $id Customize Control object, or ID.
* @param array $args { * @param array $args {
@ -3197,7 +3141,6 @@ final class WP_Customize_Manager {
* Registered types are eligible to be rendered via JS and created dynamically. * Registered types are eligible to be rendered via JS and created dynamically.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @param string $control Name of a custom control which is a subclass of * @param string $control Name of a custom control which is a subclass of
* WP_Customize_Control. * WP_Customize_Control.
@ -3210,7 +3153,6 @@ final class WP_Customize_Manager {
* Render JS templates for all registered control types. * Render JS templates for all registered control types.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
*/ */
public function render_control_templates() { public function render_control_templates() {
foreach ( $this->registered_control_types as $control_type ) { foreach ( $this->registered_control_types as $control_type ) {
@ -3350,7 +3292,6 @@ final class WP_Customize_Manager {
* Determine whether the user agent is iOS. * Determine whether the user agent is iOS.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return bool Whether the user agent is iOS. * @return bool Whether the user agent is iOS.
*/ */
@ -3362,7 +3303,6 @@ final class WP_Customize_Manager {
* Get the template string for the Customizer pane document title. * Get the template string for the Customizer pane document title.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return string The template string for the document title. * @return string The template string for the document title.
*/ */
@ -3384,7 +3324,6 @@ final class WP_Customize_Manager {
* URL is validated. * URL is validated.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $preview_url URL to be previewed. * @param string $preview_url URL to be previewed.
*/ */
@ -3397,7 +3336,6 @@ final class WP_Customize_Manager {
* Get the initial URL to be previewed. * Get the initial URL to be previewed.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return string URL being previewed. * @return string URL being previewed.
*/ */
@ -3414,7 +3352,6 @@ final class WP_Customize_Manager {
* Determines whether the admin and the frontend are on different domains. * Determines whether the admin and the frontend are on different domains.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return bool Whether cross-domain. * @return bool Whether cross-domain.
*/ */
@ -3436,7 +3373,6 @@ final class WP_Customize_Manager {
* using the customize_allowed_urls filter. * using the customize_allowed_urls filter.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @returns array Allowed URLs. * @returns array Allowed URLs.
*/ */
@ -3463,7 +3399,6 @@ final class WP_Customize_Manager {
* Get messenger channel. * Get messenger channel.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return string Messenger channel. * @return string Messenger channel.
*/ */
@ -3477,7 +3412,6 @@ final class WP_Customize_Manager {
* URL is validated. * URL is validated.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $return_url URL for return link. * @param string $return_url URL for return link.
*/ */
@ -3492,7 +3426,6 @@ final class WP_Customize_Manager {
* Get URL to link the user to when closing the Customizer. * Get URL to link the user to when closing the Customizer.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return string URL for link to close Customizer. * @return string URL for link to close Customizer.
*/ */
@ -3516,7 +3449,6 @@ final class WP_Customize_Manager {
* Set the autofocused constructs. * Set the autofocused constructs.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $autofocus { * @param array $autofocus {
* Mapping of 'panel', 'section', 'control' to the ID which should be autofocused. * Mapping of 'panel', 'section', 'control' to the ID which should be autofocused.
@ -3534,7 +3466,6 @@ final class WP_Customize_Manager {
* Get the autofocused constructs. * Get the autofocused constructs.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array { * @return array {
* Mapping of 'panel', 'section', 'control' to the ID which should be autofocused. * Mapping of 'panel', 'section', 'control' to the ID which should be autofocused.
@ -4265,7 +4196,6 @@ final class WP_Customize_Manager {
* Add settings from the POST data that were not added with code, e.g. dynamically-created settings for Widgets * Add settings from the POST data that were not added with code, e.g. dynamically-created settings for Widgets
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* *
* @see add_dynamic_settings() * @see add_dynamic_settings()
*/ */

33
wp-includes/class-wp-customize-nav-menus.php
View File

@ -22,7 +22,6 @@ final class WP_Customize_Nav_Menus {
* WP_Customize_Manager instance. * WP_Customize_Manager instance.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var WP_Customize_Manager * @var WP_Customize_Manager
*/ */
public $manager; public $manager;
@ -31,7 +30,6 @@ final class WP_Customize_Nav_Menus {
* Previewed Menus. * Previewed Menus.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var array * @var array
*/ */
public $previewed_menus; public $previewed_menus;
@ -40,7 +38,6 @@ final class WP_Customize_Nav_Menus {
* Constructor. * Constructor.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param object $manager An instance of the WP_Customize_Manager class. * @param object $manager An instance of the WP_Customize_Manager class.
*/ */
@ -77,7 +74,6 @@ final class WP_Customize_Nav_Menus {
* Adds a nonce for customizing menus. * Adds a nonce for customizing menus.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param array $nonces Array of nonces. * @param array $nonces Array of nonces.
* @return array $nonces Modified array of nonces. * @return array $nonces Modified array of nonces.
@ -91,7 +87,6 @@ final class WP_Customize_Nav_Menus {
* Ajax handler for loading available menu items. * Ajax handler for loading available menu items.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function ajax_load_available_items() { public function ajax_load_available_items() {
check_ajax_referer( 'customize-menus', 'customize-menus-nonce' ); check_ajax_referer( 'customize-menus', 'customize-menus-nonce' );
@ -135,7 +130,6 @@ final class WP_Customize_Nav_Menus {
* Performs the post_type and taxonomy queries for loading available menu items. * Performs the post_type and taxonomy queries for loading available menu items.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param string $type Optional. Accepts any custom object type and has built-in support for * @param string $type Optional. Accepts any custom object type and has built-in support for
* 'post_type' and 'taxonomy'. Default is 'post_type'. * 'post_type' and 'taxonomy'. Default is 'post_type'.
@ -258,7 +252,6 @@ final class WP_Customize_Nav_Menus {
* Ajax handler for searching available menu items. * Ajax handler for searching available menu items.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function ajax_search_available_items() { public function ajax_search_available_items() {
check_ajax_referer( 'customize-menus', 'customize-menus-nonce' ); check_ajax_referer( 'customize-menus', 'customize-menus-nonce' );
@ -292,7 +285,6 @@ final class WP_Customize_Nav_Menus {
* Based on WP_Editor::wp_link_query(). * Based on WP_Editor::wp_link_query().
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param array $args Optional. Accepts 'pagenum' and 's' (search) arguments. * @param array $args Optional. Accepts 'pagenum' and 's' (search) arguments.
* @return array Menu items. * @return array Menu items.
@ -395,7 +387,6 @@ final class WP_Customize_Nav_Menus {
* Enqueue scripts and styles for Customizer pane. * Enqueue scripts and styles for Customizer pane.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function enqueue_scripts() { public function enqueue_scripts() {
wp_enqueue_style( 'customize-nav-menus' ); wp_enqueue_style( 'customize-nav-menus' );
@ -480,7 +471,6 @@ final class WP_Customize_Nav_Menus {
* the WP_Customize_Setting constructor. * the WP_Customize_Setting constructor.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param false|array $setting_args The arguments to the WP_Customize_Setting constructor. * @param false|array $setting_args The arguments to the WP_Customize_Setting constructor.
* @param string $setting_id ID for dynamic setting, usually coming from `$_POST['customized']`. * @param string $setting_id ID for dynamic setting, usually coming from `$_POST['customized']`.
@ -505,7 +495,6 @@ final class WP_Customize_Nav_Menus {
* Allow non-statically created settings to be constructed with custom WP_Customize_Setting subclass. * Allow non-statically created settings to be constructed with custom WP_Customize_Setting subclass.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param string $setting_class WP_Customize_Setting or a subclass. * @param string $setting_class WP_Customize_Setting or a subclass.
* @param string $setting_id ID for dynamic setting, usually coming from `$_POST['customized']`. * @param string $setting_id ID for dynamic setting, usually coming from `$_POST['customized']`.
@ -527,7 +516,6 @@ final class WP_Customize_Nav_Menus {
* Add the customizer settings and controls. * Add the customizer settings and controls.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function customize_register() { public function customize_register() {
@ -708,7 +696,6 @@ final class WP_Customize_Nav_Menus {
* intval because the second argument is not what intval() expects. * intval because the second argument is not what intval() expects.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param mixed $value Number to convert. * @param mixed $value Number to convert.
* @return int Integer. * @return int Integer.
@ -722,7 +709,6 @@ final class WP_Customize_Nav_Menus {
* *
* @since 4.3.0 * @since 4.3.0
* @since 4.7.0 Each array item now includes a `$type_label` in in addition to `$title`, `$type`, and `$object`. * @since 4.7.0 Each array item now includes a `$type_label` in in addition to `$title`, `$type`, and `$object`.
* @access public
* *
* @return array The available menu item types. * @return array The available menu item types.
*/ */
@ -772,7 +758,6 @@ final class WP_Customize_Nav_Menus {
/** /**
* Add a new `auto-draft` post. * Add a new `auto-draft` post.
* *
* @access public
* @since 4.7.0 * @since 4.7.0
* *
* @param array $postarr { * @param array $postarr {
@ -822,7 +807,6 @@ final class WP_Customize_Nav_Menus {
/** /**
* Ajax handler for adding a new auto-draft post. * Ajax handler for adding a new auto-draft post.
* *
* @access public
* @since 4.7.0 * @since 4.7.0
*/ */
public function ajax_insert_auto_draft_post() { public function ajax_insert_auto_draft_post() {
@ -899,7 +883,6 @@ final class WP_Customize_Nav_Menus {
* Templates are imported into the JS use wp.template. * Templates are imported into the JS use wp.template.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function print_templates() { public function print_templates() {
?> ?>
@ -942,7 +925,6 @@ final class WP_Customize_Nav_Menus {
* Print the html template used to render the add-menu-item frame. * Print the html template used to render the add-menu-item frame.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function available_items_template() { public function available_items_template() {
?> ?>
@ -1003,7 +985,6 @@ final class WP_Customize_Nav_Menus {
* To be used in the template #available-menu-items. * To be used in the template #available-menu-items.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @param array $available_item_type Menu item data to output, including title, type, and label. * @param array $available_item_type Menu item data to output, including title, type, and label.
* @return void * @return void
@ -1043,7 +1024,6 @@ final class WP_Customize_Nav_Menus {
* Print the markup for available menu item custom links. * Print the markup for available menu item custom links.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @return void * @return void
*/ */
@ -1086,7 +1066,6 @@ final class WP_Customize_Nav_Menus {
* Nav menu args used for each instance, keyed by the args HMAC. * Nav menu args used for each instance, keyed by the args HMAC.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var array * @var array
*/ */
public $preview_nav_menu_instance_args = array(); public $preview_nav_menu_instance_args = array();
@ -1095,7 +1074,6 @@ final class WP_Customize_Nav_Menus {
* Filters arguments for dynamic nav_menu selective refresh partials. * Filters arguments for dynamic nav_menu selective refresh partials.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param array|false $partial_args Partial args. * @param array|false $partial_args Partial args.
* @param string $partial_id Partial ID. * @param string $partial_id Partial ID.
@ -1126,7 +1104,6 @@ final class WP_Customize_Nav_Menus {
* Add hooks for the Customizer preview. * Add hooks for the Customizer preview.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function customize_preview_init() { public function customize_preview_init() {
add_action( 'wp_enqueue_scripts', array( $this, 'customize_preview_enqueue_deps' ) ); add_action( 'wp_enqueue_scripts', array( $this, 'customize_preview_enqueue_deps' ) );
@ -1140,7 +1117,6 @@ final class WP_Customize_Nav_Menus {
* Make the auto-draft status protected so that it can be queried. * Make the auto-draft status protected so that it can be queried.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @global array $wp_post_statuses List of post statuses. * @global array $wp_post_statuses List of post statuses.
*/ */
@ -1153,7 +1129,6 @@ final class WP_Customize_Nav_Menus {
* Sanitize post IDs for auto-draft posts created for nav menu items to be published. * Sanitize post IDs for auto-draft posts created for nav menu items to be published.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param array $value Post IDs. * @param array $value Post IDs.
* @returns array Post IDs. * @returns array Post IDs.
@ -1189,7 +1164,6 @@ final class WP_Customize_Nav_Menus {
* post is not an auto-draft. * post is not an auto-draft.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param WP_Customize_Setting $setting Customizer setting object. * @param WP_Customize_Setting $setting Customizer setting object.
*/ */
@ -1219,7 +1193,6 @@ final class WP_Customize_Nav_Menus {
* Keep track of the arguments that are being passed to wp_nav_menu(). * Keep track of the arguments that are being passed to wp_nav_menu().
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @see wp_nav_menu() * @see wp_nav_menu()
* @see WP_Customize_Widgets_Partial_Refresh::filter_dynamic_sidebar_params() * @see WP_Customize_Widgets_Partial_Refresh::filter_dynamic_sidebar_params()
* *
@ -1287,7 +1260,6 @@ final class WP_Customize_Nav_Menus {
* Injects attributes into container element. * Injects attributes into container element.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see wp_nav_menu() * @see wp_nav_menu()
* *
@ -1312,7 +1284,6 @@ final class WP_Customize_Nav_Menus {
* Note that the array is expected to be pre-sorted. * Note that the array is expected to be pre-sorted.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param array $args The arguments to hash. * @param array $args The arguments to hash.
* @return string Hashed nav menu arguments. * @return string Hashed nav menu arguments.
@ -1325,7 +1296,6 @@ final class WP_Customize_Nav_Menus {
* Enqueue scripts for the Customizer preview. * Enqueue scripts for the Customizer preview.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function customize_preview_enqueue_deps() { public function customize_preview_enqueue_deps() {
wp_enqueue_script( 'customize-preview-nav-menus' ); // Note that we have overridden this. wp_enqueue_script( 'customize-preview-nav-menus' ); // Note that we have overridden this.
@ -1335,7 +1305,6 @@ final class WP_Customize_Nav_Menus {
* Exports data from PHP to JS. * Exports data from PHP to JS.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function export_preview_data() { public function export_preview_data() {
@ -1350,7 +1319,6 @@ final class WP_Customize_Nav_Menus {
* Export any wp_nav_menu() calls during the rendering of any partials. * Export any wp_nav_menu() calls during the rendering of any partials.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param array $response Response. * @param array $response Response.
* @return array Response. * @return array Response.
@ -1364,7 +1332,6 @@ final class WP_Customize_Nav_Menus {
* Render a specific menu via wp_nav_menu() using the supplied arguments. * Render a specific menu via wp_nav_menu() using the supplied arguments.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see wp_nav_menu() * @see wp_nav_menu()
* *

19
wp-includes/class-wp-customize-panel.php
View File

@ -26,7 +26,6 @@ class WP_Customize_Panel {
* @since 4.1.0 * @since 4.1.0
* *
* @static * @static
* @access protected
* @var int * @var int
*/ */
protected static $instance_count = 0; protected static $instance_count = 0;
@ -35,7 +34,6 @@ class WP_Customize_Panel {
* Order in which this instance was created in relation to other instances. * Order in which this instance was created in relation to other instances.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var int * @var int
*/ */
public $instance_number; public $instance_number;
@ -44,7 +42,6 @@ class WP_Customize_Panel {
* WP_Customize_Manager instance. * WP_Customize_Manager instance.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var WP_Customize_Manager * @var WP_Customize_Manager
*/ */
public $manager; public $manager;
@ -53,7 +50,6 @@ class WP_Customize_Panel {
* Unique identifier. * Unique identifier.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var string * @var string
*/ */
public $id; public $id;
@ -62,7 +58,6 @@ class WP_Customize_Panel {
* Priority of the panel, defining the display order of panels and sections. * Priority of the panel, defining the display order of panels and sections.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var integer * @var integer
*/ */
public $priority = 160; public $priority = 160;
@ -71,7 +66,6 @@ class WP_Customize_Panel {
* Capability required for the panel. * Capability required for the panel.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var string * @var string
*/ */
public $capability = 'edit_theme_options'; public $capability = 'edit_theme_options';
@ -80,7 +74,6 @@ class WP_Customize_Panel {
* Theme feature support for the panel. * Theme feature support for the panel.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var string|array * @var string|array
*/ */
public $theme_supports = ''; public $theme_supports = '';
@ -89,7 +82,6 @@ class WP_Customize_Panel {
* Title of the panel to show in UI. * Title of the panel to show in UI.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var string * @var string
*/ */
public $title = ''; public $title = '';
@ -98,7 +90,6 @@ class WP_Customize_Panel {
* Description to show in the UI. * Description to show in the UI.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var string * @var string
*/ */
public $description = ''; public $description = '';
@ -107,7 +98,6 @@ class WP_Customize_Panel {
* Auto-expand a section in a panel when the panel is expanded when the panel only has the one section. * Auto-expand a section in a panel when the panel is expanded when the panel only has the one section.
* *
* @since 4.7.4 * @since 4.7.4
* @access public
* @var bool * @var bool
*/ */
public $auto_expand_sole_section = false; public $auto_expand_sole_section = false;
@ -116,7 +106,6 @@ class WP_Customize_Panel {
* Customizer sections for this panel. * Customizer sections for this panel.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var array * @var array
*/ */
public $sections; public $sections;
@ -125,7 +114,6 @@ class WP_Customize_Panel {
* Type of this panel. * Type of this panel.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $type = 'default'; public $type = 'default';
@ -134,7 +122,6 @@ class WP_Customize_Panel {
* Active callback. * Active callback.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @see WP_Customize_Section::active() * @see WP_Customize_Section::active()
* *
@ -179,7 +166,6 @@ class WP_Customize_Panel {
* Check whether panel is active to current Customizer preview. * Check whether panel is active to current Customizer preview.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @return bool Whether the panel is active to the current preview. * @return bool Whether the panel is active to the current preview.
*/ */
@ -207,7 +193,6 @@ class WP_Customize_Panel {
* provide an 'active_callback' argument to the constructor. * provide an 'active_callback' argument to the constructor.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @return bool Always true. * @return bool Always true.
*/ */
@ -303,7 +288,6 @@ class WP_Customize_Panel {
* Panel containers are now rendered in JS by default, see WP_Customize_Panel::print_template(). * Panel containers are now rendered in JS by default, see WP_Customize_Panel::print_template().
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
*/ */
protected function render() {} protected function render() {}
@ -313,7 +297,6 @@ class WP_Customize_Panel {
* Panel contents are now rendered in JS by default, see WP_Customize_Panel::print_template(). * Panel contents are now rendered in JS by default, see WP_Customize_Panel::print_template().
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
*/ */
protected function render_content() {} protected function render_content() {}
@ -347,7 +330,6 @@ class WP_Customize_Panel {
* @see WP_Customize_Panel::print_template() * @see WP_Customize_Panel::print_template()
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
*/ */
protected function render_template() { protected function render_template() {
?> ?>
@ -370,7 +352,6 @@ class WP_Customize_Panel {
* @see WP_Customize_Panel::print_template() * @see WP_Customize_Panel::print_template()
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
*/ */
protected function content_template() { protected function content_template() {
?> ?>

18
wp-includes/class-wp-customize-section.php
View File

@ -26,7 +26,6 @@ class WP_Customize_Section {
* @since 4.1.0 * @since 4.1.0
* *
* @static * @static
* @access protected
* @var int * @var int
*/ */
protected static $instance_count = 0; protected static $instance_count = 0;
@ -35,7 +34,6 @@ class WP_Customize_Section {
* Order in which this instance was created in relation to other instances. * Order in which this instance was created in relation to other instances.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var int * @var int
*/ */
public $instance_number; public $instance_number;
@ -44,7 +42,6 @@ class WP_Customize_Section {
* WP_Customize_Manager instance. * WP_Customize_Manager instance.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var WP_Customize_Manager * @var WP_Customize_Manager
*/ */
public $manager; public $manager;
@ -53,7 +50,6 @@ class WP_Customize_Section {
* Unique identifier. * Unique identifier.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $id; public $id;
@ -62,7 +58,6 @@ class WP_Customize_Section {
* Priority of the section which informs load order of sections. * Priority of the section which informs load order of sections.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var integer * @var integer
*/ */
public $priority = 160; public $priority = 160;
@ -71,7 +66,6 @@ class WP_Customize_Section {
* Panel in which to show the section, making it a sub-section. * Panel in which to show the section, making it a sub-section.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @var string * @var string
*/ */
public $panel = ''; public $panel = '';
@ -80,7 +74,6 @@ class WP_Customize_Section {
* Capability required for the section. * Capability required for the section.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $capability = 'edit_theme_options'; public $capability = 'edit_theme_options';
@ -89,7 +82,6 @@ class WP_Customize_Section {
* Theme feature support for the section. * Theme feature support for the section.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string|array * @var string|array
*/ */
public $theme_supports = ''; public $theme_supports = '';
@ -98,7 +90,6 @@ class WP_Customize_Section {
* Title of the section to show in UI. * Title of the section to show in UI.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $title = ''; public $title = '';
@ -107,7 +98,6 @@ class WP_Customize_Section {
* Description to show in the UI. * Description to show in the UI.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $description = ''; public $description = '';
@ -116,7 +106,6 @@ class WP_Customize_Section {
* Customizer controls for this section. * Customizer controls for this section.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var array * @var array
*/ */
public $controls; public $controls;
@ -125,7 +114,6 @@ class WP_Customize_Section {
* Type of this section. * Type of this section.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $type = 'default'; public $type = 'default';
@ -134,7 +122,6 @@ class WP_Customize_Section {
* Active callback. * Active callback.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @see WP_Customize_Section::active() * @see WP_Customize_Section::active()
* *
@ -149,7 +136,6 @@ class WP_Customize_Section {
* Show the description or hide it behind the help icon. * Show the description or hide it behind the help icon.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @var bool Indicates whether the Section's description should be * @var bool Indicates whether the Section's description should be
* hidden behind a help icon ("?") in the Section header, * hidden behind a help icon ("?") in the Section header,
@ -191,7 +177,6 @@ class WP_Customize_Section {
* Check whether section is active to current Customizer preview. * Check whether section is active to current Customizer preview.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @return bool Whether the section is active to the current preview. * @return bool Whether the section is active to the current preview.
*/ */
@ -219,7 +204,6 @@ class WP_Customize_Section {
* an 'active_callback' argument to the constructor. * an 'active_callback' argument to the constructor.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @return true Always true. * @return true Always true.
*/ */
@ -331,7 +315,6 @@ class WP_Customize_Section {
* WP_Customize_Manager::register_section_type(). * WP_Customize_Manager::register_section_type().
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see WP_Customize_Manager::render_template() * @see WP_Customize_Manager::render_template()
*/ */
@ -350,7 +333,6 @@ class WP_Customize_Section {
* export custom variables by overriding WP_Customize_Section::json(). * export custom variables by overriding WP_Customize_Section::json().
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* *
* @see WP_Customize_Section::print_template() * @see WP_Customize_Section::print_template()
*/ */

17
wp-includes/class-wp-customize-setting.php
View File

@ -21,7 +21,6 @@ class WP_Customize_Setting {
* Customizer bootstrap instance. * Customizer bootstrap instance.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var WP_Customize_Manager * @var WP_Customize_Manager
*/ */
public $manager; public $manager;
@ -30,7 +29,6 @@ class WP_Customize_Setting {
* Unique string identifier for the setting. * Unique string identifier for the setting.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $id; public $id;
@ -39,7 +37,6 @@ class WP_Customize_Setting {
* Type of customize settings. * Type of customize settings.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $type = 'theme_mod'; public $type = 'theme_mod';
@ -48,7 +45,6 @@ class WP_Customize_Setting {
* Capability required to edit this setting. * Capability required to edit this setting.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string|array * @var string|array
*/ */
public $capability = 'edit_theme_options'; public $capability = 'edit_theme_options';
@ -57,7 +53,6 @@ class WP_Customize_Setting {
* Feature a theme is required to support to enable this setting. * Feature a theme is required to support to enable this setting.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $theme_supports = ''; public $theme_supports = '';
@ -66,7 +61,6 @@ class WP_Customize_Setting {
* The default value for the setting. * The default value for the setting.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $default = ''; public $default = '';
@ -80,7 +74,6 @@ class WP_Customize_Setting {
* @link https://developer.wordpress.org/themes/customize-api * @link https://developer.wordpress.org/themes/customize-api
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $transport = 'refresh'; public $transport = 'refresh';
@ -89,7 +82,6 @@ class WP_Customize_Setting {
* Server-side validation callback for the setting's value. * Server-side validation callback for the setting's value.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var callable * @var callable
*/ */
public $validate_callback = ''; public $validate_callback = '';
@ -98,7 +90,6 @@ class WP_Customize_Setting {
* Callback to filter a Customize setting value in un-slashed form. * Callback to filter a Customize setting value in un-slashed form.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var callable * @var callable
*/ */
public $sanitize_callback = ''; public $sanitize_callback = '';
@ -107,7 +98,6 @@ class WP_Customize_Setting {
* Callback to convert a Customize PHP setting value to a value that is JSON serializable. * Callback to convert a Customize PHP setting value to a value that is JSON serializable.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* @var string * @var string
*/ */
public $sanitize_js_callback = ''; public $sanitize_js_callback = '';
@ -121,7 +111,6 @@ class WP_Customize_Setting {
* from the start. * from the start.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* @var bool * @var bool
*/ */
public $dirty = false; public $dirty = false;
@ -130,7 +119,6 @@ class WP_Customize_Setting {
* ID Data. * ID Data.
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* @var array * @var array
*/ */
protected $id_data = array(); protected $id_data = array();
@ -139,7 +127,6 @@ class WP_Customize_Setting {
* Whether or not preview() was called. * Whether or not preview() was called.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var bool * @var bool
*/ */
protected $is_previewed = false; protected $is_previewed = false;
@ -149,7 +136,6 @@ class WP_Customize_Setting {
* *
* @since 4.4.0 * @since 4.4.0
* @static * @static
* @access protected
* @var array * @var array
*/ */
protected static $aggregated_multidimensionals = array(); protected static $aggregated_multidimensionals = array();
@ -158,7 +144,6 @@ class WP_Customize_Setting {
* Whether the multidimensional setting is aggregated. * Whether the multidimensional setting is aggregated.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var bool * @var bool
*/ */
protected $is_multidimensional_aggregated = false; protected $is_multidimensional_aggregated = false;
@ -277,7 +262,6 @@ class WP_Customize_Setting {
* The ID for the current site when the preview() method was called. * The ID for the current site when the preview() method was called.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
* @var int * @var int
*/ */
protected $_previewed_blog_id; protected $_previewed_blog_id;
@ -301,7 +285,6 @@ class WP_Customize_Setting {
* *
* @see WP_Customize_Setting::preview() * @see WP_Customize_Setting::preview()
* @since 4.1.1 * @since 4.1.1
* @access protected
* @var mixed * @var mixed
*/ */
protected $_original_value; protected $_original_value;

75
wp-includes/class-wp-customize-widgets.php
View File

@ -22,7 +22,6 @@ final class WP_Customize_Widgets {
* WP_Customize_Manager instance. * WP_Customize_Manager instance.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* @var WP_Customize_Manager * @var WP_Customize_Manager
*/ */
public $manager; public $manager;
@ -31,7 +30,6 @@ final class WP_Customize_Widgets {
* All id_bases for widgets defined in core. * All id_bases for widgets defined in core.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
* @var array * @var array
*/ */
protected $core_widget_id_bases = array( protected $core_widget_id_bases = array(
@ -56,21 +54,18 @@ final class WP_Customize_Widgets {
/** /**
* @since 3.9.0 * @since 3.9.0
* @access protected
* @var array * @var array
*/ */
protected $rendered_sidebars = array(); protected $rendered_sidebars = array();
/** /**
* @since 3.9.0 * @since 3.9.0
* @access protected
* @var array * @var array
*/ */
protected $rendered_widgets = array(); protected $rendered_widgets = array();
/** /**
* @since 3.9.0 * @since 3.9.0
* @access protected
* @var array * @var array
*/ */
protected $old_sidebars_widgets = array(); protected $old_sidebars_widgets = array();
@ -79,7 +74,6 @@ final class WP_Customize_Widgets {
* Mapping of widget ID base to whether it supports selective refresh. * Mapping of widget ID base to whether it supports selective refresh.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var array * @var array
*/ */
protected $selective_refreshable_widgets; protected $selective_refreshable_widgets;
@ -88,7 +82,6 @@ final class WP_Customize_Widgets {
* Mapping of setting type to setting ID pattern. * Mapping of setting type to setting ID pattern.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
* @var array * @var array
*/ */
protected $setting_id_patterns = array( protected $setting_id_patterns = array(
@ -100,7 +93,6 @@ final class WP_Customize_Widgets {
* Initial loader. * Initial loader.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param WP_Customize_Manager $manager Customize manager bootstrap instance. * @param WP_Customize_Manager $manager Customize manager bootstrap instance.
*/ */
@ -143,7 +135,6 @@ final class WP_Customize_Widgets {
* then this will always return an empty array. * then this will always return an empty array.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @global WP_Widget_Factory $wp_widget_factory * @global WP_Widget_Factory $wp_widget_factory
* *
@ -168,7 +159,6 @@ final class WP_Customize_Widgets {
* Determines if a widget supports selective refresh. * Determines if a widget supports selective refresh.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $id_base Widget ID Base. * @param string $id_base Widget ID Base.
* @return bool Whether the widget can be selective refreshed. * @return bool Whether the widget can be selective refreshed.
@ -182,7 +172,6 @@ final class WP_Customize_Widgets {
* Retrieves the widget setting type given a setting ID. * Retrieves the widget setting type given a setting ID.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
* *
* @staticvar array $cache * @staticvar array $cache
* *
@ -207,7 +196,6 @@ final class WP_Customize_Widgets {
* them up-front so widgets will be initialized properly. * them up-front so widgets will be initialized properly.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
*/ */
public function register_settings() { public function register_settings() {
$widget_setting_ids = array(); $widget_setting_ids = array();
@ -239,7 +227,6 @@ final class WP_Customize_Widgets {
* Determines the arguments for a dynamically-created setting. * Determines the arguments for a dynamically-created setting.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* *
* @param false|array $args The arguments to the WP_Customize_Setting constructor. * @param false|array $args The arguments to the WP_Customize_Setting constructor.
* @param string $setting_id ID for dynamic setting, usually coming from `$_POST['customized']`. * @param string $setting_id ID for dynamic setting, usually coming from `$_POST['customized']`.
@ -256,7 +243,6 @@ final class WP_Customize_Widgets {
* Retrieves an unslashed post value or return a default. * Retrieves an unslashed post value or return a default.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
* *
* @param string $name Post value. * @param string $name Post value.
* @param mixed $default Default post value. * @param mixed $default Default post value.
@ -280,7 +266,6 @@ final class WP_Customize_Widgets {
* theme gets switched. * theme gets switched.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @global array $sidebars_widgets * @global array $sidebars_widgets
* @global array $_wp_sidebars_widgets * @global array $_wp_sidebars_widgets
@ -313,7 +298,6 @@ final class WP_Customize_Widgets {
* theme_mod. * theme_mod.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @see WP_Customize_Widgets::handle_theme_switch() * @see WP_Customize_Widgets::handle_theme_switch()
* *
@ -332,7 +316,6 @@ final class WP_Customize_Widgets {
* option. * option.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @see WP_Customize_Widgets::handle_theme_switch() * @see WP_Customize_Widgets::handle_theme_switch()
* @global array $sidebars_widgets * @global array $sidebars_widgets
@ -352,7 +335,6 @@ final class WP_Customize_Widgets {
* Note: these actions are also fired in wp_ajax_update_widget(). * Note: these actions are also fired in wp_ajax_update_widget().
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function customize_controls_init() { public function customize_controls_init() {
/** This action is documented in wp-admin/includes/ajax-actions.php */ /** This action is documented in wp-admin/includes/ajax-actions.php */
@ -372,7 +354,6 @@ final class WP_Customize_Widgets {
* so that all filters have been initialized (e.g. Widget Visibility). * so that all filters have been initialized (e.g. Widget Visibility).
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function schedule_customize_register() { public function schedule_customize_register() {
if ( is_admin() ) { if ( is_admin() ) {
@ -386,7 +367,6 @@ final class WP_Customize_Widgets {
* Registers Customizer settings and controls for all sidebars and widgets. * Registers Customizer settings and controls for all sidebars and widgets.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @global array $wp_registered_widgets * @global array $wp_registered_widgets
* @global array $wp_registered_widget_controls * @global array $wp_registered_widget_controls
@ -537,7 +517,6 @@ final class WP_Customize_Widgets {
* Determines whether the widgets panel is active, based on whether there are sidebars registered. * Determines whether the widgets panel is active, based on whether there are sidebars registered.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @see WP_Customize_Panel::$active_callback * @see WP_Customize_Panel::$active_callback
* *
@ -553,7 +532,6 @@ final class WP_Customize_Widgets {
* Converts a widget_id into its corresponding Customizer setting ID (option name). * Converts a widget_id into its corresponding Customizer setting ID (option name).
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param string $widget_id Widget ID. * @param string $widget_id Widget ID.
* @return string Maybe-parsed widget ID. * @return string Maybe-parsed widget ID.
@ -579,7 +557,6 @@ final class WP_Customize_Widgets {
* overridden with the {@see 'is_wide_widget_in_customizer'} filter. * overridden with the {@see 'is_wide_widget_in_customizer'} filter.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @global $wp_registered_widget_controls * @global $wp_registered_widget_controls
* *
@ -609,7 +586,6 @@ final class WP_Customize_Widgets {
* Converts a widget ID into its id_base and number components. * Converts a widget ID into its id_base and number components.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param string $widget_id Widget ID. * @param string $widget_id Widget ID.
* @return array Array containing a widget's id_base and number components. * @return array Array containing a widget's id_base and number components.
@ -634,7 +610,6 @@ final class WP_Customize_Widgets {
* Converts a widget setting ID (option path) to its id_base and number components. * Converts a widget setting ID (option path) to its id_base and number components.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param string $setting_id Widget setting ID. * @param string $setting_id Widget setting ID.
* @return WP_Error|array Array containing a widget's id_base and number components, * @return WP_Error|array Array containing a widget's id_base and number components,
@ -656,7 +631,6 @@ final class WP_Customize_Widgets {
* allow custom styles from plugins. * allow custom styles from plugins.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function print_styles() { public function print_styles() {
/** This action is documented in wp-admin/admin-header.php */ /** This action is documented in wp-admin/admin-header.php */
@ -671,7 +645,6 @@ final class WP_Customize_Widgets {
* allow custom scripts from plugins. * allow custom scripts from plugins.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function print_scripts() { public function print_scripts() {
/** This action is documented in wp-admin/admin-header.php */ /** This action is documented in wp-admin/admin-header.php */
@ -685,7 +658,6 @@ final class WP_Customize_Widgets {
* Enqueues scripts and styles for Customizer panel and export data to JavaScript. * Enqueues scripts and styles for Customizer panel and export data to JavaScript.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @global WP_Scripts $wp_scripts * @global WP_Scripts $wp_scripts
* @global array $wp_registered_sidebars * @global array $wp_registered_sidebars
@ -822,7 +794,6 @@ final class WP_Customize_Widgets {
* Renders the widget form control templates into the DOM. * Renders the widget form control templates into the DOM.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function output_widget_control_templates() { public function output_widget_control_templates() {
?> ?>
@ -865,7 +836,6 @@ final class WP_Customize_Widgets {
* allow custom scripts from plugins. * allow custom scripts from plugins.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function print_footer_scripts() { public function print_footer_scripts() {
/** This action is documented in wp-admin/admin-footer.php */ /** This action is documented in wp-admin/admin-footer.php */
@ -882,7 +852,6 @@ final class WP_Customize_Widgets {
* Retrieves common arguments to supply when constructing a Customizer setting. * Retrieves common arguments to supply when constructing a Customizer setting.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param string $id Widget setting ID. * @param string $id Widget setting ID.
* @param array $overrides Array of setting overrides. * @param array $overrides Array of setting overrides.
@ -926,7 +895,6 @@ final class WP_Customize_Widgets {
* Used as the 'sanitize_callback' for each $sidebars_widgets setting. * Used as the 'sanitize_callback' for each $sidebars_widgets setting.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param array $widget_ids Array of widget IDs. * @param array $widget_ids Array of widget IDs.
* @return array Array of sanitized widget IDs. * @return array Array of sanitized widget IDs.
@ -944,7 +912,6 @@ final class WP_Customize_Widgets {
* Builds up an index of all available widgets for use in Backbone models. * Builds up an index of all available widgets for use in Backbone models.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @global array $wp_registered_widgets * @global array $wp_registered_widgets
* @global array $wp_registered_widget_controls * @global array $wp_registered_widget_controls
@ -1031,7 +998,6 @@ final class WP_Customize_Widgets {
* Naturally orders available widgets by name. * Naturally orders available widgets by name.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
* *
* @param array $widget_a The first widget to compare. * @param array $widget_a The first widget to compare.
* @param array $widget_b The second widget to compare. * @param array $widget_b The second widget to compare.
@ -1045,7 +1011,6 @@ final class WP_Customize_Widgets {
* Retrieves the widget control markup. * Retrieves the widget control markup.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param array $args Widget control arguments. * @param array $args Widget control arguments.
* @return string Widget control form HTML markup. * @return string Widget control form HTML markup.
@ -1065,7 +1030,6 @@ final class WP_Customize_Widgets {
* Retrieves the widget control markup parts. * Retrieves the widget control markup parts.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $args Widget control arguments. * @param array $args Widget control arguments.
* @return array { * @return array {
@ -1096,7 +1060,6 @@ final class WP_Customize_Widgets {
* Adds hooks for the Customizer preview. * Adds hooks for the Customizer preview.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function customize_preview_init() { public function customize_preview_init() {
add_action( 'wp_enqueue_scripts', array( $this, 'customize_preview_enqueue' ) ); add_action( 'wp_enqueue_scripts', array( $this, 'customize_preview_enqueue' ) );
@ -1108,7 +1071,6 @@ final class WP_Customize_Widgets {
* Refreshes the nonce for widget updates. * Refreshes the nonce for widget updates.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* *
* @param array $nonces Array of nonces. * @param array $nonces Array of nonces.
* @return array $nonces Array of nonces. * @return array $nonces Array of nonces.
@ -1127,7 +1089,6 @@ final class WP_Customize_Widgets {
* filter is added, it has to be reset after the filter has been added. * filter is added, it has to be reset after the filter has been added.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param array $sidebars_widgets List of widgets for the current sidebar. * @param array $sidebars_widgets List of widgets for the current sidebar.
* @return array * @return array
@ -1143,7 +1104,6 @@ final class WP_Customize_Widgets {
* Enqueues scripts for the Customizer preview. * Enqueues scripts for the Customizer preview.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function customize_preview_enqueue() { public function customize_preview_enqueue() {
wp_enqueue_script( 'customize-preview-widgets' ); wp_enqueue_script( 'customize-preview-widgets' );
@ -1154,7 +1114,6 @@ final class WP_Customize_Widgets {
* stylesheet can override. * stylesheet can override.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function print_preview_css() { public function print_preview_css() {
?> ?>
@ -1215,7 +1174,6 @@ final class WP_Customize_Widgets {
* Tracks the widgets that were rendered. * Tracks the widgets that were rendered.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param array $widget Rendered widget to tally. * @param array $widget Rendered widget to tally.
*/ */
@ -1227,7 +1185,6 @@ final class WP_Customize_Widgets {
* Determine if a widget is rendered on the page. * Determine if a widget is rendered on the page.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $widget_id Widget ID to check. * @param string $widget_id Widget ID to check.
* @return bool Whether the widget is rendered. * @return bool Whether the widget is rendered.
@ -1240,7 +1197,6 @@ final class WP_Customize_Widgets {
* Determines if a sidebar is rendered on the page. * Determines if a sidebar is rendered on the page.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $sidebar_id Sidebar ID to check. * @param string $sidebar_id Sidebar ID to check.
* @return bool Whether the sidebar is rendered. * @return bool Whether the sidebar is rendered.
@ -1257,7 +1213,6 @@ final class WP_Customize_Widgets {
* if there were widgets populating it. * if there were widgets populating it.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param bool $is_active Whether the sidebar is active. * @param bool $is_active Whether the sidebar is active.
* @param string $sidebar_id Sidebar ID. * @param string $sidebar_id Sidebar ID.
@ -1283,7 +1238,6 @@ final class WP_Customize_Widgets {
* there were widgets populating it. * there were widgets populating it.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param bool $has_widgets Whether the current sidebar has widgets. * @param bool $has_widgets Whether the current sidebar has widgets.
* @param string $sidebar_id Sidebar ID. * @param string $sidebar_id Sidebar ID.
@ -1309,7 +1263,6 @@ final class WP_Customize_Widgets {
* data has occurred. * data has occurred.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
* *
* @param string $serialized_instance Widget instance. * @param string $serialized_instance Widget instance.
* @return string MAC for serialized widget instance. * @return string MAC for serialized widget instance.
@ -1325,7 +1278,6 @@ final class WP_Customize_Widgets {
* only get applied to an instance *once*. * only get applied to an instance *once*.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param array $value Widget instance to sanitize. * @param array $value Widget instance to sanitize.
* @return array|void Sanitized widget instance. * @return array|void Sanitized widget instance.
@ -1363,7 +1315,6 @@ final class WP_Customize_Widgets {
* Converts a widget instance into JSON-representable format. * Converts a widget instance into JSON-representable format.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param array $value Widget instance to convert to JSON. * @param array $value Widget instance to convert to JSON.
* @return array JSON-converted widget instance. * @return array JSON-converted widget instance.
@ -1389,7 +1340,6 @@ final class WP_Customize_Widgets {
* in a sidebar upon deactivation. * in a sidebar upon deactivation.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @global array $wp_registered_widgets * @global array $wp_registered_widgets
* *
@ -1408,7 +1358,6 @@ final class WP_Customize_Widgets {
* Requires that `$_POST` be populated with the instance data. * Requires that `$_POST` be populated with the instance data.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @global array $wp_registered_widget_updates * @global array $wp_registered_widget_updates
* @global array $wp_registered_widget_controls * @global array $wp_registered_widget_controls
@ -1538,7 +1487,6 @@ final class WP_Customize_Widgets {
* Most code here copied from wp_ajax_save_widget(). * Most code here copied from wp_ajax_save_widget().
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @see wp_ajax_save_widget() * @see wp_ajax_save_widget()
*/ */
@ -1601,7 +1549,6 @@ final class WP_Customize_Widgets {
* Filters arguments for dynamic widget partials. * Filters arguments for dynamic widget partials.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param array|false $partial_args Partial arguments. * @param array|false $partial_args Partial arguments.
* @param string $partial_id Partial ID. * @param string $partial_id Partial ID.
@ -1635,7 +1582,6 @@ final class WP_Customize_Widgets {
* Adds hooks for selective refresh. * Adds hooks for selective refresh.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
*/ */
public function selective_refresh_init() { public function selective_refresh_init() {
if ( ! current_theme_supports( 'customize-selective-refresh-widgets' ) ) { if ( ! current_theme_supports( 'customize-selective-refresh-widgets' ) ) {
@ -1711,7 +1657,6 @@ final class WP_Customize_Widgets {
* data-* attributes can be whitelisted. * data-* attributes can be whitelisted.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var array * @var array
*/ */
protected $before_widget_tags_seen = array(); protected $before_widget_tags_seen = array();
@ -1722,7 +1667,6 @@ final class WP_Customize_Widgets {
* This is needed in case the `$before_widget` is run through wp_kses() when printed. * This is needed in case the `$before_widget` is run through wp_kses() when printed.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param array $allowed_html Allowed HTML. * @param array $allowed_html Allowed HTML.
* @return array (Maybe) modified allowed HTML. * @return array (Maybe) modified allowed HTML.
@ -1752,7 +1696,6 @@ final class WP_Customize_Widgets {
* This helps facilitate the uncommon scenario where a single sidebar is rendered multiple times on a template. * This helps facilitate the uncommon scenario where a single sidebar is rendered multiple times on a template.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var array * @var array
*/ */
protected $sidebar_instance_count = array(); protected $sidebar_instance_count = array();
@ -1761,7 +1704,6 @@ final class WP_Customize_Widgets {
* The current request's sidebar_instance_number context. * The current request's sidebar_instance_number context.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var int * @var int
*/ */
protected $context_sidebar_instance_number; protected $context_sidebar_instance_number;
@ -1770,7 +1712,6 @@ final class WP_Customize_Widgets {
* Current sidebar ID being rendered. * Current sidebar ID being rendered.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var array * @var array
*/ */
protected $current_dynamic_sidebar_id_stack = array(); protected $current_dynamic_sidebar_id_stack = array();
@ -1781,7 +1722,6 @@ final class WP_Customize_Widgets {
* Insert marker before widgets are rendered in a dynamic sidebar. * Insert marker before widgets are rendered in a dynamic sidebar.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param int|string $index Index, name, or ID of the dynamic sidebar. * @param int|string $index Index, name, or ID of the dynamic sidebar.
*/ */
@ -1802,7 +1742,6 @@ final class WP_Customize_Widgets {
* Inserts a marker after widgets are rendered in a dynamic sidebar. * Inserts a marker after widgets are rendered in a dynamic sidebar.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param int|string $index Index, name, or ID of the dynamic sidebar. * @param int|string $index Index, name, or ID of the dynamic sidebar.
*/ */
@ -1817,7 +1756,6 @@ final class WP_Customize_Widgets {
* Current sidebar being rendered. * Current sidebar being rendered.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var string * @var string
*/ */
protected $rendering_widget_id; protected $rendering_widget_id;
@ -1826,7 +1764,6 @@ final class WP_Customize_Widgets {
* Current widget being rendered. * Current widget being rendered.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var string * @var string
*/ */
protected $rendering_sidebar_id; protected $rendering_sidebar_id;
@ -1835,7 +1772,6 @@ final class WP_Customize_Widgets {
* Filters sidebars_widgets to ensure the currently-rendered widget is the only widget in the current sidebar. * Filters sidebars_widgets to ensure the currently-rendered widget is the only widget in the current sidebar.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* *
* @param array $sidebars_widgets Sidebars widgets. * @param array $sidebars_widgets Sidebars widgets.
* @return array Filtered sidebars widgets. * @return array Filtered sidebars widgets.
@ -1849,7 +1785,6 @@ final class WP_Customize_Widgets {
* Renders a specific widget using the supplied sidebar arguments. * Renders a specific widget using the supplied sidebar arguments.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @see dynamic_sidebar() * @see dynamic_sidebar()
* *
@ -1908,7 +1843,6 @@ final class WP_Customize_Widgets {
* List of captured widget option updates. * List of captured widget option updates.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
* @var array $_captured_options Values updated while option capture is happening. * @var array $_captured_options Values updated while option capture is happening.
*/ */
protected $_captured_options = array(); protected $_captured_options = array();
@ -1917,7 +1851,6 @@ final class WP_Customize_Widgets {
* Whether option capture is currently happening. * Whether option capture is currently happening.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
* @var bool $_is_current Whether option capture is currently happening or not. * @var bool $_is_current Whether option capture is currently happening or not.
*/ */
protected $_is_capturing_option_updates = false; protected $_is_capturing_option_updates = false;
@ -1926,7 +1859,6 @@ final class WP_Customize_Widgets {
* Determines whether the captured option update should be ignored. * Determines whether the captured option update should be ignored.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
* *
* @param string $option_name Option name. * @param string $option_name Option name.
* @return bool Whether the option capture is ignored. * @return bool Whether the option capture is ignored.
@ -1939,7 +1871,6 @@ final class WP_Customize_Widgets {
* Retrieves captured widget option updates. * Retrieves captured widget option updates.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
* *
* @return array Array of captured options. * @return array Array of captured options.
*/ */
@ -1951,7 +1882,6 @@ final class WP_Customize_Widgets {
* Retrieves the option that was captured from being saved. * Retrieves the option that was captured from being saved.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
* *
* @param string $option_name Option name. * @param string $option_name Option name.
* @param mixed $default Optional. Default value to return if the option does not exist. Default false. * @param mixed $default Optional. Default value to return if the option does not exist. Default false.
@ -1970,7 +1900,6 @@ final class WP_Customize_Widgets {
* Retrieves the number of captured widget option updates. * Retrieves the number of captured widget option updates.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
* *
* @return int Number of updated options. * @return int Number of updated options.
*/ */
@ -1982,7 +1911,6 @@ final class WP_Customize_Widgets {
* Begins keeping track of changes to widget options, caching new values. * Begins keeping track of changes to widget options, caching new values.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
*/ */
protected function start_capturing_option_updates() { protected function start_capturing_option_updates() {
if ( $this->_is_capturing_option_updates ) { if ( $this->_is_capturing_option_updates ) {
@ -1998,7 +1926,6 @@ final class WP_Customize_Widgets {
* Pre-filters captured option values before updating. * Pre-filters captured option values before updating.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param mixed $new_value The new option value. * @param mixed $new_value The new option value.
* @param string $option_name Name of the option. * @param string $option_name Name of the option.
@ -2023,7 +1950,6 @@ final class WP_Customize_Widgets {
* Pre-filters captured option values before retrieving. * Pre-filters captured option values before retrieving.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @param mixed $value Value to return instead of the option value. * @param mixed $value Value to return instead of the option value.
* @return mixed Filtered option value. * @return mixed Filtered option value.
@ -2045,7 +1971,6 @@ final class WP_Customize_Widgets {
* Undoes any changes to the options since options capture began. * Undoes any changes to the options since options capture began.
* *
* @since 3.9.0 * @since 3.9.0
* @access protected
*/ */
protected function stop_capturing_option_updates() { protected function stop_capturing_option_updates() {
if ( ! $this->_is_capturing_option_updates ) { if ( ! $this->_is_capturing_option_updates ) {

7
wp-includes/class-wp-dependency.php
View File

@ -20,7 +20,6 @@ class _WP_Dependency {
/** /**
* The handle name. * The handle name.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @var null * @var null
*/ */
@ -29,7 +28,6 @@ class _WP_Dependency {
/** /**
* The handle source. * The handle source.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @var null * @var null
*/ */
@ -38,7 +36,6 @@ class _WP_Dependency {
/** /**
* An array of handle dependencies. * An array of handle dependencies.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @var array * @var array
*/ */
@ -49,7 +46,6 @@ class _WP_Dependency {
* *
* Used for cache-busting. * Used for cache-busting.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @var bool|string * @var bool|string
*/ */
@ -58,7 +54,6 @@ class _WP_Dependency {
/** /**
* Additional arguments for the handle. * Additional arguments for the handle.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @var null * @var null
*/ */
@ -67,7 +62,6 @@ class _WP_Dependency {
/** /**
* Extra data to supply to the handle. * Extra data to supply to the handle.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @var array * @var array
*/ */
@ -87,7 +81,6 @@ class _WP_Dependency {
/** /**
* Add handle data. * Add handle data.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* *
* @param string $name The data key to add. * @param string $name The data key to add.

1
wp-includes/class-wp-embed.php
View File

@ -20,7 +20,6 @@ class WP_Embed {
* *
* Bypasses the {@see 'embed_maybe_make_link'} filter. * Bypasses the {@see 'embed_maybe_make_link'} filter.
* *
* @access public
* @var bool * @var bool
*/ */
public $return_false_on_fail = false; public $return_false_on_fail = false;

3
wp-includes/class-wp-error.php
View File

@ -65,7 +65,6 @@ class WP_Error {
* Retrieve all error codes. * Retrieve all error codes.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @return array List of error codes, if available. * @return array List of error codes, if available.
*/ */
@ -80,7 +79,6 @@ class WP_Error {
* Retrieve first error code available. * Retrieve first error code available.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @return string|int Empty string, if no error codes. * @return string|int Empty string, if no error codes.
*/ */
@ -157,7 +155,6 @@ class WP_Error {
* Add an error or append additional message to an existing error. * Add an error or append additional message to an existing error.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string|int $code Error code. * @param string|int $code Error code.
* @param string $message Error message. * @param string $message Error message.

9
wp-includes/class-wp-feed-cache-transient.php
View File

@ -18,7 +18,6 @@ class WP_Feed_Cache_Transient {
* Holds the transient name. * Holds the transient name.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $name; public $name;
@ -27,7 +26,6 @@ class WP_Feed_Cache_Transient {
* Holds the transient mod name. * Holds the transient mod name.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $mod_name; public $mod_name;
@ -38,7 +36,6 @@ class WP_Feed_Cache_Transient {
* Defaults to 43200 seconds (12 hours). * Defaults to 43200 seconds (12 hours).
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var int * @var int
*/ */
public $lifetime = 43200; public $lifetime = 43200;
@ -48,7 +45,6 @@ class WP_Feed_Cache_Transient {
* *
* @since 2.8.0 * @since 2.8.0
* @since 3.2.0 Updated to use a PHP5 constructor. * @since 3.2.0 Updated to use a PHP5 constructor.
* @access public
* *
* @param string $location URL location (scheme is used to determine handler). * @param string $location URL location (scheme is used to determine handler).
* @param string $filename Unique identifier for cache object. * @param string $filename Unique identifier for cache object.
@ -74,7 +70,6 @@ class WP_Feed_Cache_Transient {
* Sets the transient. * Sets the transient.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param SimplePie $data Data to save. * @param SimplePie $data Data to save.
* @return true Always true. * @return true Always true.
@ -93,7 +88,6 @@ class WP_Feed_Cache_Transient {
* Gets the transient. * Gets the transient.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @return mixed Transient value. * @return mixed Transient value.
*/ */
@ -105,7 +99,6 @@ class WP_Feed_Cache_Transient {
* Gets mod transient. * Gets mod transient.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @return mixed Transient value. * @return mixed Transient value.
*/ */
@ -117,7 +110,6 @@ class WP_Feed_Cache_Transient {
* Sets mod transient. * Sets mod transient.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @return bool False if value was not set and true if value was set. * @return bool False if value was not set and true if value was set.
*/ */
@ -129,7 +121,6 @@ class WP_Feed_Cache_Transient {
* Deletes transients. * Deletes transients.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @return true Always true. * @return true Always true.
*/ */

1
wp-includes/class-wp-feed-cache.php
View File

@ -20,7 +20,6 @@ class WP_Feed_Cache extends SimplePie_Cache {
* Creates a new SimplePie_Cache object. * Creates a new SimplePie_Cache object.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param string $location URL location (scheme is used to determine handler). * @param string $location URL location (scheme is used to determine handler).
* @param string $filename Unique identifier for cache object. * @param string $filename Unique identifier for cache object.

25
wp-includes/class-wp-hook.php
View File

@ -21,7 +21,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Hook callbacks. * Hook callbacks.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var array * @var array
*/ */
public $callbacks = array(); public $callbacks = array();
@ -30,7 +29,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* The priority keys of actively running iterations of a hook. * The priority keys of actively running iterations of a hook.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var array * @var array
*/ */
private $iterations = array(); private $iterations = array();
@ -39,7 +37,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* The current priority of actively running iterations of a hook. * The current priority of actively running iterations of a hook.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var array * @var array
*/ */
private $current_priority = array(); private $current_priority = array();
@ -48,7 +45,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Number of levels this hook can be recursively called. * Number of levels this hook can be recursively called.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var int * @var int
*/ */
private $nesting_level = 0; private $nesting_level = 0;
@ -57,7 +53,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Flag for if we're current doing an action, rather than a filter. * Flag for if we're current doing an action, rather than a filter.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var bool * @var bool
*/ */
private $doing_action = false; private $doing_action = false;
@ -66,7 +61,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Hooks a function or method to a specific filter action. * Hooks a function or method to a specific filter action.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param string $tag The name of the filter to hook the $function_to_add callback to. * @param string $tag The name of the filter to hook the $function_to_add callback to.
* @param callable $function_to_add The callback to be run when the filter is applied. * @param callable $function_to_add The callback to be run when the filter is applied.
@ -99,7 +93,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Handles reseting callback priority keys mid-iteration. * Handles reseting callback priority keys mid-iteration.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @param bool|int $new_priority Optional. The priority of the new filter being added. Default false, * @param bool|int $new_priority Optional. The priority of the new filter being added. Default false,
* for no priority being added. * for no priority being added.
@ -168,7 +161,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Unhooks a function or method from a specific filter action. * Unhooks a function or method from a specific filter action.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param string $tag The filter hook to which the function to be removed is hooked. Used * @param string $tag The filter hook to which the function to be removed is hooked. Used
* for building the callback ID when SPL is not available. * for building the callback ID when SPL is not available.
@ -196,7 +188,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Checks if a specific action has been registered for this hook. * Checks if a specific action has been registered for this hook.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param callable|bool $function_to_check Optional. The callback to check for. Default false. * @param callable|bool $function_to_check Optional. The callback to check for. Default false.
* @param string $tag Optional. The name of the filter hook. Used for building * @param string $tag Optional. The name of the filter hook. Used for building
@ -226,7 +217,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Checks if any callbacks have been registered for this hook. * Checks if any callbacks have been registered for this hook.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return bool True if callbacks have been registered for the current hook, otherwise false. * @return bool True if callbacks have been registered for the current hook, otherwise false.
*/ */
@ -243,7 +233,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Removes all callbacks from the current filter. * Removes all callbacks from the current filter.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param int|bool $priority Optional. The priority number to remove. Default false. * @param int|bool $priority Optional. The priority number to remove. Default false.
*/ */
@ -267,7 +256,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Calls the callback functions added to a filter hook. * Calls the callback functions added to a filter hook.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param mixed $value The value to filter. * @param mixed $value The value to filter.
* @param array $args Arguments to pass to callbacks. * @param array $args Arguments to pass to callbacks.
@ -314,7 +302,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Executes the callback functions hooked on a specific action hook. * Executes the callback functions hooked on a specific action hook.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param mixed $args Arguments to pass to the hook callbacks. * @param mixed $args Arguments to pass to the hook callbacks.
*/ */
@ -332,7 +319,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Processes the functions hooked into the 'all' hook. * Processes the functions hooked into the 'all' hook.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param array $args Arguments to pass to the hook callbacks. Passed by reference. * @param array $args Arguments to pass to the hook callbacks. Passed by reference.
*/ */
@ -355,7 +341,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Return the current priority level of the currently running iteration of the hook. * Return the current priority level of the currently running iteration of the hook.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return int|false If the hook is running, return the current priority level. If it isn't running, return false. * @return int|false If the hook is running, return the current priority level. If it isn't running, return false.
*/ */
@ -371,7 +356,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Normalizes filters set up before WordPress has initialized to WP_Hook objects. * Normalizes filters set up before WordPress has initialized to WP_Hook objects.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @static * @static
* *
* @param array $filters Filters to normalize. * @param array $filters Filters to normalize.
@ -405,7 +389,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Determines whether an offset value exists. * Determines whether an offset value exists.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @link https://secure.php.net/manual/en/arrayaccess.offsetexists.php * @link https://secure.php.net/manual/en/arrayaccess.offsetexists.php
* *
@ -420,7 +403,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Retrieves a value at a specified offset. * Retrieves a value at a specified offset.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @link https://secure.php.net/manual/en/arrayaccess.offsetget.php * @link https://secure.php.net/manual/en/arrayaccess.offsetget.php
* *
@ -435,7 +417,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Sets a value at a specified offset. * Sets a value at a specified offset.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @link https://secure.php.net/manual/en/arrayaccess.offsetset.php * @link https://secure.php.net/manual/en/arrayaccess.offsetset.php
* *
@ -454,7 +435,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Unsets a specified offset. * Unsets a specified offset.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @link https://secure.php.net/manual/en/arrayaccess.offsetunset.php * @link https://secure.php.net/manual/en/arrayaccess.offsetunset.php
* *
@ -468,7 +448,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Returns the current element. * Returns the current element.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @link https://secure.php.net/manual/en/iterator.current.php * @link https://secure.php.net/manual/en/iterator.current.php
* *
@ -482,7 +461,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Moves forward to the next element. * Moves forward to the next element.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @link https://secure.php.net/manual/en/iterator.next.php * @link https://secure.php.net/manual/en/iterator.next.php
* *
@ -496,7 +474,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Returns the key of the current element. * Returns the key of the current element.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @link https://secure.php.net/manual/en/iterator.key.php * @link https://secure.php.net/manual/en/iterator.key.php
* *
@ -510,7 +487,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Checks if current position is valid. * Checks if current position is valid.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @link https://secure.php.net/manual/en/iterator.valid.php * @link https://secure.php.net/manual/en/iterator.valid.php
* *
@ -524,7 +500,6 @@ final class WP_Hook implements Iterator, ArrayAccess {
* Rewinds the Iterator to the first element. * Rewinds the Iterator to the first element.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @link https://secure.php.net/manual/en/iterator.rewind.php * @link https://secure.php.net/manual/en/iterator.rewind.php
*/ */

5
wp-includes/class-wp-http-cookie.php
View File

@ -67,7 +67,6 @@ class WP_Http_Cookie {
* or a header string detailing it. * or a header string detailing it.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param string|array $data { * @param string|array $data {
* Raw cookie data as header string or data array. * Raw cookie data as header string or data array.
@ -140,7 +139,6 @@ class WP_Http_Cookie {
* *
* Decision is based on RFC 2109/2965, so look there for details on validity. * Decision is based on RFC 2109/2965, so look there for details on validity.
* *
* @access public
* @since 2.8.0 * @since 2.8.0
* *
* @param string $url URL you intend to send this cookie to * @param string $url URL you intend to send this cookie to
@ -185,7 +183,6 @@ class WP_Http_Cookie {
/** /**
* Convert cookie name and value back to header string. * Convert cookie name and value back to header string.
* *
* @access public
* @since 2.8.0 * @since 2.8.0
* *
* @return string Header encoded cookie name and value. * @return string Header encoded cookie name and value.
@ -208,7 +205,6 @@ class WP_Http_Cookie {
/** /**
* Retrieve cookie header for usage in the rest of the WordPress HTTP API. * Retrieve cookie header for usage in the rest of the WordPress HTTP API.
* *
* @access public
* @since 2.8.0 * @since 2.8.0
* *
* @return string * @return string
@ -221,7 +217,6 @@ class WP_Http_Cookie {
* Retrieves cookie attributes. * Retrieves cookie attributes.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @return array { * @return array {
* List of attributes. * List of attributes.

8
wp-includes/class-wp-http-curl.php
View File

@ -22,7 +22,6 @@ class WP_Http_Curl {
* Temporary header storage for during requests. * Temporary header storage for during requests.
* *
* @since 3.2.0 * @since 3.2.0
* @access private
* @var string * @var string
*/ */
private $headers = ''; private $headers = '';
@ -31,7 +30,6 @@ class WP_Http_Curl {
* Temporary body storage for during requests. * Temporary body storage for during requests.
* *
* @since 3.6.0 * @since 3.6.0
* @access private
* @var string * @var string
*/ */
private $body = ''; private $body = '';
@ -40,7 +38,6 @@ class WP_Http_Curl {
* The maximum amount of data to receive from the remote server. * The maximum amount of data to receive from the remote server.
* *
* @since 3.6.0 * @since 3.6.0
* @access private
* @var int * @var int
*/ */
private $max_body_length = false; private $max_body_length = false;
@ -49,7 +46,6 @@ class WP_Http_Curl {
* The file resource used for streaming to file. * The file resource used for streaming to file.
* *
* @since 3.6.0 * @since 3.6.0
* @access private
* @var resource * @var resource
*/ */
private $stream_handle = false; private $stream_handle = false;
@ -58,7 +54,6 @@ class WP_Http_Curl {
* The total bytes written in the current request. * The total bytes written in the current request.
* *
* @since 4.1.0 * @since 4.1.0
* @access private
* @var int * @var int
*/ */
private $bytes_written_total = 0; private $bytes_written_total = 0;
@ -66,7 +61,6 @@ class WP_Http_Curl {
/** /**
* Send a HTTP request to a URI using cURL extension. * Send a HTTP request to a URI using cURL extension.
* *
* @access public
* @since 2.7.0 * @since 2.7.0
* *
* @param string $url The request URL. * @param string $url The request URL.
@ -304,7 +298,6 @@ class WP_Http_Curl {
* for temporary storage * for temporary storage
* *
* @since 3.2.0 * @since 3.2.0
* @access private
* *
* @param resource $handle cURL handle. * @param resource $handle cURL handle.
* @param string $headers cURL request headers. * @param string $headers cURL request headers.
@ -323,7 +316,6 @@ class WP_Http_Curl {
* `$data` passed in will cause cURL to abort the request with `CURLE_WRITE_ERROR`. * `$data` passed in will cause cURL to abort the request with `CURLE_WRITE_ERROR`.
* *
* @since 3.6.0 * @since 3.6.0
* @access private
* *
* @param resource $handle cURL handle. * @param resource $handle cURL handle.
* @param string $data cURL request body. * @param string $data cURL request body.

13
wp-includes/class-wp-http-requests-response.php
View File

@ -19,7 +19,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Requests Response object. * Requests Response object.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* @var Requests_Response * @var Requests_Response
*/ */
protected $response; protected $response;
@ -28,7 +27,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Filename the response was saved to. * Filename the response was saved to.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* @var string|null * @var string|null
*/ */
protected $filename; protected $filename;
@ -37,7 +35,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Constructor. * Constructor.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param Requests_Response $response HTTP response. * @param Requests_Response $response HTTP response.
* @param string $filename Optional. File name. Default empty. * @param string $filename Optional. File name. Default empty.
@ -51,7 +48,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Retrieves the response object for the request. * Retrieves the response object for the request.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @return Requests_Response HTTP response. * @return Requests_Response HTTP response.
*/ */
@ -63,7 +59,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Retrieves headers associated with the response. * Retrieves headers associated with the response.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @see \Requests_Utility_CaseInsensitiveDictionary * @see \Requests_Utility_CaseInsensitiveDictionary
* *
@ -88,7 +83,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Sets all header values. * Sets all header values.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param array $headers Map of header name to header value. * @param array $headers Map of header name to header value.
*/ */
@ -100,7 +94,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Sets a single HTTP header. * Sets a single HTTP header.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string $key Header name. * @param string $key Header name.
* @param string $value Header value. * @param string $value Header value.
@ -119,7 +112,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Retrieves the HTTP return code for the response. * Retrieves the HTTP return code for the response.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @return int The 3-digit HTTP status code. * @return int The 3-digit HTTP status code.
*/ */
@ -131,7 +123,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Sets the 3-digit HTTP status code. * Sets the 3-digit HTTP status code.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param int $code HTTP status. * @param int $code HTTP status.
*/ */
@ -143,7 +134,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Retrieves the response data. * Retrieves the response data.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @return mixed Response data. * @return mixed Response data.
*/ */
@ -155,7 +145,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Sets the response data. * Sets the response data.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param mixed $data Response data. * @param mixed $data Response data.
*/ */
@ -167,7 +156,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Retrieves cookies from the response. * Retrieves cookies from the response.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @return WP_HTTP_Cookie[] List of cookie objects. * @return WP_HTTP_Cookie[] List of cookie objects.
*/ */
@ -190,7 +178,6 @@ class WP_HTTP_Requests_Response extends WP_HTTP_Response {
* Converts the object to a WP_Http response array. * Converts the object to a WP_Http response array.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @return array WP_Http response array, per WP_Http::request(). * @return array WP_Http response array, per WP_Http::request().
*/ */

12
wp-includes/class-wp-http-response.php
View File

@ -18,7 +18,6 @@ class WP_HTTP_Response {
* Response data. * Response data.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var mixed * @var mixed
*/ */
public $data; public $data;
@ -27,7 +26,6 @@ class WP_HTTP_Response {
* Response headers. * Response headers.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var array * @var array
*/ */
public $headers; public $headers;
@ -36,7 +34,6 @@ class WP_HTTP_Response {
* Response status. * Response status.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $status; public $status;
@ -45,7 +42,6 @@ class WP_HTTP_Response {
* Constructor. * Constructor.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param mixed $data Response data. Default null. * @param mixed $data Response data. Default null.
* @param int $status Optional. HTTP status code. Default 200. * @param int $status Optional. HTTP status code. Default 200.
@ -61,7 +57,6 @@ class WP_HTTP_Response {
* Retrieves headers associated with the response. * Retrieves headers associated with the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Map of header name to header value. * @return array Map of header name to header value.
*/ */
@ -73,7 +68,6 @@ class WP_HTTP_Response {
* Sets all header values. * Sets all header values.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $headers Map of header name to header value. * @param array $headers Map of header name to header value.
*/ */
@ -85,7 +79,6 @@ class WP_HTTP_Response {
* Sets a single HTTP header. * Sets a single HTTP header.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key Header name. * @param string $key Header name.
* @param string $value Header value. * @param string $value Header value.
@ -104,7 +97,6 @@ class WP_HTTP_Response {
* Retrieves the HTTP return code for the response. * Retrieves the HTTP return code for the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return int The 3-digit HTTP status code. * @return int The 3-digit HTTP status code.
*/ */
@ -116,7 +108,6 @@ class WP_HTTP_Response {
* Sets the 3-digit HTTP status code. * Sets the 3-digit HTTP status code.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param int $code HTTP status. * @param int $code HTTP status.
*/ */
@ -128,7 +119,6 @@ class WP_HTTP_Response {
* Retrieves the response data. * Retrieves the response data.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return mixed Response data. * @return mixed Response data.
*/ */
@ -140,7 +130,6 @@ class WP_HTTP_Response {
* Sets the response data. * Sets the response data.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param mixed $data Response data. * @param mixed $data Response data.
*/ */
@ -155,7 +144,6 @@ class WP_HTTP_Response {
* however this may be different if you want to do custom JSON data handling. * however this may be different if you want to do custom JSON data handling.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return mixed Any JSON-serializable value. * @return mixed Any JSON-serializable value.
*/ */

2
wp-includes/class-wp-http-streams.php
View File

@ -22,7 +22,6 @@ class WP_Http_Streams {
* @since 2.7.0 * @since 2.7.0
* @since 3.7.0 Combined with the fsockopen transport and switched to stream_socket_client(). * @since 3.7.0 Combined with the fsockopen transport and switched to stream_socket_client().
* *
* @access public
* @param string $url The request URL. * @param string $url The request URL.
* @param string|array $args Optional. Override the defaults. * @param string|array $args Optional. Override the defaults.
* @return array|WP_Error Array containing 'headers', 'body', 'response', 'cookies', 'filename'. A WP_Error instance upon error * @return array|WP_Error Array containing 'headers', 'body', 'response', 'cookies', 'filename'. A WP_Error instance upon error
@ -380,7 +379,6 @@ class WP_Http_Streams {
* Determines whether this class can be used for retrieving a URL. * Determines whether this class can be used for retrieving a URL.
* *
* @static * @static
* @access public
* @since 2.7.0 * @since 2.7.0
* @since 3.7.0 Combined with the fsockopen transport and switched to stream_socket_client(). * @since 3.7.0 Combined with the fsockopen transport and switched to stream_socket_client().
* *

13
wp-includes/class-wp-image-editor-gd.php
View File

@ -17,7 +17,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
/** /**
* GD Resource. * GD Resource.
* *
* @access protected
* @var resource * @var resource
*/ */
protected $image; protected $image;
@ -35,7 +34,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* @since 3.5.0 * @since 3.5.0
* *
* @static * @static
* @access public
* *
* @param array $args * @param array $args
* @return bool * @return bool
@ -61,7 +59,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* @since 3.5.0 * @since 3.5.0
* *
* @static * @static
* @access public
* *
* @param string $mime_type * @param string $mime_type
* @return bool * @return bool
@ -84,7 +81,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* Loads image from $this->file into new GD Resource. * Loads image from $this->file into new GD Resource.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @return bool|WP_Error True if loaded successfully; WP_Error on failure. * @return bool|WP_Error True if loaded successfully; WP_Error on failure.
*/ */
@ -122,7 +118,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* Sets or updates current image size. * Sets or updates current image size.
* *
* @since 3.5.0 * @since 3.5.0
* @access protected
* *
* @param int $width * @param int $width
* @param int $height * @param int $height
@ -147,7 +142,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* maintain aspect ratio according to the provided dimension. * maintain aspect ratio according to the provided dimension.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param int|null $max_w Image width. * @param int|null $max_w Image width.
* @param int|null $max_h Image height. * @param int|null $max_h Image height.
@ -200,7 +194,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* Resize multiple images from a single source. * Resize multiple images from a single source.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param array $sizes { * @param array $sizes {
* An array of image size arrays. Default sizes are 'small', 'medium', 'medium_large', 'large'. * An array of image size arrays. Default sizes are 'small', 'medium', 'medium_large', 'large'.
@ -263,7 +256,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* Crops Image. * Crops Image.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param int $src_x The start x position to crop from. * @param int $src_x The start x position to crop from.
* @param int $src_y The start y position to crop from. * @param int $src_y The start y position to crop from.
@ -309,7 +301,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* Ported from image-edit.php * Ported from image-edit.php
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param float $angle * @param float $angle
* @return true|WP_Error * @return true|WP_Error
@ -335,7 +326,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* Flips current image. * Flips current image.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param bool $horz Flip along Horizontal Axis * @param bool $horz Flip along Horizontal Axis
* @param bool $vert Flip along Vertical Axis * @param bool $vert Flip along Vertical Axis
@ -365,7 +355,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* Saves current in-memory image to file. * Saves current in-memory image to file.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param string|null $filename * @param string|null $filename
* @param string|null $mime_type * @param string|null $mime_type
@ -439,7 +428,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* Returns stream of current image. * Returns stream of current image.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param string $mime_type * @param string $mime_type
* @return bool * @return bool
@ -464,7 +452,6 @@ class WP_Image_Editor_GD extends WP_Image_Editor {
* Either calls editor's save function or handles file as a stream. * Either calls editor's save function or handles file as a stream.
* *
* @since 3.5.0 * @since 3.5.0
* @access protected
* *
* @param string|stream $filename * @param string|stream $filename
* @param callable $function * @param callable $function

16
wp-includes/class-wp-image-editor-imagick.php
View File

@ -17,7 +17,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
/** /**
* Imagick object. * Imagick object.
* *
* @access protected
* @var Imagick * @var Imagick
*/ */
protected $image; protected $image;
@ -39,7 +38,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* @since 3.5.0 * @since 3.5.0
* *
* @static * @static
* @access public
* *
* @param array $args * @param array $args
* @return bool * @return bool
@ -98,7 +96,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* @since 3.5.0 * @since 3.5.0
* *
* @static * @static
* @access public
* *
* @param string $mime_type * @param string $mime_type
* @return bool * @return bool
@ -126,7 +123,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Loads image from $this->file into new Imagick Object. * Loads image from $this->file into new Imagick Object.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @return true|WP_Error True if loaded; WP_Error on failure. * @return true|WP_Error True if loaded; WP_Error on failure.
*/ */
@ -181,7 +177,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Sets Image Compression quality on a 1-100% scale. * Sets Image Compression quality on a 1-100% scale.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param int $quality Compression Quality. Range: [1,100] * @param int $quality Compression Quality. Range: [1,100]
* @return true|WP_Error True if set successfully; WP_Error on failure. * @return true|WP_Error True if set successfully; WP_Error on failure.
@ -214,7 +209,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Sets or updates current image size. * Sets or updates current image size.
* *
* @since 3.5.0 * @since 3.5.0
* @access protected
* *
* @param int $width * @param int $width
* @param int $height * @param int $height
@ -249,7 +243,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* maintain aspect ratio according to the provided dimension. * maintain aspect ratio according to the provided dimension.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param int|null $max_w Image width. * @param int|null $max_w Image width.
* @param int|null $max_h Image height. * @param int|null $max_h Image height.
@ -285,7 +278,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* which resizes an image to given dimensions and removes any associated profiles. * which resizes an image to given dimensions and removes any associated profiles.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* *
* @param int $dst_w The destination width. * @param int $dst_w The destination width.
* @param int $dst_h The destination height. * @param int $dst_h The destination height.
@ -417,7 +409,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Resize multiple images from a single source. * Resize multiple images from a single source.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param array $sizes { * @param array $sizes {
* An array of image size arrays. Default sizes are 'small', 'medium', 'medium_large', 'large'. * An array of image size arrays. Default sizes are 'small', 'medium', 'medium_large', 'large'.
@ -488,7 +479,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Crops Image. * Crops Image.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param int $src_x The start x position to crop from. * @param int $src_x The start x position to crop from.
* @param int $src_y The start y position to crop from. * @param int $src_y The start y position to crop from.
@ -535,7 +525,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Rotates current image counter-clockwise by $angle. * Rotates current image counter-clockwise by $angle.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param float $angle * @param float $angle
* @return true|WP_Error * @return true|WP_Error
@ -570,7 +559,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Flips current image. * Flips current image.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param bool $horz Flip along Horizontal Axis * @param bool $horz Flip along Horizontal Axis
* @param bool $vert Flip along Vertical Axis * @param bool $vert Flip along Vertical Axis
@ -594,7 +582,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Saves current image to file. * Saves current image to file.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param string $destfilename * @param string $destfilename
* @param string $mime_type * @param string $mime_type
@ -664,7 +651,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Streams current image to browser. * Streams current image to browser.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param string $mime_type * @param string $mime_type
* @return true|WP_Error * @return true|WP_Error
@ -694,7 +680,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Strips all image meta except color profiles from an image. * Strips all image meta except color profiles from an image.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* *
* @return true|WP_Error True if stripping metadata was successful. WP_Error object on error. * @return true|WP_Error True if stripping metadata was successful. WP_Error object on error.
*/ */
@ -747,7 +732,6 @@ class WP_Image_Editor_Imagick extends WP_Image_Editor {
* Increases rendering DPI and only loads first page. * Increases rendering DPI and only loads first page.
* *
* @since 4.7.0 * @since 4.7.0
* @access protected
* *
* @return string|WP_Error File to load or WP_Error on failure. * @return string|WP_Error File to load or WP_Error on failure.
*/ */

20
wp-includes/class-wp-image-editor.php
View File

@ -35,7 +35,6 @@ abstract class WP_Image_Editor {
* @since 3.5.0 * @since 3.5.0
* *
* @static * @static
* @access public
* @abstract * @abstract
* *
* @param array $args * @param array $args
@ -52,7 +51,6 @@ abstract class WP_Image_Editor {
* @since 3.5.0 * @since 3.5.0
* *
* @static * @static
* @access public
* @abstract * @abstract
* *
* @param string $mime_type * @param string $mime_type
@ -66,7 +64,6 @@ abstract class WP_Image_Editor {
* Loads image from $this->file into editor. * Loads image from $this->file into editor.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @abstract * @abstract
* *
* @return bool|WP_Error True if loaded; WP_Error on failure. * @return bool|WP_Error True if loaded; WP_Error on failure.
@ -77,7 +74,6 @@ abstract class WP_Image_Editor {
* Saves current image to file. * Saves current image to file.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @abstract * @abstract
* *
* @param string $destfilename * @param string $destfilename
@ -94,7 +90,6 @@ abstract class WP_Image_Editor {
* maintain aspect ratio according to the provided dimension. * maintain aspect ratio according to the provided dimension.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @abstract * @abstract
* *
* @param int|null $max_w Image width. * @param int|null $max_w Image width.
@ -108,7 +103,6 @@ abstract class WP_Image_Editor {
* Resize multiple images from a single source. * Resize multiple images from a single source.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @abstract * @abstract
* *
* @param array $sizes { * @param array $sizes {
@ -128,7 +122,6 @@ abstract class WP_Image_Editor {
* Crops Image. * Crops Image.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @abstract * @abstract
* *
* @param int $src_x The start x position to crop from. * @param int $src_x The start x position to crop from.
@ -146,7 +139,6 @@ abstract class WP_Image_Editor {
* Rotates current image counter-clockwise by $angle. * Rotates current image counter-clockwise by $angle.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @abstract * @abstract
* *
* @param float $angle * @param float $angle
@ -158,7 +150,6 @@ abstract class WP_Image_Editor {
* Flips current image. * Flips current image.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @abstract * @abstract
* *
* @param bool $horz Flip along Horizontal Axis * @param bool $horz Flip along Horizontal Axis
@ -171,7 +162,6 @@ abstract class WP_Image_Editor {
* Streams current image to browser. * Streams current image to browser.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @abstract * @abstract
* *
* @param string $mime_type * @param string $mime_type
@ -183,7 +173,6 @@ abstract class WP_Image_Editor {
* Gets dimensions of image. * Gets dimensions of image.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @return array {'width'=>int, 'height'=>int} * @return array {'width'=>int, 'height'=>int}
*/ */
@ -195,7 +184,6 @@ abstract class WP_Image_Editor {
* Sets current image size. * Sets current image size.
* *
* @since 3.5.0 * @since 3.5.0
* @access protected
* *
* @param int $width * @param int $width
* @param int $height * @param int $height
@ -213,7 +201,6 @@ abstract class WP_Image_Editor {
* Gets the Image Compression quality on a 1-100% scale. * Gets the Image Compression quality on a 1-100% scale.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @return int $quality Compression Quality. Range: [1,100] * @return int $quality Compression Quality. Range: [1,100]
*/ */
@ -229,7 +216,6 @@ abstract class WP_Image_Editor {
* Sets Image Compression quality on a 1-100% scale. * Sets Image Compression quality on a 1-100% scale.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param int $quality Compression Quality. Range: [1,100] * @param int $quality Compression Quality. Range: [1,100]
* @return true|WP_Error True if set successfully; WP_Error on failure. * @return true|WP_Error True if set successfully; WP_Error on failure.
@ -298,7 +284,6 @@ abstract class WP_Image_Editor {
* Provides corrected filename only if filename is provided. * Provides corrected filename only if filename is provided.
* *
* @since 3.5.0 * @since 3.5.0
* @access protected
* *
* @param string $filename * @param string $filename
* @param string $mime_type * @param string $mime_type
@ -359,7 +344,6 @@ abstract class WP_Image_Editor {
* Builds an output filename based on current file, and adding proper suffix * Builds an output filename based on current file, and adding proper suffix
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param string $suffix * @param string $suffix
* @param string $dest_path * @param string $dest_path
@ -387,7 +371,6 @@ abstract class WP_Image_Editor {
* Builds and returns proper suffix for file based on height and width. * Builds and returns proper suffix for file based on height and width.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @return false|string suffix * @return false|string suffix
*/ */
@ -402,7 +385,6 @@ abstract class WP_Image_Editor {
* Either calls editor's save function or handles file as a stream. * Either calls editor's save function or handles file as a stream.
* *
* @since 3.5.0 * @since 3.5.0
* @access protected
* *
* @param string|stream $filename * @param string|stream $filename
* @param callable $function * @param callable $function
@ -445,7 +427,6 @@ abstract class WP_Image_Editor {
* @since 3.5.0 * @since 3.5.0
* *
* @static * @static
* @access protected
* *
* @param string $extension * @param string $extension
* @return string|false * @return string|false
@ -473,7 +454,6 @@ abstract class WP_Image_Editor {
* @since 3.5.0 * @since 3.5.0
* *
* @static * @static
* @access protected
* *
* @param string $mime_type * @param string $mime_type
* @return string|false * @return string|false

6
wp-includes/class-wp-list-util.php
View File

@ -18,7 +18,6 @@ class WP_List_Util {
* The input array. * The input array.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var array * @var array
*/ */
private $input = array(); private $input = array();
@ -27,7 +26,6 @@ class WP_List_Util {
* The output array. * The output array.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var array * @var array
*/ */
private $output = array(); private $output = array();
@ -36,7 +34,6 @@ class WP_List_Util {
* Temporary arguments for sorting. * Temporary arguments for sorting.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var array * @var array
*/ */
private $orderby = array(); private $orderby = array();
@ -58,7 +55,6 @@ class WP_List_Util {
* Returns the original input array. * Returns the original input array.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return array The input array. * @return array The input array.
*/ */
@ -70,7 +66,6 @@ class WP_List_Util {
* Returns the output array. * Returns the output array.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return array The output array. * @return array The output array.
*/ */
@ -228,7 +223,6 @@ class WP_List_Util {
* Callback to sort the list by specific fields. * Callback to sort the list by specific fields.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @see WP_List_Util::sort() * @see WP_List_Util::sort()
* *

5
wp-includes/class-wp-locale-switcher.php
View File

@ -17,7 +17,6 @@ class WP_Locale_Switcher {
* Locale stack. * Locale stack.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var string[] * @var string[]
*/ */
private $locales = array(); private $locales = array();
@ -26,7 +25,6 @@ class WP_Locale_Switcher {
* Original locale. * Original locale.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var string * @var string
*/ */
private $original_locale; private $original_locale;
@ -35,7 +33,6 @@ class WP_Locale_Switcher {
* Holds all available languages. * Holds all available languages.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @var array An array of language codes (file names without the .mo extension). * @var array An array of language codes (file names without the .mo extension).
*/ */
private $available_languages = array(); private $available_languages = array();
@ -184,7 +181,6 @@ class WP_Locale_Switcher {
* When switching to a locale, translations for this locale must be loaded from scratch. * When switching to a locale, translations for this locale must be loaded from scratch.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @global Mo[] $l10n An array of all currently loaded text domains. * @global Mo[] $l10n An array of all currently loaded text domains.
* *
@ -214,7 +210,6 @@ class WP_Locale_Switcher {
* all post type labels. * all post type labels.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @global WP_Locale $wp_locale The WordPress date and time locale object. * @global WP_Locale $wp_locale The WordPress date and time locale object.
* *

10
wp-includes/class-wp-locale.php
View File

@ -99,7 +99,6 @@ class WP_Locale {
* The thousands separator and decimal point values used for localizing numbers. * The thousands separator and decimal point values used for localizing numbers.
* *
* @since 2.3.0 * @since 2.3.0
* @access public
* @var array * @var array
*/ */
public $number_format; public $number_format;
@ -122,7 +121,6 @@ class WP_Locale {
* specific calendar names and text direction. * specific calendar names and text direction.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @global string $text_direction * @global string $text_direction
*/ */
@ -240,7 +238,6 @@ class WP_Locale {
* Outputs an admin notice if the /build directory must be used for RTL. * Outputs an admin notice if the /build directory must be used for RTL.
* *
* @since 3.8.0 * @since 3.8.0
* @access public
*/ */
public function rtl_src_admin_notice() { public function rtl_src_admin_notice() {
/* translators: %s: Name of the directory (build) */ /* translators: %s: Name of the directory (build) */
@ -255,7 +252,6 @@ class WP_Locale {
* and ends on Saturday with is fetched by using 6 (six). * and ends on Saturday with is fetched by using 6 (six).
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param int $weekday_number 0 for Sunday through 6 Saturday * @param int $weekday_number 0 for Sunday through 6 Saturday
* @return string Full translated weekday * @return string Full translated weekday
@ -273,7 +269,6 @@ class WP_Locale {
* not conflict. * not conflict.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string $weekday_name * @param string $weekday_name
* @return string * @return string
@ -289,7 +284,6 @@ class WP_Locale {
* full weekday word. * full weekday word.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string $weekday_name Full translated weekday word * @param string $weekday_name Full translated weekday word
* @return string Translated weekday abbreviation * @return string Translated weekday abbreviation
@ -310,7 +304,6 @@ class WP_Locale {
* '0' before the numbers less than 10 for you. * '0' before the numbers less than 10 for you.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string|int $month_number '01' through '12' * @param string|int $month_number '01' through '12'
* @return string Translated full month name * @return string Translated full month name
@ -326,7 +319,6 @@ class WP_Locale {
* translatable version of the month. * translatable version of the month.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string $month_name Translated month to get abbreviated version * @param string $month_name Translated month to get abbreviated version
* @return string Translated abbreviated month * @return string Translated abbreviated month
@ -341,7 +333,6 @@ class WP_Locale {
* The $meridiem parameter is expected to not be translated. * The $meridiem parameter is expected to not be translated.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string $meridiem Either 'am', 'pm', 'AM', or 'PM'. Not translated version. * @param string $meridiem Either 'am', 'pm', 'AM', or 'PM'. Not translated version.
* @return string Translated version * @return string Translated version
@ -356,7 +347,6 @@ class WP_Locale {
* For backward compatibility only. * For backward compatibility only.
* *
* @deprecated For backward compatibility only. * @deprecated For backward compatibility only.
* @access public
* *
* @global array $weekday * @global array $weekday
* @global array $weekday_initial * @global array $weekday_initial

6
wp-includes/class-wp-matchesmapregex.php
View File

@ -15,7 +15,6 @@ class WP_MatchesMapRegex {
/** /**
* store for matches * store for matches
* *
* @access private
* @var array * @var array
*/ */
private $_matches; private $_matches;
@ -23,7 +22,6 @@ class WP_MatchesMapRegex {
/** /**
* store for mapping result * store for mapping result
* *
* @access public
* @var string * @var string
*/ */
public $output; public $output;
@ -31,7 +29,6 @@ class WP_MatchesMapRegex {
/** /**
* subject to perform mapping on (query string containing $matches[] references * subject to perform mapping on (query string containing $matches[] references
* *
* @access private
* @var string * @var string
*/ */
private $_subject; private $_subject;
@ -61,7 +58,6 @@ class WP_MatchesMapRegex {
* static helper function to ease use * static helper function to ease use
* *
* @static * @static
* @access public
* *
* @param string $subject subject * @param string $subject subject
* @param array $matches data used for substitution * @param array $matches data used for substitution
@ -75,7 +71,6 @@ class WP_MatchesMapRegex {
/** /**
* do the actual mapping * do the actual mapping
* *
* @access private
* @return string * @return string
*/ */
private function _map() { private function _map() {
@ -86,7 +81,6 @@ class WP_MatchesMapRegex {
/** /**
* preg_replace_callback hook * preg_replace_callback hook
* *
* @access public
* @param array $matches preg_replace regexp matches * @param array $matches preg_replace regexp matches
* @return string * @return string
*/ */

20
wp-includes/class-wp-meta-query.php
View File

@ -26,7 +26,6 @@ class WP_Meta_Query {
* See WP_Meta_Query::__construct() for information on meta query arguments. * See WP_Meta_Query::__construct() for information on meta query arguments.
* *
* @since 3.2.0 * @since 3.2.0
* @access public
* @var array * @var array
*/ */
public $queries = array(); public $queries = array();
@ -35,7 +34,6 @@ class WP_Meta_Query {
* The relation between the queries. Can be one of 'AND' or 'OR'. * The relation between the queries. Can be one of 'AND' or 'OR'.
* *
* @since 3.2.0 * @since 3.2.0
* @access public
* @var string * @var string
*/ */
public $relation; public $relation;
@ -44,7 +42,6 @@ class WP_Meta_Query {
* Database table to query for the metadata. * Database table to query for the metadata.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $meta_table; public $meta_table;
@ -53,7 +50,6 @@ class WP_Meta_Query {
* Column in meta_table that represents the ID of the object the metadata belongs to. * Column in meta_table that represents the ID of the object the metadata belongs to.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $meta_id_column; public $meta_id_column;
@ -62,7 +58,6 @@ class WP_Meta_Query {
* Database table that where the metadata's objects are stored (eg $wpdb->users). * Database table that where the metadata's objects are stored (eg $wpdb->users).
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $primary_table; public $primary_table;
@ -71,7 +66,6 @@ class WP_Meta_Query {
* Column in primary_table that represents the ID of the object. * Column in primary_table that represents the ID of the object.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $primary_id_column; public $primary_id_column;
@ -80,7 +74,6 @@ class WP_Meta_Query {
* A flat list of table aliases used in JOIN clauses. * A flat list of table aliases used in JOIN clauses.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* @var array * @var array
*/ */
protected $table_aliases = array(); protected $table_aliases = array();
@ -89,7 +82,6 @@ class WP_Meta_Query {
* A flat list of clauses, keyed by clause 'name'. * A flat list of clauses, keyed by clause 'name'.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
* @var array * @var array
*/ */
protected $clauses = array(); protected $clauses = array();
@ -98,7 +90,6 @@ class WP_Meta_Query {
* Whether the query contains any OR relations. * Whether the query contains any OR relations.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* @var bool * @var bool
*/ */
protected $has_or_relation = false; protected $has_or_relation = false;
@ -109,7 +100,6 @@ class WP_Meta_Query {
* @since 3.2.0 * @since 3.2.0
* @since 4.2.0 Introduced support for naming query clauses by associative array keys. * @since 4.2.0 Introduced support for naming query clauses by associative array keys.
* *
* @access public
* *
* @param array $meta_query { * @param array $meta_query {
* Array of meta query clauses. When first-order clauses or sub-clauses use strings as * Array of meta query clauses. When first-order clauses or sub-clauses use strings as
@ -153,7 +143,6 @@ class WP_Meta_Query {
* Eliminates empty items and ensures that a 'relation' is set. * Eliminates empty items and ensures that a 'relation' is set.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @param array $queries Array of query clauses. * @param array $queries Array of query clauses.
* @return array Sanitized array of query clauses. * @return array Sanitized array of query clauses.
@ -222,7 +211,6 @@ class WP_Meta_Query {
* a 'value' array key. * a 'value' array key.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @param array $query Meta query arguments. * @param array $query Meta query arguments.
* @return bool Whether the query clause is a first-order clause. * @return bool Whether the query clause is a first-order clause.
@ -235,7 +223,6 @@ class WP_Meta_Query {
* Constructs a meta query based on 'meta_*' query vars * Constructs a meta query based on 'meta_*' query vars
* *
* @since 3.2.0 * @since 3.2.0
* @access public
* *
* @param array $qv The query variables * @param array $qv The query variables
*/ */
@ -283,7 +270,6 @@ class WP_Meta_Query {
* Return the appropriate alias for the given meta type if applicable. * Return the appropriate alias for the given meta type if applicable.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* *
* @param string $type MySQL type to cast meta_value. * @param string $type MySQL type to cast meta_value.
* @return string MySQL type. * @return string MySQL type.
@ -307,7 +293,6 @@ class WP_Meta_Query {
* Generates SQL clauses to be appended to a main query. * Generates SQL clauses to be appended to a main query.
* *
* @since 3.2.0 * @since 3.2.0
* @access public
* *
* @param string $type Type of meta, eg 'user', 'post'. * @param string $type Type of meta, eg 'user', 'post'.
* @param string $primary_table Database table where the object being filtered is stored (eg wp_users). * @param string $primary_table Database table where the object being filtered is stored (eg wp_users).
@ -365,7 +350,6 @@ class WP_Meta_Query {
* out to maintain parity with the other Query classes. * out to maintain parity with the other Query classes.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @return array { * @return array {
* Array containing JOIN and WHERE SQL clauses to append to the main query. * Array containing JOIN and WHERE SQL clauses to append to the main query.
@ -396,7 +380,6 @@ class WP_Meta_Query {
* produce the properly nested SQL. * produce the properly nested SQL.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @param array $query Query to parse, passed by reference. * @param array $query Query to parse, passed by reference.
* @param int $depth Optional. Number of tree levels deep we currently are. * @param int $depth Optional. Number of tree levels deep we currently are.
@ -480,7 +463,6 @@ class WP_Meta_Query {
* "First-order" means that it's an array with a 'key' or 'value'. * "First-order" means that it's an array with a 'key' or 'value'.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -658,7 +640,6 @@ class WP_Meta_Query {
* a value of 'orderby' corresponding to a meta clause. * a value of 'orderby' corresponding to a meta clause.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* *
* @return array Meta clauses. * @return array Meta clauses.
*/ */
@ -681,7 +662,6 @@ class WP_Meta_Query {
* connected by the relation 'OR'. * connected by the relation 'OR'.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @param array $clause Query clause. * @param array $clause Query clause.
* @param array $parent_query Parent query of $clause. * @param array $parent_query Parent query of $clause.

6
wp-includes/class-wp-metadata-lazyloader.php
View File

@ -33,7 +33,6 @@ class WP_Metadata_Lazyloader {
* Pending objects queue. * Pending objects queue.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var array * @var array
*/ */
protected $pending_objects; protected $pending_objects;
@ -42,7 +41,6 @@ class WP_Metadata_Lazyloader {
* Settings for supported object types. * Settings for supported object types.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var array * @var array
*/ */
protected $settings = array(); protected $settings = array();
@ -51,7 +49,6 @@ class WP_Metadata_Lazyloader {
* Constructor. * Constructor.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
*/ */
public function __construct() { public function __construct() {
$this->settings = array( $this->settings = array(
@ -70,7 +67,6 @@ class WP_Metadata_Lazyloader {
* Adds objects to the metadata lazy-load queue. * Adds objects to the metadata lazy-load queue.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $object_type Type of object whose meta is to be lazy-loaded. Accepts 'term' or 'comment'. * @param string $object_type Type of object whose meta is to be lazy-loaded. Accepts 'term' or 'comment'.
* @param array $object_ids Array of object IDs. * @param array $object_ids Array of object IDs.
@ -112,7 +108,6 @@ class WP_Metadata_Lazyloader {
* Resets lazy-load queue for a given object type. * Resets lazy-load queue for a given object type.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $object_type Object type. Accepts 'comment' or 'term'. * @param string $object_type Object type. Accepts 'comment' or 'term'.
* @return bool|WP_Error True on success, WP_Error on failure. * @return bool|WP_Error True on success, WP_Error on failure.
@ -135,7 +130,6 @@ class WP_Metadata_Lazyloader {
* is no need to invoke it directly. * is no need to invoke it directly.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param mixed $check The `$check` param passed from the 'get_term_metadata' hook. * @param mixed $check The `$check` param passed from the 'get_term_metadata' hook.
* @return mixed In order not to short-circuit `get_metadata()`. Generally, this is `null`, but it could be * @return mixed In order not to short-circuit `get_metadata()`. Generally, this is `null`, but it could be

16
wp-includes/class-wp-network-query.php
View File

@ -20,7 +20,6 @@ class WP_Network_Query {
* SQL for database query. * SQL for database query.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string * @var string
*/ */
public $request; public $request;
@ -29,7 +28,6 @@ class WP_Network_Query {
* SQL query clauses. * SQL query clauses.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* @var array * @var array
*/ */
protected $sql_clauses = array( protected $sql_clauses = array(
@ -45,7 +43,6 @@ class WP_Network_Query {
* Query vars set by the user. * Query vars set by the user.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array * @var array
*/ */
public $query_vars; public $query_vars;
@ -54,7 +51,6 @@ class WP_Network_Query {
* Default values for query vars. * Default values for query vars.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array * @var array
*/ */
public $query_var_defaults; public $query_var_defaults;
@ -63,7 +59,6 @@ class WP_Network_Query {
* List of networks located by the query. * List of networks located by the query.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array * @var array
*/ */
public $networks; public $networks;
@ -72,7 +67,6 @@ class WP_Network_Query {
* The amount of found networks for the current query. * The amount of found networks for the current query.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var int * @var int
*/ */
public $found_networks = 0; public $found_networks = 0;
@ -81,7 +75,6 @@ class WP_Network_Query {
* The number of pages. * The number of pages.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var int * @var int
*/ */
public $max_num_pages = 0; public $max_num_pages = 0;
@ -92,7 +85,6 @@ class WP_Network_Query {
* Sets up the network query, based on the query vars passed. * Sets up the network query, based on the query vars passed.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string|array $query { * @param string|array $query {
* Optional. Array or query string of network query parameters. Default empty. * Optional. Array or query string of network query parameters. Default empty.
@ -152,7 +144,6 @@ class WP_Network_Query {
* *
* @since 4.6.0 * @since 4.6.0
* *
* @access public
* *
* @param string|array $query WP_Network_Query arguments. See WP_Network_Query::__construct() * @param string|array $query WP_Network_Query arguments. See WP_Network_Query::__construct()
*/ */
@ -177,7 +168,6 @@ class WP_Network_Query {
* Sets up the WordPress query for retrieving networks. * Sets up the WordPress query for retrieving networks.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string|array $query Array or URL query string of parameters. * @param string|array $query Array or URL query string of parameters.
* @return array|int List of networks, or number of networks when 'count' is passed as a query var. * @return array|int List of networks, or number of networks when 'count' is passed as a query var.
@ -191,7 +181,6 @@ class WP_Network_Query {
* Gets a list of networks matching the query vars. * Gets a list of networks matching the query vars.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @return int|array The list of networks. * @return int|array The list of networks.
*/ */
@ -284,7 +273,6 @@ class WP_Network_Query {
* Used internally to get a list of network IDs matching the query vars. * Used internally to get a list of network IDs matching the query vars.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -461,7 +449,6 @@ class WP_Network_Query {
* if the limit clause was used. * if the limit clause was used.
* *
* @since 4.6.0 * @since 4.6.0
* @access private
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
*/ */
@ -487,7 +474,6 @@ class WP_Network_Query {
* Used internally to generate an SQL string for searching across multiple columns. * Used internally to generate an SQL string for searching across multiple columns.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -513,7 +499,6 @@ class WP_Network_Query {
* Parses and sanitizes 'orderby' keys passed to the network query. * Parses and sanitizes 'orderby' keys passed to the network query.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -547,7 +532,6 @@ class WP_Network_Query {
* Parses an 'order' query variable and cast it to 'ASC' or 'DESC' as necessary. * Parses an 'order' query variable and cast it to 'ASC' or 'DESC' as necessary.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @param string $order The 'order' query variable. * @param string $order The 'order' query variable.
* @return string The sanitized 'order' query variable. * @return string The sanitized 'order' query variable.

14
wp-includes/class-wp-network.php
View File

@ -30,7 +30,6 @@ class WP_Network {
* @since 4.6.0 Converted from public to private to explicitly enable more intuitive * @since 4.6.0 Converted from public to private to explicitly enable more intuitive
* access via magic methods. As part of the access change, the type was * access via magic methods. As part of the access change, the type was
* also changed from `string` to `int`. * also changed from `string` to `int`.
* @access private
* @var int * @var int
*/ */
private $id; private $id;
@ -39,7 +38,6 @@ class WP_Network {
* Domain of the network. * Domain of the network.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $domain = ''; public $domain = '';
@ -48,7 +46,6 @@ class WP_Network {
* Path of the network. * Path of the network.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $path = ''; public $path = '';
@ -62,7 +59,6 @@ class WP_Network {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 4.4.0 * @since 4.4.0
* @access private
* @var string * @var string
*/ */
private $blog_id = '0'; private $blog_id = '0';
@ -71,7 +67,6 @@ class WP_Network {
* Domain used to set cookies for this network. * Domain used to set cookies for this network.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $cookie_domain = ''; public $cookie_domain = '';
@ -82,7 +77,6 @@ class WP_Network {
* Named "site" vs. "network" for legacy reasons. * Named "site" vs. "network" for legacy reasons.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $site_name = ''; public $site_name = '';
@ -91,7 +85,6 @@ class WP_Network {
* Retrieve a network from the database by its ID. * Retrieve a network from the database by its ID.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -128,7 +121,6 @@ class WP_Network {
* default properties based on that information. * default properties based on that information.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param WP_Network|object $network A network object. * @param WP_Network|object $network A network object.
*/ */
@ -147,7 +139,6 @@ class WP_Network {
* Allows current multisite naming conventions when getting properties. * Allows current multisite naming conventions when getting properties.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string $key Property to get. * @param string $key Property to get.
* @return mixed Value of the property. Null if not available. * @return mixed Value of the property. Null if not available.
@ -171,7 +162,6 @@ class WP_Network {
* Allows current multisite naming conventions when checking for properties. * Allows current multisite naming conventions when checking for properties.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string $key Property to check if set. * @param string $key Property to check if set.
* @return bool Whether the property is set. * @return bool Whether the property is set.
@ -193,7 +183,6 @@ class WP_Network {
* Allows current multisite naming conventions while setting properties. * Allows current multisite naming conventions while setting properties.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string $key Property to set. * @param string $key Property to set.
* @param mixed $value Value to assign to the property. * @param mixed $value Value to assign to the property.
@ -216,7 +205,6 @@ class WP_Network {
* Set the site name assigned to the network if one has not been populated. * Set the site name assigned to the network if one has not been populated.
* *
* @since 4.4.0 * @since 4.4.0
* @access private
*/ */
private function _set_site_name() { private function _set_site_name() {
if ( ! empty( $this->site_name ) ) { if ( ! empty( $this->site_name ) ) {
@ -234,7 +222,6 @@ class WP_Network {
* @todo What if the domain of the network doesn't match the current site? * @todo What if the domain of the network doesn't match the current site?
* *
* @since 4.4.0 * @since 4.4.0
* @access private
*/ */
private function _set_cookie_domain() { private function _set_cookie_domain() {
if ( ! empty( $this->cookie_domain ) ) { if ( ! empty( $this->cookie_domain ) ) {
@ -258,7 +245,6 @@ class WP_Network {
* requested site address. * requested site address.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @static * @static
* *
* @param string $domain Domain to check. * @param string $domain Domain to check.

4
wp-includes/class-wp-oembed-controller.php
View File

@ -20,7 +20,6 @@ final class WP_oEmbed_Controller {
* Register the oEmbed REST API route. * Register the oEmbed REST API route.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
*/ */
public function register_routes() { public function register_routes() {
/** /**
@ -101,7 +100,6 @@ final class WP_oEmbed_Controller {
* Returns the JSON object for the post. * Returns the JSON object for the post.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param WP_REST_Request $request Full data about the request. * @param WP_REST_Request $request Full data about the request.
* @return WP_Error|array oEmbed response data or WP_Error on failure. * @return WP_Error|array oEmbed response data or WP_Error on failure.
@ -132,7 +130,6 @@ final class WP_oEmbed_Controller {
* Checks if current user can make a proxy oEmbed request. * Checks if current user can make a proxy oEmbed request.
* *
* @since 4.8.0 * @since 4.8.0
* @access public
* *
* @return true|WP_Error True if the request has read access, WP_Error object otherwise. * @return true|WP_Error True if the request has read access, WP_Error object otherwise.
*/ */
@ -149,7 +146,6 @@ final class WP_oEmbed_Controller {
* Returns the JSON object for the proxied item. * Returns the JSON object for the proxied item.
* *
* @since 4.8.0 * @since 4.8.0
* @access public
* *
* @see WP_oEmbed::get_html() * @see WP_oEmbed::get_html()
* @param WP_REST_Request $request Full data about the request. * @param WP_REST_Request $request Full data about the request.

42
wp-includes/class-wp-post-type.php
View File

@ -19,7 +19,6 @@ final class WP_Post_Type {
* Post type key. * Post type key.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string $name * @var string $name
*/ */
public $name; public $name;
@ -28,7 +27,6 @@ final class WP_Post_Type {
* Name of the post type shown in the menu. Usually plural. * Name of the post type shown in the menu. Usually plural.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string $label * @var string $label
*/ */
public $label; public $label;
@ -42,7 +40,6 @@ final class WP_Post_Type {
* @see get_post_type_labels() * @see get_post_type_labels()
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var object $labels * @var object $labels
*/ */
public $labels; public $labels;
@ -53,7 +50,6 @@ final class WP_Post_Type {
* Default empty. * Default empty.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string $description * @var string $description
*/ */
public $description = ''; public $description = '';
@ -67,7 +63,6 @@ final class WP_Post_Type {
* Default false. * Default false.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $public * @var bool $public
*/ */
public $public = false; public $public = false;
@ -78,7 +73,6 @@ final class WP_Post_Type {
* Default false. * Default false.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $hierarchical * @var bool $hierarchical
*/ */
public $hierarchical = false; public $hierarchical = false;
@ -90,7 +84,6 @@ final class WP_Post_Type {
* Default is the opposite value of $public. * Default is the opposite value of $public.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $exclude_from_search * @var bool $exclude_from_search
*/ */
public $exclude_from_search = null; public $exclude_from_search = null;
@ -106,7 +99,6 @@ final class WP_Post_Type {
* Default is the value of $public. * Default is the value of $public.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $publicly_queryable * @var bool $publicly_queryable
*/ */
public $publicly_queryable = null; public $publicly_queryable = null;
@ -117,7 +109,6 @@ final class WP_Post_Type {
* Default is the value of $public. * Default is the value of $public.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $show_ui * @var bool $show_ui
*/ */
public $show_ui = null; public $show_ui = null;
@ -132,7 +123,6 @@ final class WP_Post_Type {
* Default is the value of $show_ui. * Default is the value of $show_ui.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $show_in_menu * @var bool $show_in_menu
*/ */
public $show_in_menu = null; public $show_in_menu = null;
@ -143,7 +133,6 @@ final class WP_Post_Type {
* Default is the value $public. * Default is the value $public.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $show_in_nav_menus * @var bool $show_in_nav_menus
*/ */
public $show_in_nav_menus = null; public $show_in_nav_menus = null;
@ -154,7 +143,6 @@ final class WP_Post_Type {
* Default is the value of $show_in_menu. * Default is the value of $show_in_menu.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $show_in_admin_bar * @var bool $show_in_admin_bar
*/ */
public $show_in_admin_bar = null; public $show_in_admin_bar = null;
@ -165,7 +153,6 @@ final class WP_Post_Type {
* To work, $show_in_menu must be true. Default null (at the bottom). * To work, $show_in_menu must be true. Default null (at the bottom).
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var int $menu_position * @var int $menu_position
*/ */
public $menu_position = null; public $menu_position = null;
@ -181,7 +168,6 @@ final class WP_Post_Type {
* Defaults to use the posts icon. * Defaults to use the posts icon.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string $menu_icon * @var string $menu_icon
*/ */
public $menu_icon = null; public $menu_icon = null;
@ -194,7 +180,6 @@ final class WP_Post_Type {
* array( 'story', 'stories' ). Default 'post'. * array( 'story', 'stories' ). Default 'post'.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string $capability_type * @var string $capability_type
*/ */
public $capability_type = 'post'; public $capability_type = 'post';
@ -205,7 +190,6 @@ final class WP_Post_Type {
* Default false. * Default false.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $map_meta_cap * @var bool $map_meta_cap
*/ */
public $map_meta_cap = false; public $map_meta_cap = false;
@ -216,7 +200,6 @@ final class WP_Post_Type {
* Do `remove_meta_box()` and `add_meta_box()` calls in the callback. Default null. * Do `remove_meta_box()` and `add_meta_box()` calls in the callback. Default null.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string $register_meta_box_cb * @var string $register_meta_box_cb
*/ */
public $register_meta_box_cb = null; public $register_meta_box_cb = null;
@ -229,7 +212,6 @@ final class WP_Post_Type {
* Default empty array. * Default empty array.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array $taxonomies * @var array $taxonomies
*/ */
public $taxonomies = array(); public $taxonomies = array();
@ -240,7 +222,6 @@ final class WP_Post_Type {
* Will generate the proper rewrite rules if $rewrite is enabled. Default false. * Will generate the proper rewrite rules if $rewrite is enabled. Default false.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool|string $has_archive * @var bool|string $has_archive
*/ */
public $has_archive = false; public $has_archive = false;
@ -252,7 +233,6 @@ final class WP_Post_Type {
* If specified as a string, the query `?{query_var_string}={post_slug}` will be valid. * If specified as a string, the query `?{query_var_string}={post_slug}` will be valid.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string|bool $query_var * @var string|bool $query_var
*/ */
public $query_var; public $query_var;
@ -263,7 +243,6 @@ final class WP_Post_Type {
* Default true. * Default true.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $can_export * @var bool $can_export
*/ */
public $can_export = true; public $can_export = true;
@ -277,7 +256,6 @@ final class WP_Post_Type {
* Otherwise posts are not trashed or deleted. Default null. * Otherwise posts are not trashed or deleted. Default null.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $delete_with_user * @var bool $delete_with_user
*/ */
public $delete_with_user = null; public $delete_with_user = null;
@ -288,7 +266,6 @@ final class WP_Post_Type {
* Default false. * Default false.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var bool $_builtin * @var bool $_builtin
*/ */
public $_builtin = false; public $_builtin = false;
@ -299,7 +276,6 @@ final class WP_Post_Type {
* Default 'post.php?post=%d'. * Default 'post.php?post=%d'.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string $_edit_link * @var string $_edit_link
*/ */
public $_edit_link = 'post.php?post=%d'; public $_edit_link = 'post.php?post=%d';
@ -308,7 +284,6 @@ final class WP_Post_Type {
* Post type capabilities. * Post type capabilities.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var object $cap * @var object $cap
*/ */
public $cap; public $cap;
@ -319,7 +294,6 @@ final class WP_Post_Type {
* Defaults to true, using $post_type as slug. * Defaults to true, using $post_type as slug.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array|false $rewrite * @var array|false $rewrite
*/ */
public $rewrite; public $rewrite;
@ -328,7 +302,6 @@ final class WP_Post_Type {
* The features supported by the post type. * The features supported by the post type.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array|bool $supports * @var array|bool $supports
*/ */
public $supports; public $supports;
@ -340,7 +313,6 @@ final class WP_Post_Type {
* respect to $rest_base and $rest_controller_class. * respect to $rest_base and $rest_controller_class.
* *
* @since 4.7.4 * @since 4.7.4
* @access public
* @var bool $show_in_rest * @var bool $show_in_rest
*/ */
public $show_in_rest; public $show_in_rest;
@ -349,7 +321,6 @@ final class WP_Post_Type {
* The base path for this post type's REST API endpoints. * The base path for this post type's REST API endpoints.
* *
* @since 4.7.4 * @since 4.7.4
* @access public
* @var string|bool $rest_base * @var string|bool $rest_base
*/ */
public $rest_base; public $rest_base;
@ -360,7 +331,6 @@ final class WP_Post_Type {
* Custom controllers must extend WP_REST_Controller. * Custom controllers must extend WP_REST_Controller.
* *
* @since 4.7.4 * @since 4.7.4
* @access public
* @var string|bool $rest_controller_class * @var string|bool $rest_controller_class
*/ */
public $rest_controller_class; public $rest_controller_class;
@ -372,7 +342,6 @@ final class WP_Post_Type {
* default properties based on that information. * default properties based on that information.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @see register_post_type() * @see register_post_type()
* *
@ -390,7 +359,6 @@ final class WP_Post_Type {
* Sets post type properties. * Sets post type properties.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param array|string $args Array or string of arguments for registering a post type. * @param array|string $args Array or string of arguments for registering a post type.
*/ */
@ -542,7 +510,6 @@ final class WP_Post_Type {
* Sets the features support for the post type. * Sets the features support for the post type.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
*/ */
public function add_supports() { public function add_supports() {
if ( ! empty( $this->supports ) ) { if ( ! empty( $this->supports ) ) {
@ -558,7 +525,6 @@ final class WP_Post_Type {
* Adds the necessary rewrite rules for the post type. * Adds the necessary rewrite rules for the post type.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @global WP_Rewrite $wp_rewrite WordPress Rewrite Component. * @global WP_Rewrite $wp_rewrite WordPress Rewrite Component.
* @global WP $wp Current WordPress environment instance. * @global WP $wp Current WordPress environment instance.
@ -606,7 +572,6 @@ final class WP_Post_Type {
* Registers the post type meta box if a custom callback was specified. * Registers the post type meta box if a custom callback was specified.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
*/ */
public function register_meta_boxes() { public function register_meta_boxes() {
if ( $this->register_meta_box_cb ) { if ( $this->register_meta_box_cb ) {
@ -618,7 +583,6 @@ final class WP_Post_Type {
* Adds the future post hook action for the post type. * Adds the future post hook action for the post type.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
*/ */
public function add_hooks() { public function add_hooks() {
add_action( 'future_' . $this->name, '_future_post_hook', 5, 2 ); add_action( 'future_' . $this->name, '_future_post_hook', 5, 2 );
@ -628,7 +592,6 @@ final class WP_Post_Type {
* Registers the taxonomies for the post type. * Registers the taxonomies for the post type.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
*/ */
public function register_taxonomies() { public function register_taxonomies() {
foreach ( $this->taxonomies as $taxonomy ) { foreach ( $this->taxonomies as $taxonomy ) {
@ -640,7 +603,6 @@ final class WP_Post_Type {
* Removes the features support for the post type. * Removes the features support for the post type.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @global array $_wp_post_type_features Post type features. * @global array $_wp_post_type_features Post type features.
*/ */
@ -654,7 +616,6 @@ final class WP_Post_Type {
* Removes any rewrite rules, permastructs, and rules for the post type. * Removes any rewrite rules, permastructs, and rules for the post type.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @global WP_Rewrite $wp_rewrite WordPress rewrite component. * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
* @global WP $wp Current WordPress environment instance. * @global WP $wp Current WordPress environment instance.
@ -689,7 +650,6 @@ final class WP_Post_Type {
* Unregisters the post type meta box if a custom callback was specified. * Unregisters the post type meta box if a custom callback was specified.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
*/ */
public function unregister_meta_boxes() { public function unregister_meta_boxes() {
if ( $this->register_meta_box_cb ) { if ( $this->register_meta_box_cb ) {
@ -701,7 +661,6 @@ final class WP_Post_Type {
* Removes the post type from all taxonomies. * Removes the post type from all taxonomies.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
*/ */
public function unregister_taxonomies() { public function unregister_taxonomies() {
foreach ( get_object_taxonomies( $this->name ) as $taxonomy ) { foreach ( get_object_taxonomies( $this->name ) as $taxonomy ) {
@ -713,7 +672,6 @@ final class WP_Post_Type {
* Removes the future post hook action for the post type. * Removes the future post hook action for the post type.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
*/ */
public function remove_hooks() { public function remove_hooks() {
remove_action( 'future_' . $this->name, '_future_post_hook', 5 ); remove_action( 'future_' . $this->name, '_future_post_hook', 5 );

25
wp-includes/class-wp-post.php
View File

@ -25,7 +25,6 @@ final class WP_Post {
* Post ID. * Post ID.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var int * @var int
*/ */
public $ID; public $ID;
@ -36,7 +35,6 @@ final class WP_Post {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_author = 0; public $post_author = 0;
@ -45,7 +43,6 @@ final class WP_Post {
* The post's local publication time. * The post's local publication time.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_date = '0000-00-00 00:00:00'; public $post_date = '0000-00-00 00:00:00';
@ -54,7 +51,6 @@ final class WP_Post {
* The post's GMT publication time. * The post's GMT publication time.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_date_gmt = '0000-00-00 00:00:00'; public $post_date_gmt = '0000-00-00 00:00:00';
@ -63,7 +59,6 @@ final class WP_Post {
* The post's content. * The post's content.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_content = ''; public $post_content = '';
@ -72,7 +67,6 @@ final class WP_Post {
* The post's title. * The post's title.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_title = ''; public $post_title = '';
@ -81,7 +75,6 @@ final class WP_Post {
* The post's excerpt. * The post's excerpt.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_excerpt = ''; public $post_excerpt = '';
@ -90,7 +83,6 @@ final class WP_Post {
* The post's status. * The post's status.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_status = 'publish'; public $post_status = 'publish';
@ -99,7 +91,6 @@ final class WP_Post {
* Whether comments are allowed. * Whether comments are allowed.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $comment_status = 'open'; public $comment_status = 'open';
@ -108,7 +99,6 @@ final class WP_Post {
* Whether pings are allowed. * Whether pings are allowed.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $ping_status = 'open'; public $ping_status = 'open';
@ -117,7 +107,6 @@ final class WP_Post {
* The post's password in plain text. * The post's password in plain text.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_password = ''; public $post_password = '';
@ -126,7 +115,6 @@ final class WP_Post {
* The post's slug. * The post's slug.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_name = ''; public $post_name = '';
@ -135,7 +123,6 @@ final class WP_Post {
* URLs queued to be pinged. * URLs queued to be pinged.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $to_ping = ''; public $to_ping = '';
@ -144,7 +131,6 @@ final class WP_Post {
* URLs that have been pinged. * URLs that have been pinged.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $pinged = ''; public $pinged = '';
@ -153,7 +139,6 @@ final class WP_Post {
* The post's local modified time. * The post's local modified time.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_modified = '0000-00-00 00:00:00'; public $post_modified = '0000-00-00 00:00:00';
@ -162,7 +147,6 @@ final class WP_Post {
* The post's GMT modified time. * The post's GMT modified time.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_modified_gmt = '0000-00-00 00:00:00'; public $post_modified_gmt = '0000-00-00 00:00:00';
@ -171,7 +155,6 @@ final class WP_Post {
* A utility DB field for post content. * A utility DB field for post content.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_content_filtered = ''; public $post_content_filtered = '';
@ -180,7 +163,6 @@ final class WP_Post {
* ID of a post's parent post. * ID of a post's parent post.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var int * @var int
*/ */
public $post_parent = 0; public $post_parent = 0;
@ -189,7 +171,6 @@ final class WP_Post {
* The unique identifier for a post, not necessarily a URL, used as the feed GUID. * The unique identifier for a post, not necessarily a URL, used as the feed GUID.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $guid = ''; public $guid = '';
@ -198,7 +179,6 @@ final class WP_Post {
* A field used for ordering posts. * A field used for ordering posts.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var int * @var int
*/ */
public $menu_order = 0; public $menu_order = 0;
@ -207,7 +187,6 @@ final class WP_Post {
* The post's type, like post or page. * The post's type, like post or page.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_type = 'post'; public $post_type = 'post';
@ -216,7 +195,6 @@ final class WP_Post {
* An attachment's mime type. * An attachment's mime type.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $post_mime_type = ''; public $post_mime_type = '';
@ -227,7 +205,6 @@ final class WP_Post {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $comment_count = 0; public $comment_count = 0;
@ -238,7 +215,6 @@ final class WP_Post {
* Does not correspond to a DB field. * Does not correspond to a DB field.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var string * @var string
*/ */
public $filter; public $filter;
@ -248,7 +224,6 @@ final class WP_Post {
* *
* @since 3.5.0 * @since 3.5.0
* @static * @static
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *

80
wp-includes/class-wp-query.php
View File

@ -21,7 +21,6 @@ class WP_Query {
* Query vars set by the user * Query vars set by the user
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var array * @var array
*/ */
public $query; public $query;
@ -30,7 +29,6 @@ class WP_Query {
* Query vars, after parsing * Query vars, after parsing
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var array * @var array
*/ */
public $query_vars = array(); public $query_vars = array();
@ -39,7 +37,6 @@ class WP_Query {
* Taxonomy query, as passed to get_tax_sql() * Taxonomy query, as passed to get_tax_sql()
* *
* @since 3.1.0 * @since 3.1.0
* @access public
* @var object WP_Tax_Query * @var object WP_Tax_Query
*/ */
public $tax_query; public $tax_query;
@ -48,7 +45,6 @@ class WP_Query {
* Metadata query container * Metadata query container
* *
* @since 3.2.0 * @since 3.2.0
* @access public
* @var object WP_Meta_Query * @var object WP_Meta_Query
*/ */
public $meta_query = false; public $meta_query = false;
@ -57,7 +53,6 @@ class WP_Query {
* Date query container * Date query container
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* @var object WP_Date_Query * @var object WP_Date_Query
*/ */
public $date_query = false; public $date_query = false;
@ -68,7 +63,6 @@ class WP_Query {
* Holds the contents of a post, page, category, attachment. * Holds the contents of a post, page, category, attachment.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var object|array * @var object|array
*/ */
public $queried_object; public $queried_object;
@ -77,7 +71,6 @@ class WP_Query {
* The ID of the queried object. * The ID of the queried object.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var int * @var int
*/ */
public $queried_object_id; public $queried_object_id;
@ -86,7 +79,6 @@ class WP_Query {
* Get post database query. * Get post database query.
* *
* @since 2.0.1 * @since 2.0.1
* @access public
* @var string * @var string
*/ */
public $request; public $request;
@ -95,7 +87,6 @@ class WP_Query {
* List of posts. * List of posts.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var array * @var array
*/ */
public $posts; public $posts;
@ -104,7 +95,6 @@ class WP_Query {
* The amount of posts for the current query. * The amount of posts for the current query.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var int * @var int
*/ */
public $post_count = 0; public $post_count = 0;
@ -113,7 +103,6 @@ class WP_Query {
* Index of the current item in the loop. * Index of the current item in the loop.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var int * @var int
*/ */
public $current_post = -1; public $current_post = -1;
@ -122,7 +111,6 @@ class WP_Query {
* Whether the loop has started and the caller is in the loop. * Whether the loop has started and the caller is in the loop.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var bool * @var bool
*/ */
public $in_the_loop = false; public $in_the_loop = false;
@ -131,7 +119,6 @@ class WP_Query {
* The current post. * The current post.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var WP_Post * @var WP_Post
*/ */
public $post; public $post;
@ -140,7 +127,6 @@ class WP_Query {
* The list of comments for current post. * The list of comments for current post.
* *
* @since 2.2.0 * @since 2.2.0
* @access public
* @var array * @var array
*/ */
public $comments; public $comments;
@ -149,7 +135,6 @@ class WP_Query {
* The amount of comments for the posts. * The amount of comments for the posts.
* *
* @since 2.2.0 * @since 2.2.0
* @access public
* @var int * @var int
*/ */
public $comment_count = 0; public $comment_count = 0;
@ -158,7 +143,6 @@ class WP_Query {
* The index of the comment in the comment loop. * The index of the comment in the comment loop.
* *
* @since 2.2.0 * @since 2.2.0
* @access public
* @var int * @var int
*/ */
public $current_comment = -1; public $current_comment = -1;
@ -167,7 +151,6 @@ class WP_Query {
* Current comment ID. * Current comment ID.
* *
* @since 2.2.0 * @since 2.2.0
* @access public
* @var int * @var int
*/ */
public $comment; public $comment;
@ -178,7 +161,6 @@ class WP_Query {
* If limit clause was not used, equals $post_count. * If limit clause was not used, equals $post_count.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var int * @var int
*/ */
public $found_posts = 0; public $found_posts = 0;
@ -187,7 +169,6 @@ class WP_Query {
* The amount of pages. * The amount of pages.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var int * @var int
*/ */
public $max_num_pages = 0; public $max_num_pages = 0;
@ -196,7 +177,6 @@ class WP_Query {
* The amount of comment pages. * The amount of comment pages.
* *
* @since 2.7.0 * @since 2.7.0
* @access public
* @var int * @var int
*/ */
public $max_num_comment_pages = 0; public $max_num_comment_pages = 0;
@ -205,7 +185,6 @@ class WP_Query {
* Signifies whether the current query is for a single post. * Signifies whether the current query is for a single post.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_single = false; public $is_single = false;
@ -214,7 +193,6 @@ class WP_Query {
* Signifies whether the current query is for a preview. * Signifies whether the current query is for a preview.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var bool * @var bool
*/ */
public $is_preview = false; public $is_preview = false;
@ -223,7 +201,6 @@ class WP_Query {
* Signifies whether the current query is for a page. * Signifies whether the current query is for a page.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_page = false; public $is_page = false;
@ -232,7 +209,6 @@ class WP_Query {
* Signifies whether the current query is for an archive. * Signifies whether the current query is for an archive.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_archive = false; public $is_archive = false;
@ -241,7 +217,6 @@ class WP_Query {
* Signifies whether the current query is for a date archive. * Signifies whether the current query is for a date archive.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_date = false; public $is_date = false;
@ -250,7 +225,6 @@ class WP_Query {
* Signifies whether the current query is for a year archive. * Signifies whether the current query is for a year archive.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_year = false; public $is_year = false;
@ -259,7 +233,6 @@ class WP_Query {
* Signifies whether the current query is for a month archive. * Signifies whether the current query is for a month archive.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_month = false; public $is_month = false;
@ -268,7 +241,6 @@ class WP_Query {
* Signifies whether the current query is for a day archive. * Signifies whether the current query is for a day archive.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_day = false; public $is_day = false;
@ -277,7 +249,6 @@ class WP_Query {
* Signifies whether the current query is for a specific time. * Signifies whether the current query is for a specific time.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_time = false; public $is_time = false;
@ -286,7 +257,6 @@ class WP_Query {
* Signifies whether the current query is for an author archive. * Signifies whether the current query is for an author archive.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_author = false; public $is_author = false;
@ -295,7 +265,6 @@ class WP_Query {
* Signifies whether the current query is for a category archive. * Signifies whether the current query is for a category archive.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_category = false; public $is_category = false;
@ -304,7 +273,6 @@ class WP_Query {
* Signifies whether the current query is for a tag archive. * Signifies whether the current query is for a tag archive.
* *
* @since 2.3.0 * @since 2.3.0
* @access public
* @var bool * @var bool
*/ */
public $is_tag = false; public $is_tag = false;
@ -313,7 +281,6 @@ class WP_Query {
* Signifies whether the current query is for a taxonomy archive. * Signifies whether the current query is for a taxonomy archive.
* *
* @since 2.5.0 * @since 2.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_tax = false; public $is_tax = false;
@ -322,7 +289,6 @@ class WP_Query {
* Signifies whether the current query is for a search. * Signifies whether the current query is for a search.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_search = false; public $is_search = false;
@ -331,7 +297,6 @@ class WP_Query {
* Signifies whether the current query is for a feed. * Signifies whether the current query is for a feed.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_feed = false; public $is_feed = false;
@ -340,7 +305,6 @@ class WP_Query {
* Signifies whether the current query is for a comment feed. * Signifies whether the current query is for a comment feed.
* *
* @since 2.2.0 * @since 2.2.0
* @access public
* @var bool * @var bool
*/ */
public $is_comment_feed = false; public $is_comment_feed = false;
@ -349,7 +313,6 @@ class WP_Query {
* Signifies whether the current query is for trackback endpoint call. * Signifies whether the current query is for trackback endpoint call.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_trackback = false; public $is_trackback = false;
@ -358,7 +321,6 @@ class WP_Query {
* Signifies whether the current query is for the site homepage. * Signifies whether the current query is for the site homepage.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_home = false; public $is_home = false;
@ -367,7 +329,6 @@ class WP_Query {
* Signifies whether the current query couldn't find anything. * Signifies whether the current query couldn't find anything.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_404 = false; public $is_404 = false;
@ -376,7 +337,6 @@ class WP_Query {
* Signifies whether the current query is for an embed. * Signifies whether the current query is for an embed.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var bool * @var bool
*/ */
public $is_embed = false; public $is_embed = false;
@ -385,7 +345,6 @@ class WP_Query {
* Signifies whether the current query is for a paged result and not for the first page. * Signifies whether the current query is for a paged result and not for the first page.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_paged = false; public $is_paged = false;
@ -394,7 +353,6 @@ class WP_Query {
* Signifies whether the current query is for an administrative interface page. * Signifies whether the current query is for an administrative interface page.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var bool * @var bool
*/ */
public $is_admin = false; public $is_admin = false;
@ -403,7 +361,6 @@ class WP_Query {
* Signifies whether the current query is for an attachment page. * Signifies whether the current query is for an attachment page.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var bool * @var bool
*/ */
public $is_attachment = false; public $is_attachment = false;
@ -413,7 +370,6 @@ class WP_Query {
* (post, attachment, page, custom post types). * (post, attachment, page, custom post types).
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var bool * @var bool
*/ */
public $is_singular = false; public $is_singular = false;
@ -422,7 +378,6 @@ class WP_Query {
* Signifies whether the current query is for the robots.txt file. * Signifies whether the current query is for the robots.txt file.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var bool * @var bool
*/ */
public $is_robots = false; public $is_robots = false;
@ -433,7 +388,6 @@ class WP_Query {
* Basically, the homepage if the option isn't set for the static homepage. * Basically, the homepage if the option isn't set for the static homepage.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var bool * @var bool
*/ */
public $is_posts_page = false; public $is_posts_page = false;
@ -442,7 +396,6 @@ class WP_Query {
* Signifies whether the current query is for a post type archive. * Signifies whether the current query is for a post type archive.
* *
* @since 3.1.0 * @since 3.1.0
* @access public
* @var bool * @var bool
*/ */
public $is_post_type_archive = false; public $is_post_type_archive = false;
@ -452,7 +405,6 @@ class WP_Query {
* whether we have to re-parse because something has changed * whether we have to re-parse because something has changed
* *
* @since 3.1.0 * @since 3.1.0
* @access private
* @var bool|string * @var bool|string
*/ */
private $query_vars_hash = false; private $query_vars_hash = false;
@ -462,7 +414,6 @@ class WP_Query {
* via pre_get_posts hooks. * via pre_get_posts hooks.
* *
* @since 3.1.1 * @since 3.1.1
* @access private
*/ */
private $query_vars_changed = true; private $query_vars_changed = true;
@ -470,7 +421,6 @@ class WP_Query {
* Set if post thumbnails are cached * Set if post thumbnails are cached
* *
* @since 3.2.0 * @since 3.2.0
* @access public
* @var bool * @var bool
*/ */
public $thumbnails_cached = false; public $thumbnails_cached = false;
@ -493,7 +443,6 @@ class WP_Query {
* The query flags are what page info WordPress was able to figure out. * The query flags are what page info WordPress was able to figure out.
* *
* @since 2.0.0 * @since 2.0.0
* @access private
*/ */
private function init_query_flags() { private function init_query_flags() {
$this->is_single = false; $this->is_single = false;
@ -528,7 +477,6 @@ class WP_Query {
* Initiates object properties and sets default values. * Initiates object properties and sets default values.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
*/ */
public function init() { public function init() {
unset($this->posts); unset($this->posts);
@ -556,7 +504,6 @@ class WP_Query {
* Reparse the query vars. * Reparse the query vars.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
*/ */
public function parse_query_vars() { public function parse_query_vars() {
$this->parse_query(); $this->parse_query();
@ -567,7 +514,6 @@ class WP_Query {
* *
* @since 2.1.0 * @since 2.1.0
* @since 4.4.0 Removed the `comments_popup` public query variable. * @since 4.4.0 Removed the `comments_popup` public query variable.
* @access public
* *
* @param array $array Defined query variables. * @param array $array Defined query variables.
* @return array Complete query variables with undefined ones filled in empty. * @return array Complete query variables with undefined ones filled in empty.
@ -642,7 +588,6 @@ class WP_Query {
* Introduced `RAND(x)` syntax for `$orderby`, which allows an integer seed value to random sorts. * Introduced `RAND(x)` syntax for `$orderby`, which allows an integer seed value to random sorts.
* @since 4.6.0 Added 'post_name__in' support for `$orderby`. Introduced the `$lazy_load_term_meta` argument. * @since 4.6.0 Added 'post_name__in' support for `$orderby`. Introduced the `$lazy_load_term_meta` argument.
* @since 4.9.0 Introduced the `$comment_count` parameter. * @since 4.9.0 Introduced the `$comment_count` parameter.
* @access public
* *
* @param string|array $query { * @param string|array $query {
* Optional. Array or string of Query parameters. * Optional. Array or string of Query parameters.
@ -1066,7 +1011,6 @@ class WP_Query {
* *
* For BC, this method is not marked as protected. See [28987]. * For BC, this method is not marked as protected. See [28987].
* *
* @access protected
* @since 3.1.0 * @since 3.1.0
* *
* @param array $q The query variables. Passed by reference. * @param array $q The query variables. Passed by reference.
@ -1295,7 +1239,6 @@ class WP_Query {
* Generates SQL for the WHERE clause based on passed search terms. * Generates SQL for the WHERE clause based on passed search terms.
* *
* @since 3.7.0 * @since 3.7.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -1452,7 +1395,6 @@ class WP_Query {
* Generates SQL for the ORDER BY condition based on passed search terms. * Generates SQL for the ORDER BY condition based on passed search terms.
* *
* @since 3.7.0 * @since 3.7.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -1509,7 +1451,6 @@ class WP_Query {
* Converts the given orderby alias (if allowed) to a properly-prefixed value. * Converts the given orderby alias (if allowed) to a properly-prefixed value.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -1603,7 +1544,6 @@ class WP_Query {
* Parse an 'order' query variable and cast it to ASC or DESC as necessary. * Parse an 'order' query variable and cast it to ASC or DESC as necessary.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @param string $order The 'order' query variable. * @param string $order The 'order' query variable.
* @return string The sanitized 'order' query variable. * @return string The sanitized 'order' query variable.
@ -1624,7 +1564,6 @@ class WP_Query {
* Sets the 404 property and saves whether query is feed. * Sets the 404 property and saves whether query is feed.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
*/ */
public function set_404() { public function set_404() {
$is_feed = $this->is_feed; $is_feed = $this->is_feed;
@ -1641,7 +1580,6 @@ class WP_Query {
* @since 1.5.0 * @since 1.5.0
* @since 3.9.0 The `$default` argument was introduced. * @since 3.9.0 The `$default` argument was introduced.
* *
* @access public
* *
* @param string $query_var Query variable key. * @param string $query_var Query variable key.
* @param mixed $default Optional. Value to return if the query variable is not set. Default empty. * @param mixed $default Optional. Value to return if the query variable is not set. Default empty.
@ -1659,7 +1597,6 @@ class WP_Query {
* Set query variable. * Set query variable.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @param string $query_var Query variable key. * @param string $query_var Query variable key.
* @param mixed $value Query variable value. * @param mixed $value Query variable value.
@ -1675,7 +1612,6 @@ class WP_Query {
* database query. * database query.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return array List of posts. * @return array List of posts.
*/ */
@ -3074,7 +3010,6 @@ class WP_Query {
* for the current query. * for the current query.
* *
* @since 3.5.0 * @since 3.5.0
* @access private
* *
* @param array $q Query variables. * @param array $q Query variables.
* @param string $limits LIMIT clauses of the query. * @param string $limits LIMIT clauses of the query.
@ -3118,7 +3053,6 @@ class WP_Query {
* Set up the next post and iterate current post index. * Set up the next post and iterate current post index.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return WP_Post Next post. * @return WP_Post Next post.
*/ */
@ -3137,7 +3071,6 @@ class WP_Query {
* property to true. * property to true.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @global WP_Post $post * @global WP_Post $post
*/ */
@ -3165,7 +3098,6 @@ class WP_Query {
* Calls the {@see 'loop_end'} action when the loop is complete. * Calls the {@see 'loop_end'} action when the loop is complete.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return bool True if posts are available, false if end of loop. * @return bool True if posts are available, false if end of loop.
*/ */
@ -3202,7 +3134,6 @@ class WP_Query {
* Rewind the posts and reset post index. * Rewind the posts and reset post index.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
*/ */
public function rewind_posts() { public function rewind_posts() {
$this->current_post = -1; $this->current_post = -1;
@ -3215,7 +3146,6 @@ class WP_Query {
* Iterate current comment index and return WP_Comment object. * Iterate current comment index and return WP_Comment object.
* *
* @since 2.2.0 * @since 2.2.0
* @access public
* *
* @return WP_Comment Comment object. * @return WP_Comment Comment object.
*/ */
@ -3230,7 +3160,6 @@ class WP_Query {
* Sets up the current comment. * Sets up the current comment.
* *
* @since 2.2.0 * @since 2.2.0
* @access public
* @global WP_Comment $comment Current comment. * @global WP_Comment $comment Current comment.
*/ */
public function the_comment() { public function the_comment() {
@ -3254,7 +3183,6 @@ class WP_Query {
* Automatically rewinds comments when finished. * Automatically rewinds comments when finished.
* *
* @since 2.2.0 * @since 2.2.0
* @access public
* *
* @return bool True, if more comments. False, if no more posts. * @return bool True, if more comments. False, if no more posts.
*/ */
@ -3272,7 +3200,6 @@ class WP_Query {
* Rewind the comments, resets the comment index and comment to first. * Rewind the comments, resets the comment index and comment to first.
* *
* @since 2.2.0 * @since 2.2.0
* @access public
*/ */
public function rewind_comments() { public function rewind_comments() {
$this->current_comment = -1; $this->current_comment = -1;
@ -3285,7 +3212,6 @@ class WP_Query {
* Sets up the WordPress query by parsing query string. * Sets up the WordPress query by parsing query string.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @param string|array $query URL query string or array of query arguments. * @param string|array $query URL query string or array of query arguments.
* @return array List of posts. * @return array List of posts.
@ -3304,7 +3230,6 @@ class WP_Query {
* query variable. After it is set up, it will be returned. * query variable. After it is set up, it will be returned.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return object * @return object
*/ */
@ -3376,7 +3301,6 @@ class WP_Query {
* Retrieve ID of the current queried object. * Retrieve ID of the current queried object.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return int * @return int
*/ */
@ -3396,7 +3320,6 @@ class WP_Query {
* Sets up the WordPress query, if parameter is not empty. * Sets up the WordPress query, if parameter is not empty.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @param string|array $query URL query string or array of vars. * @param string|array $query URL query string or array of vars.
*/ */
@ -3410,7 +3333,6 @@ class WP_Query {
* Make private properties readable for backward compatibility. * Make private properties readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to get. * @param string $name Property to get.
* @return mixed Property. * @return mixed Property.
@ -3425,7 +3347,6 @@ class WP_Query {
* Make private properties checkable for backward compatibility. * Make private properties checkable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to check if set. * @param string $name Property to check if set.
* @return bool Whether the property is set. * @return bool Whether the property is set.
@ -3440,7 +3361,6 @@ class WP_Query {
* Make private/protected methods readable for backward compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param callable $name Method to call. * @param callable $name Method to call.
* @param array $arguments Arguments to pass when calling. * @param array $arguments Arguments to pass when calling.

63
wp-includes/class-wp-rewrite.php
View File

@ -43,7 +43,6 @@ class WP_Rewrite {
* Base for the author permalink structure (example.com/$author_base/authorname). * Base for the author permalink structure (example.com/$author_base/authorname).
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $author_base = 'author'; var $author_base = 'author';
@ -52,7 +51,6 @@ class WP_Rewrite {
* Permalink structure for author archives. * Permalink structure for author archives.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $author_structure; var $author_structure;
@ -61,7 +59,6 @@ class WP_Rewrite {
* Permalink structure for date archives. * Permalink structure for date archives.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $date_structure; var $date_structure;
@ -70,7 +67,6 @@ class WP_Rewrite {
* Permalink structure for pages. * Permalink structure for pages.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $page_structure; var $page_structure;
@ -79,7 +75,6 @@ class WP_Rewrite {
* Base of the search permalink structure (example.com/$search_base/query). * Base of the search permalink structure (example.com/$search_base/query).
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $search_base = 'search'; var $search_base = 'search';
@ -88,7 +83,6 @@ class WP_Rewrite {
* Permalink structure for searches. * Permalink structure for searches.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $search_structure; var $search_structure;
@ -97,7 +91,6 @@ class WP_Rewrite {
* Comments permalink base. * Comments permalink base.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $comments_base = 'comments'; var $comments_base = 'comments';
@ -114,7 +107,6 @@ class WP_Rewrite {
* Comments pagination permalink base. * Comments pagination permalink base.
* *
* @since 4.2.0 * @since 4.2.0
* @access private
* @var string * @var string
*/ */
var $comments_pagination_base = 'comment-page'; var $comments_pagination_base = 'comment-page';
@ -123,7 +115,6 @@ class WP_Rewrite {
* Feed permalink base. * Feed permalink base.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $feed_base = 'feed'; var $feed_base = 'feed';
@ -132,7 +123,6 @@ class WP_Rewrite {
* Comments feed permalink structure. * Comments feed permalink structure.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $comment_feed_structure; var $comment_feed_structure;
@ -141,7 +131,6 @@ class WP_Rewrite {
* Feed request permalink structure. * Feed request permalink structure.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $feed_structure; var $feed_structure;
@ -154,7 +143,6 @@ class WP_Rewrite {
* then the front is "/". * then the front is "/".
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var string * @var string
* *
* @see WP_Rewrite::init() * @see WP_Rewrite::init()
@ -169,7 +157,6 @@ class WP_Rewrite {
* will be empty. * will be empty.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var string * @var string
* *
* @see WP_Rewrite::init() * @see WP_Rewrite::init()
@ -181,7 +168,6 @@ class WP_Rewrite {
* The name of the index file which is the entry point to all requests. * The name of the index file which is the entry point to all requests.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* @var string * @var string
*/ */
public $index = 'index.php'; public $index = 'index.php';
@ -190,7 +176,6 @@ class WP_Rewrite {
* Variable name to use for regex matches in the rewritten query. * Variable name to use for regex matches in the rewritten query.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var string * @var string
*/ */
var $matches = ''; var $matches = '';
@ -199,7 +184,6 @@ class WP_Rewrite {
* Rewrite rules to match against the request to find the redirect or query. * Rewrite rules to match against the request to find the redirect or query.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var array * @var array
*/ */
var $rules; var $rules;
@ -210,7 +194,6 @@ class WP_Rewrite {
* Those not generated by the class, see add_rewrite_rule(). * Those not generated by the class, see add_rewrite_rule().
* *
* @since 2.1.0 * @since 2.1.0
* @access private
* @var array * @var array
*/ */
var $extra_rules = array(); var $extra_rules = array();
@ -221,7 +204,6 @@ class WP_Rewrite {
* Those not generated by the class, see add_rewrite_rule(). * Those not generated by the class, see add_rewrite_rule().
* *
* @since 2.3.0 * @since 2.3.0
* @access private
* @var array * @var array
*/ */
var $extra_rules_top = array(); var $extra_rules_top = array();
@ -233,7 +215,6 @@ class WP_Rewrite {
* and are added by add_external_rule(). * and are added by add_external_rule().
* *
* @since 2.1.0 * @since 2.1.0
* @access private
* @var array * @var array
*/ */
var $non_wp_rules = array(); var $non_wp_rules = array();
@ -242,7 +223,6 @@ class WP_Rewrite {
* Extra permalink structures, e.g. categories, added by add_permastruct(). * Extra permalink structures, e.g. categories, added by add_permastruct().
* *
* @since 2.1.0 * @since 2.1.0
* @access private
* @var array * @var array
*/ */
var $extra_permastructs = array(); var $extra_permastructs = array();
@ -251,7 +231,6 @@ class WP_Rewrite {
* Endpoints (like /trackback/) added by add_rewrite_endpoint(). * Endpoints (like /trackback/) added by add_rewrite_endpoint().
* *
* @since 2.1.0 * @since 2.1.0
* @access private
* @var array * @var array
*/ */
var $endpoints; var $endpoints;
@ -263,7 +242,6 @@ class WP_Rewrite {
* to the .htaccess file. * to the .htaccess file.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var bool * @var bool
* *
* @see WP_Rewrite::mod_rewrite_rules() * @see WP_Rewrite::mod_rewrite_rules()
@ -281,7 +259,6 @@ class WP_Rewrite {
* permastruct is actually a page before accepting it. * permastruct is actually a page before accepting it.
* *
* @since 2.5.0 * @since 2.5.0
* @access public
* @var bool * @var bool
* *
* @see WP_Rewrite::init() * @see WP_Rewrite::init()
@ -298,7 +275,6 @@ class WP_Rewrite {
* Additional tags can be added with add_rewrite_tag(). * Additional tags can be added with add_rewrite_tag().
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var array * @var array
*/ */
var $rewritecode = array( var $rewritecode = array(
@ -320,7 +296,6 @@ class WP_Rewrite {
* of rewrite tags, see WP_Rewrite::$rewritecode. * of rewrite tags, see WP_Rewrite::$rewritecode.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var array * @var array
*/ */
var $rewritereplace = array( var $rewritereplace = array(
@ -341,7 +316,6 @@ class WP_Rewrite {
* Query variables that rewrite tags map to, see WP_Rewrite::$rewritecode. * Query variables that rewrite tags map to, see WP_Rewrite::$rewritecode.
* *
* @since 1.5.0 * @since 1.5.0
* @access private
* @var array * @var array
*/ */
var $queryreplace = array( var $queryreplace = array(
@ -372,7 +346,6 @@ class WP_Rewrite {
* This can be either rewrite module or permalink in the HTTP query string. * This can be either rewrite module or permalink in the HTTP query string.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return bool True, if permalinks are enabled. * @return bool True, if permalinks are enabled.
*/ */
@ -386,7 +359,6 @@ class WP_Rewrite {
* Means that permalink links are enabled and index.php is in the URL. * Means that permalink links are enabled and index.php is in the URL.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return bool Whether permalink links are enabled and index.php is in the URL. * @return bool Whether permalink links are enabled and index.php is in the URL.
*/ */
@ -405,7 +377,6 @@ class WP_Rewrite {
* Using permalinks and index.php is not in the URL. * Using permalinks and index.php is not in the URL.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return bool Whether permalink links are enabled and index.php is NOT in the URL. * @return bool Whether permalink links are enabled and index.php is NOT in the URL.
*/ */
@ -424,7 +395,6 @@ class WP_Rewrite {
* value of the $number parameter. * value of the $number parameter.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @param int $number Index number. * @param int $number Index number.
* @return string * @return string
@ -448,7 +418,6 @@ class WP_Rewrite {
* retrieved. * retrieved.
* *
* @since 2.5.0 * @since 2.5.0
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -492,7 +461,6 @@ class WP_Rewrite {
* Retrieves all of the rewrite rules for pages. * Retrieves all of the rewrite rules for pages.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return array Page rewrite rules. * @return array Page rewrite rules.
*/ */
@ -519,7 +487,6 @@ class WP_Rewrite {
* structure. * structure.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return string|false False on no permalink structure. Date permalink structure. * @return string|false False on no permalink structure. Date permalink structure.
*/ */
@ -575,7 +542,6 @@ class WP_Rewrite {
* permalink structures. * permalink structures.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return false|string False on failure. Year structure on success. * @return false|string False on failure. Year structure on success.
*/ */
@ -599,7 +565,6 @@ class WP_Rewrite {
* structures. Keeps the year permalink structure. * structures. Keeps the year permalink structure.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return false|string False on failure. Year/Month structure on success. * @return false|string False on failure. Year/Month structure on success.
*/ */
@ -621,7 +586,6 @@ class WP_Rewrite {
* Keeps date permalink structure with all year, month, and day. * Keeps date permalink structure with all year, month, and day.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return string|false False on failure. Year/Month/Day structure on success. * @return string|false False on failure. Year/Month/Day structure on success.
*/ */
@ -638,7 +602,6 @@ class WP_Rewrite {
* the category_base property value. * the category_base property value.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return string|false False on failure. Category permalink structure. * @return string|false False on failure. Category permalink structure.
*/ */
@ -655,7 +618,6 @@ class WP_Rewrite {
* property value. * property value.
* *
* @since 2.3.0 * @since 2.3.0
* @access public
* *
* @return string|false False on failure. Tag permalink structure. * @return string|false False on failure. Tag permalink structure.
*/ */
@ -667,7 +629,6 @@ class WP_Rewrite {
* Retrieves an extra permalink structure by name. * Retrieves an extra permalink structure by name.
* *
* @since 2.5.0 * @since 2.5.0
* @access public
* *
* @param string $name Permalink structure name. * @param string $name Permalink structure name.
* @return string|false False if not found. Permalink structure string. * @return string|false False if not found. Permalink structure string.
@ -690,7 +651,6 @@ class WP_Rewrite {
* without attempting to set the value again. * without attempting to set the value again.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return string|false False if not found. Permalink structure string. * @return string|false False if not found. Permalink structure string.
*/ */
@ -716,7 +676,6 @@ class WP_Rewrite {
* without attempting to set the value again. * without attempting to set the value again.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return string|false False if not found. Permalink structure string. * @return string|false False if not found. Permalink structure string.
*/ */
@ -742,7 +701,6 @@ class WP_Rewrite {
* value again. * value again.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return string|false False if not found. Permalink structure string. * @return string|false False if not found. Permalink structure string.
*/ */
@ -768,7 +726,6 @@ class WP_Rewrite {
* without attempting to set the value again. * without attempting to set the value again.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return string|false False if not found. Permalink structure string. * @return string|false False if not found. Permalink structure string.
*/ */
@ -794,7 +751,6 @@ class WP_Rewrite {
* and then return it without attempting to set the value again. * and then return it without attempting to set the value again.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return string|false False if not found. Permalink structure string. * @return string|false False if not found. Permalink structure string.
*/ */
@ -819,7 +775,6 @@ class WP_Rewrite {
* that tag, otherwise add the new tag. * that tag, otherwise add the new tag.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @see WP_Rewrite::$rewritecode * @see WP_Rewrite::$rewritecode
* @see WP_Rewrite::$rewritereplace * @see WP_Rewrite::$rewritereplace
@ -846,7 +801,6 @@ class WP_Rewrite {
* Removes an existing rewrite tag. * Removes an existing rewrite tag.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @see WP_Rewrite::$rewritecode * @see WP_Rewrite::$rewritecode
* @see WP_Rewrite::$rewritereplace * @see WP_Rewrite::$rewritereplace
@ -871,7 +825,6 @@ class WP_Rewrite {
* so best just ignore the contents and move to the parameters. * so best just ignore the contents and move to the parameters.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @param string $permalink_structure The permalink structure. * @param string $permalink_structure The permalink structure.
* @param int $ep_mask Optional. Endpoint mask defining what endpoints are added to the structure. * @param int $ep_mask Optional. Endpoint mask defining what endpoints are added to the structure.
@ -1237,7 +1190,6 @@ class WP_Rewrite {
* rewrite rules does. * rewrite rules does.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @see WP_Rewrite::generate_rewrite_rules() See for long description and rest of parameters. * @see WP_Rewrite::generate_rewrite_rules() See for long description and rest of parameters.
* *
@ -1263,7 +1215,6 @@ class WP_Rewrite {
* from the function. * from the function.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return array An associate array of matches and queries. * @return array An associate array of matches and queries.
*/ */
@ -1466,7 +1417,6 @@ class WP_Rewrite {
* in the form of caching. * in the form of caching.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return array Rewrite rules. * @return array Rewrite rules.
*/ */
@ -1495,7 +1445,6 @@ class WP_Rewrite {
* the WordPress rewrite rules one. * the WordPress rewrite rules one.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @return string * @return string
*/ */
@ -1580,7 +1529,6 @@ class WP_Rewrite {
* the process that will. * the process that will.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param bool $add_parent_tags Optional. Whether to add parent tags to the rewrite rule sets. * @param bool $add_parent_tags Optional. Whether to add parent tags to the rewrite rule sets.
* Default false. * Default false.
@ -1633,7 +1581,6 @@ class WP_Rewrite {
* *
* @since 2.1.0 * @since 2.1.0
* @since 4.4.0 Array support was added to the `$query` parameter. * @since 4.4.0 Array support was added to the `$query` parameter.
* @access public
* *
* @param string $regex Regular expression to match request against. * @param string $regex Regular expression to match request against.
* @param string|array $query The corresponding query vars for this rewrite rule. * @param string|array $query The corresponding query vars for this rewrite rule.
@ -1667,7 +1614,6 @@ class WP_Rewrite {
* Adds a rewrite rule that doesn't correspond to index.php. * Adds a rewrite rule that doesn't correspond to index.php.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string $regex Regular expression to match request against. * @param string $regex Regular expression to match request against.
* @param string $query The corresponding query vars for this rewrite rule. * @param string $query The corresponding query vars for this rewrite rule.
@ -1682,7 +1628,6 @@ class WP_Rewrite {
* @since 2.1.0 * @since 2.1.0
* @since 3.9.0 $query_var parameter added. * @since 3.9.0 $query_var parameter added.
* @since 4.3.0 Added support for skipping query var registration by passing `false` to `$query_var`. * @since 4.3.0 Added support for skipping query var registration by passing `false` to `$query_var`.
* @access public
* *
* @see add_rewrite_endpoint() for full documentation. * @see add_rewrite_endpoint() for full documentation.
* @global WP $wp * @global WP $wp
@ -1722,7 +1667,6 @@ class WP_Rewrite {
* works on the new permastruct. * works on the new permastruct.
* *
* @since 2.5.0 * @since 2.5.0
* @access public
* *
* @param string $name Name for permalink structure. * @param string $name Name for permalink structure.
* @param string $struct Permalink structure (e.g. category/%category%) * @param string $struct Permalink structure (e.g. category/%category%)
@ -1778,7 +1722,6 @@ class WP_Rewrite {
* Removes a permalink structure. * Removes a permalink structure.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $name Name for permalink structure. * @param string $name Name for permalink structure.
*/ */
@ -1793,7 +1736,6 @@ class WP_Rewrite {
* If the function named 'save_mod_rewrite_rules' exists, it will be called. * If the function named 'save_mod_rewrite_rules' exists, it will be called.
* *
* @since 2.0.1 * @since 2.0.1
* @access public
* *
* @staticvar bool $do_hard_later * @staticvar bool $do_hard_later
* *
@ -1843,7 +1785,6 @@ class WP_Rewrite {
* '%tag%', or '%author%'. * '%tag%', or '%author%'.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
*/ */
public function init() { public function init() {
$this->extra_rules = $this->non_wp_rules = $this->endpoints = array(); $this->extra_rules = $this->non_wp_rules = $this->endpoints = array();
@ -1880,7 +1821,6 @@ class WP_Rewrite {
* processed passing the old and new values * processed passing the old and new values
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @param string $permalink_structure Permalink structure. * @param string $permalink_structure Permalink structure.
*/ */
@ -1911,7 +1851,6 @@ class WP_Rewrite {
* after the option is updated. * after the option is updated.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
* @param string $category_base Category permalink structure base. * @param string $category_base Category permalink structure base.
*/ */
@ -1930,7 +1869,6 @@ class WP_Rewrite {
* the option is updated. * the option is updated.
* *
* @since 2.3.0 * @since 2.3.0
* @access public
* *
* @param string $tag_base Tag permalink structure base. * @param string $tag_base Tag permalink structure base.
*/ */
@ -1945,7 +1883,6 @@ class WP_Rewrite {
* Constructor - Calls init(), which runs setup. * Constructor - Calls init(), which runs setup.
* *
* @since 1.5.0 * @since 1.5.0
* @access public
* *
*/ */
public function __construct() { public function __construct() {

6
wp-includes/class-wp-role.php
View File

@ -17,7 +17,6 @@ class WP_Role {
* Role name. * Role name.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var string * @var string
*/ */
public $name; public $name;
@ -26,7 +25,6 @@ class WP_Role {
* List of capabilities the role contains. * List of capabilities the role contains.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $capabilities; public $capabilities;
@ -38,7 +36,6 @@ class WP_Role {
* and the value a boolean of whether it is granted to the role. * and the value a boolean of whether it is granted to the role.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name. * @param string $role Role name.
* @param array $capabilities List of capabilities. * @param array $capabilities List of capabilities.
@ -52,7 +49,6 @@ class WP_Role {
* Assign role a capability. * Assign role a capability.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $cap Capability name. * @param string $cap Capability name.
* @param bool $grant Whether role has capability privilege. * @param bool $grant Whether role has capability privilege.
@ -71,7 +67,6 @@ class WP_Role {
* because you don't need to enter the role name. * because you don't need to enter the role name.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $cap Capability name. * @param string $cap Capability name.
*/ */
@ -89,7 +84,6 @@ class WP_Role {
* The third and final parameter for the hook is the role name. * The third and final parameter for the hook is the role name.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $cap Capability name. * @param string $cap Capability name.
* @return bool True if the role has the given capability. False otherwise. * @return bool True if the role has the given capability. False otherwise.

15
wp-includes/class-wp-roles.php
View File

@ -28,7 +28,6 @@ class WP_Roles {
* List of roles and capabilities. * List of roles and capabilities.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $roles; public $roles;
@ -37,7 +36,6 @@ class WP_Roles {
* List of the role objects. * List of the role objects.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $role_objects = array(); public $role_objects = array();
@ -46,7 +44,6 @@ class WP_Roles {
* List of role names. * List of role names.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $role_names = array(); public $role_names = array();
@ -55,7 +52,6 @@ class WP_Roles {
* Option name for storing role list. * Option name for storing role list.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var string * @var string
*/ */
public $role_key; public $role_key;
@ -64,7 +60,6 @@ class WP_Roles {
* Whether to use the database for retrieval and storage. * Whether to use the database for retrieval and storage.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var bool * @var bool
*/ */
public $use_db = true; public $use_db = true;
@ -82,7 +77,6 @@ class WP_Roles {
* Make private/protected methods readable for backward compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param callable $name Method to call. * @param callable $name Method to call.
* @param array $arguments Arguments to pass when calling. * @param array $arguments Arguments to pass when calling.
@ -103,7 +97,6 @@ class WP_Roles {
* be used and the role option will not be updated or used. * be used and the role option will not be updated or used.
* *
* @since 2.1.0 * @since 2.1.0
* @access protected
* *
* @global array $wp_user_roles Used to set the 'roles' property value. * @global array $wp_user_roles Used to set the 'roles' property value.
*/ */
@ -146,7 +139,6 @@ class WP_Roles {
* *
* @since 3.5.0 * @since 3.5.0
* @deprecated 4.7.0 Use new WP_Roles() * @deprecated 4.7.0 Use new WP_Roles()
* @access public
*/ */
public function reinit() { public function reinit() {
_deprecated_function( __METHOD__, '4.7.0', 'new WP_Roles()' ); _deprecated_function( __METHOD__, '4.7.0', 'new WP_Roles()' );
@ -162,7 +154,6 @@ class WP_Roles {
* To explicitly deny a role a capability you set the value for that capability to false. * To explicitly deny a role a capability you set the value for that capability to false.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name. * @param string $role Role name.
* @param string $display_name Role display name. * @param string $display_name Role display name.
@ -189,7 +180,6 @@ class WP_Roles {
* Remove role by name. * Remove role by name.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name. * @param string $role Role name.
*/ */
@ -212,7 +202,6 @@ class WP_Roles {
* Add capability to role. * Add capability to role.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name. * @param string $role Role name.
* @param string $cap Capability name. * @param string $cap Capability name.
@ -231,7 +220,6 @@ class WP_Roles {
* Remove capability from role. * Remove capability from role.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name. * @param string $role Role name.
* @param string $cap Capability name. * @param string $cap Capability name.
@ -249,7 +237,6 @@ class WP_Roles {
* Retrieve role object by name. * Retrieve role object by name.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name. * @param string $role Role name.
* @return WP_Role|null WP_Role object if found, null if the role does not exist. * @return WP_Role|null WP_Role object if found, null if the role does not exist.
@ -265,7 +252,6 @@ class WP_Roles {
* Retrieve list of role names. * Retrieve list of role names.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @return array List of role names. * @return array List of role names.
*/ */
@ -277,7 +263,6 @@ class WP_Roles {
* Whether role name is currently in the list of available roles. * Whether role name is currently in the list of available roles.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name to look up. * @param string $role Role name to look up.
* @return bool * @return bool

19
wp-includes/class-wp-session-tokens.php
View File

@ -18,7 +18,6 @@ abstract class WP_Session_Tokens {
* User ID. * User ID.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* @var int User ID. * @var int User ID.
*/ */
protected $user_id; protected $user_id;
@ -41,7 +40,6 @@ abstract class WP_Session_Tokens {
* the session manager for a subclass of `WP_Session_Tokens`. * the session manager for a subclass of `WP_Session_Tokens`.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @static * @static
* *
* @param int $user_id User whose session to manage. * @param int $user_id User whose session to manage.
@ -64,7 +62,6 @@ abstract class WP_Session_Tokens {
* Hashes a session token for storage. * Hashes a session token for storage.
* *
* @since 4.0.0 * @since 4.0.0
* @access private
* *
* @param string $token Session token to hash. * @param string $token Session token to hash.
* @return string A hash of the session token (a verifier). * @return string A hash of the session token (a verifier).
@ -82,7 +79,6 @@ abstract class WP_Session_Tokens {
* Get a user's session. * Get a user's session.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $token Session token * @param string $token Session token
* @return array User session * @return array User session
@ -98,7 +94,6 @@ abstract class WP_Session_Tokens {
* Checks that the given token is present and hasn't expired. * Checks that the given token is present and hasn't expired.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $token Token to verify. * @param string $token Token to verify.
* @return bool Whether the token is valid for the user. * @return bool Whether the token is valid for the user.
@ -120,7 +115,6 @@ abstract class WP_Session_Tokens {
* {@see 'attach_session_information'} filter). * {@see 'attach_session_information'} filter).
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param int $expiration Session expiration timestamp. * @param int $expiration Session expiration timestamp.
* @return string Session token. * @return string Session token.
@ -164,7 +158,6 @@ abstract class WP_Session_Tokens {
* Update a session token. * Update a session token.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $token Session token to update. * @param string $token Session token to update.
* @param array $session Session information. * @param array $session Session information.
@ -178,7 +171,6 @@ abstract class WP_Session_Tokens {
* Destroy a session token. * Destroy a session token.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $token Session token to destroy. * @param string $token Session token to destroy.
*/ */
@ -192,7 +184,6 @@ abstract class WP_Session_Tokens {
* except a single token, presumably the one in use. * except a single token, presumably the one in use.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $token_to_keep Session token to keep. * @param string $token_to_keep Session token to keep.
*/ */
@ -211,7 +202,6 @@ abstract class WP_Session_Tokens {
* based on expiration. * based on expiration.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @param array $session Session to check. * @param array $session Session to check.
* @return bool Whether session is valid. * @return bool Whether session is valid.
@ -224,7 +214,6 @@ abstract class WP_Session_Tokens {
* Destroy all session tokens for a user. * Destroy all session tokens for a user.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
*/ */
final public function destroy_all() { final public function destroy_all() {
$this->destroy_all_sessions(); $this->destroy_all_sessions();
@ -234,7 +223,6 @@ abstract class WP_Session_Tokens {
* Destroy all session tokens for all users. * Destroy all session tokens for all users.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @static * @static
*/ */
final public static function destroy_all_for_all_users() { final public static function destroy_all_for_all_users() {
@ -247,7 +235,6 @@ abstract class WP_Session_Tokens {
* Retrieve all sessions of a user. * Retrieve all sessions of a user.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @return array Sessions of a user. * @return array Sessions of a user.
*/ */
@ -259,7 +246,6 @@ abstract class WP_Session_Tokens {
* This method should retrieve all sessions of a user, keyed by verifier. * This method should retrieve all sessions of a user, keyed by verifier.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @return array Sessions of a user, keyed by verifier. * @return array Sessions of a user, keyed by verifier.
*/ */
@ -269,7 +255,6 @@ abstract class WP_Session_Tokens {
* This method should look up a session by its verifier (token hash). * This method should look up a session by its verifier (token hash).
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @param string $verifier Verifier of the session to retrieve. * @param string $verifier Verifier of the session to retrieve.
* @return array|null The session, or null if it does not exist. * @return array|null The session, or null if it does not exist.
@ -282,7 +267,6 @@ abstract class WP_Session_Tokens {
* Omitting the second argument should destroy the session. * Omitting the second argument should destroy the session.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @param string $verifier Verifier of the session to update. * @param string $verifier Verifier of the session to update.
* @param array $session Optional. Session. Omitting this argument destroys the session. * @param array $session Optional. Session. Omitting this argument destroys the session.
@ -294,7 +278,6 @@ abstract class WP_Session_Tokens {
* except a single session passed. * except a single session passed.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @param string $verifier Verifier of the session to keep. * @param string $verifier Verifier of the session to keep.
*/ */
@ -304,7 +287,6 @@ abstract class WP_Session_Tokens {
* This method should destroy all sessions for a user. * This method should destroy all sessions for a user.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
*/ */
abstract protected function destroy_all_sessions(); abstract protected function destroy_all_sessions();
@ -312,7 +294,6 @@ abstract class WP_Session_Tokens {
* This static method should destroy all session tokens for all users. * This static method should destroy all session tokens for all users.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @static * @static
*/ */
public static function drop_sessions() {} public static function drop_sessions() {}

1
wp-includes/class-wp-simplepie-file.php
View File

@ -21,7 +21,6 @@ class WP_SimplePie_File extends SimplePie_File {
* *
* @since 2.8.0 * @since 2.8.0
* @since 3.2.0 Updated to use a PHP5 constructor. * @since 3.2.0 Updated to use a PHP5 constructor.
* @access public
* *
* @param string $url Remote file URL. * @param string $url Remote file URL.
* @param integer $timeout Optional. How long the connection should stay open in seconds. * @param integer $timeout Optional. How long the connection should stay open in seconds.

1
wp-includes/class-wp-simplepie-sanitize-kses.php
View File

@ -25,7 +25,6 @@ class WP_SimplePie_Sanitize_KSES extends SimplePie_Sanitize {
* Sanitizes the incoming data, to ensure that it matches the type of data expected, using KSES. * Sanitizes the incoming data, to ensure that it matches the type of data expected, using KSES.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param mixed $data The data that needs to be sanitized. * @param mixed $data The data that needs to be sanitized.
* @param integer $type The type of data that it's supposed to be. * @param integer $type The type of data that it's supposed to be.

17
wp-includes/class-wp-site-query.php
View File

@ -20,7 +20,6 @@ class WP_Site_Query {
* SQL for database query. * SQL for database query.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string * @var string
*/ */
public $request; public $request;
@ -29,7 +28,6 @@ class WP_Site_Query {
* SQL query clauses. * SQL query clauses.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* @var array * @var array
*/ */
protected $sql_clauses = array( protected $sql_clauses = array(
@ -45,7 +43,6 @@ class WP_Site_Query {
* Date query container. * Date query container.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var object WP_Date_Query * @var object WP_Date_Query
*/ */
public $date_query = false; public $date_query = false;
@ -54,7 +51,6 @@ class WP_Site_Query {
* Query vars set by the user. * Query vars set by the user.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array * @var array
*/ */
public $query_vars; public $query_vars;
@ -63,7 +59,6 @@ class WP_Site_Query {
* Default values for query vars. * Default values for query vars.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array * @var array
*/ */
public $query_var_defaults; public $query_var_defaults;
@ -72,7 +67,6 @@ class WP_Site_Query {
* List of sites located by the query. * List of sites located by the query.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array * @var array
*/ */
public $sites; public $sites;
@ -81,7 +75,6 @@ class WP_Site_Query {
* The amount of found sites for the current query. * The amount of found sites for the current query.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var int * @var int
*/ */
public $found_sites = 0; public $found_sites = 0;
@ -90,7 +83,6 @@ class WP_Site_Query {
* The number of pages. * The number of pages.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var int * @var int
*/ */
public $max_num_pages = 0; public $max_num_pages = 0;
@ -100,7 +92,6 @@ class WP_Site_Query {
* *
* @since 4.6.0 * @since 4.6.0
* @since 4.8.0 Introduced the 'lang_id', 'lang__in', and 'lang__not_in' parameters. * @since 4.8.0 Introduced the 'lang_id', 'lang__in', and 'lang__not_in' parameters.
* @access public
* *
* @param string|array $query { * @param string|array $query {
* Optional. Array or query string of site query parameters. Default empty. * Optional. Array or query string of site query parameters. Default empty.
@ -192,7 +183,6 @@ class WP_Site_Query {
* Parses arguments passed to the site query with default query parameters. * Parses arguments passed to the site query with default query parameters.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @see WP_Site_Query::__construct() * @see WP_Site_Query::__construct()
* *
@ -219,7 +209,6 @@ class WP_Site_Query {
* Sets up the WordPress query for retrieving sites. * Sets up the WordPress query for retrieving sites.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string|array $query Array or URL query string of parameters. * @param string|array $query Array or URL query string of parameters.
* @return array|int List of sites, or number of sites when 'count' is passed as a query var. * @return array|int List of sites, or number of sites when 'count' is passed as a query var.
@ -234,7 +223,6 @@ class WP_Site_Query {
* Retrieves a list of sites matching the query vars. * Retrieves a list of sites matching the query vars.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @return array|int List of sites, or number of sites when 'count' is passed as a query var. * @return array|int List of sites, or number of sites when 'count' is passed as a query var.
*/ */
@ -329,7 +317,6 @@ class WP_Site_Query {
* Used internally to get a list of site IDs matching the query vars. * Used internally to get a list of site IDs matching the query vars.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -594,7 +581,6 @@ class WP_Site_Query {
* if the limit clause was used. * if the limit clause was used.
* *
* @since 4.6.0 * @since 4.6.0
* @access private
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
*/ */
@ -620,7 +606,6 @@ class WP_Site_Query {
* Used internally to generate an SQL string for searching across multiple columns. * Used internally to generate an SQL string for searching across multiple columns.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -649,7 +634,6 @@ class WP_Site_Query {
* Parses and sanitizes 'orderby' keys passed to the site query. * Parses and sanitizes 'orderby' keys passed to the site query.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -697,7 +681,6 @@ class WP_Site_Query {
* Parses an 'order' query variable and cast it to 'ASC' or 'DESC' as necessary. * Parses an 'order' query variable and cast it to 'ASC' or 'DESC' as necessary.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @param string $order The 'order' query variable. * @param string $order The 'order' query variable.
* @return string The sanitized 'order' query variable. * @return string The sanitized 'order' query variable.

19
wp-includes/class-wp-site.php
View File

@ -30,7 +30,6 @@ final class WP_Site {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $blog_id; public $blog_id;
@ -39,7 +38,6 @@ final class WP_Site {
* Domain of the site. * Domain of the site.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $domain = ''; public $domain = '';
@ -48,7 +46,6 @@ final class WP_Site {
* Path of the site. * Path of the site.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $path = ''; public $path = '';
@ -62,7 +59,6 @@ final class WP_Site {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $site_id = '0'; public $site_id = '0';
@ -71,7 +67,6 @@ final class WP_Site {
* The date on which the site was created or registered. * The date on which the site was created or registered.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string Date in MySQL's datetime format. * @var string Date in MySQL's datetime format.
*/ */
public $registered = '0000-00-00 00:00:00'; public $registered = '0000-00-00 00:00:00';
@ -80,7 +75,6 @@ final class WP_Site {
* The date and time on which site settings were last updated. * The date and time on which site settings were last updated.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string Date in MySQL's datetime format. * @var string Date in MySQL's datetime format.
*/ */
public $last_updated = '0000-00-00 00:00:00'; public $last_updated = '0000-00-00 00:00:00';
@ -91,7 +85,6 @@ final class WP_Site {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $public = '1'; public $public = '1';
@ -102,7 +95,6 @@ final class WP_Site {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $archived = '0'; public $archived = '0';
@ -116,7 +108,6 @@ final class WP_Site {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $mature = '0'; public $mature = '0';
@ -127,7 +118,6 @@ final class WP_Site {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $spam = '0'; public $spam = '0';
@ -138,7 +128,6 @@ final class WP_Site {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $deleted = '0'; public $deleted = '0';
@ -149,7 +138,6 @@ final class WP_Site {
* A numeric string, for compatibility reasons. * A numeric string, for compatibility reasons.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $lang_id = '0'; public $lang_id = '0';
@ -159,7 +147,6 @@ final class WP_Site {
* *
* @static * @static
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -196,7 +183,6 @@ final class WP_Site {
* default properties based on that information. * default properties based on that information.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param WP_Site|object $site A site object. * @param WP_Site|object $site A site object.
*/ */
@ -210,7 +196,6 @@ final class WP_Site {
* Converts an object to array. * Converts an object to array.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @return array Object as array. * @return array Object as array.
*/ */
@ -225,7 +210,6 @@ final class WP_Site {
* Allows access to extended site properties. * Allows access to extended site properties.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string $key Property to get. * @param string $key Property to get.
* @return mixed Value of the property. Null if not available. * @return mixed Value of the property. Null if not available.
@ -261,7 +245,6 @@ final class WP_Site {
* Checks for extended site properties. * Checks for extended site properties.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string $key Property to check if set. * @param string $key Property to check if set.
* @return bool Whether the property is set. * @return bool Whether the property is set.
@ -299,7 +282,6 @@ final class WP_Site {
* Allows current multisite naming conventions while setting properties. * Allows current multisite naming conventions while setting properties.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string $key Property to set. * @param string $key Property to set.
* @param mixed $value Value to assign to the property. * @param mixed $value Value to assign to the property.
@ -323,7 +305,6 @@ final class WP_Site {
* This method is used internally to lazy-load the extended properties of a site. * This method is used internally to lazy-load the extended properties of a site.
* *
* @since 4.6.0 * @since 4.6.0
* @access private
* *
* @see WP_Site::__get() * @see WP_Site::__get()
* *

17
wp-includes/class-wp-tax-query.php
View File

@ -27,7 +27,6 @@ class WP_Tax_Query {
* See WP_Tax_Query::__construct() for information on tax query arguments. * See WP_Tax_Query::__construct() for information on tax query arguments.
* *
* @since 3.1.0 * @since 3.1.0
* @access public
* @var array * @var array
*/ */
public $queries = array(); public $queries = array();
@ -36,7 +35,6 @@ class WP_Tax_Query {
* The relation between the queries. Can be one of 'AND' or 'OR'. * The relation between the queries. Can be one of 'AND' or 'OR'.
* *
* @since 3.1.0 * @since 3.1.0
* @access public
* @var string * @var string
*/ */
public $relation; public $relation;
@ -47,7 +45,6 @@ class WP_Tax_Query {
* @since 3.2.0 * @since 3.2.0
* *
* @static * @static
* @access private
* @var string * @var string
*/ */
private static $no_results = array( 'join' => array( '' ), 'where' => array( '0 = 1' ) ); private static $no_results = array( 'join' => array( '' ), 'where' => array( '0 = 1' ) );
@ -56,7 +53,6 @@ class WP_Tax_Query {
* A flat list of table aliases used in the JOIN clauses. * A flat list of table aliases used in the JOIN clauses.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* @var array * @var array
*/ */
protected $table_aliases = array(); protected $table_aliases = array();
@ -68,7 +64,6 @@ class WP_Tax_Query {
* number of places by WP_Query. * number of places by WP_Query.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var array * @var array
*/ */
public $queried_terms = array(); public $queried_terms = array();
@ -77,7 +72,6 @@ class WP_Tax_Query {
* Database table that where the metadata's objects are stored (eg $wpdb->users). * Database table that where the metadata's objects are stored (eg $wpdb->users).
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $primary_table; public $primary_table;
@ -86,7 +80,6 @@ class WP_Tax_Query {
* Column in 'primary_table' that represents the ID of the object. * Column in 'primary_table' that represents the ID of the object.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $primary_id_column; public $primary_id_column;
@ -96,7 +89,6 @@ class WP_Tax_Query {
* *
* @since 3.1.0 * @since 3.1.0
* @since 4.1.0 Added support for `$operator` 'NOT EXISTS' and 'EXISTS' values. * @since 4.1.0 Added support for `$operator` 'NOT EXISTS' and 'EXISTS' values.
* @access public
* *
* @param array $tax_query { * @param array $tax_query {
* Array of taxonomy query clauses. * Array of taxonomy query clauses.
@ -135,7 +127,6 @@ class WP_Tax_Query {
* each first-order clause contains all the necessary keys from `$defaults`. * each first-order clause contains all the necessary keys from `$defaults`.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @param array $queries Array of queries clauses. * @param array $queries Array of queries clauses.
* @return array Sanitized array of query clauses. * @return array Sanitized array of query clauses.
@ -207,7 +198,6 @@ class WP_Tax_Query {
* Sanitize a 'relation' operator. * Sanitize a 'relation' operator.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @param string $relation Raw relation key from the query argument. * @param string $relation Raw relation key from the query argument.
* @return string Sanitized relation ('AND' or 'OR'). * @return string Sanitized relation ('AND' or 'OR').
@ -232,7 +222,6 @@ class WP_Tax_Query {
* @since 4.1.0 * @since 4.1.0
* *
* @static * @static
* @access protected
* *
* @param array $query Tax query arguments. * @param array $query Tax query arguments.
* @return bool Whether the query clause is a first-order clause. * @return bool Whether the query clause is a first-order clause.
@ -247,7 +236,6 @@ class WP_Tax_Query {
* @since 3.1.0 * @since 3.1.0
* *
* @static * @static
* @access public
* *
* @param string $primary_table Database table where the object being filtered is stored (eg wp_users). * @param string $primary_table Database table where the object being filtered is stored (eg wp_users).
* @param string $primary_id_column ID column for the filtered object in $primary_table. * @param string $primary_id_column ID column for the filtered object in $primary_table.
@ -272,7 +260,6 @@ class WP_Tax_Query {
* is abstracted out to maintain parity with the other Query classes. * is abstracted out to maintain parity with the other Query classes.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @return array { * @return array {
* Array containing JOIN and WHERE SQL clauses to append to the main query. * Array containing JOIN and WHERE SQL clauses to append to the main query.
@ -303,7 +290,6 @@ class WP_Tax_Query {
* produce the properly nested SQL. * produce the properly nested SQL.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @param array $query Query to parse, passed by reference. * @param array $query Query to parse, passed by reference.
* @param int $depth Optional. Number of tree levels deep we currently are. * @param int $depth Optional. Number of tree levels deep we currently are.
@ -385,7 +371,6 @@ class WP_Tax_Query {
* Generate SQL JOIN and WHERE clauses for a "first-order" query clause. * Generate SQL JOIN and WHERE clauses for a "first-order" query clause.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @global wpdb $wpdb The WordPress database abstraction object. * @global wpdb $wpdb The WordPress database abstraction object.
* *
@ -511,7 +496,6 @@ class WP_Tax_Query {
* clauses that are connected by the relation 'OR'. * clauses that are connected by the relation 'OR'.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @param array $clause Query clause. * @param array $clause Query clause.
* @param array $parent_query Parent query of $clause. * @param array $parent_query Parent query of $clause.
@ -555,7 +539,6 @@ class WP_Tax_Query {
* Validates a single query. * Validates a single query.
* *
* @since 3.2.0 * @since 3.2.0
* @access private
* *
* @param array $query The single query. Passed by reference. * @param array $query The single query. Passed by reference.
*/ */

29
wp-includes/class-wp-taxonomy.php
View File

@ -17,7 +17,6 @@ final class WP_Taxonomy {
* Taxonomy key. * Taxonomy key.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string * @var string
*/ */
public $name; public $name;
@ -26,7 +25,6 @@ final class WP_Taxonomy {
* Name of the taxonomy shown in the menu. Usually plural. * Name of the taxonomy shown in the menu. Usually plural.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string * @var string
*/ */
public $label; public $label;
@ -35,7 +33,6 @@ final class WP_Taxonomy {
* An array of labels for this taxonomy. * An array of labels for this taxonomy.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var object * @var object
*/ */
public $labels = array(); public $labels = array();
@ -44,7 +41,6 @@ final class WP_Taxonomy {
* A short descriptive summary of what the taxonomy is for. * A short descriptive summary of what the taxonomy is for.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string * @var string
*/ */
public $description = ''; public $description = '';
@ -53,7 +49,6 @@ final class WP_Taxonomy {
* Whether a taxonomy is intended for use publicly either via the admin interface or by front-end users. * Whether a taxonomy is intended for use publicly either via the admin interface or by front-end users.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $public = true; public $public = true;
@ -62,7 +57,6 @@ final class WP_Taxonomy {
* Whether the taxonomy is publicly queryable. * Whether the taxonomy is publicly queryable.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $publicly_queryable = true; public $publicly_queryable = true;
@ -71,7 +65,6 @@ final class WP_Taxonomy {
* Whether the taxonomy is hierarchical. * Whether the taxonomy is hierarchical.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $hierarchical = false; public $hierarchical = false;
@ -80,7 +73,6 @@ final class WP_Taxonomy {
* Whether to generate and allow a UI for managing terms in this taxonomy in the admin. * Whether to generate and allow a UI for managing terms in this taxonomy in the admin.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $show_ui = true; public $show_ui = true;
@ -91,7 +83,6 @@ final class WP_Taxonomy {
* If true, the taxonomy is shown as a submenu of the object type menu. If false, no menu is shown. * If true, the taxonomy is shown as a submenu of the object type menu. If false, no menu is shown.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $show_in_menu = true; public $show_in_menu = true;
@ -100,7 +91,6 @@ final class WP_Taxonomy {
* Whether the taxonomy is available for selection in navigation menus. * Whether the taxonomy is available for selection in navigation menus.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $show_in_nav_menus = true; public $show_in_nav_menus = true;
@ -109,7 +99,6 @@ final class WP_Taxonomy {
* Whether to list the taxonomy in the tag cloud widget controls. * Whether to list the taxonomy in the tag cloud widget controls.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $show_tagcloud = true; public $show_tagcloud = true;
@ -118,7 +107,6 @@ final class WP_Taxonomy {
* Whether to show the taxonomy in the quick/bulk edit panel. * Whether to show the taxonomy in the quick/bulk edit panel.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $show_in_quick_edit = true; public $show_in_quick_edit = true;
@ -127,7 +115,6 @@ final class WP_Taxonomy {
* Whether to display a column for the taxonomy on its post type listing screens. * Whether to display a column for the taxonomy on its post type listing screens.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $show_admin_column = false; public $show_admin_column = false;
@ -136,7 +123,6 @@ final class WP_Taxonomy {
* The callback function for the meta box display. * The callback function for the meta box display.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool|callable * @var bool|callable
*/ */
public $meta_box_cb = null; public $meta_box_cb = null;
@ -145,7 +131,6 @@ final class WP_Taxonomy {
* An array of object types this taxonomy is registered for. * An array of object types this taxonomy is registered for.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var array * @var array
*/ */
public $object_type = null; public $object_type = null;
@ -154,7 +139,6 @@ final class WP_Taxonomy {
* Capabilities for this taxonomy. * Capabilities for this taxonomy.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var array * @var array
*/ */
public $cap; public $cap;
@ -163,7 +147,6 @@ final class WP_Taxonomy {
* Rewrites information for this taxonomy. * Rewrites information for this taxonomy.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var array|false * @var array|false
*/ */
public $rewrite; public $rewrite;
@ -172,7 +155,6 @@ final class WP_Taxonomy {
* Query var string for this taxonomy. * Query var string for this taxonomy.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string|false * @var string|false
*/ */
public $query_var; public $query_var;
@ -181,7 +163,6 @@ final class WP_Taxonomy {
* Function that will be called when the count is updated. * Function that will be called when the count is updated.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var callable * @var callable
*/ */
public $update_count_callback; public $update_count_callback;
@ -193,7 +174,6 @@ final class WP_Taxonomy {
* respect to $rest_base and $rest_controller_class. * respect to $rest_base and $rest_controller_class.
* *
* @since 4.7.4 * @since 4.7.4
* @access public
* @var bool $show_in_rest * @var bool $show_in_rest
*/ */
public $show_in_rest; public $show_in_rest;
@ -202,7 +182,6 @@ final class WP_Taxonomy {
* The base path for this taxonomy's REST API endpoints. * The base path for this taxonomy's REST API endpoints.
* *
* @since 4.7.4 * @since 4.7.4
* @access public
* @var string|bool $rest_base * @var string|bool $rest_base
*/ */
public $rest_base; public $rest_base;
@ -213,7 +192,6 @@ final class WP_Taxonomy {
* Custom controllers must extend WP_REST_Controller. * Custom controllers must extend WP_REST_Controller.
* *
* @since 4.7.4 * @since 4.7.4
* @access public
* @var string|bool $rest_controller_class * @var string|bool $rest_controller_class
*/ */
public $rest_controller_class; public $rest_controller_class;
@ -222,7 +200,6 @@ final class WP_Taxonomy {
* Whether it is a built-in taxonomy. * Whether it is a built-in taxonomy.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var bool * @var bool
*/ */
public $_builtin; public $_builtin;
@ -231,7 +208,6 @@ final class WP_Taxonomy {
* Constructor. * Constructor.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @global WP $wp WP instance. * @global WP $wp WP instance.
* *
@ -250,7 +226,6 @@ final class WP_Taxonomy {
* Sets taxonomy properties. * Sets taxonomy properties.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param array|string $object_type Name of the object type for the taxonomy object. * @param array|string $object_type Name of the object type for the taxonomy object.
* @param array|string $args Array or query string of arguments for registering a taxonomy. * @param array|string $args Array or query string of arguments for registering a taxonomy.
@ -382,7 +357,6 @@ final class WP_Taxonomy {
* Adds the necessary rewrite rules for the taxonomy. * Adds the necessary rewrite rules for the taxonomy.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @global WP $wp Current WordPress environment instance. * @global WP $wp Current WordPress environment instance.
*/ */
@ -411,7 +385,6 @@ final class WP_Taxonomy {
* Removes any rewrite rules, permastructs, and rules for the taxonomy. * Removes any rewrite rules, permastructs, and rules for the taxonomy.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @global WP $wp Current WordPress environment instance. * @global WP $wp Current WordPress environment instance.
*/ */
@ -435,7 +408,6 @@ final class WP_Taxonomy {
* Registers the ajax callback for the meta box. * Registers the ajax callback for the meta box.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
*/ */
public function add_hooks() { public function add_hooks() {
add_filter( 'wp_ajax_add-' . $this->name, '_wp_ajax_add_hierarchical_term' ); add_filter( 'wp_ajax_add-' . $this->name, '_wp_ajax_add_hierarchical_term' );
@ -445,7 +417,6 @@ final class WP_Taxonomy {
* Removes the ajax callback for the meta box. * Removes the ajax callback for the meta box.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
*/ */
public function remove_hooks() { public function remove_hooks() {
remove_filter( 'wp_ajax_add-' . $this->name, '_wp_ajax_add_hierarchical_term' ); remove_filter( 'wp_ajax_add-' . $this->name, '_wp_ajax_add_hierarchical_term' );

15
wp-includes/class-wp-term-query.php
View File

@ -21,7 +21,6 @@ class WP_Term_Query {
* SQL string used to perform database query. * SQL string used to perform database query.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var string * @var string
*/ */
public $request; public $request;
@ -30,7 +29,6 @@ class WP_Term_Query {
* Metadata query container. * Metadata query container.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var object WP_Meta_Query * @var object WP_Meta_Query
*/ */
public $meta_query = false; public $meta_query = false;
@ -39,7 +37,6 @@ class WP_Term_Query {
* Metadata query clauses. * Metadata query clauses.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* @var array * @var array
*/ */
protected $meta_query_clauses; protected $meta_query_clauses;
@ -48,7 +45,6 @@ class WP_Term_Query {
* SQL query clauses. * SQL query clauses.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* @var array * @var array
*/ */
protected $sql_clauses = array( protected $sql_clauses = array(
@ -63,7 +59,6 @@ class WP_Term_Query {
* Query vars set by the user. * Query vars set by the user.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array * @var array
*/ */
public $query_vars; public $query_vars;
@ -72,7 +67,6 @@ class WP_Term_Query {
* Default values for query vars. * Default values for query vars.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array * @var array
*/ */
public $query_var_defaults; public $query_var_defaults;
@ -81,7 +75,6 @@ class WP_Term_Query {
* List of terms located by the query. * List of terms located by the query.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @var array * @var array
*/ */
public $terms; public $terms;
@ -94,7 +87,6 @@ class WP_Term_Query {
* @since 4.6.0 * @since 4.6.0
* @since 4.6.0 Introduced 'term_taxonomy_id' parameter. * @since 4.6.0 Introduced 'term_taxonomy_id' parameter.
* @since 4.7.0 Introduced 'object_ids' parameter. * @since 4.7.0 Introduced 'object_ids' parameter.
* @access public
* *
* @param string|array $query { * @param string|array $query {
* Optional. Array or query string of term query parameters. Default empty. * Optional. Array or query string of term query parameters. Default empty.
@ -225,7 +217,6 @@ class WP_Term_Query {
* Parse arguments passed to the term query with default query parameters. * Parse arguments passed to the term query with default query parameters.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string|array $query WP_Term_Query arguments. See WP_Term_Query::__construct() * @param string|array $query WP_Term_Query arguments. See WP_Term_Query::__construct()
*/ */
@ -284,7 +275,6 @@ class WP_Term_Query {
* Sets up the query for retrieving terms. * Sets up the query for retrieving terms.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @param string|array $query Array or URL query string of parameters. * @param string|array $query Array or URL query string of parameters.
* @return array|int List of terms, or number of terms when 'count' is passed as a query var. * @return array|int List of terms, or number of terms when 'count' is passed as a query var.
@ -298,7 +288,6 @@ class WP_Term_Query {
* Get terms, based on query_vars. * Get terms, based on query_vars.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -822,7 +811,6 @@ class WP_Term_Query {
* Parse and sanitize 'orderby' keys passed to the term query. * Parse and sanitize 'orderby' keys passed to the term query.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -879,7 +867,6 @@ class WP_Term_Query {
* Generate the ORDER BY clause for an 'orderby' param that is potentially related to a meta query. * Generate the ORDER BY clause for an 'orderby' param that is potentially related to a meta query.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @param string $orderby_raw Raw 'orderby' value passed to WP_Term_Query. * @param string $orderby_raw Raw 'orderby' value passed to WP_Term_Query.
* @return string ORDER BY clause. * @return string ORDER BY clause.
@ -939,7 +926,6 @@ class WP_Term_Query {
* Parse an 'order' query variable and cast it to ASC or DESC as necessary. * Parse an 'order' query variable and cast it to ASC or DESC as necessary.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @param string $order The 'order' query variable. * @param string $order The 'order' query variable.
* @return string The sanitized 'order' query variable. * @return string The sanitized 'order' query variable.
@ -960,7 +946,6 @@ class WP_Term_Query {
* Used internally to generate a SQL string related to the 'search' parameter. * Used internally to generate a SQL string related to the 'search' parameter.
* *
* @since 4.6.0 * @since 4.6.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *

15
wp-includes/class-wp-term.php
View File

@ -20,7 +20,6 @@ final class WP_Term {
* Term ID. * Term ID.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $term_id; public $term_id;
@ -29,7 +28,6 @@ final class WP_Term {
* The term's name. * The term's name.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $name = ''; public $name = '';
@ -38,7 +36,6 @@ final class WP_Term {
* The term's slug. * The term's slug.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $slug = ''; public $slug = '';
@ -47,7 +44,6 @@ final class WP_Term {
* The term's term_group. * The term's term_group.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $term_group = ''; public $term_group = '';
@ -56,7 +52,6 @@ final class WP_Term {
* Term Taxonomy ID. * Term Taxonomy ID.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $term_taxonomy_id = 0; public $term_taxonomy_id = 0;
@ -65,7 +60,6 @@ final class WP_Term {
* The term's taxonomy name. * The term's taxonomy name.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $taxonomy = ''; public $taxonomy = '';
@ -74,7 +68,6 @@ final class WP_Term {
* The term's description. * The term's description.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $description = ''; public $description = '';
@ -83,7 +76,6 @@ final class WP_Term {
* ID of a term's parent term. * ID of a term's parent term.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $parent = 0; public $parent = 0;
@ -92,7 +84,6 @@ final class WP_Term {
* Cached object count for this term. * Cached object count for this term.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var int * @var int
*/ */
public $count = 0; public $count = 0;
@ -103,7 +94,6 @@ final class WP_Term {
* Does not correspond to a database field. * Does not correspond to a database field.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $filter = 'raw'; public $filter = 'raw';
@ -112,7 +102,6 @@ final class WP_Term {
* Retrieve WP_Term instance. * Retrieve WP_Term instance.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @static * @static
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
@ -202,7 +191,6 @@ final class WP_Term {
* Constructor. * Constructor.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param WP_Term|object $term Term object. * @param WP_Term|object $term Term object.
*/ */
@ -216,7 +204,6 @@ final class WP_Term {
* Sanitizes term fields, according to the filter type provided. * Sanitizes term fields, according to the filter type provided.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $filter Filter context. Accepts 'edit', 'db', 'display', 'attribute', 'js', 'raw'. * @param string $filter Filter context. Accepts 'edit', 'db', 'display', 'attribute', 'js', 'raw'.
*/ */
@ -228,7 +215,6 @@ final class WP_Term {
* Converts an object to array. * Converts an object to array.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Object as array. * @return array Object as array.
*/ */
@ -240,7 +226,6 @@ final class WP_Term {
* Getter. * Getter.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key Property to get. * @param string $key Property to get.
* @return mixed Property value. * @return mixed Property value.

14
wp-includes/class-wp-text-diff-renderer-table.php
View File

@ -18,7 +18,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
/** /**
* @see Text_Diff_Renderer::_leading_context_lines * @see Text_Diff_Renderer::_leading_context_lines
* @var int * @var int
* @access public
* @since 2.6.0 * @since 2.6.0
*/ */
public $_leading_context_lines = 10000; public $_leading_context_lines = 10000;
@ -26,7 +25,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
/** /**
* @see Text_Diff_Renderer::_trailing_context_lines * @see Text_Diff_Renderer::_trailing_context_lines
* @var int * @var int
* @access public
* @since 2.6.0 * @since 2.6.0
*/ */
public $_trailing_context_lines = 10000; public $_trailing_context_lines = 10000;
@ -35,7 +33,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
* Threshold for when a diff should be saved or omitted. * Threshold for when a diff should be saved or omitted.
* *
* @var float * @var float
* @access protected
* @since 2.6.0 * @since 2.6.0
*/ */
protected $_diff_threshold = 0.6; protected $_diff_threshold = 0.6;
@ -44,7 +41,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
* Inline display helper object name. * Inline display helper object name.
* *
* @var string * @var string
* @access protected
* @since 2.6.0 * @since 2.6.0
*/ */
protected $inline_diff_renderer = 'WP_Text_Diff_Renderer_inline'; protected $inline_diff_renderer = 'WP_Text_Diff_Renderer_inline';
@ -53,7 +49,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
* Should we show the split view or not * Should we show the split view or not
* *
* @var string * @var string
* @access protected
* @since 3.6.0 * @since 3.6.0
*/ */
protected $_show_split_view = true; protected $_show_split_view = true;
@ -136,7 +131,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
/** /**
* @ignore * @ignore
* @access public
* *
* @param array $lines * @param array $lines
* @param bool $encode * @param bool $encode
@ -175,7 +169,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
/** /**
* @ignore * @ignore
* @access public
* *
* @param array $lines * @param array $lines
* @param bool $encode * @param bool $encode
@ -202,7 +195,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
/** /**
* @ignore * @ignore
* @access public
* *
* @param array $lines * @param array $lines
* @param bool $encode * @param bool $encode
@ -232,7 +224,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
* (TRAC style) sometimes these lines can actually be deleted or added rows. * (TRAC style) sometimes these lines can actually be deleted or added rows.
* We do additional processing to figure that out * We do additional processing to figure that out
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* *
* @param array $orig * @param array $orig
@ -320,7 +311,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
* Takes changed blocks and matches which rows in orig turned into which rows in final. * Takes changed blocks and matches which rows in orig turned into which rows in final.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
* *
* @param array $orig Lines of the original version of the text. * @param array $orig Lines of the original version of the text.
* @param array $final Lines of the final version of the text. * @param array $final Lines of the final version of the text.
@ -466,7 +456,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
* Make private properties readable for backward compatibility. * Make private properties readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to get. * @param string $name Property to get.
* @return mixed Property. * @return mixed Property.
@ -481,7 +470,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
* Make private properties settable for backward compatibility. * Make private properties settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to check if set. * @param string $name Property to check if set.
* @param mixed $value Property value. * @param mixed $value Property value.
@ -497,7 +485,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
* Make private properties checkable for backward compatibility. * Make private properties checkable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to check if set. * @param string $name Property to check if set.
* @return bool Whether the property is set. * @return bool Whether the property is set.
@ -512,7 +499,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer {
* Make private properties un-settable for backward compatibility. * Make private properties un-settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to unset. * @param string $name Property to unset.
*/ */

51
wp-includes/class-wp-theme.php
View File

@ -12,7 +12,6 @@ final class WP_Theme implements ArrayAccess {
* Whether the theme has been marked as updateable. * Whether the theme has been marked as updateable.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var bool * @var bool
* *
* @see WP_MS_Themes_List_Table * @see WP_MS_Themes_List_Table
@ -23,7 +22,6 @@ final class WP_Theme implements ArrayAccess {
* Headers for style.css files. * Headers for style.css files.
* *
* @static * @static
* @access private
* @var array * @var array
*/ */
private static $file_headers = array( private static $file_headers = array(
@ -44,7 +42,6 @@ final class WP_Theme implements ArrayAccess {
* Default themes. * Default themes.
* *
* @static * @static
* @access private
* @var array * @var array
*/ */
private static $default_themes = array( private static $default_themes = array(
@ -64,7 +61,6 @@ final class WP_Theme implements ArrayAccess {
* Renamed theme tags. * Renamed theme tags.
* *
* @static * @static
* @access private
* @var array * @var array
*/ */
private static $tag_map = array( private static $tag_map = array(
@ -75,7 +71,6 @@ final class WP_Theme implements ArrayAccess {
/** /**
* Absolute path to the theme root, usually wp-content/themes * Absolute path to the theme root, usually wp-content/themes
* *
* @access private
* @var string * @var string
*/ */
private $theme_root; private $theme_root;
@ -83,7 +78,6 @@ final class WP_Theme implements ArrayAccess {
/** /**
* Header data from the theme's style.css file. * Header data from the theme's style.css file.
* *
* @access private
* @var array * @var array
*/ */
private $headers = array(); private $headers = array();
@ -91,7 +85,6 @@ final class WP_Theme implements ArrayAccess {
/** /**
* Header data from the theme's style.css file after being sanitized. * Header data from the theme's style.css file after being sanitized.
* *
* @access private
* @var array * @var array
*/ */
private $headers_sanitized; private $headers_sanitized;
@ -101,7 +94,6 @@ final class WP_Theme implements ArrayAccess {
* *
* Cached due to sorting functions running over the translated name. * Cached due to sorting functions running over the translated name.
* *
* @access private
* @var string * @var string
*/ */
private $name_translated; private $name_translated;
@ -109,7 +101,6 @@ final class WP_Theme implements ArrayAccess {
/** /**
* Errors encountered when initializing the theme. * Errors encountered when initializing the theme.
* *
* @access private
* @var WP_Error * @var WP_Error
*/ */
private $errors; private $errors;
@ -120,7 +111,6 @@ final class WP_Theme implements ArrayAccess {
* In the case of a child theme, this is directory name of the child theme. * In the case of a child theme, this is directory name of the child theme.
* Otherwise, 'stylesheet' is the same as 'template'. * Otherwise, 'stylesheet' is the same as 'template'.
* *
* @access private
* @var string * @var string
*/ */
private $stylesheet; private $stylesheet;
@ -131,7 +121,6 @@ final class WP_Theme implements ArrayAccess {
* In the case of a child theme, this is the directory name of the parent theme. * In the case of a child theme, this is the directory name of the parent theme.
* Otherwise, 'template' is the same as 'stylesheet'. * Otherwise, 'template' is the same as 'stylesheet'.
* *
* @access private
* @var string * @var string
*/ */
private $template; private $template;
@ -139,7 +128,6 @@ final class WP_Theme implements ArrayAccess {
/** /**
* A reference to the parent theme, in the case of a child theme. * A reference to the parent theme, in the case of a child theme.
* *
* @access private
* @var WP_Theme * @var WP_Theme
*/ */
private $parent; private $parent;
@ -147,7 +135,6 @@ final class WP_Theme implements ArrayAccess {
/** /**
* URL to the theme root, usually an absolute URL to wp-content/themes * URL to the theme root, usually an absolute URL to wp-content/themes
* *
* @access private
* @var string * @var string
*/ */
private $theme_root_uri; private $theme_root_uri;
@ -155,7 +142,6 @@ final class WP_Theme implements ArrayAccess {
/** /**
* Flag for whether the theme's textdomain is loaded. * Flag for whether the theme's textdomain is loaded.
* *
* @access private
* @var bool * @var bool
*/ */
private $textdomain_loaded; private $textdomain_loaded;
@ -163,7 +149,6 @@ final class WP_Theme implements ArrayAccess {
/** /**
* Stores an md5 hash of the theme root, to function as the cache key. * Stores an md5 hash of the theme root, to function as the cache key.
* *
* @access private
* @var string * @var string
*/ */
private $cache_hash; private $cache_hash;
@ -174,7 +159,6 @@ final class WP_Theme implements ArrayAccess {
* Default is false. Can be set with the {@see 'wp_cache_themes_persistently'} filter. * Default is false. Can be set with the {@see 'wp_cache_themes_persistently'} filter.
* *
* @static * @static
* @access private
* @var bool * @var bool
*/ */
private static $persistently_cache; private static $persistently_cache;
@ -185,7 +169,6 @@ final class WP_Theme implements ArrayAccess {
* By default the bucket is not cached, so this value is useless. * By default the bucket is not cached, so this value is useless.
* *
* @static * @static
* @access private
* @var bool * @var bool
*/ */
private static $cache_expiration = 1800; private static $cache_expiration = 1800;
@ -511,7 +494,6 @@ final class WP_Theme implements ArrayAccess {
* Returns errors property. * Returns errors property.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return WP_Error|false WP_Error if there are errors, or false. * @return WP_Error|false WP_Error if there are errors, or false.
*/ */
@ -526,7 +508,6 @@ final class WP_Theme implements ArrayAccess {
* meaning that the theme's directory was not found, does not exist. * meaning that the theme's directory was not found, does not exist.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return bool Whether the theme exists. * @return bool Whether the theme exists.
*/ */
@ -538,7 +519,6 @@ final class WP_Theme implements ArrayAccess {
* Returns reference to the parent theme. * Returns reference to the parent theme.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return WP_Theme|false Parent theme, or false if the current theme is not a child theme. * @return WP_Theme|false Parent theme, or false if the current theme is not a child theme.
*/ */
@ -552,7 +532,6 @@ final class WP_Theme implements ArrayAccess {
* Cache entries keyed by the theme and the type of data. * Cache entries keyed by the theme and the type of data.
* *
* @since 3.4.0 * @since 3.4.0
* @access private
* *
* @param string $key Type of data to store (theme, screenshot, headers, post_templates) * @param string $key Type of data to store (theme, screenshot, headers, post_templates)
* @param string $data Data to store * @param string $data Data to store
@ -568,7 +547,6 @@ final class WP_Theme implements ArrayAccess {
* Cache entries are keyed by the theme and the type of data. * Cache entries are keyed by the theme and the type of data.
* *
* @since 3.4.0 * @since 3.4.0
* @access private
* *
* @param string $key Type of data to retrieve (theme, screenshot, headers, post_templates) * @param string $key Type of data to retrieve (theme, screenshot, headers, post_templates)
* @return mixed Retrieved data * @return mixed Retrieved data
@ -581,7 +559,6 @@ final class WP_Theme implements ArrayAccess {
* Clears the cache for the theme. * Clears the cache for the theme.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
*/ */
public function cache_delete() { public function cache_delete() {
foreach ( array( 'theme', 'screenshot', 'headers', 'post_templates' ) as $key ) foreach ( array( 'theme', 'screenshot', 'headers', 'post_templates' ) as $key )
@ -603,7 +580,6 @@ final class WP_Theme implements ArrayAccess {
* whether it is actually valid. * whether it is actually valid.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @param string $header Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags. * @param string $header Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags.
* @return string|false String on success, false on failure. * @return string|false String on success, false on failure.
@ -637,7 +613,6 @@ final class WP_Theme implements ArrayAccess {
* Gets a theme header, formatted and translated for display. * Gets a theme header, formatted and translated for display.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @param string $header Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags. * @param string $header Theme header. Name, Description, Author, Version, ThemeURI, AuthorURI, Status, Tags.
* @param bool $markup Optional. Whether to mark up the header. Defaults to true. * @param bool $markup Optional. Whether to mark up the header. Defaults to true.
@ -666,7 +641,6 @@ final class WP_Theme implements ArrayAccess {
* Sanitize a theme header. * Sanitize a theme header.
* *
* @since 3.4.0 * @since 3.4.0
* @access private
* *
* @staticvar array $header_tags * @staticvar array $header_tags
* @staticvar array $header_tags_with_a * @staticvar array $header_tags_with_a
@ -725,7 +699,6 @@ final class WP_Theme implements ArrayAccess {
* Mark up a theme header. * Mark up a theme header.
* *
* @since 3.4.0 * @since 3.4.0
* @access private
* *
* @staticvar string $comma * @staticvar string $comma
* *
@ -772,7 +745,6 @@ final class WP_Theme implements ArrayAccess {
* Translate a theme header. * Translate a theme header.
* *
* @since 3.4.0 * @since 3.4.0
* @access private
* *
* @staticvar array $tags_list * @staticvar array $tags_list
* *
@ -836,7 +808,6 @@ final class WP_Theme implements ArrayAccess {
* Otherwise, get_stylesheet() is the same as get_template(). * Otherwise, get_stylesheet() is the same as get_template().
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return string Stylesheet * @return string Stylesheet
*/ */
@ -851,7 +822,6 @@ final class WP_Theme implements ArrayAccess {
* Otherwise, the get_template() is the same as get_stylesheet(). * Otherwise, the get_template() is the same as get_stylesheet().
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return string Template * @return string Template
*/ */
@ -866,7 +836,6 @@ final class WP_Theme implements ArrayAccess {
* of the child theme's files. * of the child theme's files.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return string Absolute path of the stylesheet directory. * @return string Absolute path of the stylesheet directory.
*/ */
@ -884,7 +853,6 @@ final class WP_Theme implements ArrayAccess {
* of the parent theme's files. * of the parent theme's files.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return string Absolute path of the template directory. * @return string Absolute path of the template directory.
*/ */
@ -904,7 +872,6 @@ final class WP_Theme implements ArrayAccess {
* child theme's files. * child theme's files.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return string URL to the stylesheet directory. * @return string URL to the stylesheet directory.
*/ */
@ -919,7 +886,6 @@ final class WP_Theme implements ArrayAccess {
* parent theme's files. * parent theme's files.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return string URL to the template directory. * @return string URL to the template directory.
*/ */
@ -938,7 +904,6 @@ final class WP_Theme implements ArrayAccess {
* This is typically the absolute path to wp-content/themes. * This is typically the absolute path to wp-content/themes.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return string Theme root. * @return string Theme root.
*/ */
@ -954,7 +919,6 @@ final class WP_Theme implements ArrayAccess {
* get_theme_root_uri() and allow it to run the {@see 'theme_root_uri'} filter. * get_theme_root_uri() and allow it to run the {@see 'theme_root_uri'} filter.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return string Theme root URI. * @return string Theme root URI.
*/ */
@ -973,7 +937,6 @@ final class WP_Theme implements ArrayAccess {
* themes, parent theme screenshots are not inherited.) * themes, parent theme screenshots are not inherited.)
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @param string $uri Type of URL to return, either 'relative' or an absolute URI. Defaults to absolute URI. * @param string $uri Type of URL to return, either 'relative' or an absolute URI. Defaults to absolute URI.
* @return string|false Screenshot file. False if the theme does not have a screenshot. * @return string|false Screenshot file. False if the theme does not have a screenshot.
@ -1005,7 +968,6 @@ final class WP_Theme implements ArrayAccess {
* Return files in the theme's directory. * Return files in the theme's directory.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @param mixed $type Optional. Array of extensions to return. Defaults to all files (null). * @param mixed $type Optional. Array of extensions to return. Defaults to all files (null).
* @param int $depth Optional. How deep to search for files. Defaults to a flat scan (0 depth). -1 depth is infinite. * @param int $depth Optional. How deep to search for files. Defaults to a flat scan (0 depth). -1 depth is infinite.
@ -1026,7 +988,6 @@ final class WP_Theme implements ArrayAccess {
* Returns the theme's post templates. * Returns the theme's post templates.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @return array Array of page templates, keyed by filename and post type, * @return array Array of page templates, keyed by filename and post type,
* with the value of the translated header name. * with the value of the translated header name.
@ -1083,7 +1044,6 @@ final class WP_Theme implements ArrayAccess {
* *
* @since 3.4.0 * @since 3.4.0
* @since 4.7.0 Added the `$post_type` parameter. * @since 4.7.0 Added the `$post_type` parameter.
* @access public
* *
* @param WP_Post|null $post Optional. The post being edited, provided for context. * @param WP_Post|null $post Optional. The post being edited, provided for context.
* @param string $post_type Optional. Post type to get the templates for. Default 'page'. * @param string $post_type Optional. Post type to get the templates for. Default 'page'.
@ -1126,7 +1086,6 @@ final class WP_Theme implements ArrayAccess {
* @since 3.4.0 * @since 3.4.0
* *
* @static * @static
* @access private
* *
* @param string $path Absolute path to search. * @param string $path Absolute path to search.
* @param array|string|null $extensions Optional. Array of extensions to find, string of a single extension, * @param array|string|null $extensions Optional. Array of extensions to find, string of a single extension,
@ -1188,7 +1147,6 @@ final class WP_Theme implements ArrayAccess {
* child theme, it should probably try to load the parent theme's translations. * child theme, it should probably try to load the parent theme's translations.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return bool True if the textdomain was successfully loaded or has already been loaded. * @return bool True if the textdomain was successfully loaded or has already been loaded.
* False if no textdomain was specified in the file headers, or if the domain could not be loaded. * False if no textdomain was specified in the file headers, or if the domain could not be loaded.
@ -1222,7 +1180,6 @@ final class WP_Theme implements ArrayAccess {
* Whether the theme is allowed (multisite only). * Whether the theme is allowed (multisite only).
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @param string $check Optional. Whether to check only the 'network'-wide settings, the 'site' * @param string $check Optional. Whether to check only the 'network'-wide settings, the 'site'
* settings, or 'both'. Defaults to 'both'. * settings, or 'both'. Defaults to 'both'.
@ -1273,7 +1230,6 @@ final class WP_Theme implements ArrayAccess {
* @since 3.4.0 * @since 3.4.0
* *
* @static * @static
* @access public
* *
* @param int $blog_id Optional. ID of the site. Defaults to the current site. * @param int $blog_id Optional. ID of the site. Defaults to the current site.
* @return array Array of stylesheet names. * @return array Array of stylesheet names.
@ -1300,7 +1256,6 @@ final class WP_Theme implements ArrayAccess {
* @since 3.4.0 * @since 3.4.0
* *
* @static * @static
* @access public
* *
* @staticvar array $allowed_themes * @staticvar array $allowed_themes
* *
@ -1330,7 +1285,6 @@ final class WP_Theme implements ArrayAccess {
* @since 3.4.0 * @since 3.4.0
* *
* @static * @static
* @access public
* *
* @staticvar array $allowed_themes * @staticvar array $allowed_themes
* *
@ -1409,7 +1363,6 @@ final class WP_Theme implements ArrayAccess {
* Enables a theme for all sites on the current network. * Enables a theme for all sites on the current network.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @static * @static
* *
* @param string|array $stylesheets Stylesheet name or array of stylesheet names. * @param string|array $stylesheets Stylesheet name or array of stylesheet names.
@ -1435,7 +1388,6 @@ final class WP_Theme implements ArrayAccess {
* Disables a theme for all sites on the current network. * Disables a theme for all sites on the current network.
* *
* @since 4.6.0 * @since 4.6.0
* @access public
* @static * @static
* *
* @param string|array $stylesheets Stylesheet name or array of stylesheet names. * @param string|array $stylesheets Stylesheet name or array of stylesheet names.
@ -1465,7 +1417,6 @@ final class WP_Theme implements ArrayAccess {
* @since 3.4.0 * @since 3.4.0
* *
* @static * @static
* @access public
* *
* @param array $themes Array of themes to sort, passed by reference. * @param array $themes Array of themes to sort, passed by reference.
*/ */
@ -1486,7 +1437,6 @@ final class WP_Theme implements ArrayAccess {
* @since 3.4.0 * @since 3.4.0
* *
* @static * @static
* @access private
* *
* @param string $a First name. * @param string $a First name.
* @param string $b Second name. * @param string $b Second name.
@ -1503,7 +1453,6 @@ final class WP_Theme implements ArrayAccess {
* @since 3.4.0 * @since 3.4.0
* *
* @static * @static
* @access private
* *
* @param string $a First name. * @param string $a First name.
* @param string $b Second name. * @param string $b Second name.

7
wp-includes/class-wp-user-meta-session-tokens.php
View File

@ -18,7 +18,6 @@ class WP_User_Meta_Session_Tokens extends WP_Session_Tokens {
* Get all sessions of a user. * Get all sessions of a user.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @return array Sessions of a user. * @return array Sessions of a user.
*/ */
@ -51,7 +50,6 @@ class WP_User_Meta_Session_Tokens extends WP_Session_Tokens {
* Retrieve a session by its verifier (token hash). * Retrieve a session by its verifier (token hash).
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @param string $verifier Verifier of the session to retrieve. * @param string $verifier Verifier of the session to retrieve.
* @return array|null The session, or null if it does not exist * @return array|null The session, or null if it does not exist
@ -70,7 +68,6 @@ class WP_User_Meta_Session_Tokens extends WP_Session_Tokens {
* Update a session by its verifier. * Update a session by its verifier.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @param string $verifier Verifier of the session to update. * @param string $verifier Verifier of the session to update.
* @param array $session Optional. Session. Omitting this argument destroys the session. * @param array $session Optional. Session. Omitting this argument destroys the session.
@ -91,7 +88,6 @@ class WP_User_Meta_Session_Tokens extends WP_Session_Tokens {
* Update a user's sessions in the usermeta table. * Update a user's sessions in the usermeta table.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @param array $sessions Sessions. * @param array $sessions Sessions.
*/ */
@ -107,7 +103,6 @@ class WP_User_Meta_Session_Tokens extends WP_Session_Tokens {
* Destroy all session tokens for a user, except a single session passed. * Destroy all session tokens for a user, except a single session passed.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
* *
* @param string $verifier Verifier of the session to keep. * @param string $verifier Verifier of the session to keep.
*/ */
@ -120,7 +115,6 @@ class WP_User_Meta_Session_Tokens extends WP_Session_Tokens {
* Destroy all session tokens for a user. * Destroy all session tokens for a user.
* *
* @since 4.0.0 * @since 4.0.0
* @access protected
*/ */
protected function destroy_all_sessions() { protected function destroy_all_sessions() {
$this->update_sessions( array() ); $this->update_sessions( array() );
@ -130,7 +124,6 @@ class WP_User_Meta_Session_Tokens extends WP_Session_Tokens {
* Destroy all session tokens for all users. * Destroy all session tokens for all users.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* @static * @static
*/ */
public static function drop_sessions() { public static function drop_sessions() {

19
wp-includes/class-wp-user-query.php
View File

@ -20,7 +20,6 @@ class WP_User_Query {
* Query vars, after parsing * Query vars, after parsing
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* @var array * @var array
*/ */
public $query_vars = array(); public $query_vars = array();
@ -29,7 +28,6 @@ class WP_User_Query {
* List of found user ids * List of found user ids
* *
* @since 3.1.0 * @since 3.1.0
* @access private
* @var array * @var array
*/ */
private $results; private $results;
@ -38,7 +36,6 @@ class WP_User_Query {
* Total number of found users for the current query * Total number of found users for the current query
* *
* @since 3.1.0 * @since 3.1.0
* @access private
* @var int * @var int
*/ */
private $total_users = 0; private $total_users = 0;
@ -47,7 +44,6 @@ class WP_User_Query {
* Metadata query container. * Metadata query container.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* @var WP_Meta_Query * @var WP_Meta_Query
*/ */
public $meta_query = false; public $meta_query = false;
@ -56,7 +52,6 @@ class WP_User_Query {
* The SQL query used to fetch matching users. * The SQL query used to fetch matching users.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @var string * @var string
*/ */
public $request; public $request;
@ -88,7 +83,6 @@ class WP_User_Query {
* Fills in missing query variables with default values. * Fills in missing query variables with default values.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $args Query vars, as passed to `WP_User_Query`. * @param array $args Query vars, as passed to `WP_User_Query`.
* @return array Complete query variables with undefined ones filled in with defaults. * @return array Complete query variables with undefined ones filled in with defaults.
@ -140,7 +134,6 @@ class WP_User_Query {
* @since 4.7.0 Added 'nicename', 'nicename__in', 'nicename__not_in', 'login', 'login__in', * @since 4.7.0 Added 'nicename', 'nicename__in', 'nicename__not_in', 'login', 'login__in',
* and 'login__not_in' parameters. * and 'login__not_in' parameters.
* *
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* @global int $blog_id * @global int $blog_id
@ -637,7 +630,6 @@ class WP_User_Query {
* Retrieve query variable. * Retrieve query variable.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param string $query_var Query variable key. * @param string $query_var Query variable key.
* @return mixed * @return mixed
@ -653,7 +645,6 @@ class WP_User_Query {
* Set query variable. * Set query variable.
* *
* @since 3.5.0 * @since 3.5.0
* @access public
* *
* @param string $query_var Query variable key. * @param string $query_var Query variable key.
* @param mixed $value Query variable value. * @param mixed $value Query variable value.
@ -665,7 +656,6 @@ class WP_User_Query {
/** /**
* Used internally to generate an SQL string for searching across multiple columns * Used internally to generate an SQL string for searching across multiple columns
* *
* @access protected
* @since 3.1.0 * @since 3.1.0
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
@ -699,7 +689,6 @@ class WP_User_Query {
* Return the list of users. * Return the list of users.
* *
* @since 3.1.0 * @since 3.1.0
* @access public
* *
* @return array Array of results. * @return array Array of results.
*/ */
@ -711,7 +700,6 @@ class WP_User_Query {
* Return the total number of users for the current query. * Return the total number of users for the current query.
* *
* @since 3.1.0 * @since 3.1.0
* @access public
* *
* @return int Number of total users. * @return int Number of total users.
*/ */
@ -723,7 +711,6 @@ class WP_User_Query {
* Parse and sanitize 'orderby' keys passed to the user query. * Parse and sanitize 'orderby' keys passed to the user query.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -783,7 +770,6 @@ class WP_User_Query {
* Parse an 'order' query variable and cast it to ASC or DESC as necessary. * Parse an 'order' query variable and cast it to ASC or DESC as necessary.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
* *
* @param string $order The 'order' query variable. * @param string $order The 'order' query variable.
* @return string The sanitized 'order' query variable. * @return string The sanitized 'order' query variable.
@ -804,7 +790,6 @@ class WP_User_Query {
* Make private properties readable for backward compatibility. * Make private properties readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to get. * @param string $name Property to get.
* @return mixed Property. * @return mixed Property.
@ -819,7 +804,6 @@ class WP_User_Query {
* Make private properties settable for backward compatibility. * Make private properties settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to check if set. * @param string $name Property to check if set.
* @param mixed $value Property value. * @param mixed $value Property value.
@ -835,7 +819,6 @@ class WP_User_Query {
* Make private properties checkable for backward compatibility. * Make private properties checkable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to check if set. * @param string $name Property to check if set.
* @return bool Whether the property is set. * @return bool Whether the property is set.
@ -850,7 +833,6 @@ class WP_User_Query {
* Make private properties un-settable for backward compatibility. * Make private properties un-settable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param string $name Property to unset. * @param string $name Property to unset.
*/ */
@ -864,7 +846,6 @@ class WP_User_Query {
* Make private/protected methods readable for backward compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param callable $name Method to call. * @param callable $name Method to call.
* @param array $arguments Arguments to pass when calling. * @param array $arguments Arguments to pass when calling.

26
wp-includes/class-wp-user.php
View File

@ -46,7 +46,6 @@ class WP_User {
* The user's ID. * The user's ID.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var int * @var int
*/ */
public $ID = 0; public $ID = 0;
@ -55,7 +54,6 @@ class WP_User {
* The individual capabilities the user has been given. * The individual capabilities the user has been given.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $caps = array(); public $caps = array();
@ -64,7 +62,6 @@ class WP_User {
* User metadata option name. * User metadata option name.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var string * @var string
*/ */
public $cap_key; public $cap_key;
@ -73,7 +70,6 @@ class WP_User {
* The roles the user is part of. * The roles the user is part of.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $roles = array(); public $roles = array();
@ -82,7 +78,6 @@ class WP_User {
* All capabilities the user has, including individual and role based. * All capabilities the user has, including individual and role based.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $allcaps = array(); public $allcaps = array();
@ -91,7 +86,6 @@ class WP_User {
* The filter context applied to user data fields. * The filter context applied to user data fields.
* *
* @since 2.9.0 * @since 2.9.0
* @access public
* @var string * @var string
*/ */
public $filter = null; public $filter = null;
@ -99,7 +93,6 @@ class WP_User {
/** /**
* @static * @static
* @since 3.3.0 * @since 3.3.0
* @access private
* @var array * @var array
*/ */
private static $back_compat_keys; private static $back_compat_keys;
@ -110,7 +103,6 @@ class WP_User {
* Retrieves the userdata and passes it to WP_User::init(). * Retrieves the userdata and passes it to WP_User::init().
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
* *
@ -250,7 +242,6 @@ class WP_User {
* Makes private/protected methods readable for backward compatibility. * Makes private/protected methods readable for backward compatibility.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param callable $name Method to call. * @param callable $name Method to call.
* @param array $arguments Arguments to pass when calling. * @param array $arguments Arguments to pass when calling.
@ -267,7 +258,6 @@ class WP_User {
* Magic method for checking the existence of a certain custom field. * Magic method for checking the existence of a certain custom field.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* *
* @param string $key User meta key to check if set. * @param string $key User meta key to check if set.
* @return bool Whether the given user meta key is set. * @return bool Whether the given user meta key is set.
@ -297,7 +287,6 @@ class WP_User {
* Magic method for accessing custom fields. * Magic method for accessing custom fields.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* *
* @param string $key User meta key to retrieve. * @param string $key User meta key to retrieve.
* @return mixed Value of the given user meta key (if set). If `$key` is 'id', the user ID. * @return mixed Value of the given user meta key (if set). If `$key` is 'id', the user ID.
@ -336,7 +325,6 @@ class WP_User {
* the value on the WP_User instance. * the value on the WP_User instance.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* *
* @param string $key User meta key. * @param string $key User meta key.
* @param mixed $value User meta value. * @param mixed $value User meta value.
@ -361,7 +349,6 @@ class WP_User {
* Magic method for unsetting a certain custom field. * Magic method for unsetting a certain custom field.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key User meta key to unset. * @param string $key User meta key to unset.
*/ */
@ -389,7 +376,6 @@ class WP_User {
* Determine whether the user exists in the database. * Determine whether the user exists in the database.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @return bool True if user exists in the database, false if not. * @return bool True if user exists in the database, false if not.
*/ */
@ -444,7 +430,6 @@ class WP_User {
* property matching the 'cap_key' exists and is an array. If so, it will be * property matching the 'cap_key' exists and is an array. If so, it will be
* used. * used.
* *
* @access protected
* @since 2.1.0 * @since 2.1.0
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
@ -476,7 +461,6 @@ class WP_User {
* granted permission to. * granted permission to.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @return array List of all capabilities for the user. * @return array List of all capabilities for the user.
*/ */
@ -504,7 +488,6 @@ class WP_User {
* Updates the user's meta data option with capabilities and roles. * Updates the user's meta data option with capabilities and roles.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name. * @param string $role Role name.
*/ */
@ -533,7 +516,6 @@ class WP_User {
* Remove role from user. * Remove role from user.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name. * @param string $role Role name.
*/ */
@ -564,7 +546,6 @@ class WP_User {
* of the roles from the user. * of the roles from the user.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $role Role name. * @param string $role Role name.
*/ */
@ -612,7 +593,6 @@ class WP_User {
* value. * value.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param int $max Max level of user. * @param int $max Max level of user.
* @param string $item Level capability name. * @param string $item Level capability name.
@ -635,7 +615,6 @@ class WP_User {
* the all of the capabilities that the user has. * the all of the capabilities that the user has.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
*/ */
@ -649,7 +628,6 @@ class WP_User {
* Add capability and grant or deny access to capability. * Add capability and grant or deny access to capability.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $cap Capability name. * @param string $cap Capability name.
* @param bool $grant Whether to grant capability to user. * @param bool $grant Whether to grant capability to user.
@ -665,7 +643,6 @@ class WP_User {
* Remove capability from user. * Remove capability from user.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string $cap Capability name. * @param string $cap Capability name.
*/ */
@ -683,7 +660,6 @@ class WP_User {
* Remove all of the capabilities of the user. * Remove all of the capabilities of the user.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @global wpdb $wpdb WordPress database abstraction object. * @global wpdb $wpdb WordPress database abstraction object.
*/ */
@ -702,7 +678,6 @@ class WP_User {
* in part, this practice is discouraged as it may produce unreliable results. * in part, this practice is discouraged as it may produce unreliable results.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @see map_meta_cap() * @see map_meta_cap()
* *
@ -766,7 +741,6 @@ class WP_User {
* Prepends 'level_' to level number. * Prepends 'level_' to level number.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param int $level Level number, 1 to 10. * @param int $level Level number, 1 to 10.
* @return string * @return string

2
wp-includes/class-wp-walker.php
View File

@ -16,7 +16,6 @@ class Walker {
* What the class handles. * What the class handles.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var string * @var string
*/ */
public $tree_type; public $tree_type;
@ -385,7 +384,6 @@ class Walker {
* Calculates the total number of root elements. * Calculates the total number of root elements.
* *
* @since 2.7.0 * @since 2.7.0
* @access public
* *
* @param array $elements Elements to list. * @param array $elements Elements to list.
* @return int Number of root elements. * @return int Number of root elements.

8
wp-includes/class-wp-widget-factory.php
View File

@ -19,7 +19,6 @@ class WP_Widget_Factory {
* Widgets array. * Widgets array.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var array * @var array
*/ */
public $widgets = array(); public $widgets = array();
@ -28,7 +27,6 @@ class WP_Widget_Factory {
* PHP5 constructor. * PHP5 constructor.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function __construct() { public function __construct() {
add_action( 'widgets_init', array( $this, '_register_widgets' ), 100 ); add_action( 'widgets_init', array( $this, '_register_widgets' ), 100 );
@ -38,7 +36,6 @@ class WP_Widget_Factory {
* PHP4 constructor. * PHP4 constructor.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
*/ */
public function WP_Widget_Factory() { public function WP_Widget_Factory() {
_deprecated_constructor( 'WP_Widget_Factory', '4.2.0' ); _deprecated_constructor( 'WP_Widget_Factory', '4.2.0' );
@ -52,7 +49,6 @@ class WP_Widget_Factory {
* is the minimum requirement for PHP. * is the minimum requirement for PHP.
* *
* @since 4.6.0 * @since 4.6.0
* @access private
* @var array * @var array
* *
* @see WP_Widget_Factory::hash_object() * @see WP_Widget_Factory::hash_object()
@ -66,7 +62,6 @@ class WP_Widget_Factory {
* is the minimum requirement for PHP. * is the minimum requirement for PHP.
* *
* @since 4.6.0 * @since 4.6.0
* @access private
* *
* @param WP_Widget $widget Widget. * @param WP_Widget $widget Widget.
* @return string Object hash. * @return string Object hash.
@ -95,7 +90,6 @@ class WP_Widget_Factory {
* @since 2.8.0 * @since 2.8.0
* @since 4.6.0 Updated the `$widget` parameter to also accept a WP_Widget instance object * @since 4.6.0 Updated the `$widget` parameter to also accept a WP_Widget instance object
* instead of simply a `WP_Widget` subclass name. * instead of simply a `WP_Widget` subclass name.
* @access public
* *
* @param string|WP_Widget $widget Either the name of a `WP_Widget` subclass or an instance of a `WP_Widget` subclass. * @param string|WP_Widget $widget Either the name of a `WP_Widget` subclass or an instance of a `WP_Widget` subclass.
*/ */
@ -113,7 +107,6 @@ class WP_Widget_Factory {
* @since 2.8.0 * @since 2.8.0
* @since 4.6.0 Updated the `$widget` parameter to also accept a WP_Widget instance object * @since 4.6.0 Updated the `$widget` parameter to also accept a WP_Widget instance object
* instead of simply a `WP_Widget` subclass name. * instead of simply a `WP_Widget` subclass name.
* @access public
* *
* @param string|WP_Widget $widget Either the name of a `WP_Widget` subclass or an instance of a `WP_Widget` subclass. * @param string|WP_Widget $widget Either the name of a `WP_Widget` subclass or an instance of a `WP_Widget` subclass.
*/ */
@ -129,7 +122,6 @@ class WP_Widget_Factory {
* Serves as a utility method for adding widgets to the registered widgets global. * Serves as a utility method for adding widgets to the registered widgets global.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @global array $wp_registered_widgets * @global array $wp_registered_widgets
*/ */

28
wp-includes/class-wp-widget.php
View File

@ -23,7 +23,6 @@ class WP_Widget {
* Root ID for all widgets of this type. * Root ID for all widgets of this type.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var mixed|string * @var mixed|string
*/ */
public $id_base; public $id_base;
@ -32,7 +31,6 @@ class WP_Widget {
* Name for this widget type. * Name for this widget type.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $name; public $name;
@ -41,7 +39,6 @@ class WP_Widget {
* Option name for this widget type. * Option name for this widget type.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $option_name; public $option_name;
@ -50,7 +47,6 @@ class WP_Widget {
* Alt option name for this widget type. * Alt option name for this widget type.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $alt_option_name; public $alt_option_name;
@ -59,7 +55,6 @@ class WP_Widget {
* Option array passed to wp_register_sidebar_widget(). * Option array passed to wp_register_sidebar_widget().
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var array * @var array
*/ */
public $widget_options; public $widget_options;
@ -68,7 +63,6 @@ class WP_Widget {
* Option array passed to wp_register_widget_control(). * Option array passed to wp_register_widget_control().
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var array * @var array
*/ */
public $control_options; public $control_options;
@ -77,7 +71,6 @@ class WP_Widget {
* Unique ID number of the current instance. * Unique ID number of the current instance.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var bool|int * @var bool|int
*/ */
public $number = false; public $number = false;
@ -86,7 +79,6 @@ class WP_Widget {
* Unique ID string of the current instance (id_base-number). * Unique ID string of the current instance (id_base-number).
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var bool|string * @var bool|string
*/ */
public $id = false; public $id = false;
@ -98,7 +90,6 @@ class WP_Widget {
* not happen twice. * not happen twice.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var bool * @var bool
*/ */
public $updated = false; public $updated = false;
@ -113,7 +104,6 @@ class WP_Widget {
* Sub-classes should over-ride this function to generate their widget code. * Sub-classes should over-ride this function to generate their widget code.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param array $args Display arguments including 'before_title', 'after_title', * @param array $args Display arguments including 'before_title', 'after_title',
* 'before_widget', and 'after_widget'. * 'before_widget', and 'after_widget'.
@ -131,7 +121,6 @@ class WP_Widget {
* saved/updated. * saved/updated.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param array $new_instance New settings for this instance as input by the user via * @param array $new_instance New settings for this instance as input by the user via
* WP_Widget::form(). * WP_Widget::form().
@ -146,7 +135,6 @@ class WP_Widget {
* Outputs the settings update form. * Outputs the settings update form.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param array $instance Current settings. * @param array $instance Current settings.
* @return string Default return is 'noform'. * @return string Default return is 'noform'.
@ -162,7 +150,6 @@ class WP_Widget {
* PHP5 constructor. * PHP5 constructor.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param string $id_base Optional Base ID for the widget, lowercase and unique. If left empty, * @param string $id_base Optional Base ID for the widget, lowercase and unique. If left empty,
* a portion of the widget's class name will be used Has to be unique. * a portion of the widget's class name will be used Has to be unique.
@ -184,7 +171,6 @@ class WP_Widget {
* PHP4 constructor. * PHP4 constructor.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @see __construct() * @see __construct()
* *
@ -209,7 +195,6 @@ class WP_Widget {
* *
* @since 2.8.0 * @since 2.8.0
* @since 4.4.0 Array format field names are now accepted. * @since 4.4.0 Array format field names are now accepted.
* @access public
* *
* @param string $field_name Field name * @param string $field_name Field name
* @return string Name attribute for $field_name * @return string Name attribute for $field_name
@ -230,7 +215,6 @@ class WP_Widget {
* *
* @since 2.8.0 * @since 2.8.0
* @since 4.4.0 Array format field IDs are now accepted. * @since 4.4.0 Array format field IDs are now accepted.
* @access public
* *
* @param string $field_name Field name. * @param string $field_name Field name.
* @return string ID attribute for `$field_name`. * @return string ID attribute for `$field_name`.
@ -243,7 +227,6 @@ class WP_Widget {
* Register all widget instances of this widget class. * Register all widget instances of this widget class.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
*/ */
public function _register() { public function _register() {
$settings = $this->get_settings(); $settings = $this->get_settings();
@ -275,7 +258,6 @@ class WP_Widget {
* Sets the internal order number for the widget instance. * Sets the internal order number for the widget instance.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param int $number The unique order number of this widget instance compared to other * @param int $number The unique order number of this widget instance compared to other
* instances of the same class. * instances of the same class.
@ -289,7 +271,6 @@ class WP_Widget {
* Retrieves the widget display callback. * Retrieves the widget display callback.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @return callable Display callback. * @return callable Display callback.
*/ */
@ -301,7 +282,6 @@ class WP_Widget {
* Retrieves the widget update callback. * Retrieves the widget update callback.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @return callable Update callback. * @return callable Update callback.
*/ */
@ -313,7 +293,6 @@ class WP_Widget {
* Retrieves the form callback. * Retrieves the form callback.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @return callable Form callback. * @return callable Form callback.
*/ */
@ -330,7 +309,6 @@ class WP_Widget {
* to transients, or anywhere else. * to transients, or anywhere else.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @global WP_Customize_Manager $wp_customize * @global WP_Customize_Manager $wp_customize
* *
@ -347,7 +325,6 @@ class WP_Widget {
* Finds the instance and calls WP_Widget::widget(). * Finds the instance and calls WP_Widget::widget().
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param array $args Display arguments. See WP_Widget::widget() for information * @param array $args Display arguments. See WP_Widget::widget() for information
* on accepted arguments. * on accepted arguments.
@ -404,7 +381,6 @@ class WP_Widget {
* Handles changed settings (Do NOT override). * Handles changed settings (Do NOT override).
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @global array $wp_registered_widgets * @global array $wp_registered_widgets
* *
@ -489,7 +465,6 @@ class WP_Widget {
* Generates the widget control form (Do NOT override). * Generates the widget control form (Do NOT override).
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param int|array $widget_args { * @param int|array $widget_args {
* Optional. Internal order number of the widget instance, or array of multi-widget arguments. * Optional. Internal order number of the widget instance, or array of multi-widget arguments.
@ -556,7 +531,6 @@ class WP_Widget {
* Registers an instance of the widget class. * Registers an instance of the widget class.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param integer $number Optional. The unique order number of this widget instance * @param integer $number Optional. The unique order number of this widget instance
* compared to other instances of the same class. Default -1. * compared to other instances of the same class. Default -1.
@ -571,7 +545,6 @@ class WP_Widget {
* Saves the settings for all instances of the widget class. * Saves the settings for all instances of the widget class.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param array $settings Multi-dimensional array of widget instance settings. * @param array $settings Multi-dimensional array of widget instance settings.
*/ */
@ -584,7 +557,6 @@ class WP_Widget {
* Retrieves the settings for all instances of the widget class. * Retrieves the settings for all instances of the widget class.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @return array Multi-dimensional array of widget instance settings. * @return array Multi-dimensional array of widget instance settings.
*/ */

20
wp-includes/class-wp-xmlrpc-server.php
View File

@ -24,7 +24,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Methods. * Methods.
* *
* @access public
* @var array * @var array
*/ */
public $methods; public $methods;
@ -32,7 +31,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Blog options. * Blog options.
* *
* @access public
* @var array * @var array
*/ */
public $blog_options; public $blog_options;
@ -40,7 +38,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* IXR_Error instance. * IXR_Error instance.
* *
* @access public
* @var IXR_Error * @var IXR_Error
*/ */
public $error; public $error;
@ -48,7 +45,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Flags that the user authentication has failed in this instance of wp_xmlrpc_server. * Flags that the user authentication has failed in this instance of wp_xmlrpc_server.
* *
* @access protected
* @var bool * @var bool
*/ */
protected $auth_failed = false; protected $auth_failed = false;
@ -174,7 +170,6 @@ class wp_xmlrpc_server extends IXR_Server {
* Make private/protected methods readable for backward compatibility. * Make private/protected methods readable for backward compatibility.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @param callable $name Method to call. * @param callable $name Method to call.
* @param array $arguments Arguments to pass when calling. * @param array $arguments Arguments to pass when calling.
@ -191,7 +186,6 @@ class wp_xmlrpc_server extends IXR_Server {
* Serves the XML-RPC request. * Serves the XML-RPC request.
* *
* @since 2.9.0 * @since 2.9.0
* @access public
*/ */
public function serve_request() { public function serve_request() {
$this->IXR_Server($this->methods); $this->IXR_Server($this->methods);
@ -724,7 +718,6 @@ class wp_xmlrpc_server extends IXR_Server {
* Checks if the method received at least the minimum number of arguments. * Checks if the method received at least the minimum number of arguments.
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* *
* @param string|array $args Sanitize single string or array of strings. * @param string|array $args Sanitize single string or array of strings.
* @param int $count Minimum number of arguments. * @param int $count Minimum number of arguments.
@ -742,7 +735,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Prepares taxonomy data for return in an XML-RPC object. * Prepares taxonomy data for return in an XML-RPC object.
* *
* @access protected
* *
* @param object $taxonomy The unprepared taxonomy data. * @param object $taxonomy The unprepared taxonomy data.
* @param array $fields The subset of taxonomy fields to return. * @param array $fields The subset of taxonomy fields to return.
@ -785,7 +777,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Prepares term data for return in an XML-RPC object. * Prepares term data for return in an XML-RPC object.
* *
* @access protected
* *
* @param array|object $term The unprepared term data. * @param array|object $term The unprepared term data.
* @return array The prepared term data. * @return array The prepared term data.
@ -821,7 +812,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Convert a WordPress date string to an IXR_Date object. * Convert a WordPress date string to an IXR_Date object.
* *
* @access protected
* *
* @param string $date Date string to convert. * @param string $date Date string to convert.
* @return IXR_Date IXR_Date object. * @return IXR_Date IXR_Date object.
@ -836,7 +826,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Convert a WordPress GMT date string to an IXR_Date object. * Convert a WordPress GMT date string to an IXR_Date object.
* *
* @access protected
* *
* @param string $date_gmt WordPress GMT date string. * @param string $date_gmt WordPress GMT date string.
* @param string $date Date string. * @param string $date Date string.
@ -852,7 +841,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Prepares post data for return in an XML-RPC object. * Prepares post data for return in an XML-RPC object.
* *
* @access protected
* *
* @param array $post The unprepared post data. * @param array $post The unprepared post data.
* @param array $fields The subset of post type fields to return. * @param array $fields The subset of post type fields to return.
@ -953,7 +941,6 @@ class wp_xmlrpc_server extends IXR_Server {
* *
* @since 3.4.0 * @since 3.4.0
* @since 4.6.0 Converted the `$post_type` parameter to accept a WP_Post_Type object. * @since 4.6.0 Converted the `$post_type` parameter to accept a WP_Post_Type object.
* @access protected
* *
* @param WP_Post_Type $post_type Post type object. * @param WP_Post_Type $post_type Post type object.
* @param array $fields The subset of post fields to return. * @param array $fields The subset of post fields to return.
@ -1004,7 +991,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Prepares media item data for return in an XML-RPC object. * Prepares media item data for return in an XML-RPC object.
* *
* @access protected
* *
* @param object $media_item The unprepared media item data. * @param object $media_item The unprepared media item data.
* @param string $thumbnail_size The image size to use for the thumbnail URL. * @param string $thumbnail_size The image size to use for the thumbnail URL.
@ -1044,7 +1030,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Prepares page data for return in an XML-RPC object. * Prepares page data for return in an XML-RPC object.
* *
* @access protected
* *
* @param object $page The unprepared page data. * @param object $page The unprepared page data.
* @return array The prepared page data. * @return array The prepared page data.
@ -1125,7 +1110,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Prepares comment data for return in an XML-RPC object. * Prepares comment data for return in an XML-RPC object.
* *
* @access protected
* *
* @param object $comment The unprepared comment data. * @param object $comment The unprepared comment data.
* @return array The prepared comment data. * @return array The prepared comment data.
@ -1174,7 +1158,6 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Prepares user data for return in an XML-RPC object. * Prepares user data for return in an XML-RPC object.
* *
* @access protected
* *
* @param WP_User $user The unprepared user object. * @param WP_User $user The unprepared user object.
* @param array $fields The subset of user fields to return. * @param array $fields The subset of user fields to return.
@ -1319,7 +1302,6 @@ class wp_xmlrpc_server extends IXR_Server {
* and determining if the user has permission to do so * and determining if the user has permission to do so
* *
* @since 4.3.0 * @since 4.3.0
* @access private
* *
* @param array $post_data * @param array $post_data
* @param bool $update * @param bool $update
@ -1356,7 +1338,6 @@ class wp_xmlrpc_server extends IXR_Server {
* Helper method for wp_newPost() and wp_editPost(), containing shared logic. * Helper method for wp_newPost() and wp_editPost(), containing shared logic.
* *
* @since 3.4.0 * @since 3.4.0
* @access protected
* *
* @see wp_insert_post() * @see wp_insert_post()
* *
@ -4469,7 +4450,6 @@ class wp_xmlrpc_server extends IXR_Server {
* Private function for retrieving a users blogs for multisite setups * Private function for retrieving a users blogs for multisite setups
* *
* @since 3.0.0 * @since 3.0.0
* @access protected
* *
* @param array $args { * @param array $args {
* Method arguments. Note: arguments must be ordered as documented. * Method arguments. Note: arguments must be ordered as documented.

20
wp-includes/class-wp.php
View File

@ -12,7 +12,6 @@ class WP {
* Long list of public query variables. * Long list of public query variables.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $public_query_vars = array('m', 'p', 'posts', 'w', 'cat', 'withcomments', 'withoutcomments', 's', 'search', 'exact', 'sentence', 'calendar', 'page', 'paged', 'more', 'tb', 'pb', 'author', 'order', 'orderby', 'year', 'monthnum', 'day', 'hour', 'minute', 'second', 'name', 'category_name', 'tag', 'feed', 'author_name', 'static', 'pagename', 'page_id', 'error', 'attachment', 'attachment_id', 'subpost', 'subpost_id', 'preview', 'robots', 'taxonomy', 'term', 'cpage', 'post_type', 'embed' ); public $public_query_vars = array('m', 'p', 'posts', 'w', 'cat', 'withcomments', 'withoutcomments', 's', 'search', 'exact', 'sentence', 'calendar', 'page', 'paged', 'more', 'tb', 'pb', 'author', 'order', 'orderby', 'year', 'monthnum', 'day', 'hour', 'minute', 'second', 'name', 'category_name', 'tag', 'feed', 'author_name', 'static', 'pagename', 'page_id', 'error', 'attachment', 'attachment_id', 'subpost', 'subpost_id', 'preview', 'robots', 'taxonomy', 'term', 'cpage', 'post_type', 'embed' );
@ -23,7 +22,6 @@ class WP {
* Long list of private query variables. * Long list of private query variables.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $private_query_vars = array( 'offset', 'posts_per_page', 'posts_per_archive_page', 'showposts', 'nopaging', 'post_type', 'post_status', 'category__in', 'category__not_in', 'category__and', 'tag__in', 'tag__not_in', 'tag__and', 'tag_slug__in', 'tag_slug__and', 'tag_id', 'post_mime_type', 'perm', 'comments_per_page', 'post__in', 'post__not_in', 'post_parent', 'post_parent__in', 'post_parent__not_in', 'title', 'fields' ); public $private_query_vars = array( 'offset', 'posts_per_page', 'posts_per_archive_page', 'showposts', 'nopaging', 'post_type', 'post_status', 'category__in', 'category__not_in', 'category__and', 'tag__in', 'tag__not_in', 'tag__and', 'tag_slug__in', 'tag_slug__and', 'tag_id', 'post_mime_type', 'perm', 'comments_per_page', 'post__in', 'post__not_in', 'post_parent', 'post_parent__in', 'post_parent__not_in', 'title', 'fields' );
@ -32,7 +30,6 @@ class WP {
* Extra query variables set by the user. * Extra query variables set by the user.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* @var array * @var array
*/ */
public $extra_query_vars = array(); public $extra_query_vars = array();
@ -41,7 +38,6 @@ class WP {
* Query variables for setting up the WordPress Query Loop. * Query variables for setting up the WordPress Query Loop.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var array * @var array
*/ */
public $query_vars; public $query_vars;
@ -50,7 +46,6 @@ class WP {
* String parsed to set the query variables. * String parsed to set the query variables.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var string * @var string
*/ */
public $query_string; public $query_string;
@ -59,7 +54,6 @@ class WP {
* The request path, e.g. 2015/05/06. * The request path, e.g. 2015/05/06.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var string * @var string
*/ */
public $request; public $request;
@ -68,7 +62,6 @@ class WP {
* Rewrite rule the request matched. * Rewrite rule the request matched.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var string * @var string
*/ */
public $matched_rule; public $matched_rule;
@ -77,7 +70,6 @@ class WP {
* Rewrite query the request matched. * Rewrite query the request matched.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var string * @var string
*/ */
public $matched_query; public $matched_query;
@ -86,7 +78,6 @@ class WP {
* Whether already did the permalink. * Whether already did the permalink.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* @var bool * @var bool
*/ */
public $did_permalink = false; public $did_permalink = false;
@ -95,7 +86,6 @@ class WP {
* Add name to list of public query variables. * Add name to list of public query variables.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string $qv Query variable name. * @param string $qv Query variable name.
*/ */
@ -108,7 +98,6 @@ class WP {
* Removes a query variable from a list of public query variables. * Removes a query variable from a list of public query variables.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $name Query variable name. * @param string $name Query variable name.
*/ */
@ -120,7 +109,6 @@ class WP {
* Set the value of a query variable. * Set the value of a query variable.
* *
* @since 2.3.0 * @since 2.3.0
* @access public
* *
* @param string $key Query variable name. * @param string $key Query variable name.
* @param mixed $value Query variable value. * @param mixed $value Query variable value.
@ -136,7 +124,6 @@ class WP {
* filters and actions that can be used to further manipulate the result. * filters and actions that can be used to further manipulate the result.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @global WP_Rewrite $wp_rewrite * @global WP_Rewrite $wp_rewrite
* *
@ -394,7 +381,6 @@ class WP {
* *
* @since 2.0.0 * @since 2.0.0
* @since 4.4.0 `X-Pingback` header is added conditionally after posts have been queried in handle_404(). * @since 4.4.0 `X-Pingback` header is added conditionally after posts have been queried in handle_404().
* @access public
*/ */
public function send_headers() { public function send_headers() {
$headers = array(); $headers = array();
@ -525,7 +511,6 @@ class WP {
* use the {@see 'request'} filter instead. * use the {@see 'request'} filter instead.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
*/ */
public function build_query_string() { public function build_query_string() {
$this->query_string = ''; $this->query_string = '';
@ -560,7 +545,6 @@ class WP {
* WordPress environment. * WordPress environment.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @global WP_Query $wp_query * @global WP_Query $wp_query
* @global string $query_string Query string for the loop. * @global string $query_string Query string for the loop.
@ -597,7 +581,6 @@ class WP {
* Set up the current user. * Set up the current user.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
*/ */
public function init() { public function init() {
wp_get_current_user(); wp_get_current_user();
@ -607,7 +590,6 @@ class WP {
* Set up the Loop based on the query variables. * Set up the Loop based on the query variables.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @global WP_Query $wp_the_query * @global WP_Query $wp_the_query
*/ */
@ -631,7 +613,6 @@ class WP {
* a 404 so that canonical redirection logic can kick in. * a 404 so that canonical redirection logic can kick in.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @global WP_Query $wp_query * @global WP_Query $wp_query
*/ */
@ -724,7 +705,6 @@ class WP {
* object. * object.
* *
* @since 2.0.0 * @since 2.0.0
* @access public
* *
* @param string|array $query_args Passed to parse_request(). * @param string|array $query_args Passed to parse_request().
*/ */

18
wp-includes/class.wp-dependencies.php
View File

@ -19,7 +19,6 @@ class WP_Dependencies {
/** /**
* An array of registered handle objects. * An array of registered handle objects.
* *
* @access public
* @since 2.6.8 * @since 2.6.8
* @var array * @var array
*/ */
@ -28,7 +27,6 @@ class WP_Dependencies {
/** /**
* An array of queued _WP_Dependency handle objects. * An array of queued _WP_Dependency handle objects.
* *
* @access public
* @since 2.6.8 * @since 2.6.8
* @var array * @var array
*/ */
@ -37,7 +35,6 @@ class WP_Dependencies {
/** /**
* An array of _WP_Dependency handle objects to queue. * An array of _WP_Dependency handle objects to queue.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @var array * @var array
*/ */
@ -46,7 +43,6 @@ class WP_Dependencies {
/** /**
* An array of _WP_Dependency handle objects already queued. * An array of _WP_Dependency handle objects already queued.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @var array * @var array
*/ */
@ -57,7 +53,6 @@ class WP_Dependencies {
* *
* Arguments are appended to the item query string. * Arguments are appended to the item query string.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @var array * @var array
*/ */
@ -66,7 +61,6 @@ class WP_Dependencies {
/** /**
* An array of handle groups to enqueue. * An array of handle groups to enqueue.
* *
* @access public
* @since 2.8.0 * @since 2.8.0
* @var array * @var array
*/ */
@ -75,7 +69,6 @@ class WP_Dependencies {
/** /**
* A handle group to enqueue. * A handle group to enqueue.
* *
* @access public
* @since 2.8.0 * @since 2.8.0
* @deprecated 4.5.0 * @deprecated 4.5.0
* @var int * @var int
@ -87,7 +80,6 @@ class WP_Dependencies {
* *
* Processes the items passed to it or the queue, and their dependencies. * Processes the items passed to it or the queue, and their dependencies.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* @since 2.8.0 Added the `$group` parameter. * @since 2.8.0 Added the `$group` parameter.
* *
@ -124,7 +116,6 @@ class WP_Dependencies {
/** /**
* Processes a dependency. * Processes a dependency.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* *
* @param string $handle Name of the item. Should be unique. * @param string $handle Name of the item. Should be unique.
@ -140,7 +131,6 @@ class WP_Dependencies {
* Recursively builds an array of items to process taking * Recursively builds an array of items to process taking
* dependencies into account. Does NOT catch infinite loops. * dependencies into account. Does NOT catch infinite loops.
* *
* @access public
* @since 2.1.0 * @since 2.1.0
* @since 2.6.0 Moved from `WP_Scripts`. * @since 2.6.0 Moved from `WP_Scripts`.
* @since 2.8.0 Added the `$group` parameter. * @since 2.8.0 Added the `$group` parameter.
@ -200,7 +190,6 @@ class WP_Dependencies {
* *
* Registers the item if no item of that name already exists. * Registers the item if no item of that name already exists.
* *
* @access public
* @since 2.1.0 * @since 2.1.0
* @since 2.6.0 Moved from `WP_Scripts`. * @since 2.6.0 Moved from `WP_Scripts`.
* *
@ -226,7 +215,6 @@ class WP_Dependencies {
* *
* Adds data to a registered item. * Adds data to a registered item.
* *
* @access public
* @since 2.6.0 * @since 2.6.0
* *
* @param string $handle Name of the item. Should be unique. * @param string $handle Name of the item. Should be unique.
@ -246,7 +234,6 @@ class WP_Dependencies {
* *
* Gets data associated with a registered item. * Gets data associated with a registered item.
* *
* @access public
* @since 3.3.0 * @since 3.3.0
* *
* @param string $handle Name of the item. Should be unique. * @param string $handle Name of the item. Should be unique.
@ -266,7 +253,6 @@ class WP_Dependencies {
/** /**
* Un-register an item or items. * Un-register an item or items.
* *
* @access public
* @since 2.1.0 * @since 2.1.0
* @since 2.6.0 Moved from `WP_Scripts`. * @since 2.6.0 Moved from `WP_Scripts`.
* *
@ -286,7 +272,6 @@ class WP_Dependencies {
* classes, $args is appended to the item url as a query string. * classes, $args is appended to the item url as a query string.
* Note $args is NOT the $args property of items in the $registered array. * Note $args is NOT the $args property of items in the $registered array.
* *
* @access public
* @since 2.1.0 * @since 2.1.0
* @since 2.6.0 Moved from `WP_Scripts`. * @since 2.6.0 Moved from `WP_Scripts`.
* *
@ -309,7 +294,6 @@ class WP_Dependencies {
* Decodes handles and arguments, then dequeues handles * Decodes handles and arguments, then dequeues handles
* and removes arguments from the class property $args. * and removes arguments from the class property $args.
* *
* @access public
* @since 2.1.0 * @since 2.1.0
* @since 2.6.0 Moved from `WP_Scripts`. * @since 2.6.0 Moved from `WP_Scripts`.
* *
@ -354,7 +338,6 @@ class WP_Dependencies {
/** /**
* Query list for an item. * Query list for an item.
* *
* @access public
* @since 2.1.0 * @since 2.1.0
* @since 2.6.0 Moved from `WP_Scripts`. * @since 2.6.0 Moved from `WP_Scripts`.
* *
@ -391,7 +374,6 @@ class WP_Dependencies {
/** /**
* Set item group, unless already in a lower group. * Set item group, unless already in a lower group.
* *
* @access public
* @since 2.8.0 * @since 2.8.0
* *
* @param string $handle Name of the item. Should be unique. * @param string $handle Name of the item. Should be unique.

27
wp-includes/class.wp-scripts.php
View File

@ -22,7 +22,6 @@ class WP_Scripts extends WP_Dependencies {
* Full URL with trailing slash. * Full URL with trailing slash.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
* @var string * @var string
*/ */
public $base_url; public $base_url;
@ -31,7 +30,6 @@ class WP_Scripts extends WP_Dependencies {
* URL of the content directory. * URL of the content directory.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $content_url; public $content_url;
@ -40,7 +38,6 @@ class WP_Scripts extends WP_Dependencies {
* Default version string for stylesheets. * Default version string for stylesheets.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
* @var string * @var string
*/ */
public $default_version; public $default_version;
@ -49,7 +46,6 @@ class WP_Scripts extends WP_Dependencies {
* Holds handles of scripts which are enqueued in footer. * Holds handles of scripts which are enqueued in footer.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var array * @var array
*/ */
public $in_footer = array(); public $in_footer = array();
@ -58,7 +54,6 @@ class WP_Scripts extends WP_Dependencies {
* Holds a list of script handles which will be concatenated. * Holds a list of script handles which will be concatenated.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $concat = ''; public $concat = '';
@ -68,7 +63,6 @@ class WP_Scripts extends WP_Dependencies {
* *
* @since 2.8.0 * @since 2.8.0
* @deprecated 3.4.0 * @deprecated 3.4.0
* @access public
* @var string * @var string
*/ */
public $concat_version = ''; public $concat_version = '';
@ -77,7 +71,6 @@ class WP_Scripts extends WP_Dependencies {
* Whether to perform concatenation. * Whether to perform concatenation.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var bool * @var bool
*/ */
public $do_concat = false; public $do_concat = false;
@ -87,7 +80,6 @@ class WP_Scripts extends WP_Dependencies {
* is enabled. * is enabled.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $print_html = ''; public $print_html = '';
@ -96,7 +88,6 @@ class WP_Scripts extends WP_Dependencies {
* Holds inline code if concatenation is enabled. * Holds inline code if concatenation is enabled.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $print_code = ''; public $print_code = '';
@ -108,7 +99,6 @@ class WP_Scripts extends WP_Dependencies {
* Unused in core. * Unused in core.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $ext_handles = ''; public $ext_handles = '';
@ -120,7 +110,6 @@ class WP_Scripts extends WP_Dependencies {
* Unused in core. * Unused in core.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $ext_version = ''; public $ext_version = '';
@ -129,7 +118,6 @@ class WP_Scripts extends WP_Dependencies {
* List of default directories. * List of default directories.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var array * @var array
*/ */
public $default_dirs; public $default_dirs;
@ -138,7 +126,6 @@ class WP_Scripts extends WP_Dependencies {
* Constructor. * Constructor.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
*/ */
public function __construct() { public function __construct() {
$this->init(); $this->init();
@ -149,7 +136,6 @@ class WP_Scripts extends WP_Dependencies {
* Initialize the class. * Initialize the class.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
*/ */
public function init() { public function init() {
/** /**
@ -169,7 +155,6 @@ class WP_Scripts extends WP_Dependencies {
* *
* @since 2.1.0 * @since 2.1.0
* @since 2.8.0 Added the `$group` parameter. * @since 2.8.0 Added the `$group` parameter.
* @access public
* *
* @param mixed $handles Optional. Scripts to be printed. (void) prints queue, (string) prints * @param mixed $handles Optional. Scripts to be printed. (void) prints queue, (string) prints
* that script, (array of strings) prints those scripts. Default false. * that script, (array of strings) prints those scripts. Default false.
@ -187,7 +172,6 @@ class WP_Scripts extends WP_Dependencies {
* @since 2.1.0 * @since 2.1.0
* @since 2.8.0 Added the `$echo` parameter. * @since 2.8.0 Added the `$echo` parameter.
* @deprecated 3.3.0 * @deprecated 3.3.0
* @access public
* *
* @see print_extra_script() * @see print_extra_script()
* *
@ -205,7 +189,6 @@ class WP_Scripts extends WP_Dependencies {
* Prints extra scripts of a registered script. * Prints extra scripts of a registered script.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* *
* @param string $handle The script's registered handle. * @param string $handle The script's registered handle.
* @param bool $echo Optional. Whether to echo the extra script instead of just returning it. * @param bool $echo Optional. Whether to echo the extra script instead of just returning it.
@ -233,7 +216,6 @@ class WP_Scripts extends WP_Dependencies {
* *
* @since 2.6.0 * @since 2.6.0
* @since 2.8.0 Added the `$group` parameter. * @since 2.8.0 Added the `$group` parameter.
* @access public
* *
* @see WP_Dependencies::do_item() * @see WP_Dependencies::do_item()
* *
@ -368,7 +350,6 @@ class WP_Scripts extends WP_Dependencies {
* Adds extra code to a registered script. * Adds extra code to a registered script.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $handle Name of the script to add the inline script to. Must be lowercase. * @param string $handle Name of the script to add the inline script to. Must be lowercase.
* @param string $data String containing the javascript to be added. * @param string $data String containing the javascript to be added.
@ -395,7 +376,6 @@ class WP_Scripts extends WP_Dependencies {
* Prints inline scripts registered for a specific handle. * Prints inline scripts registered for a specific handle.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $handle Name of the script to add the inline script to. Must be lowercase. * @param string $handle Name of the script to add the inline script to. Must be lowercase.
* @param string $position Optional. Whether to add the inline script before the handle * @param string $position Optional. Whether to add the inline script before the handle
@ -424,7 +404,6 @@ class WP_Scripts extends WP_Dependencies {
* Localizes a script, only if the script has already been added. * Localizes a script, only if the script has already been added.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @param string $handle * @param string $handle
* @param string $object_name * @param string $object_name
@ -464,7 +443,6 @@ class WP_Scripts extends WP_Dependencies {
* Sets handle group. * Sets handle group.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @see WP_Dependencies::set_group() * @see WP_Dependencies::set_group()
* *
@ -489,7 +467,6 @@ class WP_Scripts extends WP_Dependencies {
* Determines script dependencies. * Determines script dependencies.
* *
* @since 2.1.0 * @since 2.1.0
* @access public
* *
* @see WP_Dependencies::all_deps() * @see WP_Dependencies::all_deps()
* *
@ -517,7 +494,6 @@ class WP_Scripts extends WP_Dependencies {
* Processes items and dependencies for the head group. * Processes items and dependencies for the head group.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @see WP_Dependencies::do_items() * @see WP_Dependencies::do_items()
* *
@ -532,7 +508,6 @@ class WP_Scripts extends WP_Dependencies {
* Processes items and dependencies for the footer group. * Processes items and dependencies for the footer group.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @see WP_Dependencies::do_items() * @see WP_Dependencies::do_items()
* *
@ -547,7 +522,6 @@ class WP_Scripts extends WP_Dependencies {
* Whether a handle's source is in a default directory. * Whether a handle's source is in a default directory.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param string $src The source of the enqueued script. * @param string $src The source of the enqueued script.
* @return bool True if found, false if not. * @return bool True if found, false if not.
@ -573,7 +547,6 @@ class WP_Scripts extends WP_Dependencies {
* Resets class properties. * Resets class properties.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
*/ */
public function reset() { public function reset() {
$this->do_concat = false; $this->do_concat = false;

19
wp-includes/class.wp-styles.php
View File

@ -22,7 +22,6 @@ class WP_Styles extends WP_Dependencies {
* Full URL with trailing slash. * Full URL with trailing slash.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
* @var string * @var string
*/ */
public $base_url; public $base_url;
@ -31,7 +30,6 @@ class WP_Styles extends WP_Dependencies {
* URL of the content directory. * URL of the content directory.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $content_url; public $content_url;
@ -40,7 +38,6 @@ class WP_Styles extends WP_Dependencies {
* Default version string for stylesheets. * Default version string for stylesheets.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
* @var string * @var string
*/ */
public $default_version; public $default_version;
@ -49,7 +46,6 @@ class WP_Styles extends WP_Dependencies {
* The current text direction. * The current text direction.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
* @var string * @var string
*/ */
public $text_direction = 'ltr'; public $text_direction = 'ltr';
@ -58,7 +54,6 @@ class WP_Styles extends WP_Dependencies {
* Holds a list of style handles which will be concatenated. * Holds a list of style handles which will be concatenated.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $concat = ''; public $concat = '';
@ -68,7 +63,6 @@ class WP_Styles extends WP_Dependencies {
* *
* @since 2.8.0 * @since 2.8.0
* @deprecated 3.4.0 * @deprecated 3.4.0
* @access public
* @var string * @var string
*/ */
public $concat_version = ''; public $concat_version = '';
@ -77,7 +71,6 @@ class WP_Styles extends WP_Dependencies {
* Whether to perform concatenation. * Whether to perform concatenation.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var bool * @var bool
*/ */
public $do_concat = false; public $do_concat = false;
@ -87,7 +80,6 @@ class WP_Styles extends WP_Dependencies {
* is enabled. * is enabled.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var string * @var string
*/ */
public $print_html = ''; public $print_html = '';
@ -96,7 +88,6 @@ class WP_Styles extends WP_Dependencies {
* Holds inline styles if concatenation is enabled. * Holds inline styles if concatenation is enabled.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* @var string * @var string
*/ */
public $print_code = ''; public $print_code = '';
@ -105,7 +96,6 @@ class WP_Styles extends WP_Dependencies {
* List of default directories. * List of default directories.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* @var array * @var array
*/ */
public $default_dirs; public $default_dirs;
@ -114,7 +104,6 @@ class WP_Styles extends WP_Dependencies {
* Constructor. * Constructor.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
*/ */
public function __construct() { public function __construct() {
/** /**
@ -131,7 +120,6 @@ class WP_Styles extends WP_Dependencies {
* Processes a style dependency. * Processes a style dependency.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
* *
* @see WP_Dependencies::do_item() * @see WP_Dependencies::do_item()
* *
@ -246,7 +234,6 @@ class WP_Styles extends WP_Dependencies {
* Adds extra CSS styles to a registered stylesheet. * Adds extra CSS styles to a registered stylesheet.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* *
* @param string $handle The style's registered handle. * @param string $handle The style's registered handle.
* @param string $code String containing the CSS styles to be added. * @param string $code String containing the CSS styles to be added.
@ -271,7 +258,6 @@ class WP_Styles extends WP_Dependencies {
* Prints extra CSS styles of a registered stylesheet. * Prints extra CSS styles of a registered stylesheet.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* *
* @param string $handle The style's registered handle. * @param string $handle The style's registered handle.
* @param bool $echo Optional. Whether to echo the inline style instead of just returning it. * @param bool $echo Optional. Whether to echo the inline style instead of just returning it.
@ -300,7 +286,6 @@ class WP_Styles extends WP_Dependencies {
* Determines style dependencies. * Determines style dependencies.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
* *
* @see WP_Dependencies::all_deps() * @see WP_Dependencies::all_deps()
* *
@ -328,7 +313,6 @@ class WP_Styles extends WP_Dependencies {
* Generates an enqueued style's fully-qualified URL. * Generates an enqueued style's fully-qualified URL.
* *
* @since 2.6.0 * @since 2.6.0
* @access public
* *
* @param string $src The source of the enqueued style. * @param string $src The source of the enqueued style.
* @param string $ver The version of the enqueued style. * @param string $ver The version of the enqueued style.
@ -359,7 +343,6 @@ class WP_Styles extends WP_Dependencies {
* Whether a handle's source is in a default directory. * Whether a handle's source is in a default directory.
* *
* @since 2.8.0 * @since 2.8.0
* @access public
* *
* @param string $src The source of the enqueued style. * @param string $src The source of the enqueued style.
* @return bool True if found, false if not. * @return bool True if found, false if not.
@ -381,7 +364,6 @@ class WP_Styles extends WP_Dependencies {
* HTML 5 allows styles in the body, grab late enqueued items and output them in the footer. * HTML 5 allows styles in the body, grab late enqueued items and output them in the footer.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
* *
* @see WP_Dependencies::do_items() * @see WP_Dependencies::do_items()
* *
@ -396,7 +378,6 @@ class WP_Styles extends WP_Dependencies {
* Resets class properties. * Resets class properties.
* *
* @since 3.3.0 * @since 3.3.0
* @access public
*/ */
public function reset() { public function reset() {
$this->do_concat = false; $this->do_concat = false;

3
wp-includes/customize/class-wp-customize-background-position-control.php
View File

@ -20,7 +20,6 @@ class WP_Customize_Background_Position_Control extends WP_Customize_Control {
* Type. * Type.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string * @var string
*/ */
public $type = 'background_position'; public $type = 'background_position';
@ -29,7 +28,6 @@ class WP_Customize_Background_Position_Control extends WP_Customize_Control {
* Don't render the control content from PHP, as it's rendered via JS on load. * Don't render the control content from PHP, as it's rendered via JS on load.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
*/ */
public function render_content() {} public function render_content() {}
@ -37,7 +35,6 @@ class WP_Customize_Background_Position_Control extends WP_Customize_Control {
* Render a JS template for the content of the position control. * Render a JS template for the content of the position control.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
*/ */
public function content_template() { public function content_template() {
$options = array( $options = array(

3
wp-includes/customize/class-wp-customize-color-control.php
View File

@ -18,7 +18,6 @@ class WP_Customize_Color_Control extends WP_Customize_Control {
/** /**
* Type. * Type.
* *
* @access public
* @var string * @var string
*/ */
public $type = 'color'; public $type = 'color';
@ -26,7 +25,6 @@ class WP_Customize_Color_Control extends WP_Customize_Control {
/** /**
* Statuses. * Statuses.
* *
* @access public
* @var array * @var array
*/ */
public $statuses; public $statuses;
@ -35,7 +33,6 @@ class WP_Customize_Color_Control extends WP_Customize_Control {
* Mode. * Mode.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string * @var string
*/ */
public $mode = 'full'; public $mode = 'full';

7
wp-includes/customize/class-wp-customize-cropped-image-control.php
View File

@ -20,7 +20,6 @@ class WP_Customize_Cropped_Image_Control extends WP_Customize_Image_Control {
* Control type. * Control type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'cropped_image'; public $type = 'cropped_image';
@ -29,7 +28,6 @@ class WP_Customize_Cropped_Image_Control extends WP_Customize_Image_Control {
* Suggested width for cropped image. * Suggested width for cropped image.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var int * @var int
*/ */
public $width = 150; public $width = 150;
@ -38,7 +36,6 @@ class WP_Customize_Cropped_Image_Control extends WP_Customize_Image_Control {
* Suggested height for cropped image. * Suggested height for cropped image.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var int * @var int
*/ */
public $height = 150; public $height = 150;
@ -47,7 +44,6 @@ class WP_Customize_Cropped_Image_Control extends WP_Customize_Image_Control {
* Whether the width is flexible. * Whether the width is flexible.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var bool * @var bool
*/ */
public $flex_width = false; public $flex_width = false;
@ -56,7 +52,6 @@ class WP_Customize_Cropped_Image_Control extends WP_Customize_Image_Control {
* Whether the height is flexible. * Whether the height is flexible.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var bool * @var bool
*/ */
public $flex_height = false; public $flex_height = false;
@ -65,7 +60,6 @@ class WP_Customize_Cropped_Image_Control extends WP_Customize_Image_Control {
* Enqueue control related scripts/styles. * Enqueue control related scripts/styles.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function enqueue() { public function enqueue() {
wp_enqueue_script( 'customize-views' ); wp_enqueue_script( 'customize-views' );
@ -77,7 +71,6 @@ class WP_Customize_Cropped_Image_Control extends WP_Customize_Image_Control {
* Refresh the parameters passed to the JavaScript via JSON. * Refresh the parameters passed to the JavaScript via JSON.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see WP_Customize_Control::to_json() * @see WP_Customize_Control::to_json()
*/ */

14
wp-includes/customize/class-wp-customize-custom-css-setting.php
View File

@ -22,7 +22,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* The setting type. * The setting type.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string * @var string
*/ */
public $type = 'custom_css'; public $type = 'custom_css';
@ -31,7 +30,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* Setting Transport * Setting Transport
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string * @var string
*/ */
public $transport = 'postMessage'; public $transport = 'postMessage';
@ -40,7 +38,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* Capability required to edit this setting. * Capability required to edit this setting.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string * @var string
*/ */
public $capability = 'edit_css'; public $capability = 'edit_css';
@ -49,7 +46,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* Stylesheet * Stylesheet
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @var string * @var string
*/ */
public $stylesheet = ''; public $stylesheet = '';
@ -58,7 +54,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* WP_Customize_Custom_CSS_Setting constructor. * WP_Customize_Custom_CSS_Setting constructor.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @throws Exception If the setting ID does not match the pattern `custom_css[$stylesheet]`. * @throws Exception If the setting ID does not match the pattern `custom_css[$stylesheet]`.
* *
@ -82,7 +77,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* Add filter to preview post value. * Add filter to preview post value.
* *
* @since 4.7.9 * @since 4.7.9
* @access public
* *
* @return bool False when preview short-circuits due no change needing to be previewed. * @return bool False when preview short-circuits due no change needing to be previewed.
*/ */
@ -101,7 +95,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* This is used in the preview when `wp_get_custom_css()` is called for rendering the styles. * This is used in the preview when `wp_get_custom_css()` is called for rendering the styles.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* @see wp_get_custom_css() * @see wp_get_custom_css()
* *
* @param string $css Original CSS. * @param string $css Original CSS.
@ -122,7 +115,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* Fetch the value of the setting. Will return the previewed value when `preview()` is called. * Fetch the value of the setting. Will return the previewed value when `preview()` is called.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* @see WP_Customize_Setting::value() * @see WP_Customize_Setting::value()
* *
* @return string * @return string
@ -159,7 +151,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* @todo There are cases where valid CSS can be incorrectly marked as invalid when strings or comments include balancing characters. To fix, CSS tokenization needs to be used. * @todo There are cases where valid CSS can be incorrectly marked as invalid when strings or comments include balancing characters. To fix, CSS tokenization needs to be used.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param string $css The input string. * @param string $css The input string.
* @return true|WP_Error True if the input was validated, otherwise WP_Error. * @return true|WP_Error True if the input was validated, otherwise WP_Error.
@ -269,7 +260,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* Store the CSS setting value in the custom_css custom post type for the stylesheet. * Store the CSS setting value in the custom_css custom post type for the stylesheet.
* *
* @since 4.7.0 * @since 4.7.0
* @access public
* *
* @param string $css The input value. * @param string $css The input value.
* @return int|false The post ID or false if the value could not be saved. * @return int|false The post ID or false if the value could not be saved.
@ -306,7 +296,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* in the CSS. * in the CSS.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @param string $opening_char The opening character. * @param string $opening_char The opening character.
* @param string $closing_char The closing character. * @param string $closing_char The closing character.
@ -328,7 +317,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* in the CSS. * in the CSS.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @param string $char A character. * @param string $char A character.
* @param string $css The CSS input string. * @param string $css The CSS input string.
@ -347,7 +335,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* @see self::validate() * @see self::validate()
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @param string $css The CSS input string. * @param string $css The CSS input string.
* @return int Count. * @return int Count.
@ -392,7 +379,6 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* using a strict "false === strpos()" comparison. * using a strict "false === strpos()" comparison.
* *
* @since 4.7.0 * @since 4.7.0
* @access private
* *
* @param string $css The CSS input string. * @param string $css The CSS input string.
* @return bool * @return bool

1
wp-includes/customize/class-wp-customize-filter-setting.php
View File

@ -22,7 +22,6 @@ class WP_Customize_Filter_Setting extends WP_Customize_Setting {
* Saves the value of the setting, using the related API. * Saves the value of the setting, using the related API.
* *
* @since 3.4.0 * @since 3.4.0
* @access public
* *
* @param mixed $value The value to update. * @param mixed $value The value to update.
*/ */

3
wp-includes/customize/class-wp-customize-header-image-control.php
View File

@ -41,7 +41,6 @@ class WP_Customize_Header_Image_Control extends WP_Customize_Image_Control {
} }
/** /**
* @access public
*/ */
public function enqueue() { public function enqueue() {
wp_enqueue_media(); wp_enqueue_media();
@ -85,7 +84,6 @@ class WP_Customize_Header_Image_Control extends WP_Customize_Image_Control {
} }
/** /**
* @access public
*/ */
public function print_header_image_template() { public function print_header_image_template() {
?> ?>
@ -157,7 +155,6 @@ class WP_Customize_Header_Image_Control extends WP_Customize_Image_Control {
} }
/** /**
* @access public
*/ */
public function render_content() { public function render_content() {
$this->print_header_image_template(); $this->print_header_image_template();

3
wp-includes/customize/class-wp-customize-media-control.php
View File

@ -19,7 +19,6 @@ class WP_Customize_Media_Control extends WP_Customize_Control {
* Control type. * Control type.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* @var string * @var string
*/ */
public $type = 'media'; public $type = 'media';
@ -28,7 +27,6 @@ class WP_Customize_Media_Control extends WP_Customize_Control {
* Media control mime type. * Media control mime type.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* @var string * @var string
*/ */
public $mime_type = ''; public $mime_type = '';
@ -37,7 +35,6 @@ class WP_Customize_Media_Control extends WP_Customize_Control {
* Button labels. * Button labels.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* @var array * @var array
*/ */
public $button_labels = array(); public $button_labels = array();

3
wp-includes/customize/class-wp-customize-nav-menu-auto-add-control.php
View File

@ -20,7 +20,6 @@ class WP_Customize_Nav_Menu_Auto_Add_Control extends WP_Customize_Control {
* Type of control, used by JS. * Type of control, used by JS.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'nav_menu_auto_add'; public $type = 'nav_menu_auto_add';
@ -29,7 +28,6 @@ class WP_Customize_Nav_Menu_Auto_Add_Control extends WP_Customize_Control {
* No-op since we're using JS template. * No-op since we're using JS template.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
*/ */
protected function render_content() {} protected function render_content() {}
@ -37,7 +35,6 @@ class WP_Customize_Nav_Menu_Auto_Add_Control extends WP_Customize_Control {
* Render the Underscore template for this control. * Render the Underscore template for this control.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
*/ */
protected function content_template() { protected function content_template() {
?> ?>

5
wp-includes/customize/class-wp-customize-nav-menu-control.php
View File

@ -18,7 +18,6 @@ class WP_Customize_Nav_Menu_Control extends WP_Customize_Control {
* Control type. * Control type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'nav_menu'; public $type = 'nav_menu';
@ -27,7 +26,6 @@ class WP_Customize_Nav_Menu_Control extends WP_Customize_Control {
* The nav menu setting. * The nav menu setting.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var WP_Customize_Nav_Menu_Setting * @var WP_Customize_Nav_Menu_Setting
*/ */
public $setting; public $setting;
@ -36,7 +34,6 @@ class WP_Customize_Nav_Menu_Control extends WP_Customize_Control {
* Don't render the control's content - it uses a JS template instead. * Don't render the control's content - it uses a JS template instead.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function render_content() {} public function render_content() {}
@ -44,7 +41,6 @@ class WP_Customize_Nav_Menu_Control extends WP_Customize_Control {
* JS/Underscore template for the control UI. * JS/Underscore template for the control UI.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function content_template() { public function content_template() {
?> ?>
@ -89,7 +85,6 @@ class WP_Customize_Nav_Menu_Control extends WP_Customize_Control {
* Return parameters for this control. * Return parameters for this control.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @return array Exported parameters. * @return array Exported parameters.
*/ */

6
wp-includes/customize/class-wp-customize-nav-menu-item-control.php
View File

@ -18,7 +18,6 @@ class WP_Customize_Nav_Menu_Item_Control extends WP_Customize_Control {
* Control type. * Control type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'nav_menu_item'; public $type = 'nav_menu_item';
@ -27,7 +26,6 @@ class WP_Customize_Nav_Menu_Item_Control extends WP_Customize_Control {
* The nav menu item setting. * The nav menu item setting.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var WP_Customize_Nav_Menu_Item_Setting * @var WP_Customize_Nav_Menu_Item_Setting
*/ */
public $setting; public $setting;
@ -36,7 +34,6 @@ class WP_Customize_Nav_Menu_Item_Control extends WP_Customize_Control {
* Constructor. * Constructor.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see WP_Customize_Control::__construct() * @see WP_Customize_Control::__construct()
* *
@ -52,7 +49,6 @@ class WP_Customize_Nav_Menu_Item_Control extends WP_Customize_Control {
* Don't render the control's content - it's rendered with a JS template. * Don't render the control's content - it's rendered with a JS template.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function render_content() {} public function render_content() {}
@ -60,7 +56,6 @@ class WP_Customize_Nav_Menu_Item_Control extends WP_Customize_Control {
* JS/Underscore template for the control UI. * JS/Underscore template for the control UI.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function content_template() { public function content_template() {
?> ?>
@ -155,7 +150,6 @@ class WP_Customize_Nav_Menu_Item_Control extends WP_Customize_Control {
* Return parameters for this control. * Return parameters for this control.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @return array Exported parameters. * @return array Exported parameters.
*/ */

23
wp-includes/customize/class-wp-customize-nav-menu-item-setting.php
View File

@ -29,7 +29,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Setting type. * Setting type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = self::TYPE; public $type = self::TYPE;
@ -38,7 +37,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Default setting value. * Default setting value.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var array * @var array
* *
* @see wp_setup_nav_menu_item() * @see wp_setup_nav_menu_item()
@ -68,7 +66,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* *
* @since 4.3.0 * @since 4.3.0
* @since 4.5.0 Default changed to 'refresh' * @since 4.5.0 Default changed to 'refresh'
* @access public
* @var string * @var string
*/ */
public $transport = 'refresh'; public $transport = 'refresh';
@ -79,7 +76,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* A negative value represents a placeholder ID for a new menu not yet saved. * A negative value represents a placeholder ID for a new menu not yet saved.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var int * @var int
*/ */
public $post_id; public $post_id;
@ -88,7 +84,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Storage of pre-setup menu item to prevent wasted calls to wp_setup_nav_menu_item(). * Storage of pre-setup menu item to prevent wasted calls to wp_setup_nav_menu_item().
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* @var array * @var array
*/ */
protected $value; protected $value;
@ -102,7 +97,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* a real post. * a real post.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var int * @var int
* *
* @see WP_Customize_Nav_Menu_Item_Setting::update() * @see WP_Customize_Nav_Menu_Item_Setting::update()
@ -115,7 +109,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* which ensures that we can apply the proper filters. * which ensures that we can apply the proper filters.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var int * @var int
*/ */
public $original_nav_menu_term_id; public $original_nav_menu_term_id;
@ -124,7 +117,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Whether or not update() was called. * Whether or not update() was called.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* @var bool * @var bool
*/ */
protected $is_updated = false; protected $is_updated = false;
@ -138,7 +130,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* When status is error, the error is stored in $update_error. * When status is error, the error is stored in $update_error.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string updated|inserted|deleted|error * @var string updated|inserted|deleted|error
* *
* @see WP_Customize_Nav_Menu_Item_Setting::update() * @see WP_Customize_Nav_Menu_Item_Setting::update()
@ -150,7 +141,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Any error object returned by wp_update_nav_menu_item() when setting is updated. * Any error object returned by wp_update_nav_menu_item() when setting is updated.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var WP_Error * @var WP_Error
* *
* @see WP_Customize_Nav_Menu_Item_Setting::update() * @see WP_Customize_Nav_Menu_Item_Setting::update()
@ -164,7 +154,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Any supplied $args override class property defaults. * Any supplied $args override class property defaults.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param WP_Customize_Manager $manager Bootstrap Customizer instance. * @param WP_Customize_Manager $manager Bootstrap Customizer instance.
* @param string $id An specific ID of the setting. Can be a * @param string $id An specific ID of the setting. Can be a
@ -201,7 +190,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Clear the cached value when this nav menu item is updated. * Clear the cached value when this nav menu item is updated.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param int $menu_id The term ID for the menu. * @param int $menu_id The term ID for the menu.
* @param int $menu_item_id The post ID for the menu item. * @param int $menu_item_id The post ID for the menu item.
@ -217,7 +205,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Get the instance data for a given nav_menu_item setting. * Get the instance data for a given nav_menu_item setting.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see wp_setup_nav_menu_item() * @see wp_setup_nav_menu_item()
* *
@ -274,7 +261,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Get original title. * Get original title.
* *
* @since 4.7.0 * @since 4.7.0
* @access protected
* *
* @param object $item Nav menu item. * @param object $item Nav menu item.
* @return string The original title. * @return string The original title.
@ -311,7 +297,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Get type label. * Get type label.
* *
* @since 4.7.0 * @since 4.7.0
* @access protected
* *
* @param object $item Nav menu item. * @param object $item Nav menu item.
* @returns string The type label. * @returns string The type label.
@ -345,7 +330,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Translates some properties added by wp_setup_nav_menu_item() and removes others. * Translates some properties added by wp_setup_nav_menu_item() and removes others.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* *
* @see WP_Customize_Nav_Menu_Item_Setting::value() * @see WP_Customize_Nav_Menu_Item_Setting::value()
*/ */
@ -441,7 +425,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* *
* @since 4.3.0 * @since 4.3.0
* @since 4.4.0 Added boolean return value. * @since 4.4.0 Added boolean return value.
* @access public
* *
* @see WP_Customize_Manager::post_value() * @see WP_Customize_Manager::post_value()
* *
@ -480,7 +463,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Filters the wp_get_nav_menu_items() result to supply the previewed menu items. * Filters the wp_get_nav_menu_items() result to supply the previewed menu items.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see wp_get_nav_menu_items() * @see wp_get_nav_menu_items()
* *
@ -554,7 +536,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Re-apply the tail logic also applied on $items by wp_get_nav_menu_items(). * Re-apply the tail logic also applied on $items by wp_get_nav_menu_items().
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @static * @static
* *
* @see wp_get_nav_menu_items() * @see wp_get_nav_menu_items()
@ -591,7 +572,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Get the value emulated into a WP_Post and set up as a nav_menu_item. * Get the value emulated into a WP_Post and set up as a nav_menu_item.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @return WP_Post With wp_setup_nav_menu_item() applied. * @return WP_Post With wp_setup_nav_menu_item() applied.
*/ */
@ -659,7 +639,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* we remove that in this override. * we remove that in this override.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param array $menu_item_value The value to sanitize. * @param array $menu_item_value The value to sanitize.
* @return array|false|null Null if an input isn't valid. False if it is marked for deletion. * @return array|false|null Null if an input isn't valid. False if it is marked for deletion.
@ -743,7 +722,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* To delete a menu, the client can send false as the value. * To delete a menu, the client can send false as the value.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* *
* @see wp_update_nav_menu_item() * @see wp_update_nav_menu_item()
* *
@ -878,7 +856,6 @@ class WP_Customize_Nav_Menu_Item_Setting extends WP_Customize_Setting {
* Export data for the JS client. * Export data for the JS client.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see WP_Customize_Nav_Menu_Item_Setting::update() * @see WP_Customize_Nav_Menu_Item_Setting::update()
* *

4
wp-includes/customize/class-wp-customize-nav-menu-location-control.php
View File

@ -22,7 +22,6 @@ class WP_Customize_Nav_Menu_Location_Control extends WP_Customize_Control {
* Control type. * Control type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'nav_menu_location'; public $type = 'nav_menu_location';
@ -31,7 +30,6 @@ class WP_Customize_Nav_Menu_Location_Control extends WP_Customize_Control {
* Location ID. * Location ID.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $location_id = ''; public $location_id = '';
@ -40,7 +38,6 @@ class WP_Customize_Nav_Menu_Location_Control extends WP_Customize_Control {
* Refresh the parameters passed to JavaScript via JSON. * Refresh the parameters passed to JavaScript via JSON.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see WP_Customize_Control::to_json() * @see WP_Customize_Control::to_json()
*/ */
@ -53,7 +50,6 @@ class WP_Customize_Nav_Menu_Location_Control extends WP_Customize_Control {
* Render content just like a normal select control. * Render content just like a normal select control.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function render_content() { public function render_content() {
if ( empty( $this->choices ) ) { if ( empty( $this->choices ) ) {

3
wp-includes/customize/class-wp-customize-nav-menu-name-control.php
View File

@ -20,7 +20,6 @@ class WP_Customize_Nav_Menu_Name_Control extends WP_Customize_Control {
* Type of control, used by JS. * Type of control, used by JS.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'nav_menu_name'; public $type = 'nav_menu_name';
@ -29,7 +28,6 @@ class WP_Customize_Nav_Menu_Name_Control extends WP_Customize_Control {
* No-op since we're using JS template. * No-op since we're using JS template.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
*/ */
protected function render_content() {} protected function render_content() {}
@ -37,7 +35,6 @@ class WP_Customize_Nav_Menu_Name_Control extends WP_Customize_Control {
* Render the Underscore template for this control. * Render the Underscore template for this control.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
*/ */
protected function content_template() { protected function content_template() {
?> ?>

2
wp-includes/customize/class-wp-customize-nav-menu-section.php
View File

@ -22,7 +22,6 @@ class WP_Customize_Nav_Menu_Section extends WP_Customize_Section {
* Control type. * Control type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'nav_menu'; public $type = 'nav_menu';
@ -31,7 +30,6 @@ class WP_Customize_Nav_Menu_Section extends WP_Customize_Section {
* Get section parameters for JS. * Get section parameters for JS.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @return array Exported parameters. * @return array Exported parameters.
*/ */
public function json() { public function json() {

21
wp-includes/customize/class-wp-customize-nav-menu-setting.php
View File

@ -30,7 +30,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Setting type. * Setting type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = self::TYPE; public $type = self::TYPE;
@ -39,7 +38,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Default setting value. * Default setting value.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var array * @var array
* *
* @see wp_get_nav_menu_object() * @see wp_get_nav_menu_object()
@ -55,7 +53,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Default transport. * Default transport.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $transport = 'postMessage'; public $transport = 'postMessage';
@ -66,7 +63,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* A negative value represents a placeholder ID for a new menu not yet saved. * A negative value represents a placeholder ID for a new menu not yet saved.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var int * @var int
*/ */
public $term_id; public $term_id;
@ -80,7 +76,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* a real term. * a real term.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var int * @var int
* *
* @see WP_Customize_Nav_Menu_Setting::update() * @see WP_Customize_Nav_Menu_Setting::update()
@ -92,7 +87,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Whether or not update() was called. * Whether or not update() was called.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* @var bool * @var bool
*/ */
protected $is_updated = false; protected $is_updated = false;
@ -106,7 +100,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* When status is error, the error is stored in `$update_error`. * When status is error, the error is stored in `$update_error`.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string updated|inserted|deleted|error * @var string updated|inserted|deleted|error
* *
* @see WP_Customize_Nav_Menu_Setting::update() * @see WP_Customize_Nav_Menu_Setting::update()
@ -118,7 +111,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Any error object returned by wp_update_nav_menu_object() when setting is updated. * Any error object returned by wp_update_nav_menu_object() when setting is updated.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var WP_Error * @var WP_Error
* *
* @see WP_Customize_Nav_Menu_Setting::update() * @see WP_Customize_Nav_Menu_Setting::update()
@ -132,7 +124,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Any supplied $args override class property defaults. * Any supplied $args override class property defaults.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param WP_Customize_Manager $manager Bootstrap Customizer instance. * @param WP_Customize_Manager $manager Bootstrap Customizer instance.
* @param string $id An specific ID of the setting. Can be a * @param string $id An specific ID of the setting. Can be a
@ -159,7 +150,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Get the instance data for a given widget setting. * Get the instance data for a given widget setting.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see wp_get_nav_menu_object() * @see wp_get_nav_menu_object()
* *
@ -206,7 +196,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* *
* @since 4.3.0 * @since 4.3.0
* @since 4.4.0 Added boolean return value * @since 4.4.0 Added boolean return value
* @access public
* *
* @see WP_Customize_Manager::post_value() * @see WP_Customize_Manager::post_value()
* *
@ -240,7 +229,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Filters the wp_get_nav_menus() result to ensure the inserted menu object is included, and the deleted one is removed. * Filters the wp_get_nav_menus() result to ensure the inserted menu object is included, and the deleted one is removed.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see wp_get_nav_menus() * @see wp_get_nav_menus()
* *
@ -300,7 +288,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Temporary non-closure passing of orderby value to function. * Temporary non-closure passing of orderby value to function.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* @var string * @var string
* *
* @see WP_Customize_Nav_Menu_Setting::filter_wp_get_nav_menus() * @see WP_Customize_Nav_Menu_Setting::filter_wp_get_nav_menus()
@ -315,7 +302,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* *
* @since 4.3.0 * @since 4.3.0
* @deprecated 4.7.0 Use wp_list_sort() * @deprecated 4.7.0 Use wp_list_sort()
* @access protected
* *
* @param object $menu1 * @param object $menu1
* @param object $menu2 * @param object $menu2
@ -336,7 +322,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Requesting a nav_menu object by anything but ID is not supported. * Requesting a nav_menu object by anything but ID is not supported.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see wp_get_nav_menu_object() * @see wp_get_nav_menu_object()
* *
@ -385,7 +370,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Filters the nav_menu_options option to include this menu's auto_add preference. * Filters the nav_menu_options option to include this menu's auto_add preference.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param array $nav_menu_options Nav menu options including auto_add. * @param array $nav_menu_options Nav menu options including auto_add.
* @return array (Kaybe) modified nav menu options. * @return array (Kaybe) modified nav menu options.
@ -412,7 +396,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* we remove that in this override. * we remove that in this override.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param array $value The value to sanitize. * @param array $value The value to sanitize.
* @return array|false|null Null if an input isn't valid. False if it is marked for deletion. * @return array|false|null Null if an input isn't valid. False if it is marked for deletion.
@ -456,7 +439,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* *
* See {@see 'customize_save_response'}. * See {@see 'customize_save_response'}.
* *
* @access protected
* @since 4.3.0 * @since 4.3.0
* @var array * @var array
* *
@ -474,7 +456,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* To delete a menu, the client can send false as the value. * To delete a menu, the client can send false as the value.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* *
* @see wp_update_nav_menu_object() * @see wp_update_nav_menu_object()
* *
@ -597,7 +578,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Updates a nav_menu_options array. * Updates a nav_menu_options array.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* *
* @see WP_Customize_Nav_Menu_Setting::filter_nav_menu_options() * @see WP_Customize_Nav_Menu_Setting::filter_nav_menu_options()
* @see WP_Customize_Nav_Menu_Setting::update() * @see WP_Customize_Nav_Menu_Setting::update()
@ -627,7 +607,6 @@ class WP_Customize_Nav_Menu_Setting extends WP_Customize_Setting {
* Export data for the JS client. * Export data for the JS client.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @see WP_Customize_Nav_Menu_Setting::update() * @see WP_Customize_Nav_Menu_Setting::update()
* *

3
wp-includes/customize/class-wp-customize-nav-menus-panel.php
View File

@ -22,7 +22,6 @@ class WP_Customize_Nav_Menus_Panel extends WP_Customize_Panel {
* Control type. * Control type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'nav_menus'; public $type = 'nav_menus';
@ -31,7 +30,6 @@ class WP_Customize_Nav_Menus_Panel extends WP_Customize_Panel {
* Render screen options for Menus. * Render screen options for Menus.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function render_screen_options() { public function render_screen_options() {
// Adds the screen options. // Adds the screen options.
@ -64,7 +62,6 @@ class WP_Customize_Nav_Menus_Panel extends WP_Customize_Panel {
* export custom variables by overriding WP_Customize_Panel::json(). * export custom variables by overriding WP_Customize_Panel::json().
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
* *
* @see WP_Customize_Panel::print_template() * @see WP_Customize_Panel::print_template()
*/ */

2
wp-includes/customize/class-wp-customize-new-menu-control.php
View File

@ -20,7 +20,6 @@ class WP_Customize_New_Menu_Control extends WP_Customize_Control {
* Control type. * Control type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'new_menu'; public $type = 'new_menu';
@ -29,7 +28,6 @@ class WP_Customize_New_Menu_Control extends WP_Customize_Control {
* Render the control's content. * Render the control's content.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
*/ */
public function render_content() { public function render_content() {
?> ?>

2
wp-includes/customize/class-wp-customize-new-menu-section.php
View File

@ -22,7 +22,6 @@ class WP_Customize_New_Menu_Section extends WP_Customize_Section {
* Control type. * Control type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'new_menu'; public $type = 'new_menu';
@ -31,7 +30,6 @@ class WP_Customize_New_Menu_Section extends WP_Customize_Section {
* Render the section, and the controls that have been added to it. * Render the section, and the controls that have been added to it.
* *
* @since 4.3.0 * @since 4.3.0
* @access protected
*/ */
protected function render() { protected function render() {
?> ?>

17
wp-includes/customize/class-wp-customize-partial.php
View File

@ -22,7 +22,6 @@ class WP_Customize_Partial {
* Component. * Component.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var WP_Customize_Selective_Refresh * @var WP_Customize_Selective_Refresh
*/ */
public $component; public $component;
@ -34,7 +33,6 @@ class WP_Customize_Partial {
* be the same as the associated setting's ID. * be the same as the associated setting's ID.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $id; public $id;
@ -43,7 +41,6 @@ class WP_Customize_Partial {
* Parsed ID. * Parsed ID.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var array { * @var array {
* @type string $base ID base. * @type string $base ID base.
* @type array $keys Keys for multidimensional. * @type array $keys Keys for multidimensional.
@ -55,7 +52,6 @@ class WP_Customize_Partial {
* Type of this partial. * Type of this partial.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $type = 'default'; public $type = 'default';
@ -64,7 +60,6 @@ class WP_Customize_Partial {
* The jQuery selector to find the container element for the partial. * The jQuery selector to find the container element for the partial.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $selector; public $selector;
@ -72,7 +67,6 @@ class WP_Customize_Partial {
/** /**
* IDs for settings tied to the partial. * IDs for settings tied to the partial.
* *
* @access public
* @since 4.5.0 * @since 4.5.0
* @var array * @var array
*/ */
@ -84,7 +78,6 @@ class WP_Customize_Partial {
* If not supplied, it will default to the ID of the first setting. * If not supplied, it will default to the ID of the first setting.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $primary_setting; public $primary_setting;
@ -96,7 +89,6 @@ class WP_Customize_Partial {
* of the associated `$settings`. * of the associated `$settings`.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var string * @var string
*/ */
public $capability; public $capability;
@ -105,7 +97,6 @@ class WP_Customize_Partial {
* Render callback. * Render callback.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @see WP_Customize_Partial::render() * @see WP_Customize_Partial::render()
* @var callable Callback is called with one argument, the instance of * @var callable Callback is called with one argument, the instance of
* WP_Customize_Partial. The callback can either echo the * WP_Customize_Partial. The callback can either echo the
@ -117,7 +108,6 @@ class WP_Customize_Partial {
* Whether the container element is included in the partial, or if only the contents are rendered. * Whether the container element is included in the partial, or if only the contents are rendered.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var bool * @var bool
*/ */
public $container_inclusive = false; public $container_inclusive = false;
@ -128,7 +118,6 @@ class WP_Customize_Partial {
* A partial render is considered a failure if the render_callback returns false. * A partial render is considered a failure if the render_callback returns false.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var bool * @var bool
*/ */
public $fallback_refresh = true; public $fallback_refresh = true;
@ -141,7 +130,6 @@ class WP_Customize_Partial {
* If `$args['settings']` is not defined, use the $id as the setting ID. * If `$args['settings']` is not defined, use the $id as the setting ID.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param WP_Customize_Selective_Refresh $component Customize Partial Refresh plugin instance. * @param WP_Customize_Selective_Refresh $component Customize Partial Refresh plugin instance.
* @param string $id Control ID. * @param string $id Control ID.
@ -184,7 +172,6 @@ class WP_Customize_Partial {
* Retrieves parsed ID data for multidimensional setting. * Retrieves parsed ID data for multidimensional setting.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @return array { * @return array {
* ID data for multidimensional partial. * ID data for multidimensional partial.
@ -201,7 +188,6 @@ class WP_Customize_Partial {
* Renders the template partial involving the associated settings. * Renders the template partial involving the associated settings.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param array $container_context Optional. Array of context data associated with the target container (placement). * @param array $container_context Optional. Array of context data associated with the target container (placement).
* Default empty array. * Default empty array.
@ -270,7 +256,6 @@ class WP_Customize_Partial {
* applying to client-side templating. * applying to client-side templating.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param WP_Customize_Partial $partial Partial. * @param WP_Customize_Partial $partial Partial.
* @param array $context Context. * @param array $context Context.
@ -285,7 +270,6 @@ class WP_Customize_Partial {
* Retrieves the data to export to the client via JSON. * Retrieves the data to export to the client via JSON.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @return array Array of parameters passed to the JavaScript. * @return array Array of parameters passed to the JavaScript.
*/ */
@ -308,7 +292,6 @@ class WP_Customize_Partial {
* or if one of the associated settings does not exist. * or if one of the associated settings does not exist.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @return bool False if user can't edit one one of the related settings, * @return bool False if user can't edit one one of the related settings,
* or if one of the associated settings does not exist. * or if one of the associated settings does not exist.

15
wp-includes/customize/class-wp-customize-selective-refresh.php
View File

@ -25,7 +25,6 @@ final class WP_Customize_Selective_Refresh {
* Customize manager. * Customize manager.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* @var WP_Customize_Manager * @var WP_Customize_Manager
*/ */
public $manager; public $manager;
@ -34,7 +33,6 @@ final class WP_Customize_Selective_Refresh {
* Registered instances of WP_Customize_Partial. * Registered instances of WP_Customize_Partial.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var WP_Customize_Partial[] * @var WP_Customize_Partial[]
*/ */
protected $partials = array(); protected $partials = array();
@ -43,7 +41,6 @@ final class WP_Customize_Selective_Refresh {
* Log of errors triggered when partials are rendered. * Log of errors triggered when partials are rendered.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var array * @var array
*/ */
protected $triggered_errors = array(); protected $triggered_errors = array();
@ -52,7 +49,6 @@ final class WP_Customize_Selective_Refresh {
* Keep track of the current partial being rendered. * Keep track of the current partial being rendered.
* *
* @since 4.5.0 * @since 4.5.0
* @access protected
* @var string * @var string
*/ */
protected $current_partial_id; protected $current_partial_id;
@ -61,7 +57,6 @@ final class WP_Customize_Selective_Refresh {
* Plugin bootstrap for Partial Refresh functionality. * Plugin bootstrap for Partial Refresh functionality.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param WP_Customize_Manager $manager Manager instance. * @param WP_Customize_Manager $manager Manager instance.
*/ */
@ -76,7 +71,6 @@ final class WP_Customize_Selective_Refresh {
* Retrieves the registered partials. * Retrieves the registered partials.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @return array Partials. * @return array Partials.
*/ */
@ -136,7 +130,6 @@ final class WP_Customize_Selective_Refresh {
* Retrieves a partial. * Retrieves a partial.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $id Customize Partial ID. * @param string $id Customize Partial ID.
* @return WP_Customize_Partial|null The partial, if set. Otherwise null. * @return WP_Customize_Partial|null The partial, if set. Otherwise null.
@ -153,7 +146,6 @@ final class WP_Customize_Selective_Refresh {
* Removes a partial. * Removes a partial.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $id Customize Partial ID. * @param string $id Customize Partial ID.
*/ */
@ -165,7 +157,6 @@ final class WP_Customize_Selective_Refresh {
* Initializes the Customizer preview. * Initializes the Customizer preview.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
*/ */
public function init_preview() { public function init_preview() {
add_action( 'template_redirect', array( $this, 'handle_render_partials_request' ) ); add_action( 'template_redirect', array( $this, 'handle_render_partials_request' ) );
@ -176,7 +167,6 @@ final class WP_Customize_Selective_Refresh {
* Enqueues preview scripts. * Enqueues preview scripts.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
*/ */
public function enqueue_preview_scripts() { public function enqueue_preview_scripts() {
wp_enqueue_script( 'customize-selective-refresh' ); wp_enqueue_script( 'customize-selective-refresh' );
@ -187,7 +177,6 @@ final class WP_Customize_Selective_Refresh {
* Exports data in preview after it has finished rendering so that partials can be added at runtime. * Exports data in preview after it has finished rendering so that partials can be added at runtime.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
*/ */
public function export_preview_data() { public function export_preview_data() {
$partials = array(); $partials = array();
@ -226,7 +215,6 @@ final class WP_Customize_Selective_Refresh {
* Registers dynamically-created partials. * Registers dynamically-created partials.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @see WP_Customize_Manager::add_dynamic_settings() * @see WP_Customize_Manager::add_dynamic_settings()
* *
@ -292,7 +280,6 @@ final class WP_Customize_Selective_Refresh {
* just that essentially the route is a match. * just that essentially the route is a match.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @return bool Whether the request is for rendering partials. * @return bool Whether the request is for rendering partials.
*/ */
@ -306,7 +293,6 @@ final class WP_Customize_Selective_Refresh {
* These errors will be relayed back to the client in the Ajax response. * These errors will be relayed back to the client in the Ajax response.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param int $errno Error number. * @param int $errno Error number.
* @param string $errstr Error string. * @param string $errstr Error string.
@ -329,7 +315,6 @@ final class WP_Customize_Selective_Refresh {
* Handles the Ajax request to return the rendered partials for the requested placements. * Handles the Ajax request to return the rendered partials for the requested placements.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
*/ */
public function handle_render_partials_request() { public function handle_render_partials_request() {
if ( ! $this->is_render_partials_request() ) { if ( ! $this->is_render_partials_request() ) {

3
wp-includes/customize/class-wp-customize-sidebar-section.php
View File

@ -20,7 +20,6 @@ class WP_Customize_Sidebar_Section extends WP_Customize_Section {
* Type of this section. * Type of this section.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $type = 'sidebar'; public $type = 'sidebar';
@ -29,7 +28,6 @@ class WP_Customize_Sidebar_Section extends WP_Customize_Section {
* Unique identifier. * Unique identifier.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var string * @var string
*/ */
public $sidebar_id; public $sidebar_id;
@ -51,7 +49,6 @@ class WP_Customize_Sidebar_Section extends WP_Customize_Section {
* Whether the current sidebar is rendered on the page. * Whether the current sidebar is rendered on the page.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @return bool Whether sidebar is rendered. * @return bool Whether sidebar is rendered.
*/ */

3
wp-includes/customize/class-wp-customize-site-icon-control.php
View File

@ -22,7 +22,6 @@ class WP_Customize_Site_Icon_Control extends WP_Customize_Cropped_Image_Control
* Control type. * Control type.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* @var string * @var string
*/ */
public $type = 'site_icon'; public $type = 'site_icon';
@ -31,7 +30,6 @@ class WP_Customize_Site_Icon_Control extends WP_Customize_Cropped_Image_Control
* Constructor. * Constructor.
* *
* @since 4.3.0 * @since 4.3.0
* @access public
* *
* @param WP_Customize_Manager $manager Customizer bootstrap instance. * @param WP_Customize_Manager $manager Customizer bootstrap instance.
* @param string $id Control ID. * @param string $id Control ID.
@ -46,7 +44,6 @@ class WP_Customize_Site_Icon_Control extends WP_Customize_Cropped_Image_Control
* Renders a JS template for the content of the site icon control. * Renders a JS template for the content of the site icon control.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
*/ */
public function content_template() { public function content_template() {
?> ?>

5
wp-includes/customize/class-wp-customize-theme-control.php
View File

@ -20,7 +20,6 @@ class WP_Customize_Theme_Control extends WP_Customize_Control {
* Customize control type. * Customize control type.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* @var string * @var string
*/ */
public $type = 'theme'; public $type = 'theme';
@ -29,7 +28,6 @@ class WP_Customize_Theme_Control extends WP_Customize_Control {
* Theme object. * Theme object.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* @var WP_Theme * @var WP_Theme
*/ */
public $theme; public $theme;
@ -38,7 +36,6 @@ class WP_Customize_Theme_Control extends WP_Customize_Control {
* Refresh the parameters passed to the JavaScript via JSON. * Refresh the parameters passed to the JavaScript via JSON.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* *
* @see WP_Customize_Control::to_json() * @see WP_Customize_Control::to_json()
*/ */
@ -51,7 +48,6 @@ class WP_Customize_Theme_Control extends WP_Customize_Control {
* Don't render the control content from PHP, as it's rendered via JS on load. * Don't render the control content from PHP, as it's rendered via JS on load.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
*/ */
public function render_content() {} public function render_content() {}
@ -59,7 +55,6 @@ class WP_Customize_Theme_Control extends WP_Customize_Control {
* Render a JS template for theme display. * Render a JS template for theme display.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
*/ */
public function content_template() { public function content_template() {
$current_url = set_url_scheme( 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'] ); $current_url = set_url_scheme( 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'] );

2
wp-includes/customize/class-wp-customize-themes-section.php
View File

@ -22,7 +22,6 @@ class WP_Customize_Themes_Section extends WP_Customize_Section {
* Customize section type. * Customize section type.
* *
* @since 4.2.0 * @since 4.2.0
* @access public
* @var string * @var string
*/ */
public $type = 'themes'; public $type = 'themes';
@ -31,7 +30,6 @@ class WP_Customize_Themes_Section extends WP_Customize_Section {
* Render the themes section, which behaves like a panel. * Render the themes section, which behaves like a panel.
* *
* @since 4.2.0 * @since 4.2.0
* @access protected
*/ */
protected function render() { protected function render() {
$classes = 'accordion-section control-section control-section-' . $this->type; $classes = 'accordion-section control-section control-section-' . $this->type;

4
wp-includes/customize/class-wp-widget-area-customize-control.php
View File

@ -20,7 +20,6 @@ class WP_Widget_Area_Customize_Control extends WP_Customize_Control {
* Customize control type. * Customize control type.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* @var string * @var string
*/ */
public $type = 'sidebar_widgets'; public $type = 'sidebar_widgets';
@ -29,7 +28,6 @@ class WP_Widget_Area_Customize_Control extends WP_Customize_Control {
* Sidebar ID. * Sidebar ID.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* @var int|string * @var int|string
*/ */
public $sidebar_id; public $sidebar_id;
@ -38,7 +36,6 @@ class WP_Widget_Area_Customize_Control extends WP_Customize_Control {
* Refreshes the parameters passed to the JavaScript via JSON. * Refreshes the parameters passed to the JavaScript via JSON.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function to_json() { public function to_json() {
parent::to_json(); parent::to_json();
@ -52,7 +49,6 @@ class WP_Widget_Area_Customize_Control extends WP_Customize_Control {
* Renders the control's content. * Renders the control's content.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function render_content() { public function render_content() {
$id = 'reorder-widgets-desc-' . str_replace( array( '[', ']' ), array( '-', '' ), $this->id ); $id = 'reorder-widgets-desc-' . str_replace( array( '[', ']' ), array( '-', '' ), $this->id );

3
wp-includes/customize/class-wp-widget-form-customize-control.php
View File

@ -28,7 +28,6 @@ class WP_Widget_Form_Customize_Control extends WP_Customize_Control {
* Gather control params for exporting to JavaScript. * Gather control params for exporting to JavaScript.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
* *
* @global array $wp_registered_widgets * @global array $wp_registered_widgets
*/ */
@ -65,7 +64,6 @@ class WP_Widget_Form_Customize_Control extends WP_Customize_Control {
* Override render_content to be no-op since content is exported via to_json for deferred embedding. * Override render_content to be no-op since content is exported via to_json for deferred embedding.
* *
* @since 3.9.0 * @since 3.9.0
* @access public
*/ */
public function render_content() {} public function render_content() {}
@ -73,7 +71,6 @@ class WP_Widget_Form_Customize_Control extends WP_Customize_Control {
* Whether the current widget is rendered on the page. * Whether the current widget is rendered on the page.
* *
* @since 4.0.0 * @since 4.0.0
* @access public
* *
* @return bool Whether the widget is rendered. * @return bool Whether the widget is rendered.
*/ */

19
wp-includes/date.php
View File

@ -21,7 +21,6 @@ class WP_Date_Query {
* See WP_Date_Query::__construct() for information on date query arguments. * See WP_Date_Query::__construct() for information on date query arguments.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* @var array * @var array
*/ */
public $queries = array(); public $queries = array();
@ -30,7 +29,6 @@ class WP_Date_Query {
* The default relation between top-level queries. Can be either 'AND' or 'OR'. * The default relation between top-level queries. Can be either 'AND' or 'OR'.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* @var string * @var string
*/ */
public $relation = 'AND'; public $relation = 'AND';
@ -39,7 +37,6 @@ class WP_Date_Query {
* The column to query against. Can be changed via the query arguments. * The column to query against. Can be changed via the query arguments.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* @var string * @var string
*/ */
public $column = 'post_date'; public $column = 'post_date';
@ -48,7 +45,6 @@ class WP_Date_Query {
* The value comparison operator. Can be changed via the query arguments. * The value comparison operator. Can be changed via the query arguments.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* @var array * @var array
*/ */
public $compare = '='; public $compare = '=';
@ -57,7 +53,6 @@ class WP_Date_Query {
* Supported time-related parameter keys. * Supported time-related parameter keys.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* @var array * @var array
*/ */
public $time_keys = array( 'after', 'before', 'year', 'month', 'monthnum', 'week', 'w', 'dayofyear', 'day', 'dayofweek', 'dayofweek_iso', 'hour', 'minute', 'second' ); public $time_keys = array( 'after', 'before', 'year', 'month', 'monthnum', 'week', 'w', 'dayofyear', 'day', 'dayofweek', 'dayofweek_iso', 'hour', 'minute', 'second' );
@ -73,7 +68,6 @@ class WP_Date_Query {
* @since 3.7.0 * @since 3.7.0
* @since 4.0.0 The $inclusive logic was updated to include all times within the date range. * @since 4.0.0 The $inclusive logic was updated to include all times within the date range.
* @since 4.1.0 Introduced 'dayofweek_iso' time type parameter. * @since 4.1.0 Introduced 'dayofweek_iso' time type parameter.
* @access public
* *
* @param array $date_query { * @param array $date_query {
* Array of date query clauses. * Array of date query clauses.
@ -191,7 +185,6 @@ class WP_Date_Query {
* `$defaults`. * `$defaults`.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @param array $queries * @param array $queries
* @param array $parent_query * @param array $parent_query
@ -252,7 +245,6 @@ class WP_Date_Query {
* If so, it's first-order. * If so, it's first-order.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @param array $query Query clause. * @param array $query Query clause.
* @return bool True if this is a first-order clause. * @return bool True if this is a first-order clause.
@ -266,7 +258,6 @@ class WP_Date_Query {
* Determines and validates what comparison operator to use. * Determines and validates what comparison operator to use.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* *
* @param array $query A date query or a date subquery. * @param array $query A date query or a date subquery.
* @return string The comparison operator. * @return string The comparison operator.
@ -286,7 +277,6 @@ class WP_Date_Query {
* This method only generates debug notices for these cases. * This method only generates debug notices for these cases.
* *
* @since 4.1.0 * @since 4.1.0
* @access public
* *
* @param array $date_query The date_query array. * @param array $date_query The date_query array.
* @return bool True if all values in the query are valid, false if one or more fail. * @return bool True if all values in the query are valid, false if one or more fail.
@ -482,7 +472,6 @@ class WP_Date_Query {
* and are only sanitized to remove illegal characters. * and are only sanitized to remove illegal characters.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* *
* @param string $column The user-supplied column name. * @param string $column The user-supplied column name.
* @return string A validated column name value. * @return string A validated column name value.
@ -551,7 +540,6 @@ class WP_Date_Query {
* Generate WHERE clause to be appended to a main query. * Generate WHERE clause to be appended to a main query.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* *
* @return string MySQL WHERE clause. * @return string MySQL WHERE clause.
*/ */
@ -578,7 +566,6 @@ class WP_Date_Query {
* out to maintain parity with the other Query classes. * out to maintain parity with the other Query classes.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @return array { * @return array {
* Array containing JOIN and WHERE SQL clauses to append to the main query. * Array containing JOIN and WHERE SQL clauses to append to the main query.
@ -604,7 +591,6 @@ class WP_Date_Query {
* produce the properly nested SQL. * produce the properly nested SQL.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @param array $query Query to parse. * @param array $query Query to parse.
* @param int $depth Optional. Number of tree levels deep we currently are. * @param int $depth Optional. Number of tree levels deep we currently are.
@ -689,7 +675,6 @@ class WP_Date_Query {
* compatibility while retaining the naming convention across Query classes. * compatibility while retaining the naming convention across Query classes.
* *
* @since 3.7.0 * @since 3.7.0
* @access protected
* *
* @param array $query Date query arguments. * @param array $query Date query arguments.
* @return array { * @return array {
@ -707,7 +692,6 @@ class WP_Date_Query {
* Turns a first-order date query into SQL for a WHERE clause. * Turns a first-order date query into SQL for a WHERE clause.
* *
* @since 4.1.0 * @since 4.1.0
* @access protected
* *
* @param array $query Date query clause. * @param array $query Date query clause.
* @param array $parent_query Parent query of the current date query. * @param array $parent_query Parent query of the current date query.
@ -802,7 +786,6 @@ class WP_Date_Query {
* Builds and validates a value string based on the comparison operator. * Builds and validates a value string based on the comparison operator.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* *
* @param string $compare The compare operator to use * @param string $compare The compare operator to use
* @param string|array $value The value * @param string|array $value The value
@ -862,7 +845,6 @@ class WP_Date_Query {
* pass a string that will be run through strtotime(). * pass a string that will be run through strtotime().
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* *
* @param string|array $datetime An array of parameters or a strotime() string * @param string|array $datetime An array of parameters or a strotime() string
* @param bool $default_to_max Whether to round up incomplete dates. Supported by values * @param bool $default_to_max Whether to round up incomplete dates. Supported by values
@ -950,7 +932,6 @@ class WP_Date_Query {
* in order to be able to accurately compare against. * in order to be able to accurately compare against.
* *
* @since 3.7.0 * @since 3.7.0
* @access public
* *
* @param string $column The column to query against. Needs to be pre-validated! * @param string $column The column to query against. Needs to be pre-validated!
* @param string $compare The comparison operator. Needs to be pre-validated! * @param string $compare The comparison operator. Needs to be pre-validated!

50
wp-includes/rest-api/class-wp-rest-request.php
View File

@ -32,7 +32,6 @@ class WP_REST_Request implements ArrayAccess {
* HTTP method. * HTTP method.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var string * @var string
*/ */
protected $method = ''; protected $method = '';
@ -44,7 +43,6 @@ class WP_REST_Request implements ArrayAccess {
* superglobals when being created from the global scope. * superglobals when being created from the global scope.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var array Contains GET, POST and FILES keys mapping to arrays of data. * @var array Contains GET, POST and FILES keys mapping to arrays of data.
*/ */
protected $params; protected $params;
@ -53,7 +51,6 @@ class WP_REST_Request implements ArrayAccess {
* HTTP headers for the request. * HTTP headers for the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var array Map of key to value. Key is always lowercase, as per HTTP specification. * @var array Map of key to value. Key is always lowercase, as per HTTP specification.
*/ */
protected $headers = array(); protected $headers = array();
@ -62,7 +59,6 @@ class WP_REST_Request implements ArrayAccess {
* Body data. * Body data.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var string Binary data from the request. * @var string Binary data from the request.
*/ */
protected $body = null; protected $body = null;
@ -71,7 +67,6 @@ class WP_REST_Request implements ArrayAccess {
* Route matched for the request. * Route matched for the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var string * @var string
*/ */
protected $route; protected $route;
@ -83,7 +78,6 @@ class WP_REST_Request implements ArrayAccess {
* containing the callback as well as the valid methods for the route. * containing the callback as well as the valid methods for the route.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var array Attributes for the request. * @var array Attributes for the request.
*/ */
protected $attributes = array(); protected $attributes = array();
@ -94,7 +88,6 @@ class WP_REST_Request implements ArrayAccess {
* Allows lazy-parsing of JSON data where possible. * Allows lazy-parsing of JSON data where possible.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var bool * @var bool
*/ */
protected $parsed_json = false; protected $parsed_json = false;
@ -103,7 +96,6 @@ class WP_REST_Request implements ArrayAccess {
* Used to determine if the body data has been parsed yet. * Used to determine if the body data has been parsed yet.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var bool * @var bool
*/ */
protected $parsed_body = false; protected $parsed_body = false;
@ -112,7 +104,6 @@ class WP_REST_Request implements ArrayAccess {
* Constructor. * Constructor.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $method Optional. Request method. Default empty. * @param string $method Optional. Request method. Default empty.
* @param string $route Optional. Request route. Default empty. * @param string $route Optional. Request route. Default empty.
@ -140,7 +131,6 @@ class WP_REST_Request implements ArrayAccess {
* Retrieves the HTTP method for the request. * Retrieves the HTTP method for the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return string HTTP method. * @return string HTTP method.
*/ */
@ -152,7 +142,6 @@ class WP_REST_Request implements ArrayAccess {
* Sets HTTP method for the request. * Sets HTTP method for the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $method HTTP method. * @param string $method HTTP method.
*/ */
@ -164,7 +153,6 @@ class WP_REST_Request implements ArrayAccess {
* Retrieves all headers from the request. * Retrieves all headers from the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Map of key to value. Key is always lowercase, as per HTTP specification. * @return array Map of key to value. Key is always lowercase, as per HTTP specification.
*/ */
@ -186,7 +174,6 @@ class WP_REST_Request implements ArrayAccess {
* @link https://nginx.org/en/docs/http/ngx_http_core_module.html#underscores_in_headers * @link https://nginx.org/en/docs/http/ngx_http_core_module.html#underscores_in_headers
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* @static * @static
* *
* @param string $key Header name. * @param string $key Header name.
@ -207,7 +194,6 @@ class WP_REST_Request implements ArrayAccess {
* (notably cookie headers) cannot be joined this way. * (notably cookie headers) cannot be joined this way.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key Header name, will be canonicalized to lowercase. * @param string $key Header name, will be canonicalized to lowercase.
* @return string|null String value if set, null otherwise. * @return string|null String value if set, null otherwise.
@ -226,7 +212,6 @@ class WP_REST_Request implements ArrayAccess {
* Retrieves header values from the request. * Retrieves header values from the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key Header name, will be canonicalized to lowercase. * @param string $key Header name, will be canonicalized to lowercase.
* @return array|null List of string values if set, null otherwise. * @return array|null List of string values if set, null otherwise.
@ -245,7 +230,6 @@ class WP_REST_Request implements ArrayAccess {
* Sets the header on request. * Sets the header on request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key Header name. * @param string $key Header name.
* @param string $value Header value, or list of values. * @param string $value Header value, or list of values.
@ -261,7 +245,6 @@ class WP_REST_Request implements ArrayAccess {
* Appends a header value for the given header. * Appends a header value for the given header.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key Header name. * @param string $key Header name.
* @param string $value Header value, or list of values. * @param string $value Header value, or list of values.
@ -281,7 +264,6 @@ class WP_REST_Request implements ArrayAccess {
* Removes all values for a header. * Removes all values for a header.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key Header name. * @param string $key Header name.
*/ */
@ -294,7 +276,6 @@ class WP_REST_Request implements ArrayAccess {
* Sets headers on the request. * Sets headers on the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $headers Map of header name to value. * @param array $headers Map of header name to value.
* @param bool $override If true, replace the request's headers. Otherwise, merge with existing. * @param bool $override If true, replace the request's headers. Otherwise, merge with existing.
@ -313,7 +294,6 @@ class WP_REST_Request implements ArrayAccess {
* Retrieves the content-type of the request. * Retrieves the content-type of the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Map containing 'value' and 'parameters' keys. * @return array Map containing 'value' and 'parameters' keys.
*/ */
@ -348,7 +328,6 @@ class WP_REST_Request implements ArrayAccess {
* Used when checking parameters in get_param(). * Used when checking parameters in get_param().
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* *
* @return array List of types to check, in order of priority. * @return array List of types to check, in order of priority.
*/ */
@ -400,7 +379,6 @@ class WP_REST_Request implements ArrayAccess {
* Retrieves a parameter from the request. * Retrieves a parameter from the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key Parameter name. * @param string $key Parameter name.
* @return mixed|null Value if set, null otherwise. * @return mixed|null Value if set, null otherwise.
@ -422,7 +400,6 @@ class WP_REST_Request implements ArrayAccess {
* Sets a parameter on the request. * Sets a parameter on the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $key Parameter name. * @param string $key Parameter name.
* @param mixed $value Parameter value. * @param mixed $value Parameter value.
@ -439,7 +416,6 @@ class WP_REST_Request implements ArrayAccess {
* Handles merging all the available values into a single array. * Handles merging all the available values into a single array.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Map of key to value. * @return array Map of key to value.
*/ */
@ -465,7 +441,6 @@ class WP_REST_Request implements ArrayAccess {
* These are parsed from the URL using the regex. * These are parsed from the URL using the regex.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Parameter map of key to value. * @return array Parameter map of key to value.
*/ */
@ -479,7 +454,6 @@ class WP_REST_Request implements ArrayAccess {
* Typically, this is set after parsing the URL. * Typically, this is set after parsing the URL.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $params Parameter map of key to value. * @param array $params Parameter map of key to value.
*/ */
@ -493,7 +467,6 @@ class WP_REST_Request implements ArrayAccess {
* These are the parameters you'd typically find in `$_GET`. * These are the parameters you'd typically find in `$_GET`.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Parameter map of key to value * @return array Parameter map of key to value
*/ */
@ -507,7 +480,6 @@ class WP_REST_Request implements ArrayAccess {
* Typically, this is set from `$_GET`. * Typically, this is set from `$_GET`.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $params Parameter map of key to value. * @param array $params Parameter map of key to value.
*/ */
@ -521,7 +493,6 @@ class WP_REST_Request implements ArrayAccess {
* These are the parameters you'd typically find in `$_POST`. * These are the parameters you'd typically find in `$_POST`.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Parameter map of key to value. * @return array Parameter map of key to value.
*/ */
@ -535,7 +506,6 @@ class WP_REST_Request implements ArrayAccess {
* Typically, this is set from `$_POST`. * Typically, this is set from `$_POST`.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $params Parameter map of key to value. * @param array $params Parameter map of key to value.
*/ */
@ -549,7 +519,6 @@ class WP_REST_Request implements ArrayAccess {
* These are the parameters you'd typically find in `$_FILES`. * These are the parameters you'd typically find in `$_FILES`.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Parameter map of key to value * @return array Parameter map of key to value
*/ */
@ -563,7 +532,6 @@ class WP_REST_Request implements ArrayAccess {
* Typically, this is set from `$_FILES`. * Typically, this is set from `$_FILES`.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $params Parameter map of key to value. * @param array $params Parameter map of key to value.
*/ */
@ -577,7 +545,6 @@ class WP_REST_Request implements ArrayAccess {
* These are the parameters set in the route registration. * These are the parameters set in the route registration.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Parameter map of key to value * @return array Parameter map of key to value
*/ */
@ -591,7 +558,6 @@ class WP_REST_Request implements ArrayAccess {
* These are the parameters set in the route registration. * These are the parameters set in the route registration.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $params Parameter map of key to value. * @param array $params Parameter map of key to value.
*/ */
@ -603,7 +569,6 @@ class WP_REST_Request implements ArrayAccess {
* Retrieves the request body content. * Retrieves the request body content.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return string Binary data from the request body. * @return string Binary data from the request body.
*/ */
@ -615,7 +580,6 @@ class WP_REST_Request implements ArrayAccess {
* Sets body content. * Sets body content.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $data Binary data from the request body. * @param string $data Binary data from the request body.
*/ */
@ -632,7 +596,6 @@ class WP_REST_Request implements ArrayAccess {
* Retrieves the parameters from a JSON-formatted body. * Retrieves the parameters from a JSON-formatted body.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Parameter map of key to value. * @return array Parameter map of key to value.
*/ */
@ -650,7 +613,6 @@ class WP_REST_Request implements ArrayAccess {
* *
* @since 4.4.0 * @since 4.4.0
* @since 4.7.0 Returns error instance if value cannot be decoded. * @since 4.7.0 Returns error instance if value cannot be decoded.
* @access protected
* @return true|WP_Error True if the JSON data was passed or no JSON data was provided, WP_Error if invalid JSON was passed. * @return true|WP_Error True if the JSON data was passed or no JSON data was provided, WP_Error if invalid JSON was passed.
*/ */
protected function parse_json_params() { protected function parse_json_params() {
@ -706,7 +668,6 @@ class WP_REST_Request implements ArrayAccess {
* natively by PHP. In PHP 5.x, only POST has these parsed automatically. * natively by PHP. In PHP 5.x, only POST has these parsed automatically.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
*/ */
protected function parse_body_params() { protected function parse_body_params() {
if ( $this->parsed_body ) { if ( $this->parsed_body ) {
@ -747,7 +708,6 @@ class WP_REST_Request implements ArrayAccess {
* Retrieves the route that matched the request. * Retrieves the route that matched the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return string Route matching regex. * @return string Route matching regex.
*/ */
@ -759,7 +719,6 @@ class WP_REST_Request implements ArrayAccess {
* Sets the route that matched the request. * Sets the route that matched the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $route Route matching regex. * @param string $route Route matching regex.
*/ */
@ -773,7 +732,6 @@ class WP_REST_Request implements ArrayAccess {
* These are the options for the route that was matched. * These are the options for the route that was matched.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array Attributes for the request. * @return array Attributes for the request.
*/ */
@ -785,7 +743,6 @@ class WP_REST_Request implements ArrayAccess {
* Sets the attributes for the request. * Sets the attributes for the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $attributes Attributes for the request. * @param array $attributes Attributes for the request.
*/ */
@ -800,7 +757,6 @@ class WP_REST_Request implements ArrayAccess {
* argument. * argument.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return true|WP_Error True if parameters were sanitized, WP_Error if an error occurred during sanitization. * @return true|WP_Error True if parameters were sanitized, WP_Error if an error occurred during sanitization.
*/ */
@ -856,7 +812,6 @@ class WP_REST_Request implements ArrayAccess {
* Checks whether this request is valid according to its attributes. * Checks whether this request is valid according to its attributes.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return bool|WP_Error True if there are no parameters to validate or if all pass validation, * @return bool|WP_Error True if there are no parameters to validate or if all pass validation,
* WP_Error if required parameters are missing. * WP_Error if required parameters are missing.
@ -924,7 +879,6 @@ class WP_REST_Request implements ArrayAccess {
* Checks if a parameter is set. * Checks if a parameter is set.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $offset Parameter name. * @param string $offset Parameter name.
* @return bool Whether the parameter is set. * @return bool Whether the parameter is set.
@ -945,7 +899,6 @@ class WP_REST_Request implements ArrayAccess {
* Retrieves a parameter from the request. * Retrieves a parameter from the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $offset Parameter name. * @param string $offset Parameter name.
* @return mixed|null Value if set, null otherwise. * @return mixed|null Value if set, null otherwise.
@ -958,7 +911,6 @@ class WP_REST_Request implements ArrayAccess {
* Sets a parameter on the request. * Sets a parameter on the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $offset Parameter name. * @param string $offset Parameter name.
* @param mixed $value Parameter value. * @param mixed $value Parameter value.
@ -971,7 +923,6 @@ class WP_REST_Request implements ArrayAccess {
* Removes a parameter from the request. * Removes a parameter from the request.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $offset Parameter name. * @param string $offset Parameter name.
*/ */
@ -989,7 +940,6 @@ class WP_REST_Request implements ArrayAccess {
* *
* @static * @static
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @param string $url URL with protocol, domain, path and query args. * @param string $url URL with protocol, domain, path and query args.
* @return WP_REST_Request|false WP_REST_Request object on success, false on failure. * @return WP_REST_Request|false WP_REST_Request object on success, false on failure.

15
wp-includes/rest-api/class-wp-rest-response.php
View File

@ -20,7 +20,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Links related to the response. * Links related to the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var array * @var array
*/ */
protected $links = array(); protected $links = array();
@ -29,7 +28,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* The route that was to create the response. * The route that was to create the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var string * @var string
*/ */
protected $matched_route = ''; protected $matched_route = '';
@ -38,7 +36,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* The handler that was used to create the response. * The handler that was used to create the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access protected
* @var null|array * @var null|array
*/ */
protected $matched_handler = null; protected $matched_handler = null;
@ -49,7 +46,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* @internal The $rel parameter is first, as this looks nicer when sending multiple. * @internal The $rel parameter is first, as this looks nicer when sending multiple.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @link https://tools.ietf.org/html/rfc5988 * @link https://tools.ietf.org/html/rfc5988
* @link https://www.iana.org/assignments/link-relations/link-relations.xml * @link https://www.iana.org/assignments/link-relations/link-relations.xml
@ -79,7 +75,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Removes a link from the response. * Removes a link from the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $rel Link relation. Either an IANA registered type, or an absolute URL. * @param string $rel Link relation. Either an IANA registered type, or an absolute URL.
* @param string $href Optional. Only remove links for the relation matching the given href. * @param string $href Optional. Only remove links for the relation matching the given href.
@ -110,7 +105,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* associative arrays. * associative arrays.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $links Map of link relation to list of links. * @param array $links Map of link relation to list of links.
*/ */
@ -131,7 +125,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Retrieves links for the response. * Retrieves links for the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return array List of links. * @return array List of links.
*/ */
@ -145,7 +138,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* @internal The $rel parameter is first, as this looks nicer when sending multiple. * @internal The $rel parameter is first, as this looks nicer when sending multiple.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @link https://tools.ietf.org/html/rfc5988 * @link https://tools.ietf.org/html/rfc5988
* @link https://www.iana.org/assignments/link-relations/link-relations.xml * @link https://www.iana.org/assignments/link-relations/link-relations.xml
@ -171,7 +163,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Retrieves the route that was used. * Retrieves the route that was used.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return string The matched route. * @return string The matched route.
*/ */
@ -183,7 +174,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Sets the route (regex for path) that caused the response. * Sets the route (regex for path) that caused the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param string $route Route name. * @param string $route Route name.
*/ */
@ -195,7 +185,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Retrieves the handler that was used to generate the response. * Retrieves the handler that was used to generate the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return null|array The handler that was used to create the response. * @return null|array The handler that was used to create the response.
*/ */
@ -207,7 +196,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Retrieves the handler that was responsible for generating the response. * Retrieves the handler that was responsible for generating the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @param array $handler The matched handler. * @param array $handler The matched handler.
*/ */
@ -219,7 +207,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Checks if the response is an error, i.e. >= 400 response code. * Checks if the response is an error, i.e. >= 400 response code.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return bool Whether the response is an error. * @return bool Whether the response is an error.
*/ */
@ -231,7 +218,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Retrieves a WP_Error object from the response. * Retrieves a WP_Error object from the response.
* *
* @since 4.4.0 * @since 4.4.0
* @access public
* *
* @return WP_Error|null WP_Error or null on not an errored response. * @return WP_Error|null WP_Error or null on not an errored response.
*/ */
@ -261,7 +247,6 @@ class WP_REST_Response extends WP_HTTP_Response {
* Retrieves the CURIEs (compact URIs) used for relations. * Retrieves the CURIEs (compact URIs) used for relations.
* *
* @since 4.5.0 * @since 4.5.0
* @access public
* *
* @return array Compact URIs. * @return array Compact URIs.
*/ */

Some files were not shown because too many files have changed in this diff Show More