WordPress函数add_role()添加角色(如果不存在)

　　在 WordPress CMS内容管理系统中，add_role()用于创建新的用户角色并将其与特定的能力（权限）关联起来。除了“管理员”、“编辑者”、“作者”、“贡献者”和“订阅者”等默认角色之外，此功能还允许您定义自定义角色。

add_role()函数基本语法

描述

　　注册并配置管理屏幕选项

用法

add_role( string $role, string $display_name, bool[] $capabilities = array() )

$role（字符串）（必需）：角色的唯一名称。
$display_name (string)（必需）：人类可读的角色名称。
$capability (array) （可选）：该角色的功能的关联数组，以功能名称作为键（例如，’edit_posts’ => true，’delete_posts’ => false）。默认是一个空数组。

　　推荐：WordPress电子邮件营销自动化插件FluentCRM Pro插件

add_role()函数

　　在 WordPress 中，该add_role()功能允许您创建具有特定功能的自定义用户角色。这是详细的解释：使您能够通过定义具有定制权限的新角色来扩展默认的 WordPress 用户角色（管理员、编辑者、作者、贡献者、订阅者）。（源文件可参考这里）

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

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

如何使用add_role()

　　创建一个简单的角色，此示例创建一个基本的“editor_extended”角色，该角色具有读取、编辑帖子和发布帖子的功能。

add_role(
    'editor_extended', 
    'Extended Editor', 
    array(
        'read' => true, 
        'edit_posts' => true,
        'publish_posts' => true,
    )
);

　　添加插件激活角色，此示例演示如何在激活插件时添加角色。函数“add_roles_on_plugin_activation”与插件激活挂钩，并添加“custom_role”。

function add_roles_on_plugin_activation() {
    add_role('custom_role', 'Custom Subscriber', array('read' => true, 'level_0' => true));
}
register_activation_hook(__FILE__, 'add_roles_on_plugin_activation');

　　克隆现有角色，在此示例中，我们将创建一个新角色“经理”，它克隆“编辑”角色的所有功能。

add_role('manager', 'Manager', get_role('editor')->capabilities);

　　创建具有自定义功能的角色，此示例创建一个“guest_author”角色，该角色具有读取和编辑帖子的功能，但无法删除帖子。

$result = add_role(
    'guest_author', 
    __('Guest Author', 'testdomain'), 
    array(
        'read' => true, 
        'edit_posts' => true,
        'delete_posts' => false,
    )
);

　　更新角色，此示例演示了更新现有角色的功能。首先，删除“编辑”角色，然后添加附加功能。

remove_role('editor');
add_role(
    'editor', 
    'Editor', 
    array(
        'read' => true, 
        'edit_posts' => true,
        'delete_posts' => true,
        'publish_posts' => true,
        'moderate_comments' => true,
    )
);

　　推荐：导入Elementor模板时不起作用怎么办

　　推荐：WordPress函数使用手册