在本系列教程的第一篇文章《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以后的版本,请传递用户权限值。