函数原型
add_role( string $role, string $display_name, bool[] $capabilities = array() ): WP_Role|void
函数描述
Adds a role, if it does not exist.
是否弃用
未弃用
函数参数
-
$role
string
Required - Role name.
-
$display_name
string
Required - Display name for role.
-
$capabilities
bool[]
Optional - List of capabilities keyed by the capability name, e.g. array(
'edit_posts'=> true,'delete_posts'=> false ).Default:
array()
函数返回值
WP_Role|void WP_Role object, if the role is added.
函数位置
File: wp-includes/capabilities.php.
函数源码
function add_role( $role, $display_name, $capabilities = array() ) {
if ( empty( $role ) ) {
return;
}
return wp_roles()->add_role( $role, $display_name, $capabilities );
}
源码链接
变更日志
| Version | Description |
|---|---|
| 2.0.0 | Introduced. |

