Core Function
View Source on Trac ↗ add_role()
add_role( mixed $role, mixed $display_name, mixed $capabilities = array() ) Adds a role, if it does not exist.
Parameters 3 required
| Name / Type | Description |
|---|---|
| $role string | Role name. Required |
| $display_name string | Display name for role. Required |
| bool[] | $capabilities List of capabilities keyed by the capability name, e.g. array( 'edit_posts' => true, 'delete_posts' => false ). Required |
Return Value
((WP_Role)
| void) WP_Role object, if the role is added.
Function Information
Since Version
2.0.0
Source File
wp-includes/capabilities.php
Advertisement