add_users_page函数是WordPress中用于在后台管理界面中添加新的用户管理页面的函数。其用法如下:
add_users_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '' )
参数解析:
- $page_title: (string) 定义页面的标题。
- $menu_title: (string) 定义菜单中显示的标题。
- $capability: (string) 定义用户所需的权限来访问该页面。常见的权限包括:manage_options(管理员权限)、edit_posts(编辑帖子权限)等。
- $menu_slug: (string) 定义菜单的URL片段,用于生成页面的URL。在菜单中使用此slug来标识对应的页面。
- $function: (callable) 可选参数,定义在访问页面时执行的回调函数。
使用示例:
function custom_users_page_content() {
// 在这里编写自定义页面的内容
echo "
自定义用户管理页面
";
echo "
欢迎来到自定义用户管理页面。
";
}
add_users_page( 'Custom Users Page', 'Custom Users', 'manage_options', 'custom-users', 'custom_users_page_content' );
以上示例将在后台管理界面的左侧菜单中添加一个名为"Custom Users"的菜单项,点击该菜单项将跳转到一个名为"Custom Users Page"的用户管理页面。此页面只有拥有"manage_options"权限的用户可以访问。页面的内容由回调函数`custom_users_page_content`生成。
需要注意的是,add_users_page函数必须在WordPress加载完管理界面后调用,通常是在"admin_menu"钩子中调用。
0 个评论