一,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