文章目录
本文最后更新于 2022-10-17,已超过 365 天未更新,内容可能已失效。

add_users_page( string $page_titlestring $menu_titlestring $capabilitystring $menu_slugcallable $function = int $position = null )

将子菜单页添加到用户/配置文件主菜单。
Add submenu page to the Users/Profile main menu.


说明(Description)

此函数具有用于确定菜单中是否包含页面的功能。

连接以处理页面输出的函数必须检查用户是否也具有所需的功能。


参数(Parameters)

参数类型必填说明
$page_title(string)必需选择菜单时要在页面标题标记中显示的文本。
$menu_title(string)必需用于菜单的文本。
$capability(string)必需向用户显示此菜单所需的功能。
$menu_slug(string)必需用于引用此菜单的slug名称(对于此菜单应是唯一的)。
$function(callable)可选要调用以输出此页内容的函数。
$position(int)可选此项在菜单中的显示顺序。

返回(Return)

(string|false)结果页的hook_后缀,如果用户没有所需的功能,则为false。


源码(Source)

/**
 * 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 );
}

 

更新版本源码位置使用被使用
5.3.0wp-admin/includes/plugin.php:156602
CC 许可协议
署名-非商业性使用-相同方式共享 4.0 国际 了解协议
文章链接:https://zptheme.com/5478.html
本文作者:子佩·来源:子佩工作室

除非注明,子佩工作室 文章均为原创,转载请以链接形式标明本文地址。

相关推荐

登录后即可发表评论

社交账号登录

全部评论 (0)