Ticket #26252: 26252.diff

wp-admin/includes/update.php

@@ -285 +285 @@
                 else
                         printf( __('There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a> or <a href="%5$s">update now</a>.'), $plugin_name, esc_url($details_url), esc_attr($plugin_name), $r->new_version, wp_nonce_url( self_admin_url('update.php?action=upgrade-plugin&plugin=') . $file, 'upgrade-plugin_' . $file) );
 
+                /**
+                 * Appends output to the plugin update notification message.
+                 *
+                 * Output additional markup in the Network Admin plugins overview page after the plugin's table row.
+                 *
+                 * @since 2.8.0
+                 *
+                 * @param string $file The location of the main plugin PHP file relative to the plugins folder.
+                 * @param array $plugin_data {
+                 *              An array containing all of the plugin metadata.
+                 *
+                 *              @type string $Name The human-readable name of the plugin.
+                 *              @type string $PluginURI Path to the plugin's web resources.
+                 *              @type string $Version The version number for the current plugin.
+                 *              @type string $Description A short description of the plugin.
+                 *              @type string $Author Plugin author's username.
+                 *              @type string $AuthorURI Path to the plugin author's web resources.
+                 *              @type string $TextDomain Plugin's text domain for localization.
+                 *              @type string $DomainPath Plugin's relative directory path to .mo files.
+                 *              @type bool $Network Boolean. Whether the plugin can only be activated network wide.
+                 *              @type string $Title The human-readable title of the plugin.
+                 *              @type string $AuthorName Plugin author's name.
+                 * }
+                 * @param array $r {
+                 *              An array containing metadata about the latest available plugin update.
+                 *
+                 *              @type int $id The plugins numeric identifier.
+                 *              @type string $slug Unique name of this plugin as found in the plugins repository.
+                 *              @type string $new_version The version of the plugin to be updated.
+                 *              @type string $url The home web page for this plugin.
+                 *              @type string $package The source location of the package that contains the plugin files to be updated.
+                 * }
+                 */
                 do_action( "in_plugin_update_message-$file", $plugin_data, $r );
 
                 echo '</div></td></tr>';
@@ -342 +375 @@
         else
                 printf( __('There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a> or <a href="%5$s">update now</a>.'), $theme['Name'], esc_url($details_url), esc_attr($theme['Name']), $r['new_version'], wp_nonce_url( self_admin_url('update.php?action=upgrade-theme&theme=') . $theme_key, 'upgrade-theme_' . $theme_key) );
 
+        /**
+         * Appends output to the theme update notification message.
+         *
+         * Output additional markup in the Network Admin themes overview page after the theme's table row.
+         *
+         * @since 3.1.0
+         *
+         * @param string $theme_key The unique name of the theme as found in the themes repository.
+         * @param array $theme {
+         *              An array containing all of the theme metadata.
+         *
+         *              @type string $Name The human-readable name of the theme.
+         *              @type string $Title The human-readable title of the theme.
+         *              @type string $Description A short description of the theme.
+         *              @type string $Author Theme author's username.
+         *              @type string $Author Name Theme author's name.
+         *              @type string $Author URI Path to the theme author's web resources.
+         *              @type string $Version The version number for the current theme.
+         *              @type string $Template Unique name of this theme as found in the themes repository.
+         *              @type string $Stylesheet Unique name of the parent theme as found in the themes repository if available.
+         *              @type array $Template Files An array of all PHP files included in the theme.
+         *              @type array $Stylesheet Files An array of all CSS files included in the theme.
+         *              @type string $Template Dir Local path to the theme.
+         *              @type string $Stylesheet Dir Local path to the directory containing style.css.
+         *              @type string $Status The theme's availablity in the current WordPress installation.
+         *              @type string $Screenshot The filename of the theme thumbnail.
+         *              @type array $Tags An array of all tags used to describe the theme.
+         *              @type string $Theme Root Local path to the WordPress installations themes directory.
+         *              @type string $Theme Root URI Path to the WordPress installations theme directory.
+         *              @type string $Parent Theme The name of the parent theme if applicable.
+         *              @type bool $enabled. Whether the theme is enabled.
+         * }
+         * @param array $r {
+         *              An array containing metadata about the latest available theme update.
+         *
+         *              @type string $new_version The version of the theme to be updated.
+         *              @type string $url The home web page for this theme.
+         *              @type string $package The source location of the package that contains the theme files to be updated.
+         * }
+         */
         do_action( "in_theme_update_message-$theme_key", $theme, $r );
 
         echo '</div></td></tr>';