WordPress 常用函数 / add_role

简介

添加一个新的用户角色到 WordPress。

用法

<?php add_role( $role, $display_name, $capabilities ); ?>

参数

$role
(string) (required) 用户角色的名称
Default: None

$display_name
(string) (required) 用户角色的显示名
Default: None

$capability
(array) (optional) 权限名称的数组
Default: array()

返回值

(mixed)
成功返回 WP_Role 对象，如果添加的用户角色已存在，返回空。

实例

$result = add_role('basic_contributor', 'Basic Contributor', array(
'read' => true, // True allows that capability
'edit_posts' => true,
'delete_posts' => false, // Use false to explicitly deny
));
if (null !== $result) {
echo '新的用户角色创建成功！';
} else {
echo '厄，basic_contributor 这个用户角色已经存在。';
}