Ticket #19828: 19828.diff

wp-admin/includes/screen.php

@@ -719 +719 @@
          *
          * @since 3.4.0
          *
-         * @return array Help tabs with arguments.
+         * @return array Help tabs with arguments sorted by their priority.
          */
         public function get_help_tabs() {
-                return $this->_help_tabs;
+                $help_tabs = $this->_help_tabs; 
+                usort( $help_tabs, array( $this, 'sort_help_tabs' ) ); 
+                return $help_tabs;
         }
 
+        /** 
+         * Compares the difference between the help tabs priorities. Used for help tabs sorting.
+         * 
+         * @since 4.4.0 
+         * 
+         * $param  int $tab_a The priority argument for the first tab. 
+         * $param  int $tab_b The priority argument for the second tab. 
+         * @return int The difference between the priority arguments. 
+         */ 
+        function sort_help_tabs( $tab_a, $tab_b ) { 
+                return $tab_a['priority'] - $tab_b['priority']; 
+        }
+
         /**
          * Gets the arguments for a help tab.
          *
@@ -745 +760 @@
          *
          * @since 3.3.0
          *
-         * @param array $args
-         * - string   - title    - Title for the tab.
-         * - string   - id       - Tab ID. Must be HTML-safe.
-         * - string   - content  - Help tab content in plain text or HTML. Optional.
-         * - callback - callback - A callback to generate the tab content. Optional.
-         *
+         * @param array $args { 
+         *     Array of arguments used to display the help tab. 
+         * 
+         *     @type string $title    Title for the tab. Default false.
+         *     @type string $id       Tab ID. Must be HTML-safe. Default false.
+         *     @type string $content  Optional. Help tab content in plain text or HTML. Default empty string.
+         *     @type string $callback Optional. A callback to generate the tab content. Default false. 
+         *     @type int    $priority Optional. The priority of the tab, used for ordering. Default 10. 
+         * }
          */
         public function add_help_tab( $args ) {
                 $defaults = array(
@@ -758 +776 @@
                         'id'       => false,
                         'content'  => '',
                         'callback' => false,
+                        'priority' => 10,
                 );
                 $args = wp_parse_args( $args, $defaults );