Docs: Use a consistent description for $plugin parameter in various plugin API functions.

See #36333.
Built from https://develop.svn.wordpress.org/trunk@39890


git-svn-id: http://core.svn.wordpress.org/trunk@39827 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2017-01-12 06:16:41 +00:00
parent a989f0b168
commit 327a11ad65
2 changed files with 16 additions and 16 deletions

View File

@ -47,7 +47,7 @@
* *
* @since 1.5.0 * @since 1.5.0
* *
* @param string $plugin_file Path to the plugin file * @param string $plugin_file Path to the main plugin file.
* @param bool $markup Optional. If the returned data should have HTML markup applied. * @param bool $markup Optional. If the returned data should have HTML markup applied.
* Default true. * Default true.
* @param bool $translate Optional. If the returned data should be translated. Default true. * @param bool $translate Optional. If the returned data should be translated. Default true.
@ -187,7 +187,7 @@ function _get_plugin_data_markup_translate( $plugin_file, $plugin_data, $markup
* *
* @since 2.8.0 * @since 2.8.0
* *
* @param string $plugin Plugin ID * @param string $plugin Path to the main plugin file from plugins directory.
* @return array List of files relative to the plugin root. * @return array List of files relative to the plugin root.
*/ */
function get_plugin_files($plugin) { function get_plugin_files($plugin) {
@ -444,7 +444,7 @@ function _get_dropins() {
* *
* @since 2.5.0 * @since 2.5.0
* *
* @param string $plugin Base plugin path from plugins directory. * @param string $plugin Path to the main plugin file from plugins directory.
* @return bool True, if in the active plugins list. False, not in the list. * @return bool True, if in the active plugins list. False, not in the list.
*/ */
function is_plugin_active( $plugin ) { function is_plugin_active( $plugin ) {
@ -459,7 +459,7 @@ function is_plugin_active( $plugin ) {
* @since 3.1.0 * @since 3.1.0
* @see is_plugin_active() * @see is_plugin_active()
* *
* @param string $plugin Base plugin path from plugins directory. * @param string $plugin Path to the main plugin file from plugins directory.
* @return bool True if inactive. False if active. * @return bool True if inactive. False if active.
*/ */
function is_plugin_inactive( $plugin ) { function is_plugin_inactive( $plugin ) {
@ -476,7 +476,7 @@ function is_plugin_inactive( $plugin ) {
* *
* @since 3.0.0 * @since 3.0.0
* *
* @param string $plugin Base plugin path from plugins directory. * @param string $plugin Path to the main plugin file from plugins directory.
* @return bool True, if active for the network, otherwise false. * @return bool True, if active for the network, otherwise false.
*/ */
function is_plugin_active_for_network( $plugin ) { function is_plugin_active_for_network( $plugin ) {
@ -499,7 +499,7 @@ function is_plugin_active_for_network( $plugin ) {
* *
* @since 3.0.0 * @since 3.0.0
* *
* @param string $plugin Plugin to check * @param string $plugin Path to the main plugin file from plugins directory.
* @return bool True if plugin is network only, false otherwise. * @return bool True if plugin is network only, false otherwise.
*/ */
function is_network_only_plugin( $plugin ) { function is_network_only_plugin( $plugin ) {
@ -529,7 +529,7 @@ function is_network_only_plugin( $plugin ) {
* *
* @since 2.5.0 * @since 2.5.0
* *
* @param string $plugin Plugin path to main plugin file with plugin data. * @param string $plugin Path to the main plugin file from plugins directory.
* @param string $redirect Optional. URL to redirect to. * @param string $redirect Optional. URL to redirect to.
* @param bool $network_wide Optional. Whether to enable the plugin for all sites in the network * @param bool $network_wide Optional. Whether to enable the plugin for all sites in the network
* or just the current site. Multisite only. Default false. * or just the current site. Multisite only. Default false.
@ -569,7 +569,7 @@ function activate_plugin( $plugin, $redirect = '', $network_wide = false, $silen
* *
* @since 2.9.0 * @since 2.9.0
* *
* @param string $plugin Plugin path to main plugin file with plugin data. * @param string $plugin Path to the main plugin file from plugins directory.
* @param bool $network_wide Whether to enable the plugin for all sites in the network * @param bool $network_wide Whether to enable the plugin for all sites in the network
* or just the current site. Multisite only. Default is false. * or just the current site. Multisite only. Default is false.
*/ */
@ -611,7 +611,7 @@ function activate_plugin( $plugin, $redirect = '', $network_wide = false, $silen
* *
* @since 2.9.0 * @since 2.9.0
* *
* @param string $plugin Plugin path to main plugin file with plugin data. * @param string $plugin Path to the main plugin file from plugins directory.
* @param bool $network_wide Whether to enable the plugin for all sites in the network * @param bool $network_wide Whether to enable the plugin for all sites in the network
* or just the current site. Multisite only. Default is false. * or just the current site. Multisite only. Default is false.
*/ */
@ -663,7 +663,7 @@ function deactivate_plugins( $plugins, $silent = false, $network_wide = null ) {
* *
* @since 2.9.0 * @since 2.9.0
* *
* @param string $plugin Plugin path to main plugin file with plugin data. * @param string $plugin Path to the main plugin file from plugins directory.
* @param bool $network_deactivating Whether the plugin is deactivated for all sites in the network * @param bool $network_deactivating Whether the plugin is deactivated for all sites in the network
* or just the current site. Multisite only. Default is false. * or just the current site. Multisite only. Default is false.
*/ */
@ -711,8 +711,8 @@ function deactivate_plugins( $plugins, $silent = false, $network_wide = null ) {
* *
* @since 2.9.0 * @since 2.9.0
* *
* @param string $plugin Plugin basename. * @param string $plugin Path to the main plugin file from plugins directory.
* @param bool $network_deactivating Whether the plugin is deactivated for all sites in the network * @param bool $network_deactivating Whether the plugin is deactivated for all sites in the network.
* or just the current site. Multisite only. Default false. * or just the current site. Multisite only. Default false.
*/ */
do_action( 'deactivated_plugin', $plugin, $network_deactivating ); do_action( 'deactivated_plugin', $plugin, $network_deactivating );
@ -964,7 +964,7 @@ function validate_plugin($plugin) {
* *
* @since 2.7.0 * @since 2.7.0
* *
* @param string $plugin Plugin path to check. * @param string $plugin Path to the main plugin file from plugins directory.
* @return bool Whether plugin can be uninstalled. * @return bool Whether plugin can be uninstalled.
*/ */
function is_uninstallable_plugin($plugin) { function is_uninstallable_plugin($plugin) {
@ -984,7 +984,7 @@ function is_uninstallable_plugin($plugin) {
* *
* @since 2.7.0 * @since 2.7.0
* *
* @param string $plugin Relative plugin path from Plugin Directory. * @param string $plugin Path to the main plugin file from plugins directory.
* @return true True if a plugin's uninstall.php file has been found and included. * @return true True if a plugin's uninstall.php file has been found and included.
*/ */
function uninstall_plugin($plugin) { function uninstall_plugin($plugin) {
@ -997,7 +997,7 @@ function uninstall_plugin($plugin) {
* *
* @since 4.5.0 * @since 4.5.0
* *
* @param string $plugin Relative plugin path from plugin directory. * @param string $plugin Path to the main plugin file from plugins directory.
* @param array $uninstallable_plugins Uninstallable plugins. * @param array $uninstallable_plugins Uninstallable plugins.
*/ */
do_action( 'pre_uninstall_plugin', $plugin, $uninstallable_plugins ); do_action( 'pre_uninstall_plugin', $plugin, $uninstallable_plugins );

View File

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