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 这个用户角色已经存在。';
}
注解
新用户角色的设置是添加到数据库中(表 wp_options 的 wp_user_roles 字段中),所以该函数最好在主题/插件激活的时候调用。
修改记录
Since: 2.0.0
源文件
wp-includes/capabilities.php