Ticket #25501: widgets.php.patch

widgets.php

@@ -34 +34 @@
                 wp_enqueue_script( 'jquery-touch-punch' );
 }
 
+/**
+ * Fires early when editing the widgets displayed in sidebars.
+ *
+ * This action is triggered after widgets are set up (globals
+ * $wp_registered_widgets and $wp_registered_widget_controls are defined) but
+ * before other actions on the widgets are taken. 
+ *
+ * @since 2.2.0
+ */
 do_action( 'sidebar_admin_setup' );
 
 $title = __( 'Widgets' );
@@ -315 +324 @@
 <div id="message" class="error"><p><?php echo $errors[$_GET['error']]; ?></p></div>
 <?php } ?>
 
-<?php do_action( 'widgets_admin_page' ); ?>
+<?php 
+/**
+ * Fires after title, but before main content.
+ *
+ * Triggered on the widget admin page before the main content (available widgets
+ * & sidebars) has loaded. Hook this action to display content on the widget
+ * admin page before the main content.
+ *
+ * @since 3.0.0
+ */
+do_action( 'widgets_admin_page' ); ?>
 
 <div class="widget-liquid-left">
 <div id="widgets-left">
@@ -396 +415 @@
 </div>
 
 <?php
+
+/**
+ * Fires after main content is processed.
+ *
+ * Triggered on the widget admin page after the main content (available widgets
+ * & sidebars) has loaded.  Hook this action to display content on the widget
+ * admin page as part of the main content.
+ *
+ * @since 2.2.0
+ */
 do_action( 'sidebar_admin_page' );
 require_once( ABSPATH . 'wp-admin/admin-footer.php' );