在WordPress中注册自定义菜单和页面通常涉及以下步骤:
1. 注册自定义菜单
要在WordPress插件中注册自定义菜单,你需要使用 add_menu_page()
或相关函数来添加菜单项。以下是一个基本的示例:
function my_plugin_add_menu() {
// 添加一个顶级菜单项
add_menu_page(
'My Plugin Menu', // 页面标题
'My Plugin', // 菜单标题
'manage_options', // 能看到此菜单的用户角色
'my-plugin-menu', // 唯一标识符
'my_plugin_menu_page', // 调用回调函数来显示页面内容
'dashicons-admin-site-alt3', // 图标类名(Dashicons)
6 // 位置(数字越小,菜单越靠前)
);
}
// 当admin_menu钩子被调用时,添加自定义菜单
add_action('admin_menu', 'my_plugin_add_menu');
// 定义显示菜单页面的回调函数
function my_plugin_menu_page() {
?>
<div class="wrap">
<h1>My Plugin Menu Page</h1>
<p>这里是你自定义菜单页面的内容。</p>
</div>
<?php
}
2. 注册自定义页面
如果你想要创建一个在后台管理的自定义页面,你可以使用 add_submenu_page()
来添加一个子菜单页面:
function my_plugin_add_submenu_page() {
// 添加一个子菜单页面到我们刚刚创建的顶级菜单下
add_submenu_page(
'my-plugin-menu', // 父菜单的ID
'My Submenu Page', // 页面标题
'Submenu Page', // 子菜单标题
'manage_options', // 能看到此子菜单的用户角色
'my-plugin-submenu', // 唯一标识符
'my_plugin_submenu_page' // 调用回调函数来显示页面内容
);
}
// 当admin_menu钩子被调用时,添加自定义子菜单
add_action('admin_menu', 'my_plugin_add_submenu_page');
// 定义显示子菜单页面的回调函数
function my_plugin_submenu_page() {
?>
<div class="wrap">
<h1>My Submenu Page</h1>
<p>这里是你自定义子菜单页面的内容。</p>
</div>
<?php
}
确保将这些代码片段放入你的插件的主要PHP文件中,或者在插件目录中创建一个适当的文件,并在插件的主文件中使用 require_once()
或 include()
来包含它。
当你激活插件后,你应该能够在WordPress管理后台的左侧菜单中看到你创建的自定义菜单和子菜单。点击它们将显示你定义的页面内容。