WP_Role::add_cap( string $cap, bool $grant = true )
Assign role a capability.
Parameters
- $cap
-
(string) (Required) Capability name.
- $grant
-
(bool) (Optional) Whether role has capability privilege.
Default value: true
More Information
Changing the capabilities of a role is persistent, meaning the added capability will stay in effect until explicitly revoked.
This setting is saved to the database (in table wp_options, field wp_user_roles), so it might be better to run this on theme/plugin activation.
Source
File: wp-includes/class-wp-role.php
public function add_cap( $cap, $grant = true ) { $this->capabilities[ $cap ] = $grant; wp_roles()->add_cap( $this->name, $cap, $grant ); }
Expand full source code Collapse full source code View on Trac View on GitHub
Changelog
Version | Description |
---|---|
2.0.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Example
NB: This setting is saved to the database, so it might be better to run this on theme/plugin activation
Expand full source codeCollapse full source code
To add capability to specific user :
Note that add_cap only accept one string; you cannot add multiple using a single add_cap call; you need to make multiple add_cap calls like the following:
$your_var -> add_cap( 'edit_others_posts' );
$your_var -> add_cap( 'upload_files' );