add_menu_page函数是WordPress的一个核心函数,用于在WordPress后台添加一个新的顶级菜单。
其基本用法为:
add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position );
下面对各个参数进行详细解析:
1. $page_title (string):菜单页面的标题,显示在浏览器的标题栏上。
2. $menu_title (string):菜单在后台菜单中的显示名称。
3. $capability (string):访问该菜单所需的用户权限。常用的权限有:
- 'manage_options':超级管理员权限
- 'edit_posts':编辑文章权限
- 'read':只读权限
4. $menu_slug (string):菜单的唯一标识符,用于在代码中引用该菜单。
5. $function (string):菜单点击后触发的回调函数,用于显示菜单页面的内容。此参数可选。
6. $icon_url (string):菜单图标的URL,可以是一个图片的URL地址。此参数可选。
7. $position (int):菜单的显示位置,数字越小越靠前。此参数可选。
使用示例:
add_menu_page( 'My Custom Menu', 'Custom Menu', 'manage_options', 'my-custom-menu', 'my_custom_menu_page', 'dashicons-admin-custom', 99 );
function my_custom_menu_page(){
// 添加菜单页面的内容
}
上述示例将在WordPress后台添加一个名为"Custom Menu"的顶级菜单,点击后触发回调函数"my_custom_menu_page",并且将使用名为"dashicons-admin-custom"的图标进行显示,该菜单的显示位置为99。
0 个评论