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-admin/* 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@41161


git-svn-id: http://core.svn.wordpress.org/trunk@41001 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2017-07-27 00:40:43 +00:00
parent 32128ffd45
commit 1a28ec87e1
45 changed files with 2 additions and 528 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
wp-admin/custom-background.php
View File

@ -18,7 +18,6 @@ class Custom_Background {
*
* @var callable
* @since 3.0.0
* @access public
*/
public $admin_header_callback;
@ -27,7 +26,6 @@ class Custom_Background {
*
* @var callable
* @since 3.0.0
* @access public
*/
public $admin_image_div_callback;
@ -35,7 +33,6 @@ class Custom_Background {
* Used to trigger a success message when settings updated and set to true.
*
* @since 3.0.0
* @access private
* @var bool
*/
private $updated;

4
wp-admin/custom-header.php
View File

@ -18,7 +18,6 @@ class Custom_Image_Header {
*
* @var callable
* @since 2.1.0
* @access public
*/
public $admin_header_callback;
@ -27,7 +26,6 @@ class Custom_Image_Header {
*
* @var callable
* @since 3.0.0
* @access public
*/
public $admin_image_div_callback;
@ -36,7 +34,6 @@ class Custom_Image_Header {
*
* @var array
* @since 3.0.0
* @access public
*/
public $default_headers = array();
@ -44,7 +41,6 @@ class Custom_Image_Header {
* Used to trigger a success message when settings updated and set to true.
*
* @since 3.0.0
* @access private
* @var bool
*/
private $updated;

5
wp-admin/includes/class-automatic-upgrader-skin.php
View File

@ -27,7 +27,6 @@ class Automatic_Upgrader_Skin extends WP_Upgrader_Skin {
*
* @since 3.7.0
* @since 4.6.0 The `$context` parameter default changed from `false` to an empty string.
* @access public
*
* @see request_filesystem_credentials()
*
@ -51,7 +50,6 @@ class Automatic_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*
* @return array
*/
@ -60,7 +58,6 @@ class Automatic_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*
* @param string|array|WP_Error $data
*/
@ -101,14 +98,12 @@ class Automatic_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function header() {
ob_start();
}
/**
* @access public
*/
public function footer() {
$output = ob_get_clean();

3
wp-admin/includes/class-bulk-plugin-upgrader-skin.php
View File

@ -24,7 +24,6 @@ class Bulk_Plugin_Upgrader_Skin extends Bulk_Upgrader_Skin {
}
/**
* @access public
*
* @param string $title
*/
@ -33,7 +32,6 @@ class Bulk_Plugin_Upgrader_Skin extends Bulk_Upgrader_Skin {
}
/**
* @access public
*
* @param string $title
*/
@ -43,7 +41,6 @@ class Bulk_Plugin_Upgrader_Skin extends Bulk_Upgrader_Skin {
}
/**
* @access public
*/
public function bulk_footer() {
parent::bulk_footer();

3
wp-admin/includes/class-bulk-theme-upgrader-skin.php
View File

@ -24,7 +24,6 @@ class Bulk_Theme_Upgrader_Skin extends Bulk_Upgrader_Skin {
}
/**
* @access public
*
* @param string $title
*/
@ -33,7 +32,6 @@ class Bulk_Theme_Upgrader_Skin extends Bulk_Upgrader_Skin {
}
/**
* @access public
*
* @param string $title
*/
@ -43,7 +41,6 @@ class Bulk_Theme_Upgrader_Skin extends Bulk_Upgrader_Skin {
}
/**
* @access public
*/
public function bulk_footer() {
parent::bulk_footer();

12
wp-admin/includes/class-bulk-upgrader-skin.php
View File

@ -23,7 +23,6 @@ class Bulk_Upgrader_Skin extends WP_Upgrader_Skin {
public $error = false;
/**
* @access public
*
* @param array $args
*/
@ -35,7 +34,6 @@ class Bulk_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function add_strings() {
$this->upgrader->strings['skin_upgrade_start'] = __('The update process is starting. This process may take a while on some hosts, so please be patient.');
@ -49,7 +47,6 @@ class Bulk_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*
* @param string $string
*/
@ -75,21 +72,18 @@ class Bulk_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function header() {
// Nothing, This will be displayed within a iframe.
}
/**
* @access public
*/
public function footer() {
// Nothing, This will be displayed within a iframe.
}
/**
* @access public
*
* @param string|WP_Error $error
*/
@ -111,21 +105,18 @@ class Bulk_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function bulk_header() {
$this->feedback('skin_upgrade_start');
}
/**
* @access public
*/
public function bulk_footer() {
$this->feedback('skin_upgrade_end');
}
/**
* @access public
*
* @param string $title
*/
@ -139,7 +130,6 @@ class Bulk_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*
* @param string $title
*/
@ -170,7 +160,6 @@ class Bulk_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function reset() {
$this->in_loop = false;
@ -178,7 +167,6 @@ class Bulk_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function flush_output() {
wp_ob_end_flush_all();

4
wp-admin/includes/class-core-upgrader.php
View File

@ -24,7 +24,6 @@ class Core_Upgrader extends WP_Upgrader {
* Initialize the upgrade strings.
*
* @since 2.8.0
* @access public
*/
public function upgrade_strings() {
$this->strings['up_to_date'] = __('WordPress is at the latest version.');
@ -42,7 +41,6 @@ class Core_Upgrader extends WP_Upgrader {
* Upgrade WordPress core.
*
* @since 2.8.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
* @global callable $_wp_filesystem_direct_method
@ -228,7 +226,6 @@ class Core_Upgrader extends WP_Upgrader {
* Determines if this WordPress Core version should update to an offered version or not.
*
* @since 3.7.0
* @access public
*
* @static
*
@ -337,7 +334,6 @@ class Core_Upgrader extends WP_Upgrader {
* Compare the disk file checksums against the expected checksums.
*
* @since 3.7.0
* @access public
*
* @global string $wp_version
* @global string $wp_local_package

5
wp-admin/includes/class-file-upload-upgrader.php
View File

@ -22,7 +22,6 @@ class File_Upload_Upgrader {
* The full path to the file package.
*
* @since 2.8.0
* @access public
* @var string $package
*/
public $package;
@ -31,7 +30,6 @@ class File_Upload_Upgrader {
* The name of the file.
*
* @since 2.8.0
* @access public
* @var string $filename
*/
public $filename;
@ -40,7 +38,6 @@ class File_Upload_Upgrader {
* The ID of the attachment post for this file.
*
* @since 3.3.0
* @access public
* @var int $id
*/
public $id = 0;
@ -49,7 +46,6 @@ class File_Upload_Upgrader {
* Construct the upgrader for a form.
*
* @since 2.8.0
* @access public
*
* @param string $form The name of the form the file was uploaded from.
* @param string $urlholder The name of the `GET` parameter that holds the filename.
@ -113,7 +109,6 @@ class File_Upload_Upgrader {
* Delete the attachment/uploaded file.
*
* @since 3.2.2
* @access public
*
* @return bool Whether the cleanup was successful.
*/

5
wp-admin/includes/class-language-pack-upgrader-skin.php
View File

@ -22,7 +22,6 @@ class Language_Pack_Upgrader_Skin extends WP_Upgrader_Skin {
public $display_footer_actions = true;
/**
* @access public
*
* @param array $args
*/
@ -38,7 +37,6 @@ class Language_Pack_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function before() {
$name = $this->upgrader->get_name_for_update( $this->language_update );
@ -49,7 +47,6 @@ class Language_Pack_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*
* @param string|WP_Error $error
*/
@ -60,14 +57,12 @@ class Language_Pack_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function after() {
echo '</div>';
}
/**
* @access public
*/
public function bulk_footer() {
$this->decrement_update_count( 'translation' );

8
wp-admin/includes/class-language-pack-upgrader.php
View File

@ -22,7 +22,6 @@ class Language_Pack_Upgrader extends WP_Upgrader {
* Result of the language pack upgrade.
*
* @since 3.7.0
* @access public
* @var array|WP_Error $result
* @see WP_Upgrader::$result
*/
@ -32,7 +31,6 @@ class Language_Pack_Upgrader extends WP_Upgrader {
* Whether a bulk upgrade/install is being performed.
*
* @since 3.7.0
* @access public
* @var bool $bulk
*/
public $bulk = true;
@ -43,7 +41,6 @@ class Language_Pack_Upgrader extends WP_Upgrader {
* Hooked to the {@see 'upgrader_process_complete'} action by default.
*
* @since 3.7.0
* @access public
* @static
*
* @param false|WP_Upgrader $upgrader Optional. WP_Upgrader instance or false. If `$upgrader` is
@ -110,7 +107,6 @@ class Language_Pack_Upgrader extends WP_Upgrader {
* Initialize the upgrade strings.
*
* @since 3.7.0
* @access public
*/
public function upgrade_strings() {
$this->strings['starting_upgrade'] = __( 'Some of your translations need updating. Sit tight for a few more seconds while we update them as well.' );
@ -126,7 +122,6 @@ class Language_Pack_Upgrader extends WP_Upgrader {
* Upgrade a language pack.
*
* @since 3.7.0
* @access public
*
* @param string|false $update Optional. Whether an update offer is available. Default false.
* @param array $args Optional. Other optional arguments, see
@ -151,7 +146,6 @@ class Language_Pack_Upgrader extends WP_Upgrader {
* Bulk upgrade language packs.
*
* @since 3.7.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*
@ -307,7 +301,6 @@ class Language_Pack_Upgrader extends WP_Upgrader {
* Language_Pack_Upgrader::bulk_upgrade().
*
* @since 3.7.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*
@ -349,7 +342,6 @@ class Language_Pack_Upgrader extends WP_Upgrader {
* Get the name of an item being updated.
*
* @since 3.7.0
* @access public
*
* @param object $update The data for an update.
* @return string The name of the item being updated.

2
wp-admin/includes/class-plugin-installer-skin.php
View File

@ -34,7 +34,6 @@ class Plugin_Installer_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function before() {
if ( !empty($this->api) )
@ -42,7 +41,6 @@ class Plugin_Installer_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function after() {
$plugin_file = $this->upgrader->plugin_info();

2
wp-admin/includes/class-plugin-upgrader-skin.php
View File

@ -21,7 +21,6 @@ class Plugin_Upgrader_Skin extends WP_Upgrader_Skin {
public $plugin_network_active = false;
/**
* @access public
*
* @param array $args
*/
@ -38,7 +37,6 @@ class Plugin_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function after() {
$this->plugin = $this->upgrader->plugin_info();

11
wp-admin/includes/class-plugin-upgrader.php
View File

@ -24,7 +24,6 @@ class Plugin_Upgrader extends WP_Upgrader {
* Plugin upgrade result.
*
* @since 2.8.0
* @access public
* @var array|WP_Error $result
*
* @see WP_Upgrader::$result
@ -35,7 +34,6 @@ class Plugin_Upgrader extends WP_Upgrader {
* Whether a bulk upgrade/install is being performed.
*
* @since 2.9.0
* @access public
* @var bool $bulk
*/
public $bulk = false;
@ -44,7 +42,6 @@ class Plugin_Upgrader extends WP_Upgrader {
* Initialize the upgrade strings.
*
* @since 2.8.0
* @access public
*/
public function upgrade_strings() {
$this->strings['up_to_date'] = __('The plugin is at the latest version.');
@ -62,7 +59,6 @@ class Plugin_Upgrader extends WP_Upgrader {
* Initialize the install strings.
*
* @since 2.8.0
* @access public
*/
public function install_strings() {
$this->strings['no_package'] = __('Install package not available.');
@ -79,7 +75,6 @@ class Plugin_Upgrader extends WP_Upgrader {
*
* @since 2.8.0
* @since 3.7.0 The `$args` parameter was added, making clearing the plugin update cache optional.
* @access public
*
* @param string $package The full local path or URI of the package.
* @param array $args {
@ -134,7 +129,6 @@ class Plugin_Upgrader extends WP_Upgrader {
*
* @since 2.8.0
* @since 3.7.0 The `$args` parameter was added, making clearing the plugin update cache optional.
* @access public
*
* @param string $plugin The basename path to the main plugin file.
* @param array $args {
@ -206,7 +200,6 @@ class Plugin_Upgrader extends WP_Upgrader {
*
* @since 2.8.0
* @since 3.7.0 The `$args` parameter was added, making clearing the plugin update cache optional.
* @access public
*
* @param array $plugins Array of the basename paths of the plugins' main files.
* @param array $args {
@ -325,7 +318,6 @@ class Plugin_Upgrader extends WP_Upgrader {
* Plugin_Upgrader::install().
*
* @since 3.3.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*
@ -368,7 +360,6 @@ class Plugin_Upgrader extends WP_Upgrader {
* This isn't used internally in the class, but is called by the skins.
*
* @since 2.8.0
* @access public
*
* @return string|false The full path to the main plugin file, or false.
*/
@ -394,7 +385,6 @@ class Plugin_Upgrader extends WP_Upgrader {
*
* @since 2.8.0
* @since 4.1.0 Added a return value.
* @access public
*
* @param bool|WP_Error $return Upgrade offer return.
* @param array $plugin Plugin package arguments.
@ -428,7 +418,6 @@ class Plugin_Upgrader extends WP_Upgrader {
* Plugin_Upgrader::upgrade() and Plugin_Upgrader::bulk_upgrade().
*
* @since 2.8.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*

2
wp-admin/includes/class-theme-installer-skin.php
View File

@ -34,7 +34,6 @@ class Theme_Installer_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function before() {
if ( !empty($this->api) )
@ -42,7 +41,6 @@ class Theme_Installer_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function after() {
if ( empty($this->upgrader->result['destination_name']) )

2
wp-admin/includes/class-theme-upgrader-skin.php
View File

@ -19,7 +19,6 @@ class Theme_Upgrader_Skin extends WP_Upgrader_Skin {
public $theme = '';
/**
* @access public
*
* @param array $args
*/
@ -33,7 +32,6 @@ class Theme_Upgrader_Skin extends WP_Upgrader_Skin {
}
/**
* @access public
*/
public function after() {
$this->decrement_update_count( 'theme' );

14
wp-admin/includes/class-theme-upgrader.php
View File

@ -24,7 +24,6 @@ class Theme_Upgrader extends WP_Upgrader {
* Result of the theme upgrade offer.
*
* @since 2.8.0
* @access public
* @var array|WP_Error $result
* @see WP_Upgrader::$result
*/
@ -34,7 +33,6 @@ class Theme_Upgrader extends WP_Upgrader {
* Whether multiple themes are being upgraded/installed in bulk.
*
* @since 2.9.0
* @access public
* @var bool $bulk
*/
public $bulk = false;
@ -43,7 +41,6 @@ class Theme_Upgrader extends WP_Upgrader {
* Initialize the upgrade strings.
*
* @since 2.8.0
* @access public
*/
public function upgrade_strings() {
$this->strings['up_to_date'] = __('The theme is at the latest version.');
@ -60,7 +57,6 @@ class Theme_Upgrader extends WP_Upgrader {
* Initialize the install strings.
*
* @since 2.8.0
* @access public
*/
public function install_strings() {
$this->strings['no_package'] = __('Install package not available.');
@ -88,7 +84,6 @@ class Theme_Upgrader extends WP_Upgrader {
* Hooked to the {@see 'upgrader_post_install'} filter by Theme_Upgrader::install().
*
* @since 3.4.0
* @access public
*
* @param bool $install_result
* @param array $hook_extra
@ -162,7 +157,6 @@ class Theme_Upgrader extends WP_Upgrader {
* a child theme and installing the parent theme fails.
*
* @since 3.4.0
* @access public
*
* @param array $actions Preview actions.
* @return array
@ -177,7 +171,6 @@ class Theme_Upgrader extends WP_Upgrader {
*
* @since 2.8.0
* @since 3.7.0 The `$args` parameter was added, making clearing the update cache optional.
* @access public
*
* @param string $package The full local path or URI of the package.
* @param array $args {
@ -235,7 +228,6 @@ class Theme_Upgrader extends WP_Upgrader {
*
* @since 2.8.0
* @since 3.7.0 The `$args` parameter was added, making clearing the update cache optional.
* @access public
*
* @param string $theme The theme slug.
* @param array $args {
@ -306,7 +298,6 @@ class Theme_Upgrader extends WP_Upgrader {
*
* @since 3.0.0
* @since 3.7.0 The `$args` parameter was added, making clearing the update cache optional.
* @access public
*
* @param array $themes The theme slugs.
* @param array $args {
@ -427,7 +418,6 @@ class Theme_Upgrader extends WP_Upgrader {
* files.
*
* @since 3.3.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*
@ -486,7 +476,6 @@ class Theme_Upgrader extends WP_Upgrader {
* Theme_Upgrader::bulk_upgrade().
*
* @since 2.8.0
* @access public
*
* @param bool|WP_Error $return
* @param array $theme
@ -514,7 +503,6 @@ class Theme_Upgrader extends WP_Upgrader {
* and Theme_Upgrader::bulk_upgrade().
*
* @since 2.8.0
* @access public
*
* @param bool|WP_Error $return
* @param array $theme
@ -549,7 +537,6 @@ class Theme_Upgrader extends WP_Upgrader {
* and Theme_Upgrader::bulk_upgrade().
*
* @since 2.8.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*
@ -583,7 +570,6 @@ class Theme_Upgrader extends WP_Upgrader {
*
* @since 2.8.0
* @since 3.0.0 The `$theme` argument was added.
* @access public
*
* @param string $theme The directory name of the theme. This is optional, and if not supplied,
* the directory name from the last result will be used.

6
wp-admin/includes/class-wp-ajax-upgrader-skin.php
View File

@ -22,7 +22,6 @@ class WP_Ajax_Upgrader_Skin extends Automatic_Upgrader_Skin {
* Holds the WP_Error object.
*
* @since 4.6.0
* @access protected
* @var null|WP_Error
*/
protected $errors = null;
@ -31,7 +30,6 @@ class WP_Ajax_Upgrader_Skin extends Automatic_Upgrader_Skin {
* Constructor.
*
* @since 4.6.0
* @access public
*
* @param array $args Options for the upgrader, see WP_Upgrader_Skin::__construct().
*/
@ -45,7 +43,6 @@ class WP_Ajax_Upgrader_Skin extends Automatic_Upgrader_Skin {
* Retrieves the list of errors.
*
* @since 4.6.0
* @access public
*
* @return WP_Error Errors during an upgrade.
*/
@ -57,7 +54,6 @@ class WP_Ajax_Upgrader_Skin extends Automatic_Upgrader_Skin {
* Retrieves a string for error messages.
*
* @since 4.6.0
* @access public
*
* @return string Error messages during an upgrade.
*/
@ -79,7 +75,6 @@ class WP_Ajax_Upgrader_Skin extends Automatic_Upgrader_Skin {
* Stores a log entry for an error.
*
* @since 4.6.0
* @access public
*
* @param string|WP_Error $errors Errors.
*/
@ -115,7 +110,6 @@ class WP_Ajax_Upgrader_Skin extends Automatic_Upgrader_Skin {
* Stores a log entry.
*
* @since 4.6.0
* @access public
*
* @param string|array|WP_Error $data Log entry data.
*/

10
wp-admin/includes/class-wp-automatic-updater.php
View File

@ -19,7 +19,6 @@ class WP_Automatic_Updater {
* Tracks update results during processing.
*
* @var array
* @access protected
*/
protected $update_results = array();
@ -27,7 +26,6 @@ class WP_Automatic_Updater {
* Whether the entire automatic updater is disabled.
*
* @since 3.7.0
* @access public
*/
public function is_disabled() {
// Background updates are disabled if you don't want file changes.
@ -68,7 +66,6 @@ class WP_Automatic_Updater {
* how things get updated.
*
* @since 3.7.0
* @access public
*
* @param string $context The filesystem path to check, in addition to ABSPATH.
*/
@ -121,7 +118,6 @@ class WP_Automatic_Updater {
* Tests to see if we can and should update a specific item.
*
* @since 3.7.0
* @access public
*
* @global wpdb $wpdb WordPress database abstraction object.
*
@ -205,7 +201,6 @@ class WP_Automatic_Updater {
* Notifies an administrator of a core update.
*
* @since 3.7.0
* @access protected
*
* @param object $item The update offer.
*/
@ -249,7 +244,6 @@ class WP_Automatic_Updater {
* Update an item, if appropriate.
*
* @since 3.7.0
* @access public
*
* @param string $type The type of update being checked: 'core', 'theme', 'plugin', 'translation'.
* @param object $item The update offer.
@ -370,7 +364,6 @@ class WP_Automatic_Updater {
* Kicks off the background update process, looping through all pending updates.
*
* @since 3.7.0
* @access public
*/
public function run() {
if ( $this->is_disabled() )
@ -487,7 +480,6 @@ class WP_Automatic_Updater {
* and if we need to avoid processing future updates.
*
* @since Unknown
* @access protected
*
* @param object $update_result The result of the core update. Includes the update offer and result.
*/
@ -575,7 +567,6 @@ class WP_Automatic_Updater {
* Sends an email upon the completion or failure of a background core update.
*
* @since 3.7.0
* @access protected
*
* @param string $type The type of email to send. Can be one of 'success', 'fail', 'manual', 'critical'.
* @param object $core_update The update offer that was attempted.
@ -773,7 +764,6 @@ class WP_Automatic_Updater {
* Prepares and sends an email of a full log of background update results, useful for debugging and geekery.
*
* @since 3.7.0
* @access protected
*/
protected function send_debug_email() {
$update_count = 0;

5
wp-admin/includes/class-wp-comments-list-table.php
View File

@ -29,7 +29,6 @@ class WP_Comments_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -428,7 +427,6 @@ class WP_Comments_List_Table extends WP_List_Table {
* Get the name of the default primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Name of the default primary column, in this case, 'comment'.
*/
@ -437,7 +435,6 @@ class WP_Comments_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function display() {
wp_nonce_field( "fetch-list-" . get_class( $this ), '_ajax_fetch_list_nonce' );
@ -715,7 +712,6 @@ class WP_Comments_List_Table extends WP_List_Table {
}
/**
* @access public
*
* @param WP_Comment $comment The comment object.
*/
@ -741,7 +737,6 @@ class WP_Comments_List_Table extends WP_List_Table {
}
/**
* @access public
*
* @param WP_Comment $comment The comment object.
*/

10
wp-admin/includes/class-wp-community-events.php
View File

@ -18,7 +18,6 @@ class WP_Community_Events {
/**
* ID for a WordPress user account.
*
* @access protected
* @since 4.8.0
*
* @var int
@ -28,7 +27,6 @@ class WP_Community_Events {
/**
* Stores location data for the user.
*
* @access protected
* @since 4.8.0
*
* @var bool|array
@ -171,7 +169,6 @@ class WP_Community_Events {
/**
* Builds an array of args to use in an HTTP request to the w.org Events API.
*
* @access protected
* @since 4.8.0
*
* @param string $search Optional. City search string. Default empty string.
@ -229,7 +226,6 @@ class WP_Community_Events {
* _NOT_ guarantee that the returned address is valid or accurate, and it can
* be easily spoofed.
*
* @access protected
* @since 4.8.0
*
* @return false|string The anonymized address on success; the given address
@ -281,7 +277,6 @@ class WP_Community_Events {
* Test if two pairs of latitude/longitude coordinates match each other.
*
* @since 4.8.0
* @access protected
*
* @param array $a The first pair, with indexes 'latitude' and 'longitude'.
* @param array $b The second pair, with indexes 'latitude' and 'longitude'.
@ -303,7 +298,6 @@ class WP_Community_Events {
* functions, and having it abstracted keeps the logic consistent and DRY,
* which is less prone to errors.
*
* @access protected
* @since 4.8.0
*
* @param array $location Should contain 'latitude' and 'longitude' indexes.
@ -324,7 +318,6 @@ class WP_Community_Events {
/**
* Caches an array of events data from the Events API.
*
* @access protected
* @since 4.8.0
*
* @param array $events Response body from the API request.
@ -366,7 +359,6 @@ class WP_Community_Events {
* the cache, then all users would see the events in the localized data/time
* of the user who triggered the cache refresh, rather than their own.
*
* @access protected
* @since 4.8.0
*
* @param array $response_body The response which contains the events.
@ -395,7 +387,6 @@ class WP_Community_Events {
/**
* Discards expired events, and reduces the remaining list.
*
* @access protected
* @since 4.8.0
*
* @param array $response_body The response body which contains the events.
@ -436,7 +427,6 @@ class WP_Community_Events {
* Errors are logged instead of being triggered, to avoid breaking the JSON
* response when called from AJAX handlers and `display_errors` is enabled.
*
* @access protected
* @since 4.8.0
*
* @param string $message A description of what occurred.

44
wp-admin/includes/class-wp-filesystem-base.php
View File

@ -15,7 +15,6 @@ class WP_Filesystem_Base {
/**
* Whether to display debug data for the connection.
*
* @access public
* @since 2.5.0
* @var bool
*/
@ -24,7 +23,6 @@ class WP_Filesystem_Base {
/**
* Cached list of local filepaths to mapped remote filepaths.
*
* @access public
* @since 2.7.0
* @var array
*/
@ -33,27 +31,23 @@ class WP_Filesystem_Base {
/**
* The Access method of the current connection, Set automatically.
*
* @access public
* @since 2.5.0
* @var string
*/
public $method = '';
/**
* @access public
* @var WP_Error
*/
public $errors = null;
/**
* @access public
*/
public $options = array();
/**
* Return the path on the remote filesystem of ABSPATH.
*
* @access public
* @since 2.7.0
*
* @return string The location of the remote path.
@ -69,7 +63,6 @@ class WP_Filesystem_Base {
/**
* Return the path on the remote filesystem of WP_CONTENT_DIR.
*
* @access public
* @since 2.7.0
*
* @return string The location of the remote path.
@ -81,7 +74,6 @@ class WP_Filesystem_Base {
/**
* Return the path on the remote filesystem of WP_PLUGIN_DIR.
*
* @access public
* @since 2.7.0
*
* @return string The location of the remote path.
@ -93,7 +85,6 @@ class WP_Filesystem_Base {
/**
* Return the path on the remote filesystem of the Themes Directory.
*
* @access public
* @since 2.7.0
*
* @param string $theme The Theme stylesheet or template for the directory.
@ -112,7 +103,6 @@ class WP_Filesystem_Base {
/**
* Return the path on the remote filesystem of WP_LANG_DIR.
*
* @access public
* @since 3.2.0
*
* @return string The location of the remote path.
@ -124,7 +114,6 @@ class WP_Filesystem_Base {
/**
* Locate a folder on the remote filesystem.
*
* @access public
* @since 2.5.0
* @deprecated 2.7.0 use WP_Filesystem::abspath() or WP_Filesystem::wp_*_dir() instead.
* @see WP_Filesystem::abspath()
@ -147,7 +136,6 @@ class WP_Filesystem_Base {
/**
* Locate a folder on the remote filesystem.
*
* @access public
* @since 2.5.0
* @deprecated 2.7.0 use WP_Filesystem::abspath() or WP_Filesystem::wp_*_dir() methods instead.
* @see WP_Filesystem::abspath()
@ -172,7 +160,6 @@ class WP_Filesystem_Base {
* Assumes that on Windows systems, Stripping off the Drive
* letter is OK Sanitizes \\ to / in windows filepaths.
*
* @access public
* @since 2.7.0
*
* @param string $folder the folder to locate.
@ -238,7 +225,6 @@ class WP_Filesystem_Base {
*
* Expects Windows sanitized path.
*
* @access public
* @since 2.7.0
*
* @param string $folder The folder to locate.
@ -319,7 +305,6 @@ class WP_Filesystem_Base {
*
* @link https://secure.php.net/manual/en/function.fileperms.php
*
* @access public
* @since 2.5.0
*
* @param string $file String filename.
@ -370,7 +355,6 @@ class WP_Filesystem_Base {
/**
* Gets the permissions of the specified file or filepath in their octal format
*
* @access public
* @since 2.5.0
* @param string $file
* @return string the last 3 characters of the octal number
@ -387,7 +371,6 @@ class WP_Filesystem_Base {
*
* @link https://secure.php.net/manual/en/function.chmod.php#49614
*
* @access public
* @since 2.5.0
*
* @param string $mode string The *nix-style file permission.
@ -418,7 +401,6 @@ class WP_Filesystem_Base {
/**
* Determine if the string provided contains binary characters.
*
* @access public
* @since 2.7.0
*
* @param string $text String to test against.
@ -433,7 +415,6 @@ class WP_Filesystem_Base {
*
* Default behavior is to do nothing, override this in your subclass, if desired.
*
* @access public
* @since 2.5.0
*
* @param string $file Path to the file.
@ -448,7 +429,6 @@ class WP_Filesystem_Base {
/**
* Connect filesystem.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -461,7 +441,6 @@ class WP_Filesystem_Base {
/**
* Read entire file into a string.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -475,7 +454,6 @@ class WP_Filesystem_Base {
/**
* Read entire file into an array.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -489,7 +467,6 @@ class WP_Filesystem_Base {
/**
* Write a string to a file.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -505,7 +482,6 @@ class WP_Filesystem_Base {
/**
* Get the current working directory.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -518,7 +494,6 @@ class WP_Filesystem_Base {
/**
* Change current directory.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -532,7 +507,6 @@ class WP_Filesystem_Base {
/**
* Change the file group.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -548,7 +522,6 @@ class WP_Filesystem_Base {
/**
* Change filesystem permissions.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -564,7 +537,6 @@ class WP_Filesystem_Base {
/**
* Get the file owner.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -578,7 +550,6 @@ class WP_Filesystem_Base {
/**
* Get the file's group.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -592,7 +563,6 @@ class WP_Filesystem_Base {
/**
* Copy a file.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -611,7 +581,6 @@ class WP_Filesystem_Base {
/**
* Move a file.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -628,7 +597,6 @@ class WP_Filesystem_Base {
/**
* Delete a file or directory.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -646,7 +614,6 @@ class WP_Filesystem_Base {
/**
* Check if a file or directory exists.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -660,7 +627,6 @@ class WP_Filesystem_Base {
/**
* Check if resource is a file.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -674,7 +640,6 @@ class WP_Filesystem_Base {
/**
* Check if resource is a directory.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -688,7 +653,6 @@ class WP_Filesystem_Base {
/**
* Check if a file is readable.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -702,7 +666,6 @@ class WP_Filesystem_Base {
/**
* Check if a file or directory is writable.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -716,7 +679,6 @@ class WP_Filesystem_Base {
/**
* Gets the file's last access time.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -730,7 +692,6 @@ class WP_Filesystem_Base {
/**
* Gets the file modification time.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -744,7 +705,6 @@ class WP_Filesystem_Base {
/**
* Gets the file size (in bytes).
*
* @access public
* @since 2.5.0
* @abstract
*
@ -760,7 +720,6 @@ class WP_Filesystem_Base {
*
* Note: If $file doesn't exist, it will be created.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -778,7 +737,6 @@ class WP_Filesystem_Base {
/**
* Create a directory.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -798,7 +756,6 @@ class WP_Filesystem_Base {
/**
* Delete a directory.
*
* @access public
* @since 2.5.0
* @abstract
*
@ -814,7 +771,6 @@ class WP_Filesystem_Base {
/**
* Get details for files in a directory or a specific file.
*
* @access public
* @since 2.5.0
* @abstract
*

27
wp-admin/includes/class-wp-filesystem-direct.php
View File

@ -18,7 +18,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* constructor
*
* @access public
*
* @param mixed $arg ignored argument
*/
@ -30,7 +29,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* Reads entire file into a string
*
* @access public
*
* @param string $file Name of the file to read.
* @return string|bool The function returns the read data or false on failure.
@ -42,7 +40,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* Reads entire file into an array
*
* @access public
*
* @param string $file Path to the file.
* @return array|bool the file contents in an array or false on failure.
@ -54,7 +51,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* Write a string to a file
*
* @access public
*
* @param string $file Remote path to the file where to write the data.
* @param string $contents The data to write.
@ -88,7 +84,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* Gets the current working directory
*
* @access public
*
* @return string|bool the current working directory on success, or false on failure.
*/
@ -99,7 +94,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* Change directory
*
* @access public
*
* @param string $dir The new current directory.
* @return bool Returns true on success or false on failure.
@ -111,7 +105,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* Changes file group
*
* @access public
*
* @param string $file Path to the file.
* @param mixed $group A group name or number.
@ -137,7 +130,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* Changes filesystem permissions
*
* @access public
*
* @param string $file Path to the file.
* @param int $mode Optional. The permissions as octal number, usually 0644 for files,
@ -169,7 +161,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* Changes file owner
*
* @access public
*
* @param string $file Path to the file.
* @param mixed $owner A user name or number.
@ -195,7 +186,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
/**
* Gets file owner
*
* @access public
*
* @param string $file Path to the file.
* @return string|bool Username of the user or false on error.
@ -215,7 +205,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
*
* FIXME does not handle errors in fileperms()
*
* @access public
*
* @param string $file Path to the file.
* @return string Mode of the file (last 3 digits).
@ -225,7 +214,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string|false
@ -241,7 +229,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $source
* @param string $destination
@ -260,7 +247,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $source
* @param string $destination
@ -284,7 +270,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param bool $recursive
@ -319,7 +304,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
return $retval;
}
/**
* @access public
*
* @param string $file
* @return bool
@ -328,7 +312,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
return @file_exists($file);
}
/**
* @access public
*
* @param string $file
* @return bool
@ -337,7 +320,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
return @is_file($file);
}
/**
* @access public
*
* @param string $path
* @return bool
@ -347,7 +329,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -357,7 +338,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -367,7 +347,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return int
@ -377,7 +356,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return int
@ -387,7 +365,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return int
@ -397,7 +374,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param int $time
@ -413,7 +389,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param mixed $chmod
@ -441,7 +416,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param bool $recursive
@ -452,7 +426,6 @@ class WP_Filesystem_Direct extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param bool $include_hidden

28
wp-admin/includes/class-wp-filesystem-ftpext.php
View File

@ -17,7 +17,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
public $link;
/**
* @access public
*
* @param array $opt
*/
@ -63,7 +62,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @return bool
*/
@ -105,7 +103,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
* Retrieves the file contents.
*
* @since 2.5.0
* @access public
*
* @param string $file Filename.
* @return string|false File contents on success, false if no temp file could be opened,
@ -138,7 +135,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return array
@ -148,7 +144,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param string $contents
@ -190,7 +185,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @return string
*/
@ -202,7 +196,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $dir
* @return bool
@ -212,7 +205,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param int $mode
@ -243,7 +235,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string
@ -253,7 +244,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
return $dir[$file]['owner'];
}
/**
* @access public
*
* @param string $file
* @return string
@ -264,7 +254,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string
@ -275,7 +264,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $source
* @param string $destination
@ -293,7 +281,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $source
* @param string $destination
@ -305,7 +292,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param bool $recursive
@ -328,7 +314,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -344,7 +329,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -354,7 +338,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @return bool
@ -370,7 +353,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -380,7 +362,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -390,7 +371,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -400,7 +380,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return int
@ -410,7 +389,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return int
@ -420,7 +398,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -430,7 +407,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param mixed $chmod
@ -450,7 +426,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param bool $recursive
@ -461,7 +436,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @staticvar bool $is_windows
* @param string $line
@ -543,7 +517,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param bool $include_hidden
@ -600,7 +573,6 @@ class WP_Filesystem_FTPext extends WP_Filesystem_Base {
}
/**
* @access public
*/
public function __destruct() {
if ( $this->link )

27
wp-admin/includes/class-wp-filesystem-ftpsockets.php
View File

@ -15,13 +15,11 @@
*/
class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
/**
* @access public
* @var ftp
*/
public $ftp;
/**
* @access public
*
* @param array $opt
*/
@ -58,7 +56,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @return bool
*/
@ -108,7 +105,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
* Retrieves the file contents.
*
* @since 2.5.0
* @access public
*
* @param string $file Filename.
* @return string|false File contents on success, false if no temp file could be opened,
@ -150,7 +146,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return array
@ -160,7 +155,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param string $contents
@ -202,7 +196,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @return string
*/
@ -214,7 +207,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -224,7 +216,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param int|bool $mode
@ -253,7 +244,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string
@ -264,7 +254,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string
@ -275,7 +264,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string
@ -286,7 +274,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $source
* @param string $destination
@ -306,7 +293,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $source
* @param string $destination
@ -318,7 +304,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param bool $recursive
@ -337,7 +322,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -354,7 +338,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -368,7 +351,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @return bool
@ -383,7 +365,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -393,7 +374,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -403,7 +383,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -413,7 +392,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return int
@ -431,7 +409,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param int $time
@ -443,7 +420,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param mixed $chmod
@ -465,7 +441,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param bool $recursive
@ -476,7 +451,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param bool $include_hidden
@ -536,7 +510,6 @@ class WP_Filesystem_ftpsockets extends WP_Filesystem_Base {
}
/**
* @access public
*/
public function __destruct() {
$this->ftp->quit();

34
wp-admin/includes/class-wp-filesystem-ssh2.php
View File

@ -36,19 +36,16 @@
class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
/**
* @access public
*/
public $link = false;
/**
* @access public
* @var resource
*/
public $sftp_link;
public $keys = false;
/**
* @access public
*
* @param array $opt
*/
@ -109,7 +106,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @return bool
*/
@ -174,7 +170,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
* this, the path is converted to /./ which is semantically the same as /
* See https://bugs.php.net/bug.php?id=64169 for more details.
*
* @access public
*
* @since 4.4.0
*
@ -189,8 +184,7 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
*
* @param string $command
* @param bool $returnbool
* @return bool|string True on success, false on failure. String if the command was executed, `$returnbool`
@ -222,7 +216,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string|false
@ -232,7 +225,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return array
@ -242,7 +234,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param string $contents
@ -261,7 +252,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @return bool
*/
@ -274,7 +264,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $dir
* @return bool|string
@ -284,7 +273,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param string $group
@ -301,7 +289,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param int $mode
@ -329,7 +316,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
/**
* Change the ownership of a file / folder.
*
* @access public
*
* @param string $file Path to the file.
* @param string|int $owner A user name or number.
@ -345,7 +331,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string|false
@ -361,7 +346,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string
@ -371,7 +355,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return string|false
@ -387,7 +370,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $source
* @param string $destination
@ -405,7 +387,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $source
* @param string $destination
@ -417,7 +398,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param bool $recursive
@ -439,7 +419,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -449,7 +428,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -459,7 +437,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @return bool
@ -469,7 +446,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -479,7 +455,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return bool
@ -490,7 +465,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return int
@ -500,7 +474,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return int
@ -510,7 +483,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @return int
@ -520,7 +492,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $file
* @param int $time
@ -531,7 +502,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param mixed $chmod
@ -556,7 +526,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param bool $recursive
@ -567,7 +536,6 @@ class WP_Filesystem_SSH2 extends WP_Filesystem_Base {
}
/**
* @access public
*
* @param string $path
* @param bool $include_hidden

12
wp-admin/includes/class-wp-links-list-table.php
View File

@ -21,7 +21,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -69,7 +68,6 @@ class WP_Links_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function no_items() {
_e( 'No links found.' );
@ -151,7 +149,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Get the name of the default primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Name of the default primary column, in this case, 'name'.
*/
@ -163,7 +160,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Handles the checkbox column output.
*
* @since 4.3.0
* @access public
*
* @param object $link The current link object.
*/
@ -178,7 +174,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Handles the link name column output.
*
* @since 4.3.0
* @access public
*
* @param object $link The current link object.
*/
@ -196,7 +191,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Handles the link URL column output.
*
* @since 4.3.0
* @access public
*
* @param object $link The current link object.
*/
@ -209,7 +203,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Handles the link categories column output.
*
* @since 4.3.0
* @access public
*
* @global int $cat_id
*
@ -237,7 +230,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Handles the link relation column output.
*
* @since 4.3.0
* @access public
*
* @param object $link The current link object.
*/
@ -249,7 +241,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Handles the link visibility column output.
*
* @since 4.3.0
* @access public
*
* @param object $link The current link object.
*/
@ -265,7 +256,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Handles the link rating column output.
*
* @since 4.3.0
* @access public
*
* @param object $link The current link object.
*/
@ -277,7 +267,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Handles the default column output.
*
* @since 4.3.0
* @access public
*
* @param object $link Link object.
* @param string $column_name Current column name.
@ -311,7 +300,6 @@ class WP_Links_List_Table extends WP_List_Table {
* Generates and displays row action links.
*
* @since 4.3.0
* @access protected
*
* @param object $link Link being acted upon.
* @param string $column_name Current column name.

2
wp-admin/includes/class-wp-list-table-compat.php
View File

@ -29,7 +29,6 @@ class _WP_List_Table_Compat extends WP_List_Table {
}
/**
* @access protected
*
* @return array
*/
@ -43,7 +42,6 @@ class _WP_List_Table_Compat extends WP_List_Table {
}
/**
* @access public
*
* @return array
*/

54
wp-admin/includes/class-wp-list-table.php
View File

@ -19,7 +19,6 @@ class WP_List_Table {
* The current list of items.
*
* @since 3.1.0
* @access public
* @var array
*/
public $items;
@ -28,7 +27,6 @@ class WP_List_Table {
* Various information about the current table.
*
* @since 3.1.0
* @access protected
* @var array
*/
protected $_args;
@ -37,7 +35,6 @@ class WP_List_Table {
* Various information needed for displaying the pagination.
*
* @since 3.1.0
* @access protected
* @var array
*/
protected $_pagination_args = array();
@ -46,7 +43,6 @@ class WP_List_Table {
* The current screen.
*
* @since 3.1.0
* @access protected
* @var object
*/
protected $screen;
@ -55,7 +51,6 @@ class WP_List_Table {
* Cached bulk actions.
*
* @since 3.1.0
* @access private
* @var array
*/
private $_actions;
@ -64,7 +59,6 @@ class WP_List_Table {
* Cached pagination output.
*
* @since 3.1.0
* @access private
* @var string
*/
private $_pagination;
@ -73,7 +67,6 @@ class WP_List_Table {
* The view switcher modes.
*
* @since 4.1.0
* @access protected
* @var array
*/
protected $modes = array();
@ -82,7 +75,6 @@ class WP_List_Table {
* Stores the value returned by ->get_column_info().
*
* @since 4.1.0
* @access protected
* @var array
*/
protected $_column_headers;
@ -90,7 +82,6 @@ class WP_List_Table {
/**
* {@internal Missing Summary}
*
* @access protected
* @var array
*/
protected $compat_fields = array( '_args', '_pagination_args', 'screen', '_actions', '_pagination' );
@ -98,7 +89,6 @@ class WP_List_Table {
/**
* {@internal Missing Summary}
*
* @access protected
* @var array
*/
protected $compat_methods = array( 'set_pagination_args', 'get_views', 'get_bulk_actions', 'bulk_actions',
@ -113,7 +103,6 @@ class WP_List_Table {
* the default $args.
*
* @since 3.1.0
* @access public
*
* @param array|string $args {
* Array or string of arguments.
@ -169,7 +158,6 @@ class WP_List_Table {
* Make private properties readable for backward compatibility.
*
* @since 4.0.0
* @access public
*
* @param string $name Property to get.
* @return mixed Property.
@ -184,7 +172,6 @@ class WP_List_Table {
* Make private properties settable for backward compatibility.
*
* @since 4.0.0
* @access public
*
* @param string $name Property to check if set.
* @param mixed $value Property value.
@ -200,7 +187,6 @@ class WP_List_Table {
* Make private properties checkable for backward compatibility.
*
* @since 4.0.0
* @access public
*
* @param string $name Property to check if set.
* @return bool Whether the property is set.
@ -215,7 +201,6 @@ class WP_List_Table {
* Make private properties un-settable for backward compatibility.
*
* @since 4.0.0
* @access public
*
* @param string $name Property to unset.
*/
@ -229,7 +214,6 @@ class WP_List_Table {
* Make private/protected methods readable for backward compatibility.
*
* @since 4.0.0
* @access public
*
* @param callable $name Method to call.
* @param array $arguments Arguments to pass when calling.
@ -246,7 +230,6 @@ class WP_List_Table {
* Checks the current user's permissions
*
* @since 3.1.0
* @access public
* @abstract
*/
public function ajax_user_can() {
@ -258,7 +241,6 @@ class WP_List_Table {
* @uses WP_List_Table::set_pagination_args()
*
* @since 3.1.0
* @access public
* @abstract
*/
public function prepare_items() {
@ -269,7 +251,6 @@ class WP_List_Table {
* An internal method that sets all the necessary pagination arguments
*
* @since 3.1.0
* @access protected
*
* @param array|string $args Array or string of arguments with information about the pagination.
*/
@ -296,7 +277,6 @@ class WP_List_Table {
* Access the pagination args.
*
* @since 3.1.0
* @access public
*
* @param string $key Pagination argument to retrieve. Common values include 'total_items',
* 'total_pages', 'per_page', or 'infinite_scroll'.
@ -316,7 +296,6 @@ class WP_List_Table {
* Whether the table has items to display or not
*
* @since 3.1.0
* @access public
*
* @return bool
*/
@ -328,7 +307,6 @@ class WP_List_Table {
* Message to be displayed when there are no items
*
* @since 3.1.0
* @access public
*/
public function no_items() {
_e( 'No items found.' );
@ -338,7 +316,6 @@ class WP_List_Table {
* Displays the search box.
*
* @since 3.1.0
* @access public
*
* @param string $text The 'submit' button label.
* @param string $input_id ID attribute value for the search input field.
@ -371,7 +348,6 @@ class WP_List_Table {
* of views available on this table.
*
* @since 3.1.0
* @access protected
*
* @return array
*/
@ -383,7 +359,6 @@ class WP_List_Table {
* Display the list of views available on this table.
*
* @since 3.1.0
* @access public
*/
public function views() {
$views = $this->get_views();
@ -417,7 +392,6 @@ class WP_List_Table {
* of bulk actions available on this table.
*
* @since 3.1.0
* @access protected
*
* @return array
*/
@ -429,7 +403,6 @@ class WP_List_Table {
* Display the bulk actions dropdown.
*
* @since 3.1.0
* @access protected
*
* @param string $which The location of the bulk actions: 'top' or 'bottom'.
* This is designated as optional for backward compatibility.
@ -478,7 +451,6 @@ class WP_List_Table {
* Get the current action selected from the bulk actions dropdown.
*
* @since 3.1.0
* @access public
*
* @return string|false The action name or False if no action was selected
*/
@ -499,7 +471,6 @@ class WP_List_Table {
* Generate row actions div
*
* @since 3.1.0
* @access protected
*
* @param array $actions The list of actions
* @param bool $always_visible Whether the actions should be always visible
@ -529,7 +500,6 @@ class WP_List_Table {
* Display a monthly dropdown for filtering items
*
* @since 3.1.0
* @access protected
*
* @global wpdb $wpdb
* @global WP_Locale $wp_locale
@ -610,7 +580,6 @@ class WP_List_Table {
* Display a view switcher
*
* @since 3.1.0
* @access protected
*
* @param string $current_mode
*/
@ -639,7 +608,6 @@ class WP_List_Table {
* Display a comment count bubble
*
* @since 3.1.0
* @access protected
*
* @param int $post_id The post ID.
* @param int $pending_comments Number of pending comments.
@ -691,7 +659,6 @@ class WP_List_Table {
* Get the current page number
*
* @since 3.1.0
* @access public
*
* @return int
*/
@ -708,7 +675,6 @@ class WP_List_Table {
* Get number of items to display on a single page
*
* @since 3.1.0
* @access protected
*
* @param string $option
* @param int $default
@ -739,7 +705,6 @@ class WP_List_Table {
* Display the pagination.
*
* @since 3.1.0
* @access protected
*
* @param string $which
*/
@ -864,7 +829,6 @@ class WP_List_Table {
* 'internal-name' => 'Title'
*
* @since 3.1.0
* @access public
* @abstract
*
* @return array
@ -882,7 +846,6 @@ class WP_List_Table {
* The second format will make the initial sorting order be descending
*
* @since 3.1.0
* @access protected
*
* @return array
*/
@ -894,7 +857,6 @@ class WP_List_Table {
* Gets the name of the default primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Name of the default primary column, in this case, an empty string.
*/
@ -924,7 +886,6 @@ class WP_List_Table {
* Public wrapper for WP_List_Table::get_default_primary_column_name().
*
* @since 4.4.0
* @access public
*
* @return string Name of the default primary column.
*/
@ -936,7 +897,6 @@ class WP_List_Table {
* Gets the name of the primary column.
*
* @since 4.3.0
* @access protected
*
* @return string The name of the primary column.
*/
@ -971,7 +931,6 @@ class WP_List_Table {
* Get a list of all, hidden and sortable columns, with filter applied
*
* @since 3.1.0
* @access protected
*
* @return array
*/
@ -1026,7 +985,6 @@ class WP_List_Table {
* Return number of visible columns
*
* @since 3.1.0
* @access public
*
* @return int
*/
@ -1040,7 +998,6 @@ class WP_List_Table {
* Print column headers, accounting for hidden and sortable columns.
*
* @since 3.1.0
* @access public
*
* @staticvar int $cb_counter
*
@ -1118,7 +1075,6 @@ class WP_List_Table {
* Display the table
*
* @since 3.1.0
* @access public
*/
public function display() {
$singular = $this->_args['singular'];
@ -1156,7 +1112,6 @@ class WP_List_Table {
* Get a list of CSS classes for the WP_List_Table table tag.
*
* @since 3.1.0
* @access protected
*
* @return array List of CSS classes for the table tag.
*/
@ -1168,7 +1123,6 @@ class WP_List_Table {
* Generate the table navigation above or below the table
*
* @since 3.1.0
* @access protected
* @param string $which
*/
protected function display_tablenav( $which ) {
@ -1196,7 +1150,6 @@ class WP_List_Table {
* Extra controls to be displayed between bulk actions and pagination
*
* @since 3.1.0
* @access protected
*
* @param string $which
*/
@ -1206,7 +1159,6 @@ class WP_List_Table {
* Generate the tbody element for the list table.
*
* @since 3.1.0
* @access public
*/
public function display_rows_or_placeholder() {
if ( $this->has_items() ) {
@ -1222,7 +1174,6 @@ class WP_List_Table {
* Generate the table rows
*
* @since 3.1.0
* @access public
*/
public function display_rows() {
foreach ( $this->items as $item )
@ -1233,7 +1184,6 @@ class WP_List_Table {
* Generates content for a single row of the table
*
* @since 3.1.0
* @access public
*
* @param object $item The current item
*/
@ -1260,7 +1210,6 @@ class WP_List_Table {
* Generates the columns for a single row of the table
*
* @since 3.1.0
* @access protected
*
* @param object $item The current item
*/
@ -1313,7 +1262,6 @@ class WP_List_Table {
* Generates and display row actions links for the list table.
*
* @since 4.3.0
* @access protected
*
* @param object $item The item being acted upon.
* @param string $column_name Current column name.
@ -1328,7 +1276,6 @@ class WP_List_Table {
* Handle an incoming ajax request (called from admin-ajax.php)
*
* @since 3.1.0
* @access public
*/
public function ajax_response() {
$this->prepare_items();
@ -1361,7 +1308,6 @@ class WP_List_Table {
/**
* Send required variables to JavaScript land
*
* @access public
*/
public function _js_vars() {
$args = array(

13
wp-admin/includes/class-wp-media-list-table.php
View File

@ -21,7 +21,6 @@ class WP_Media_List_Table extends WP_List_Table {
*
* @since 4.4.0
* @var array
* @access protected
*/
protected $comment_pending_count = array();
@ -33,7 +32,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -210,7 +208,6 @@ class WP_Media_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function no_items() {
_e( 'No media files found.' );
@ -341,7 +338,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Handles the checkbox column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -358,7 +354,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Handles the title column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -405,7 +400,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Handles the author column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -420,7 +414,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Handles the description column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -432,7 +425,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Handles the date column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -460,7 +452,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Handles the parent column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -521,7 +512,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Handles the comments column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -543,7 +533,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Handles output for the default column.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
* @param string $column_name Current column name.
@ -629,7 +618,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Gets the name of the default primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Name of the default primary column, in this case, 'title'.
*/
@ -764,7 +752,6 @@ class WP_Media_List_Table extends WP_List_Table {
* Generates and displays row action links.
*
* @since 4.3.0
* @access protected
*
* @param object $post Attachment being acted upon.
* @param string $column_name Current column name.

13
wp-admin/includes/class-wp-ms-sites-list-table.php
View File

@ -21,7 +21,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Site status list.
*
* @since 4.3.0
* @access public
* @var array
*/
public $status_list;
@ -30,7 +29,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -186,7 +184,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function no_items() {
_e( 'No sites found.' );
@ -262,7 +259,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Handles the checkbox column output.
*
* @since 4.3.0
* @access public
*
* @param array $blog Current site.
*/
@ -281,7 +277,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Handles the ID column output.
*
* @since 4.4.0
* @access public
*
* @param array $blog Current site.
*/
@ -293,7 +288,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Handles the site name column output.
*
* @since 4.3.0
* @access public
*
* @global string $mode List table view mode.
*
@ -347,7 +341,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Handles the lastupdated column output.
*
* @since 4.3.0
* @access public
*
* @global string $mode List table view mode.
*
@ -369,7 +362,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Handles the registered column output.
*
* @since 4.3.0
* @access public
*
* @global string $mode List table view mode.
*
@ -395,7 +387,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Handles the users column output.
*
* @since 4.3.0
* @access public
*
* @param array $blog Current site.
*/
@ -419,7 +410,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Handles the plugins column output.
*
* @since 4.3.0
* @access public
*
* @param array $blog Current site.
*/
@ -442,7 +432,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Handles output for the default column.
*
* @since 4.3.0
* @access public
*
* @param array $blog Current site.
* @param string $column_name Current column name.
@ -487,7 +476,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Gets the name of the default primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Name of the default primary column, in this case, 'blogname'.
*/
@ -499,7 +487,6 @@ class WP_MS_Sites_List_Table extends WP_List_Table {
* Generates and displays row action links.
*
* @since 4.3.0
* @access protected
*
* @param object $blog Site being acted upon.
* @param string $column_name Current column name.

9
wp-admin/includes/class-wp-ms-themes-list-table.php
View File

@ -26,7 +26,6 @@ class WP_MS_Themes_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -227,7 +226,6 @@ class WP_MS_Themes_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function no_items() {
if ( $this->has_items ) {
@ -263,7 +261,6 @@ class WP_MS_Themes_List_Table extends WP_List_Table {
* Gets the name of the primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Unalterable name of the primary column name, in this case, 'name'.
*/
@ -343,7 +340,6 @@ class WP_MS_Themes_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function display_rows() {
foreach ( $this->items as $theme )
@ -354,7 +350,6 @@ class WP_MS_Themes_List_Table extends WP_List_Table {
* Handles the checkbox column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Theme $theme The current WP_Theme object.
*/
@ -370,7 +365,6 @@ class WP_MS_Themes_List_Table extends WP_List_Table {
* Handles the name column output.
*
* @since 4.3.0
* @access public
*
* @global string $status
* @global int $page
@ -512,7 +506,6 @@ class WP_MS_Themes_List_Table extends WP_List_Table {
* Handles the description column output.
*
* @since 4.3.0
* @access public
*
* @global string $status
* @global array $totals
@ -580,7 +573,6 @@ class WP_MS_Themes_List_Table extends WP_List_Table {
* Handles default column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Theme $theme The current WP_Theme object.
* @param string $column_name The current column name.
@ -604,7 +596,6 @@ class WP_MS_Themes_List_Table extends WP_List_Table {
* Handles the output for a single table row.
*
* @since 4.3.0
* @access public
*
* @param WP_Theme $item The current WP_Theme object.
*/

12
wp-admin/includes/class-wp-ms-users-list-table.php
View File

@ -117,7 +117,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function no_items() {
_e( 'No users found.' );
@ -200,7 +199,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Handles the checkbox column output.
*
* @since 4.3.0
* @access public
*
* @param WP_User $user The current WP_User object.
*/
@ -218,7 +216,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Handles the ID column output.
*
* @since 4.4.0
* @access public
*
* @param WP_User $user The current WP_User object.
*/
@ -230,7 +227,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Handles the username column output.
*
* @since 4.3.0
* @access public
*
* @param WP_User $user The current WP_User object.
*/
@ -253,7 +249,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Handles the name column output.
*
* @since 4.3.0
* @access public
*
* @param WP_User $user The current WP_User object.
*/
@ -269,7 +264,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Handles the email column output.
*
* @since 4.3.0
* @access public
*
* @param WP_User $user The current WP_User object.
*/
@ -281,7 +275,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Handles the registered date column output.
*
* @since 4.3.0
* @access public
*
* @global string $mode List table view mode.
*
@ -299,7 +292,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
/**
* @since 4.3.0
* @access protected
*
* @param WP_User $user
* @param string $classes
@ -317,7 +309,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Handles the sites column output.
*
* @since 4.3.0
* @access public
*
* @param WP_User $user The current WP_User object.
*/
@ -382,7 +373,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Handles the default column output.
*
* @since 4.3.0
* @access public
*
* @param WP_User $user The current WP_User object.
* @param string $column_name The current column name.
@ -416,7 +406,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Gets the name of the default primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Name of the default primary column, in this case, 'username'.
*/
@ -428,7 +417,6 @@ class WP_MS_Users_List_Table extends WP_List_Table {
* Generates and displays row action links.
*
* @since 4.3.0
* @access protected
*
* @param object $user User being acted upon.
* @param string $column_name Current column name.

2
wp-admin/includes/class-wp-plugin-install-list-table.php
View File

@ -39,7 +39,6 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
* within get_plugins().
*
* @since 4.0.0
* @access protected
*
* @return array
*/
@ -228,7 +227,6 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function no_items() {
if ( isset( $this->error ) ) {

3
wp-admin/includes/class-wp-plugins-list-table.php
View File

@ -21,7 +21,6 @@ class WP_Plugins_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -346,7 +345,6 @@ class WP_Plugins_List_Table extends WP_List_Table {
* Displays the search box.
*
* @since 4.6.0
* @access public
*
* @param string $text The 'submit' button label.
* @param string $input_id ID attribute value for the search input field.
@ -864,7 +862,6 @@ class WP_Plugins_List_Table extends WP_List_Table {
* Gets the name of the primary column for this specific list table.
*
* @since 4.3.0
* @access protected
*
* @return string Unalterable name for the primary column, in this case, 'name'.
*/

18
wp-admin/includes/class-wp-posts-list-table.php
View File

@ -22,7 +22,6 @@ class WP_Posts_List_Table extends WP_List_Table {
*
* @since 3.1.0
* @var bool
* @access protected
*/
protected $hierarchical_display;
@ -31,7 +30,6 @@ class WP_Posts_List_Table extends WP_List_Table {
*
* @since 3.1.0
* @var array
* @access protected
*/
protected $comment_pending_count;
@ -40,7 +38,6 @@ class WP_Posts_List_Table extends WP_List_Table {
*
* @since 3.1.0
* @var int
* @access private
*/
private $user_posts_count;
@ -49,7 +46,6 @@ class WP_Posts_List_Table extends WP_List_Table {
*
* @since 3.1.0
* @var int
* @access private
*/
private $sticky_posts_count = 0;
@ -59,7 +55,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Current level for output.
*
* @since 4.3.0
* @access protected
* @var int
*/
protected $current_level = 0;
@ -68,7 +63,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -196,7 +190,6 @@ class WP_Posts_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function no_items() {
if ( isset( $_REQUEST['post_status'] ) && 'trash' === $_REQUEST['post_status'] )
@ -229,7 +222,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Helper to create links to edit.php with params.
*
* @since 4.4.0
* @access protected
*
* @param array $args URL parameters for the link.
* @param string $label Link text.
@ -415,7 +407,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Displays a categories drop-down for filtering on the Posts list table.
*
* @since 4.6.0
* @access protected
*
* @global int $cat Currently selected category.
*
@ -826,7 +817,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Handles the checkbox column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -851,7 +841,6 @@ class WP_Posts_List_Table extends WP_List_Table {
/**
* @since 4.3.0
* @access protected
*
* @param WP_Post $post
* @param string $classes
@ -869,7 +858,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Handles the title column output.
*
* @since 4.3.0
* @access public
*
* @global string $mode List table view mode.
*
@ -966,7 +954,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Handles the post date column output.
*
* @since 4.3.0
* @access public
*
* @global string $mode List table view mode.
*
@ -1047,7 +1034,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Handles the comments column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -1067,7 +1053,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Handles the post author column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
*/
@ -1083,7 +1068,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Handles the default column output.
*
* @since 4.3.0
* @access public
*
* @param WP_Post $post The current WP_Post object.
* @param string $column_name The current column name.
@ -1209,7 +1193,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Gets the name of the default primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Name of the default primary column, in this case, 'title'.
*/
@ -1221,7 +1204,6 @@ class WP_Posts_List_Table extends WP_List_Table {
* Generates and displays row action links.
*
* @since 4.3.0
* @access protected
*
* @param object $post Post being acted upon.
* @param string $column_name Current column name.

19
wp-admin/includes/class-wp-press-this.php
View File

@ -27,7 +27,6 @@ class WP_Press_This {
* Constructor.
*
* @since 4.2.0
* @access public
*/
public function __construct() {}
@ -35,7 +34,6 @@ class WP_Press_This {
* App and site settings data, including i18n strings for the client-side.
*
* @since 4.2.0
* @access public
*
* @return array Site settings.
*/
@ -56,7 +54,6 @@ class WP_Press_This {
* Get the source's images and save them locally, for posterity, unless we can't.
*
* @since 4.2.0
* @access public
*
* @param int $post_id Post ID.
* @param string $content Optional. Current expected markup for Press This. Expects slashed. Default empty.
@ -99,7 +96,6 @@ class WP_Press_This {
* Ajax handler for saving the post as draft or published.
*
* @since 4.2.0
* @access public
*/
public function save_post() {
if ( empty( $_POST['post_ID'] ) || ! $post_id = (int) $_POST['post_ID'] ) {
@ -210,7 +206,6 @@ class WP_Press_This {
* Ajax handler for adding a new category.
*
* @since 4.2.0
* @access public
*/
public function add_category() {
if ( false === wp_verify_nonce( $_POST['new_cat_nonce'], 'add-category' ) ) {
@ -279,7 +274,6 @@ class WP_Press_This {
* Downloads the source's HTML via server-side call for the given URL.
*
* @since 4.2.0
* @access public
*
* @param string $url URL to scan.
* @return string Source's HTML sanitized markup
@ -562,7 +556,6 @@ class WP_Press_This {
* Fetches and parses _meta, _images, and _links data from the source.
*
* @since 4.2.0
* @access public
*
* @param string $url URL to scan.
* @param array $data Optional. Existing data array if you have one. Default empty array.
@ -672,7 +665,6 @@ class WP_Press_This {
* Handles backward-compat with the legacy version of Press This by supporting its query string params.
*
* @since 4.2.0
* @access public
*
* @return array
*/
@ -798,7 +790,6 @@ class WP_Press_This {
* Adds another stylesheet inside TinyMCE.
*
* @since 4.2.0
* @access public
*
* @param string $styles URL to editor stylesheet.
* @return string Possibly modified stylesheets list.
@ -820,7 +811,6 @@ class WP_Press_This {
* Outputs the post format selection HTML.
*
* @since 4.2.0
* @access public
*
* @param WP_Post $post Post object.
*/
@ -868,7 +858,6 @@ class WP_Press_This {
* Outputs the categories HTML.
*
* @since 4.2.0
* @access public
*
* @param WP_Post $post Post object.
*/
@ -926,7 +915,6 @@ class WP_Press_This {
* Outputs the tags HTML.
*
* @since 4.2.0
* @access public
*
* @param WP_Post $post Post object.
*/
@ -977,7 +965,6 @@ class WP_Press_This {
* Get a list of embeds with no duplicates.
*
* @since 4.2.0
* @access public
*
* @param array $data The site's data.
* @return array Embeds selected to be available.
@ -1010,7 +997,6 @@ class WP_Press_This {
* Get a list of images with no duplicates.
*
* @since 4.2.0
* @access public
*
* @param array $data The site's data.
* @return array
@ -1044,7 +1030,6 @@ class WP_Press_This {
* Gets the source page's canonical link, based on passed location and meta data.
*
* @since 4.2.0
* @access public
*
* @param array $data The site's data.
* @return string Discovered canonical URL, or empty
@ -1075,7 +1060,6 @@ class WP_Press_This {
* Gets the source page's site name, based on passed meta data.
*
* @since 4.2.0
* @access public
*
* @param array $data The site's data.
* @return string Discovered site name, or empty
@ -1098,7 +1082,6 @@ class WP_Press_This {
* Gets the source page's title, based on passed title and meta data.
*
* @since 4.2.0
* @access public
*
* @param array $data The site's data.
* @return string Discovered page title, or empty
@ -1127,7 +1110,6 @@ class WP_Press_This {
* Features a blockquoted excerpt, as well as content attribution, if any.
*
* @since 4.2.0
* @access public
*
* @param array $data The site's data.
* @return string Discovered content, or empty
@ -1212,7 +1194,6 @@ class WP_Press_This {
* Serves the app's base HTML, which in turns calls the load script.
*
* @since 4.2.0
* @access public
*
* @global WP_Locale $wp_locale
* @global bool $is_IE

21
wp-admin/includes/class-wp-screen.php
View File

@ -18,7 +18,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var string
* @access public
*/
public $action;
@ -28,7 +27,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var string
* @access public
*/
public $base;
@ -37,7 +35,6 @@ final class WP_Screen {
*
* @since 3.4.0
* @var int
* @access private
*/
private $columns = 0;
@ -46,7 +43,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var string
* @access public
*/
public $id;
@ -55,7 +51,6 @@ final class WP_Screen {
*
* @since 3.5.0
* @var string
* @access protected
*/
protected $in_admin;
@ -67,7 +62,6 @@ final class WP_Screen {
* @since 3.3.0
* @deprecated 3.5.0
* @var bool
* @access public
*/
public $is_network;
@ -79,7 +73,6 @@ final class WP_Screen {
* @since 3.3.0
* @deprecated 3.5.0
* @var bool
* @access public
*/
public $is_user;
@ -90,7 +83,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var string
* @access public
*/
public $parent_base;
@ -100,7 +92,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var string
* @access public
*/
public $parent_file;
@ -111,7 +102,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var string
* @access public
*/
public $post_type;
@ -120,7 +110,6 @@ final class WP_Screen {
* The 'edit-tags.php?taxonomy=category' screen has a taxonomy of 'category'.
* @since 3.3.0
* @var string
* @access public
*/
public $taxonomy;
@ -129,7 +118,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var array
* @access private
*/
private $_help_tabs = array();
@ -138,7 +126,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var string
* @access private
*/
private $_help_sidebar = '';
@ -146,7 +133,6 @@ final class WP_Screen {
* The accessible hidden headings and text associated with the screen, if any.
*
* @since 4.4.0
* @access private
* @var array
*/
private $_screen_reader_content = array();
@ -155,7 +141,6 @@ final class WP_Screen {
* Stores old string-based help.
*
* @static
* @access private
*
* @var array
*/
@ -166,7 +151,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var array
* @access private
*/
private $_options = array();
@ -176,7 +160,6 @@ final class WP_Screen {
* @since 3.3.0
*
* @static
* @access private
*
* @var array
*/
@ -187,7 +170,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var bool
* @access private
*/
private $_show_screen_options;
@ -196,7 +178,6 @@ final class WP_Screen {
*
* @since 3.3.0
* @var string
* @access private
*/
private $_screen_settings;
@ -204,7 +185,6 @@ final class WP_Screen {
* Fetches a screen object.
*
* @since 3.3.0
* @access public
*
* @static
*
@ -400,7 +380,6 @@ final class WP_Screen {
* Constructor
*
* @since 3.3.0
* @access private
*/
private function __construct() {}

9
wp-admin/includes/class-wp-site-icon.php
View File

@ -18,7 +18,6 @@ class WP_Site_Icon {
* The minimum size of the site icon.
*
* @since 4.3.0
* @access public
* @var int
*/
public $min_size = 512;
@ -27,7 +26,6 @@ class WP_Site_Icon {
* The size to which to crop the image so that we can display it in the UI nicely.
*
* @since 4.3.0
* @access public
* @var int
*/
public $page_crop = 512;
@ -36,7 +34,6 @@ class WP_Site_Icon {
* List of site icon sizes.
*
* @since 4.3.0
* @access public
* @var array
*/
public $site_icon_sizes = array(
@ -70,7 +67,6 @@ class WP_Site_Icon {
* Registers actions and filters.
*
* @since 4.3.0
* @access public
*/
public function __construct() {
add_action( 'delete_attachment', array( $this, 'delete_attachment_data' ) );
@ -110,7 +106,6 @@ class WP_Site_Icon {
* Inserts an attachment.
*
* @since 4.3.0
* @access public
*
* @param array $object Attachment object.
* @param string $file File path of the attached image.
@ -139,7 +134,6 @@ class WP_Site_Icon {
* Adds additional sizes to be made when creating the site_icon images.
*
* @since 4.3.0
* @access public
*
* @param array $sizes List of additional sizes.
* @return array Additional image sizes.
@ -184,7 +178,6 @@ class WP_Site_Icon {
* Adds Site Icon sizes to the array of image sizes on demand.
*
* @since 4.3.0
* @access public
*
* @param array $sizes List of image sizes.
* @return array List of intermediate image sizes.
@ -203,7 +196,6 @@ class WP_Site_Icon {
* Deletes the Site Icon when the image file is deleted.
*
* @since 4.3.0
* @access public
*
* @param int $post_id Attachment ID.
*/
@ -219,7 +211,6 @@ class WP_Site_Icon {
* Adds custom image sizes when meta data for an image is requested, that happens to be used as Site Icon.
*
* @since 4.3.0
* @access public
*
* @param null|array|string $value The value get_metadata() should return a single metadata value, or an
* array of values.

6
wp-admin/includes/class-wp-terms-list-table.php
View File

@ -25,7 +25,6 @@ class WP_Terms_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -72,7 +71,6 @@ class WP_Terms_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function prepare_items() {
$tags_per_page = $this->get_items_per_page( 'edit_' . $this->screen->taxonomy . '_per_page' );
@ -139,7 +137,6 @@ class WP_Terms_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function no_items() {
echo get_taxonomy( $this->screen->taxonomy )->labels->not_found;
@ -206,7 +203,6 @@ class WP_Terms_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function display_rows_or_placeholder() {
$taxonomy = $this->screen->taxonomy;
@ -399,7 +395,6 @@ class WP_Terms_List_Table extends WP_List_Table {
* Gets the name of the default primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Name of the default primary column, in this case, 'name'.
*/
@ -411,7 +406,6 @@ class WP_Terms_List_Table extends WP_List_Table {
* Generates and displays row action links.
*
* @since 4.3.0
* @access protected
*
* @param WP_Term $tag Tag being acted upon.
* @param string $column_name Current column name.

6
wp-admin/includes/class-wp-theme-install-list-table.php
View File

@ -154,7 +154,6 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
}
/**
* @access public
*/
public function no_items() {
_e( 'No themes match your request.' );
@ -180,7 +179,6 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
}
/**
* @access public
*/
public function display() {
wp_nonce_field( "fetch-list-" . get_class( $this ), '_ajax_fetch_list_nonce' );
@ -209,7 +207,6 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
}
/**
* @access public
*/
public function display_rows() {
$themes = $this->items;
@ -227,7 +224,6 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
* Prints a theme from the WordPress.org API.
*
* @since 3.1.0
* @access public
*
* @global array $themes_allowedtags
*
@ -436,7 +432,6 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
* Send required variables to JavaScript land
*
* @since 3.4.0
* @access public
*
* @global string $tab Current tab within Themes->Install screen
* @global string $type Type of search.
@ -452,7 +447,6 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
* Check to see if the theme is already installed.
*
* @since 3.4.0
* @access private
*
* @param object $theme - A WordPress.org Theme API object.
* @return string Theme status.

7
wp-admin/includes/class-wp-themes-list-table.php
View File

@ -24,7 +24,6 @@ class WP_Themes_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -47,7 +46,6 @@ class WP_Themes_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function prepare_items() {
$themes = wp_get_themes( array( 'allowed' => true ) );
@ -83,7 +81,6 @@ class WP_Themes_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function no_items() {
if ( $this->search_terms || $this->features ) {
@ -130,7 +127,6 @@ class WP_Themes_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function display() {
wp_nonce_field( "fetch-list-" . get_class( $this ), '_ajax_fetch_list_nonce' );
@ -154,7 +150,6 @@ class WP_Themes_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function display_rows_or_placeholder() {
if ( $this->has_items() ) {
@ -167,7 +162,6 @@ class WP_Themes_List_Table extends WP_List_Table {
}
/**
* @access public
*/
public function display_rows() {
$themes = $this->items;
@ -286,7 +280,6 @@ class WP_Themes_List_Table extends WP_List_Table {
* Send required variables to JavaScript land
*
* @since 3.4.0
* @access public
*
* @param array $extra_args
*/

15
wp-admin/includes/class-wp-upgrader-skin.php
View File

@ -23,14 +23,12 @@ class WP_Upgrader_Skin {
* Holds the result of an upgrade.
*
* @since 2.8.0
* @access public
* @var string|bool|WP_Error
*/
public $result = false;
public $options = array();
/**
* @access public
*
* @param array $args
*/
@ -40,7 +38,6 @@ class WP_Upgrader_Skin {
}
/**
* @access public
*
* @param WP_Upgrader $upgrader
*/
@ -51,7 +48,6 @@ class WP_Upgrader_Skin {
}
/**
* @access public
*/
public function add_strings() {
}
@ -60,7 +56,6 @@ class WP_Upgrader_Skin {
* Sets the result of an upgrade.
*
* @since 2.8.0
* @access public
*
* @param string|bool|WP_Error $result The result of an upgrade.
*/
@ -74,7 +69,6 @@ class WP_Upgrader_Skin {
*
* @since 2.8.0
* @since 4.6.0 The `$context` parameter default changed from `false` to an empty string.
* @access public
*
* @see request_filesystem_credentials()
*
@ -100,7 +94,6 @@ class WP_Upgrader_Skin {
}
/**
* @access public
*/
public function header() {
if ( $this->done_header ) {
@ -112,7 +105,6 @@ class WP_Upgrader_Skin {
}
/**
* @access public
*/
public function footer() {
if ( $this->done_footer ) {
@ -123,7 +115,6 @@ class WP_Upgrader_Skin {
}
/**
* @access public
*
* @param string|WP_Error $errors
*/
@ -143,7 +134,6 @@ class WP_Upgrader_Skin {
}
/**
* @access public
*
* @param string $string
*/
@ -166,12 +156,10 @@ class WP_Upgrader_Skin {
}
/**
* @access public
*/
public function before() {}
/**
* @access public
*/
public function after() {}
@ -179,7 +167,6 @@ class WP_Upgrader_Skin {
* Output JavaScript that calls function to decrement the update counts.
*
* @since 3.9.0
* @access protected
*
* @param string $type Type of update count to decrement. Likely values include 'plugin',
* 'theme', 'translation', etc.
@ -207,12 +194,10 @@ class WP_Upgrader_Skin {
}
/**
* @access public
*/
public function bulk_header() {}
/**
* @access public
*/
public function bulk_footer() {}
}

15
wp-admin/includes/class-wp-upgrader.php
View File

@ -54,7 +54,6 @@ class WP_Upgrader {
* The error/notification strings used to update the user on the progress.
*
* @since 2.8.0
* @access public
* @var array $strings
*/
public $strings = array();
@ -63,7 +62,6 @@ class WP_Upgrader {
* The upgrader skin being used.
*
* @since 2.8.0
* @access public
* @var Automatic_Upgrader_Skin|WP_Upgrader_Skin $skin
*/
public $skin = null;
@ -77,7 +75,6 @@ class WP_Upgrader {
* it.
*
* @since 2.8.0
* @access public
*
* @var WP_Error|array $result {
* @type string $source The full path to the source the files were installed from.
@ -100,7 +97,6 @@ class WP_Upgrader {
* Set by the bulk update methods.
*
* @since 3.0.0
* @access public
* @var int $update_count
*/
public $update_count = 0;
@ -111,7 +107,6 @@ class WP_Upgrader {
* Used by the bulk update methods, and incremented for each update.
*
* @since 3.0.0
* @access public
* @var int
*/
public $update_current = 0;
@ -120,7 +115,6 @@ class WP_Upgrader {
* Construct the upgrader with a skin.
*
* @since 2.8.0
* @access public
*
* @param WP_Upgrader_Skin $skin The upgrader skin to use. Default is a WP_Upgrader_Skin.
* instance.
@ -139,7 +133,6 @@ class WP_Upgrader {
* and also add the generic strings to `WP_Upgrader::$strings`.
*
* @since 2.8.0
* @access public
*/
public function init() {
$this->skin->set_upgrader($this);
@ -150,7 +143,6 @@ class WP_Upgrader {
* Add the generic strings to WP_Upgrader::$strings.
*
* @since 2.8.0
* @access public
*/
public function generic_strings() {
$this->strings['bad_request'] = __('Invalid data provided.');
@ -179,7 +171,6 @@ class WP_Upgrader {
* Connect to the filesystem.
*
* @since 2.8.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*
@ -243,7 +234,6 @@ class WP_Upgrader {
* Download a package.
*
* @since 2.8.0
* @access public
*
* @param string $package The URI of the package. If this is the full path to an
* existing local file, it will be returned untouched.
@ -286,7 +276,6 @@ class WP_Upgrader {
* Unpack a compressed package file.
*
* @since 2.8.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*
@ -338,7 +327,6 @@ class WP_Upgrader {
* Clears the directory where this item is going to be installed into.
*
* @since 4.3.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*
@ -402,7 +390,6 @@ class WP_Upgrader {
* clear out the destination folder if it already exists.
*
* @since 2.8.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
* @global array $wp_theme_directories
@ -610,7 +597,6 @@ class WP_Upgrader {
* install it in the destination folder.
*
* @since 2.8.0
* @access public
*
* @param array $options {
* Array or string of arguments for upgrading/installing a package.
@ -802,7 +788,6 @@ class WP_Upgrader {
* Creates/deletes the maintenance file to enable/disable maintenance mode.
*
* @since 2.8.0
* @access public
*
* @global WP_Filesystem_Base $wp_filesystem Subclass
*

16
wp-admin/includes/class-wp-users-list-table.php
View File

@ -21,7 +21,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Site ID to generate the Users list table for.
*
* @since 3.1.0
* @access public
* @var int
*/
public $site_id;
@ -30,7 +29,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Whether or not the current Users list table is for Multisite.
*
* @since 3.1.0
* @access public
* @var bool
*/
public $is_site_users;
@ -39,7 +37,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Constructor.
*
* @since 3.1.0
* @access public
*
* @see WP_List_Table::__construct() for more information on default arguments.
*
@ -62,7 +59,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Check the current user's permissions.
*
* @since 3.1.0
* @access public
*
* @return bool
*/
@ -77,7 +73,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Prepare the users list for display.
*
* @since 3.1.0
* @access public
*
* @global string $role
* @global string $usersearch
@ -149,7 +144,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Output 'no users' message.
*
* @since 3.1.0
* @access public
*/
public function no_items() {
_e( 'No users found.' );
@ -163,7 +157,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Filtersing of the user table.
*
* @since 3.1.0
* @access protected
*
* @global string $role
*
@ -229,7 +222,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Retrieve an associative array of bulk actions available on this table.
*
* @since 3.1.0
* @access protected
*
* @return array Array of bulk actions.
*/
@ -251,7 +243,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Output the controls to allow user roles to be changed in bulk.
*
* @since 3.1.0
* @access protected
*
* @param string $which Whether this is being invoked above ("top")
* or below the table ("bottom").
@ -302,7 +293,6 @@ class WP_Users_List_Table extends WP_List_Table {
* the role change drop-down.
*
* @since 3.1.0
* @access public
*
* @return string The bulk action required.
*/
@ -319,7 +309,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Get a list of columns for the list table.
*
* @since 3.1.0
* @access public
*
* @return array Array in which the key is the ID of the column,
* and the value is the description.
@ -344,7 +333,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Get a list of sortable columns for the list table.
*
* @since 3.1.0
* @access protected
*
* @return array Array of sortable columns.
*/
@ -361,7 +349,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Generate the list table rows.
*
* @since 3.1.0
* @access public
*/
public function display_rows() {
// Query the post counts for this page
@ -379,7 +366,6 @@ class WP_Users_List_Table extends WP_List_Table {
* @since 3.1.0
* @since 4.2.0 The `$style` parameter was deprecated.
* @since 4.4.0 The `$role` parameter was deprecated.
* @access public
*
* @param WP_User $user_object The current user object.
* @param string $style Deprecated. Not used.
@ -548,7 +534,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Gets the name of the default primary column.
*
* @since 4.3.0
* @access protected
*
* @return string Name of the default primary column, in this case, 'username'.
*/
@ -560,7 +545,6 @@ class WP_Users_List_Table extends WP_List_Table {
* Returns an array of user roles for a given user object.
*
* @since 4.4.0
* @access protected
*
* @param WP_User $user_object The WP_User object.
* @return array An array of user roles.

2
wp-includes/version.php
View File

@ -4,7 +4,7 @@
*
* @global string $wp_version
*/
$wp_version = '4.9-alpha-41160';
$wp_version = '4.9-alpha-41161';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.