在WordPress中,add_menu_page()
和 add_submenu_page()
函数用于在管理后台创建菜单和子菜单。以下是如何使用这些函数的步骤和示例代码:
步骤 1: 定义一个函数来创建菜单和子菜单
首先,你需要定义一个函数来创建菜单和子菜单。这个函数通常会连接到 admin_menu
动作钩子。
步骤 2: 使用 add_menu_page()
添加主菜单
使用 add_menu_page()
函数来添加一个主菜单项。这个函数需要几个参数,包括菜单标题、页面标题、用户权限、菜单ID、回调函数等。
步骤 3: 使用 add_submenu_page()
添加子菜单
使用 add_submenu_page()
函数来添加子菜单项。这个函数的参数与 add_menu_page()
类似,但是还需要指定父菜单的ID。
以下是一个示例代码:
<?php
// 在插件文件中添加以下代码
// 步骤 1: 定义一个函数来创建菜单和子菜单
function my_custom_menu() {
// 步骤 2: 使用 add_menu_page() 添加主菜单
add_menu_page(
'My Custom Menu', // 页面标题
'Custom Menu', // 菜单标题
'manage_options', // 用户权限
'my-custom-menu', // 菜单ID
'my_custom_menu_page', // 回调函数
'dashicons-admin-site-alt3', // 图标URL
6 // 菜单位置
);
// 步骤 3: 使用 add_submenu_page() 添加子菜单
add_submenu_page(
'my-custom-menu', // 父菜单ID
'Submenu Page Title', // 页面标题
'Submenu', // 子菜单标题
'manage_options', // 用户权限
'my-custom-submenu', // 子菜单ID
'my_custom_submenu_page' // 回调函数
);
}
// 步骤 4: 将自定义菜单函数连接到 admin_menu 动作钩子
add_action('admin_menu', 'my_custom_menu');
// 定义回调函数,显示菜单页面内容
function my_custom_menu_page() {
echo '<div class="wrap"><h1>My Custom Menu</h1><p>这里是主菜单的内容。</p></div>';
}
// 定义子菜单回调函数,显示子菜单页面内容
function my_custom_submenu_page() {
echo '<div class="wrap"><h1>My Custom Submenu</h1><p>这里是子菜单的内容。</p></div>';
}
?>
将上述代码添加到你的插件文件中,然后在WordPress后台激活该插件。你应该会在管理菜单中看到一个名为“Custom Menu”的主菜单,并且在该菜单下有一个名为“Submenu”的子菜单。点击这些菜单项将会显示相应的页面内容。