add_role()函数是Wordpress函数,添加角色(如果不存在)。
add_role( string $role, string $display_name, bool[] $capabilities = array() )
添加角色(如果不存在)。
Add role, if it does not exist.
参数(Parameters)
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
$role | (string) | 必需 | 角色名称。 |
$display_name | (string) | 必需 | 角色的显示名称。 |
$capabilities | (bool[]) | 可选 | 由功能名称键入的功能列表,例如array(“edit_posts”=>true,“delete_posts”=>false)。 |
返回(Return)
(WP_Role|null)WP_Role object如果添加了Role,如果已经存在,则为null。
更新版本 | 源码位置 | 使用 | 被使用 |
---|---|---|---|
2.0.0 | wp-includes/capabilities.php:824 | 1 function | 2 |
笔记(Notes)
请确保仅在激活挂钩或条件块中使用此函数(以及类似的角色函数)。不需要每次加载页面时都执行此操作,而且每次调用时都会不断更新数据库。
激活插件时创建新角色
还可以基于现有用户角色轻松创建新用户角色。