add_role

函数


add_role ( $role, $display_name, $capabilities = array() )
参数
  • (string)
    $role
    Role name.
    Required:
  • (string)
    $display_name
    Display name for role.
    Required:
  • (bool[])
    $capabilities
    List of capabilities keyed by the capability name, e.g. array( ‘edit_posts’ => true, ‘delete_posts’ => false ).
    Required:
    Default: array()
返回值
  • (WP_Role|void) WP_Role object, if the role is added.
定义位置
  • wp-includes/capabilities.php
    , line 1025
引入
2.0.0
弃用

添加一个角色,如果它不存在的话。

function add_role( $role, $display_name, $capabilities = array() ) {
	if ( empty( $role ) ) {
		return;
	}

	return wp_roles()->add_role( $role, $display_name, $capabilities );
}