WordPress功能函数add_users_page()

WordPress功能函数add_users_page()

WordPress功能函数add_users_page(),添加子菜单页到用户/配置文件主菜单。

用法:

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

描述:

该函数具有一种功能,用于确定菜单中是否包含某个页面。

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

参数:

$page_title

(string) (必需) 选中菜单时要在页面标题标签中显示的文本。

$menu_title

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

$capability

(string) (必需) 向用户显示该菜单所需的功能。

$menu_slug

(string) (必需) 用来引用这个菜单的slug 名称(对于这个菜单应该是唯一的)。

$function

(callable) (可选) 用于输出此页面内容的函数。

默认值: ”

$position

(int) (可选) 该项目应出现在菜单顺序中的位置。

默认值: null

返回

(string|false)结果页面的hook_suffix,如果用户不具备所需的能力则为false。

更多信息

  • 注意:如果你正在运行»你没有足够的权限访问这个页面,“wp_die()”屏幕中的消息,那么你太早上钩了,你应该使用的钩子是’ admin_menu ‘,
  • 这个函数是一个简单的包装器,用于调用add_submenu_page(),传递接收到的参数并指定’ users ‘,php”或“配置文件,php ‘(取决于用户的能力)作为$parent_slug参数,这意味着新页面将作为子菜单添加到用户或配置文件菜单,
  • 用户菜单仅对能够编辑其他用户的用户可用,

来源:

文件: 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 );

}

更新日志:

WordPress功能函数add_users_page() (https://www.wpzt.net/) WordPress开发教程 第1张

用户贡献的笔记:

(由Codex – 5年前贡献)

基本的例子

典型用法出现在注册了’ admin_menu ‘钩子的函数中(参见添加管理菜单):

/**

* 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’);

本站所有资源版权均属于原作者所有,这里所提供资源均只能用于参考学习用,请勿直接商用。若由于商用引起版权纠纷,一切责任均由使用者承担。如有需求,建议购买正版!如果源码侵犯了您的利益请留言告知!!
优质资源共享平台-811轩轩资源 » WordPress功能函数add_users_page()