WordPress 开发文档
收录了这篇文章 

一，WordPress 添加顶级菜单 add_menu_page()

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

function custom_menu_page(){
    echo "Admin Page Test";
    // require('myplugin/myplugin-index.php);
}

函数介绍：

add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position )

$page_title：(字符串) (必须) 这个参数是子菜单的标题，将会显示在浏览器的标题栏，默认为空；

$menu_title：(字符串) (必须) 显示的菜单名称，默认为空；

$capability：(字符串) (必须) 用户权限，定义了具有哪些权限的用户会看到这个子菜单（权限部分请看文章结尾处），默认为空，参照capability；

$menu_slug：(字符串) (必须) 显示在URl上面的菜单名称，默认为空；

$function：返回的方法名称；

$icon_url：(字符串) (可选) 显示的菜单图标，可以使用plugin_dir_url( __FILE__ )，图标宽高为16像素；

$position：(整数) (可选) 显示菜单的位置。常用位置，4或者59或者99。

函数返回值: 返回菜单结果页面的hook。

位置：

2 – Dashboard
4 – Separator
5 – Posts
10 – Media
15 – Links
20 – Pages
25 – Comments
59 – Separator
60 – Appearance
65 – Plugins
70 – Users
75 – Tools
80 – Settings
99 – Separator

二，WordPress后台添加子菜单 add_submenu_page()

add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function );

添加内置菜单：

1、在仪表盘添加子菜单: 
add_submenu_page( 'index.php', … );
2、在文章处添加子菜单: 
add_submenu_page( 'edit.php', … );
3、在媒体处添加子菜单: 
add_submenu_page( 'upload.php', … );
4、在链接处添加子菜单: 
add_submenu_page( 'link-manager.php', … );
5、在页面处添加子菜单: 
add_submenu_page( 'edit.php?post_type=page', … );
6、在评论处添加子菜单: 
add_submenu_page( 'edit-comments.php', … );
7、在你自定义文章类型处添加子菜单: 
add_submenu_page('edit.php?post_type=your_post_type',…)
8、在外观处添加子菜单: 
add_submenu_page( 'themes.php', … );
9、在插件处添加子菜单: 
add_submenu_page( 'plugins.php', … );
10、在用户处添加子菜单: 
add_submenu_page( 'users.php', … );
11、在工具处添加子菜单: 
add_submenu_page( 'tools.php', … );
12、在设置处添加子菜单: 
add_submenu_page( 'options-general.php', … );

例子：

function test_function()
{
    add_menu_page('title标题', '菜单标题', 'edit_themes', 'ashu_slug', 'display_function', '', 6);
}

function display_function()
{
    echo '<h1>这是设置页面</h1><p>这里是设置的内容</p>';
}
add_action('admin_menu', 'test_function');

//以下是添加子菜单项代码 
add_action('admin_menu', 'add_my_custom_submenu_page');

function add_my_custom_submenu_page()
{
    //顶级菜单的slug是ashu_slug 
    add_submenu_page('ashu_slug', '子菜单', '子菜单', 'edit_themes', 'ashu-submenu-page', 'my_submenu_page_display');
}

function my_submenu_page_display()
{
    echo '<h3>子菜单项的输出代码</h3><p>这里是子菜单设置的内容</p>';
}

三，WordPress 添加到后台“外观”中的菜单 add_theme_page()

function test_theme_menu(){
    add_submenu_page("plugins.php", "test 插件设置", "test 插件设置", 'edit_theme_options', "test-config",  'test_display');  
}   
function test_display(){   
    echo '<h1>菜单对应的页面或函数</h1>'; 
    echo '<div class=""></div>'; 
}   
add_action('admin_menu', 'test_theme_menu'); 

参数：

$parent_slug (string) (必须的) 父菜单项标志.

$page_title (string) (必须的) 页面标题.

$menu_title (string) (必须的) 菜单项名称.

$capability (string) (必须的) 规定查看此菜单项，需要的用户权限.

$menu_slug (string) (必须的) 菜单唯一标志，会在链接中显示。可以使用小写字母、数字、破折号和下划线。

$callback (callable) (可选的) 菜单项对应的渲染内容. 默认: ''

$position (int|float) (可选的) 在父菜单的位置. 默认: null

修改时间 2023-11-18