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

5年以前 | 阅读数：986 次 | 编程语言：PHP

添加设置页面-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，比较一下可发现，它将会在"文章"的后面，看：

$2016111150821806.png $482×220$$

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

添加子菜单项-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>';  

    }  

    ?>

效果图是这样：

$2016111151006224.png $532×275$$