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/