Uses
| Uses | Description |
|---|---|
| wp-includes/formatting.php: sanitize_html_class() | Sanitizes an HTML classname to ensure it only contains valid characters. |
| wp-includes/functions.php: wp_parse_args() | Merge user defined arguments into defaults array. |
Add a help tab to the contextual help for the screen.
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.
(array) (Required) Array of arguments used to display the help tab.
(string) Title for the tab. Default false.
(string) Tab ID. Must be HTML-safe and should be unique for this menu. It is NOT allowed to contain any empty spaces. Default false.
(string) Optional. Help tab content in plain text or HTML. Default empty string.
(callable) Optional. A callback to generate the tab content. Default false.
(int) Optional. The priority of the tab, used for ordering. Default 10.
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;
} | Version | Description |
|---|---|
| 4.4.0 | The $priority argument was added. |
| 3.3.0 | Introduced. |
© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/WP_Screen/add_help_tab