WordPress中,钩子(hooks)是指在特定的时间点执行特定的函数,而admin_menu就是其中一个钩子。
admin_menu钩子在后台管理菜单加载之后触发,在该钩子中可以添加、编辑或删除菜单项。
下面是admin_menu钩子的用法详解:
1. 添加菜单项:
使用add_menu_page函数可以在后台管理菜单中添加一个新的菜单项。函数的基本语法如下:
add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position );
- $page_title:菜单页面的标题。
- $menu_title:菜单项在菜单中的显示名称。
- $capability:用户需要具备的权限才能访问该菜单项。
- $menu_slug:菜单项的唯一标识符。
- $function:点击菜单项后执行的函数。
- $icon_url:菜单项的图标URL。
- $position:菜单项在菜单中的位置。
2. 编辑菜单项:
使用add_submenu_page函数可以在已有的菜单项中添加子菜单。函数的基本语法如下:
add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function );
- $parent_slug:父菜单项的标识符。
- 其他参数的含义和add_menu_page函数相同。
3. 删除菜单项:
使用remove_menu_page函数可以移除一个已有的菜单项。函数的基本语法如下:
remove_menu_page( $menu_slug );
- $menu_slug:要移除的菜单项的标识符。
示例代码:
function my_custom_menu_page() {
add_menu_page( 'My Custom Menu', 'My Custom Menu', 'manage_options', 'my-custom-menu', 'my_custom_menu_callback', 'dashicons-admin-tools', 99 );
add_submenu_page( 'my-custom-menu', 'Submenu 1', 'Submenu 1', 'manage_options', 'submenu-1', 'submenu_1_callback' );
}
function my_custom_menu_callback() {
echo '
My Custom Menu Page
';
}
function submenu_1_callback() {
echo '
Submenu 1 Page
';
}
add_action( 'admin_menu', 'my_custom_menu_page' );
在上述示例中,首先定义了两个回调函数,分别用于自定义菜单页和子菜单页的内容。然后通过add_menu_page和add_submenu_page函数在admin_menu钩子中添加了自定义菜单项和子菜单项。最后使用add_action函数将my_custom_menu_page函数与admin_menu钩子关联起来,以便在后台加载完成后执行。
以上就是WordPress钩子admin_menu的用法详解。使用admin_menu钩子可以方便地自定义后台管理菜单。
0 个评论