WordPress函数：add_role 添加自定义用户角色

之前曾介绍过 WordPress 自带用户角色及相应权限，对于博客或者新闻杂志站点，这些用户角色已经够用了。但是，如果是商城系统、BBS或者其他的系统，这些用户角色就不太够用了。

如何新建新的用户角色呢？WordPress 提供了函数 add_role。

参数：$role 角色名称；$display_name 显示名称；$capabilities 角色权限设置。

函数源码：

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

使用举例：

$result = add_role(
    'guest_author',
    __( 'Guest Author', 'testdomain' ),
    array(
        'read'         => true,  // true allows this capability
        'edit_posts'   => true,
        'delete_posts' => false, // Use false to explicitly deny
    )
);
 
if ( null !== $result ) {
    echo "Success: {$result->name} user role created.";
}
else {
    echo 'Failure: user role already exists.';
}

建议：最好是在 WordPress init 钩子里，就执行增加角色的操作。