1. 首页
  2. WordPress 函数手册

add_role()

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。


源码(Source)


更新版本 源码位置 使用 被使用
2.0.0 wp-includes/capabilities.php:824 1 function 2

笔记(Notes)

请确保仅在激活挂钩或条件块中使用此函数(以及类似的角色函数)。不需要每次加载页面时都执行此操作,而且每次调用时都会不断更新数据库。
激活插件时创建新角色
还可以基于现有用户角色轻松创建新用户角色。

add_role() 为WP2原创文章,链接:https://www.wp2.cn/functions/add_role/

发表评论

您的电子邮箱地址不会被公开。