WordPress函数文档add_users_page()
在后台管理界面的“用户”菜单下增加二级菜单 描述 Add sub menu page to the Users…
在后台管理界面的“用户”菜单下增加二级菜单
描述
Add sub menu page to the Users or Profile menu.
NOTE: If you’re running into the »You do not have sufficient permissions to access this page.« message in a wp_die()
screen, then you’ve hooked too early. The hook you should use is admin_menu
.
用法
<?php
add_users_page( $page_title, $menu_title, $capability, $menu_slug, $function);
?>
参数
$page_title
(string) (必填) The text to be displayed in the title tags of the page when the menu is selected
默认值: None
$menu_title
(string) (必填) The text to be used for the menu
默认值: None
$capability
(string) (必填) The capability required for this menu to be displayed to the user.
默认值: None
$menu_slug
(string) (必填) The slug name to refer to this menu by (should be unique for this menu).
默认值: None
$function
(callback) (可选) The function to be called to output the content for this page.
默认值: ‘ ‘
返回值
string
The resulting page’s hook_suffix (What add_submenu_page() returns)
注意
- This function is a simple wrapper for a call to add_submenu_page(), passing the received arguments and specifying ‘users.php’ or ‘profile.php’ (depending upon the users capability) as the $parent_slug argument. This means the new page will be added as a sub menu to the Users or Profile menu.
- The $capability parameter is used to determine whether or not the page is included in the menu based on the Roles and Capabilities) of the current user.
- The function handling the output of the options page should also verify the user’s capabilities.
- The Users menu is only available to users with the ability to edit other users. Users with capability below this level will see a Profile menu instead.
源文件
add_users_page() 函数的代码位于 wp-admin/includes/plugin.php
.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
/* ———————————-
* wordpress函数 kim收集
* ———————————- */
/**
* Add sub menu page to the Users/Profile main menu.
*
* This function takes a capability which will be used to determine whether
* or not a page is included in the menu.
*
* The function which is hooked in to handle the output of the page must check
* that the user has the required capability as well.
*
* @param string $page_title The text to be displayed in the title tags of the page when the menu is selected
* @param string $menu_title The text to be used for the menu
* @param string $capability The capability required for this menu to be displayed to the user.
* @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu)
* @param callback $function The function to be called to output the content for this page.
*
* @return false|string The resulting page’s hook_suffix, or false if the user does not have the capability required.
*/
function add_users_page( $page_title, $menu_title, $capability, $menu_slug, $function = ” ) {
if ( current_user_can(‘edit_users’) )
$parent = ‘users.php’;
else
$parent = ‘profile.php’;
return add_submenu_page( $parent, $page_title, $menu_title, $capability, $menu_slug, $function );
}
|
- 原文:http://codex.wordpress.org/Function_Reference/add_users_page
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
评论功能已经关闭!