add_menu_page()
热度:87add_menu_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', string $icon_url = '', int $position = null )
添加顶级菜单页面。
描述:
此功能具有一种功能,可用于确定菜单中是否包含页面。
处理页面输出的函数必须检查用户是否具有所需的功能。
参数:
$page_title
(string) (Required) 选择菜单时要在页面的标题标签中显示的文本。
$menu_title
(string) (Required) 用于菜单的文本。
$capability
(string) (Required) 此菜单显示给用户所需的功能。
$menu_slug
(string) (Required) 用于引用此菜单的slug名称。对于此菜单页面应该是唯一的,并且只包含与sanitize_key()兼容的小写字母数字,短划线和下划线字符。
$function
(callable) (Optional) 要输出此页面内容的函数。
Default value(默认值): ''
$icon_url
(string) (Optional) 用于此菜单的图标的URL。
* 使用数据URI传递base64编码的SVG,数据URI将着色以匹配颜色方案。这应该以'data:image / svg + xml; base64''开头。
* 传递Dashicons助手类的名称以使用字体图标,例如'dashicons-chart-pie'。
* 通过'none'将div.wp-menu-image留空,以便可以通过CSS添加图标。
Default value(默认值): ''
$position
(int) (Optional) 应显示菜单顺序中的位置。
Default value(默认值): null
Return(返回):
(string) 结果页面的hook_suffix。
示例:
function add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $icon_url = '', $position = null ) {
global $menu, $admin_page_hooks, $_registered_pages, $_parent_pages;
$menu_slug = plugin_basename( $menu_slug );
$admin_page_hooks[ $menu_slug ] = sanitize_title( $menu_title );
$hookname = get_plugin_page_hookname( $menu_slug, '' );
if ( ! empty( $function ) && ! empty( $hookname ) && current_user_can( $capability ) ) {
add_action( $hookname, $function );