WordPress功能函數(shù)add_users_page()，添加子菜單頁(yè)到用戶/配置文件主菜單。

用法：

add_users_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', int $position = null )

描述：

該函數(shù)具有一種功能，用于確定菜單中是否包含某個(gè)頁(yè)面。

用于處理頁(yè)面輸出的函數(shù)也必須檢查用戶是否具備所需的功能。

參數(shù)：

$page_title

(string) (必需) 選中菜單時(shí)要在頁(yè)面標(biāo)題標(biāo)簽中顯示的文本。

$menu_title

(string) (必需) 要用于菜單的文本。

$capability

(string) (必需) 向用戶顯示該菜單所需的功能。

$menu_slug

(string) (必需) 用來(lái)引用這個(gè)菜單的slug 名稱(對(duì)于這個(gè)菜單應(yīng)該是唯一的)。

$function

(callable) (可選) 用于輸出此頁(yè)面內(nèi)容的函數(shù)。

默認(rèn)值: ''

$position

(int) (可選) 該項(xiàng)目應(yīng)出現(xiàn)在菜單順序中的位置。

默認(rèn)值: null

返回

(string|false)結(jié)果頁(yè)面的hook_suffix，如果用戶不具備所需的能力則為false。

更多信息

• 注意:如果你正在運(yùn)行?你沒(méi)有足夠的權(quán)限訪問(wèn)這個(gè)頁(yè)面?！皐p_die()”屏幕中的消息，那么你太早上鉤了。你應(yīng)該使用的鉤子是' admin_menu '。
• 這個(gè)函數(shù)是一個(gè)簡(jiǎn)單的包裝器，用于調(diào)用add_submenu_page()，傳遞接收到的參數(shù)并指定' users '。php”或“配置文件。php '(取決于用戶的能力)作為$parent_slug參數(shù)。這意味著新頁(yè)面將作為子菜單添加到用戶或配置文件菜單。
• 用戶菜單僅對(duì)能夠編輯其他用戶的用戶可用。

來(lái)源：

文件: wp-admin/includes/plugin.php

function add_users_page( $page_title, $menu_title, $capability, $menu_slug, $function = '', $position = null ) {

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, $position );

}

更新日志：

用戶貢獻(xiàn)的筆記：

（由Codex - 5年前貢獻(xiàn)）

基本的例子

典型用法出現(xiàn)在注冊(cè)了' admin_menu '鉤子的函數(shù)中(參見(jiàn)添加管理菜單):

/**

* Register a new page under "Users".

*/

function wpdocs_my_users_menu() {

add_users_page(

__( 'My Plugin Users', 'textdomain' ),

__( 'My Plugin', 'textdomain' ),

'read',

'my-unique-identifier',

'my_plugin_function'

);

}

add_action('admin_menu', 'wpdocs_my_users_menu');