WordPress.org

Make WordPress Core

Ticket #19828: wp-admin-includes-screen.diff

File wp-admin-includes-screen.diff, 2.0 KB (added by dustyf, 5 years ago)

Patch dds priority argument for help tabs and method to sort by argument

  • wp-admin/includes/screen.php

     
    669669         * @return array Help tabs with arguments.
    670670         */
    671671        public function get_help_tabs() {
    672                 return $this->_help_tabs;
     672                $help_tabs = $this->_help_tabs;
     673                usort( $help_tabs, array( $this, 'sort_help_tabs' ) );
     674                return $help_tabs;
    673675        }
    674676
    675677        /**
     678         * Returns the priority difference for tabs so they can be sorted.
     679         *
     680         * @since x.x.x
     681         *
     682         * $param  int $tab_a The priority argument for the first tab.
     683         * $param  int $tab_b The priority argument for the second tab.
     684         * @return int The difference between the priority arguments.
     685         */
     686        function sort_help_tabs( $tab_a, $tab_b ) {
     687                return $tab_a['priority'] - $tab_b['priority'];
     688        }
     689
     690        /**
    676691         * Gets the arguments for a help tab.
    677692         *
    678693         * @since 3.4.0
     
    688703
    689704        /**
    690705         * Add a help tab to the contextual help for the screen.
     706         *
    691707         * Call this on the load-$pagenow hook for the relevant screen.
    692708         *
    693709         * @since 3.3.0
    694710         *
    695          * @param array $args
    696          * - string   - title    - Title for the tab.
    697          * - string   - id       - Tab ID. Must be HTML-safe.
    698          * - string   - content  - Help tab content in plain text or HTML. Optional.
    699          * - callback - callback - A callback to generate the tab content. Optional.
     711         * @param array $args {
     712         *     Array of arguments used to display the help tab.
    700713         *
     714         *     @type string $title Title for the tab.
     715         *     @type string $id Tab ID. Must be HTML-safe.
     716         *     @type string $content Optional. Help tab content in plain text or HTML.
     717         *     @type string $callback Optional. A callback to generate the tab content.
     718         *     @type int    $priority Optional. The priority of the tab, used for ordering.
     719         * }
    701720         */
    702721        public function add_help_tab( $args ) {
    703722                $defaults = array(
     
    705724                        'id'       => false,
    706725                        'content'  => '',
    707726                        'callback' => false,
     727                        'priority' => 10,
    708728                );
    709729                $args = wp_parse_args( $args, $defaults );
    710730