WP_Screen::add_help_tab( array $args )
Adds a help tab to the contextual help for the screen.
Description
Call this on the load-$pagenow
hook for the relevant screen, or fetch the $current_screen
object, or use get_current_screen() and then call the method from the object.
You may need to filter $current_screen
using an if or switch statement to prevent new help tabs from being added to ALL admin screens.
Parameters
- $args
-
(Required) Array of arguments used to display the help tab.<br>
- 'title'
(string) Title for the tab. Default false.<br> - 'id'
(string) Tab ID. Must be HTML-safe and should be unique for this menu.<br> It is NOT allowed to contain any empty spaces. Default false.<br> - 'content'
(string) Optional. Help tab content in plain text or HTML. Default empty string.<br> - 'callback'
(callable) Optional. A callback to generate the tab content. Default false.<br> - 'priority'
(int) Optional. The priority of the tab, used for ordering. Default 10.<br>
- 'title'
Source
File: wp-admin/includes/class-wp-screen.php
public function add_help_tab( $args ) {
$defaults = array(
'title' => false,
'id' => false,
'content' => '',
'callback' => false,
'priority' => 10,
);
$args = wp_parse_args( $args, $defaults );
$args['id'] = sanitize_html_class( $args['id'] );
// Ensure we have an ID and title.
if ( ! $args['id'] || ! $args['title'] )
return;
// Allows for overriding an existing tab with that ID.
$this->_help_tabs[ $args['id'] ] = $args;
}
Changelog
Version | Description |
---|---|
4.4.0 | The $priority argument was added. |
3.3.0 | Introduced. |