摘要
使用add_submenu_page()函数可以让我们在开发WordPress主题或者插件的时候更具方便的在后插入二级菜单,比如在后台设置菜单下面插入一个二级菜单某某某设置。
简介
使用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
【必填】
该参数处,填写的是二级菜单所属的顶级菜单的别名,用于告诉wordpress,新建的二级菜单,是属于哪个顶级菜单的。
在仪表盘添加子菜单: add_submenu_page( 'index.php', … );
在文章处添加子菜单: add_submenu_page( 'edit.php', … );
在媒体处添加子菜单: add_submenu_page( 'upload.php', … );
在链接处添加子菜单: add_submenu_page( 'link-manager.php', … );
在页面处添加子菜单: add_submenu_page( 'edit.php?post_type=page', … );
在评论处添加子菜单: add_submenu_page( 'edit-comments.php', … );
在你自定义文章类型处添加子菜单: add_submenu_page('edit.php?post_type=your_post_type',…)
在外观处添加子菜单: add_submenu_page( 'themes.php', … );
在插件处添加子菜单: add_submenu_page( 'plugins.php', … );
在用户处添加子菜单: add_submenu_page( 'users.php', … );
在工具处添加子菜单: add_submenu_page( 'tools.php', … );
在设置处添加子菜单: add_submenu_page( 'options-general.php', … );
$page_title
【必填】
该参数的作用是,设置新建的菜单页面的标题。
$menu_title
【必填】
限制用户必须具备什么样的权限,才会在后台显示出新创建的菜单。
$menu_slug
【必填】
该参数,设置的是新建的二级菜单的名称(或标题)
$capability
【必填】
该参数的作用是,告诉wordpress,用户必须具备什么权限,才在后台的菜单列表中显示新建的菜单。
$menu_slug
【必填】
menu_slug是菜单别名的意思,通过此参数,可以给创建的菜单起一个独一无二的名称,用于区分不同的菜单页面。
$function
【可选】
该参数的作用是,告诉wordpress,当用户点击新建的二级菜单,用户看到的内容是哪个函数的输出结果。
实例
function my_add_submenu() {
add_submenu_page( 'tools.php', 'my_backup', '备份', 'manage_options', 'backup-page', 'my_magic_function');
}
// 用于显示菜单的内容,填写菜单页面的HTML代码即可
function my_magic_function() {
echo ' 这里填菜单页面的HTML代码 ';
// echo '
//
//
备份
//
这里可以备份你的博客数据库。
//
// ';
}
// 通过add_action来自动调用my_add_submenu函数
add_action('admin_menu', 'my_add_submenu');