add_role( string $role, string $display_name, array $capabilities = array() )

Add role, if it does not exist.

Parameters

$role

(Required) Role name.

$display_name

(Required) Display name for role.

$capabilities

(Optional) List of capabilities, e.g. array( 'edit_posts' => true, 'delete_posts' => false );

Default value: array()

Return

(WP_Role|null) WP_Role object if role is added, null if already exists.

Source

File: wp-includes/capabilities.php 

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

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/capabilities.php: wp_roles()

Retrieves the global WP_Roles instance and instantiates it if necessary.
wp-includes/class-wp-roles.php: WP_Roles::add_role()

Add role name with capabilities to list.

Used By

Used By
Used By Description
wp-admin/includes/schema.php: populate_roles_160()

Create the roles for WordPress 2.0

Changelog

Changelog
Version Description
WP-2.0.0 Introduced.