From d1fe2eec5c546e407b965634a4eb6225f3e88bad Mon Sep 17 00:00:00 2001 From: audrasjb Date: Sun, 13 Mar 2022 21:56:01 +0000 Subject: [PATCH] Docs: Miscellaneous fixes in `wp-admin/includes/plugin-install.php` and `wp-admin/includes/plugin.php`. See #54729. Built from https://develop.svn.wordpress.org/trunk@52931 git-svn-id: http://core.svn.wordpress.org/trunk@52520 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-admin/includes/plugin-install.php | 14 +++++++------ wp-admin/includes/plugin.php | 30 ++++++++++++++-------------- wp-includes/version.php | 2 +- 3 files changed, 24 insertions(+), 22 deletions(-) diff --git a/wp-admin/includes/plugin-install.php b/wp-admin/includes/plugin-install.php index 747f461331..3f7c07703f 100644 --- a/wp-admin/includes/plugin-install.php +++ b/wp-admin/includes/plugin-install.php @@ -235,7 +235,7 @@ function plugins_api( $action, $args = array() ) { } /** - * Retrieve popular WordPress plugin tags. + * Retrieves popular WordPress plugin tags. * * @since 2.7.0 * @@ -261,6 +261,8 @@ function install_popular_tags( $args = array() ) { } /** + * Displays plugin install dashboard. + * * @since 2.7.0 */ function install_dashboard() { @@ -342,7 +344,7 @@ function install_search_form( $deprecated = true ) { } /** - * Upload from zip + * Displays a form to upload plugins from zip files. * * @since 2.8.0 */ @@ -361,7 +363,7 @@ function install_plugins_upload() { } /** - * Show a username form for the favorites page + * Shows a username form for the favorites page. * * @since 3.5.0 */ @@ -383,7 +385,7 @@ function install_plugins_favorites_form() { } /** - * Display plugin content based on plugin list. + * Displays plugin content based on plugin list. * * @since 2.7.0 * @@ -418,7 +420,7 @@ function display_plugins_table() { } /** - * Determine the status we can perform on a plugin. + * Determines the status we can perform on a plugin. * * @since 3.0.0 * @@ -508,7 +510,7 @@ function install_plugin_install_status( $api, $loop = false ) { } /** - * Display plugin information in dialog box form. + * Displays plugin information in dialog box form. * * @since 2.7.0 * diff --git a/wp-admin/includes/plugin.php b/wp-admin/includes/plugin.php index 3850b41f3d..da00c2d456 100644 --- a/wp-admin/includes/plugin.php +++ b/wp-admin/includes/plugin.php @@ -215,7 +215,7 @@ function _get_plugin_data_markup_translate( $plugin_file, $plugin_data, $markup } /** - * Get a list of a plugin's files. + * Gets a list of a plugin's files. * * @since 2.8.0 * @@ -250,7 +250,7 @@ function get_plugin_files( $plugin ) { } /** - * Check the plugins directory and retrieve all plugin files with plugin data. + * Checks the plugins directory and retrieve all plugin files with plugin data. * * WordPress only supports plugin files in the base plugins directory * (wp-content/plugins) and in one directory above the plugins directory @@ -350,7 +350,7 @@ function get_plugins( $plugin_folder = '' ) { } /** - * Check the mu-plugins directory and retrieve all mu-plugin files with any plugin data. + * Checks the mu-plugins directory and retrieve all mu-plugin files with any plugin data. * * WordPress only includes mu-plugin files in the base mu-plugins directory (wp-content/mu-plugins). * @@ -409,7 +409,7 @@ function get_mu_plugins() { } /** - * Callback to sort array by a 'Name' key. + * Declares a callback to sort array by a 'Name' key. * * @since 3.1.0 * @@ -424,7 +424,7 @@ function _sort_uname_callback( $a, $b ) { } /** - * Check the wp-content directory and retrieve all drop-ins with any plugin data. + * Checks the wp-content directory and retrieve all drop-ins with any plugin data. * * @since 3.0.0 * @return array[] Array of arrays of dropin plugin data, keyed by plugin file name. See `get_plugin_data()`. @@ -728,7 +728,7 @@ function activate_plugin( $plugin, $redirect = '', $network_wide = false, $silen } /** - * Deactivate a single plugin or multiple plugins. + * Deactivates a single plugin or multiple plugins. * * The deactivation hook is disabled by the plugin upgrader by using the $silent * parameter. @@ -836,7 +836,7 @@ function deactivate_plugins( $plugins, $silent = false, $network_wide = null ) { } /** - * Activate multiple plugins. + * Activates multiple plugins. * * When WP_Error is returned, it does not mean that one of the plugins had * errors. It means that one or more of the plugin file paths were invalid. @@ -876,7 +876,7 @@ function activate_plugins( $plugins, $redirect = '', $network_wide = false, $sil } /** - * Remove directory and files of a plugin for a list of plugins. + * Removes directory and files of a plugin for a list of plugins. * * @since 2.6.0 * @@ -1041,7 +1041,7 @@ function delete_plugins( $plugins, $deprecated = '' ) { } /** - * Validate active plugins + * Validates active plugins. * * Validate all active plugins, deactivates invalid and * returns an array of deactivated ones. @@ -1080,7 +1080,7 @@ function validate_active_plugins() { } /** - * Validate the plugin path. + * Validates the plugin path. * * Checks that the main plugin file exists and is a valid plugin. See validate_file(). * @@ -1182,7 +1182,7 @@ function validate_plugin_requirements( $plugin ) { } /** - * Whether the plugin can be uninstalled. + * Determines whether the plugin can be uninstalled. * * @since 2.7.0 * @@ -1201,7 +1201,7 @@ function is_uninstallable_plugin( $plugin ) { } /** - * Uninstall a single plugin. + * Uninstalls a single plugin. * * Calls the uninstall hook, if it is available. * @@ -2259,7 +2259,7 @@ function remove_allowed_options( $del_options, $options = '' ) { } /** - * Output nonce, action, and option_page fields for a settings page. + * Outputs nonce, action, and option_page fields for a settings page. * * @since 2.7.0 * @@ -2287,7 +2287,7 @@ function wp_clean_plugins_cache( $clear_update_cache = true ) { } /** - * Load a given plugin attempt to generate errors. + * Loads a given plugin attempt to generate errors. * * @since 3.0.0 * @since 4.4.0 Function was moved into the `wp-admin/includes/plugin.php` file. @@ -2304,7 +2304,7 @@ function plugin_sandbox_scrape( $plugin ) { } /** - * Helper function for adding content to the Privacy Policy Guide. + * Declares an helper function for adding content to the Privacy Policy Guide. * * Plugins and themes should suggest text for inclusion in the site's privacy policy. * The suggested text should contain information about any functionality that affects user privacy, diff --git a/wp-includes/version.php b/wp-includes/version.php index b24fe1fa1b..4b96462cff 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -16,7 +16,7 @@ * * @global string $wp_version */ -$wp_version = '6.0-alpha-52930'; +$wp_version = '6.0-alpha-52931'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.