add_menu_page() WP 1.0
Add a top-level menu page.
This function takes a capability which will be used to determine whether or not a page is included in the menu.
The function which is hooked in to handle the output of the page must check that the user has the required capability as well.
- Global. Array.
$menu
- Global. Array.
$admin_page_hooks
- Global. Array.
$_registered_pages
- Global. Array.
$_parent_pages
No Hooks.
Return
String. The resulting page's hook_suffix.
Usage
add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position );
- $page_title(string) (required)
- The text to be displayed in the title tags of the page when the menu is selected.
- $menu_title(string) (required)
- The text to be used for the menu.
- $capability(string) (required)
- The capability required for this menu to be displayed to the user.
- $menu_slug(string) (required)
- The slug name to refer to this menu by. Should be unique for this menu page and only include lowercase alphanumeric, dashes, and underscores characters to be compatible with sanitize_key().
- $function(callable)
- The function to be called to output the content for this page.
Default:''
- $icon_url(string)
The URL to the icon to be used for this menu.
- Pass a base64-encoded SVG using a data URI, which will be colored to match the color scheme. This should begin with
'data:image/svg+xml;base64,'
. - Pass the name of a Dashicons helper class to use a font icon, e.g.
'dashicons-chart-pie'
. - Pass
'none'
to leave div.wp-menu-image empty so an icon can be added via CSS.
Default:
''
- Pass a base64-encoded SVG using a data URI, which will be colored to match the color scheme. This should begin with
- $position(int)
- The position in the menu order this one should appear.
Default:null