add_submenu_page() 函数用于在 WordPress 后台管理菜单的子菜单下添加一个新的页面。
函数的基本用法如下:
add_submenu_page( string $parent_slug, string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '' )
参数解析:
- $parent_slug:要将子菜单添加到的父菜单的文件名(slug);
- $page_title:子菜单页面的标题;
- $menu_title:在管理菜单中显示的子菜单名称;
- $capability:用户需要具备的权限才能访问子菜单页面;
- $menu_slug:子菜单的文件名(slug),用于生成子菜单页面的 URL;
- $function:可选参数,用于指定子菜单页面的回调函数。
以下是一个具体的例子:
add_action( 'admin_menu', 'custom_submenu_page' );
function custom_submenu_page() {
add_submenu_page(
'options-general.php', // 将子菜单添加到“设置”菜单下
'Custom Submenu Page', // 子菜单页面的标题
'Custom Submenu', // 在管理菜单中显示的子菜单名称
'manage_options', // 用户需要“manage_options”权限才能访问该子菜单
'custom-submenu', // 子菜单的文件名(slug)
'custom_submenu_callback' // 子菜单页面的回调函数
);
}
function custom_submenu_callback() {
echo '
Custom Submenu Page
';
echo '
This is a custom submenu page in WordPress Admin.
';
}
在上面的例子中,我们在 WordPress 后台管理菜单的“设置”菜单下添加了一个名为“Custom Submenu”的子菜单。用户需要具备 “manage_options” 权限才能访问该子菜单页面。并且,我们定义了一个回调函数 custom_submenu_callback(),用于显示子菜单页面的内容。
通过这样的方式,我们可以通过 add_submenu_page() 函数在 WordPress 后台管理菜单中灵活地添加自己的子菜单页面。
0 个评论