WordPress企业网站定制教程(六)后台侧边栏添加顶级菜单
2012-06-24

在本系列教程的第一篇文章《WordPress企业网站定制教程(一)删除后台侧边栏顶级菜单》中,偶米工作室已经详细介绍了如何删除WordPress后台不必要的顶级菜单,现在再给大家介绍一下如果往WordPress后台的侧边栏添加自己定义的顶级菜单。

往WordPress后台添加侧边栏菜单有什么用呢?之前你可能用过一些插件或者一些主题,它们提供了属于自己的一个菜单,点击进入这个菜单可以设置插件或主题的选项,或者给使用提供一些使用说明,这大大扩展了WordPress的功能,也方便用户去使用这些插件或主题,何乐而不为呢?其实我们在做一些WordPress主题的时候,WordPress提供的菜单仅限于设置WordPress本身自带的功能,当WordPress的功能被扩展后,这些自带的菜单已经不能满足我们的要求了,所以添加自定义菜单也成了WordPress主题开发者的一项迫切需求。

添加WordPress顶级管理菜单其实也是一件非常简单的事情,使用两个WordPress内置函数就可以解决问题,分别是add_menu_page()和add_action(),下面提供一个php示例代码,添加到主题目录下的functions.php中就可以了:

/**
  * 名称:WordPress后台添加顶级菜单
  * 作者:露兜
  * 博客:http://www.ludou.org/
  * 最后修改:2011年01月26日
  */
// my_add_pages() 为 'admin_menu' 钩子的回调函数
 function my_add_pages() {
     // 第一个参数'Help page'为菜单名称,第二个参数'使用帮助'为菜单标题
     // 'manage_options' 参数为用户权限
     // 'my_toplevel_page' 参数用于调用my_toplevel_page()函数,来显示菜单内容
     add_menu_page('Help page', '使用帮助', 'manage_options', __FILE__, 'my_toplevel_page');
 }
// my_toplevel_page() 用于显示菜单的内容,填写菜单页面的HTML代码即可
 function my_toplevel_page() {
     echo '
     这里填菜单页面的HTML代码
     ';
    // 如以下示例代码。 wrap 类是WordPress构建好的css类,可以在你的HTML代码中使用
     /*
     echo '
     <div>
     <h2>使用帮助</h2>
     <p>这里是使用帮助,通过阅读本文你将了解本程序的使用!有事请<a href="#">与我联系</a></p>
     </div>
     ';
     */
 }
// 通过add_action来自动调用my_add_pages函数
 add_action('admin_menu', 'my_add_pages');

 

上面的代码注释已经比较清晰的介绍了主要内容,下面我再补充一点,关于add_menu_page的第三个参数,上面代码中传递了 manage_options 这个值,这个参数值为用户权限,也就是说只当当前已登录的用户具有manage_options这项权限时,才会在后台侧边栏显示你添加的这个菜单。需要提醒的是,这个是权限参数在WordPress 3.0中已被重新定义,之前版本可以往这个参数传递用户等级(1-10),但是如果你使用的是3.0以后的版本,请传递用户权限值。

相关知识