Ticket #25823: 25823.diff

wp-admin/theme-install.php

@@ -2 +2 @@
 /**
  * Install theme administration panel.
  *
+ * @since 2.8.0
+ *
  * @package WordPress
  * @subpackage Administration
  */
@@ -9 +11 @@
 if ( !defined( 'IFRAME_REQUEST' ) && isset( $_GET['tab'] ) && ( 'theme-information' == $_GET['tab'] ) )
         define( 'IFRAME_REQUEST', true );
 
-/** WordPress Administration Bootstrap */
+// Include WordPress Administration Bootstrap.
 require_once( dirname( __FILE__ ) . '/admin.php' );
 
 if ( ! current_user_can('install_themes') )
@@ -34 +36 @@
 
 $body_id = $tab;
 
-do_action('install_themes_pre_' . $tab); //Used to override the general interface, Eg, install or theme information.
+/**
+ * Fires before theme install tabs are rendered
+ *
+ * The exact action fired will depend on the $tab variable. Possible values are:
+ * - install_themes_pre_dashboard
+ * - install_themes_pre_upload
+ * - install_themes_pre_featured
+ * - install_themes_pre_new
+ * - install_themes_pre_updated
+ *
+ * @since 2.8.0
+ *
+ */
+do_action('install_themes_pre_' . $tab);
 
 $help_overview =
         '<p>' . sprintf(__('You can find additional themes for your site by using the Theme Browser/Installer on this screen, which will display themes from the <a href="%s" target="_blank">WordPress.org Theme Directory</a>. These themes are designed and developed by third parties, are available free of charge, and are compatible with the license WordPress uses.'), 'http://wordpress.org/themes/') . '</p>' .
@@ -80 +95 @@
 $wp_list_table->views(); ?>
 
 <br class="clear" />
+<?php
+/**
+ * Fires at the top of the theme install page tabs
+ *
+ * The exact action fired will depend on the $tab variable. Possible values are:
+ * - install_themes_dashboard
+ * - install_themes_upload
+ * - install_themes_featured
+ * - install_themes_new
+ * - install_themes_updated
+ *
+ * @since 2.8.0
+ *
+ * @param  int $paged The page of results being viewed
+ */
+?>
 <?php do_action('install_themes_' . $tab, $paged); ?>
 </div>
 <?php