在WordPress的后台中添加顶级菜单和子菜单的函数详解

Green

添加设置页面-add_menu_page函数
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参数可以是一个文件路径。

上面函数的position参数，默认的菜单项位置属性如下：

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

好了，还是以实例来讲解，这样才能李菊福嘛。在默认的Twenty Ten主题中新建一个myfuntions.php ,然后在functions.php文件中include用编辑器打开我们的myfunctions.php，
添加新代码：

<?php 
function test_function(){ 
  add_menu_page( 'title标题', '菜单标题', 'edit_themes', 'ashu_slug','display_function','',6); 
} 
 
function display_function(){ 
  echo '<h1>这是设置页面</h1>'; 
} 
add_action('admin_menu', 'test_function'); 
?>

可以看到，菜单位置是6，比较一下可发现，它将会在“文章”的后面，看：

已经出现了一个顶级菜单页面了。。。

添加子菜单项-add_submenu_page
添加子菜单项的函数如下：

<?php 
add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function ); 
//parent_slug-父级菜单项的别名 
//page_title--页面的title信息 
//menu_title-菜单标题 
//capability-权限 
//menu_slug-别名 
//function-执行的函数 
?>

其实有了前两篇教程，这个函数的用法无需多言了。

实例，还是用上两篇教程中的文件(在默认的Twenty Ten主题中新建一个myfuntions.php ,然后在functions.php文件中include新文件)用编辑器打开我们的myfunctions.php，上一篇教程中我们已经添加了一个顶级菜单项，今天我们就在这个顶级菜单项的基础上添加一个子菜单项，保留昨天的代码，补充新的代码,之后myfunctions.php中的代码是这样：

<?php  
function test_function(){  
  add_menu_page( 'title标题', '菜单标题', 'edit_themes', 'ashu_slug','display_function','',6);  
}  
   
function display_function(){  
  echo '<h1>这是设置页面</h1>';  
}  
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>'; 
 
} 
 
?>

效果图是这样：