add_menu_page()函数是往后台添加顶级菜单,也就是和“外观”、“插件”等一样的顶级菜单。

语法结构

<?php  
add_menu_page(
    $page_title,
    $menu_title,
    $capability,
    $menu_slug,
    $function,
    $icon_url,
    $position );  
?>

参数

page_title 页面title标签信息

$menu_title 菜单标题

capability 权限

menu_slug 别名自己命名

function 执行函数

icon_url 菜单图标url地址

position 此菜单项在菜单中的位置,警告:如果两个菜单项的位置属性相同,其中一个可能要被覆盖

对于function参数,这个参数一般是函数名,如果在类中,要调用类的方法,使用array(类名,函数名)这样的形式调用。如果这个参数为空的话,menu_slug参数可以是一个文件路径。

capability参数,默认的权限包括如下:

Subscriber 订阅者
Contributor 投稿者
Author 作者
Editor 编辑
Administrator 管理员

position参数,默认的菜单项位置属性如下:

2 Dashboard 仪表盘
5 Posts 文章
10 Media 媒体
15 Links 链接
20 Pages 页面
25 Comments 评论
60 Appearance 外观
65 Plugins 插件
70 Users 用户
75 Tools 工具
80 Settings 设置

栗子

function register_custom_menu_page(){
    add_menu_page(
        '菜单标题', 
        '菜单名称', 
        'administrator', 
        'custompage', 
        'custom_menu_page', 
        plugins_url('/images/icon.png'), 
        6
    );
}
function custom_menu_page(){
    echo "Admin Page Test";
}
add_action('admin_menu', 'register_custom_menu_page');