简介
在制作主题或者插件的时候我们可能需要给主题或者插件添加一个设置选项,而将设置选项固定在后台菜单中,我们就需要用到这个add_menu_page()函数。
用法
- add_menu_page (
- string $page_title,
- string $menu_title,
- string $capability,
- string $menu_slug,
- callable $function = '',
- string $icon_url = '',
- int $position = null
- )
参数
- $page_title
【必填】
填写的是菜单页面的标题(<title>$page_title</title>)
- $menu_title
【必填】
菜单的名称。也就是,在调用add_menu_page()时填写的第二个参数的值,会作为后台菜单的标题。
- $capability
【必填】
限制用户必须具备什么样的权限,才会在后台显示出新创建的菜单。
- $menu_slug
【必填】
菜单的别名,主要的作用是,用于区分不同的菜单。因为,你可以在后台添加多个菜单,那么菜单之间要有明确的区分。
菜单的别名,其实就是字符串类型的数据,但是一定要做到独一无二。
- $function
【可选】
当“菜单别名”参数处,填写的是一个文件的路径的时候,此参数是可选的。
当“菜单别名”参数处,填写的是一个独一无二的普通字符串的时候,此参数就是必填的。
- $icon_url
【可选】
此参数的作用是,设置新创建的菜单在后台的图标。
- $position
【可选】
该参数的作用是,告诉wordpress新建的菜单,放在后台菜单列表中的哪个位置。
实例
- //方法一
- add_action('admin_menu', 'register_custom_menu_page');
- function register_custom_menu_page() {
- add_menu_page('自定义菜单标题', '测试菜单', 'administrator', 'myplugin/myplugin-index.php','',plugins_url('myplugin/images/icon.png'), 6);
- }
- //然后将下面的代码放到myplugin/myplugin-index.php文件中
- echo "后台页面内容";
- //方法二
- 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 "后台页面内容";
- }