WP_User::add_cap( string $cap, bool $grant = true )

Parameters

$capstring

Capability name.

$grantbooloptional

Whether to grant capability to user.Default: true

Uses · 3

• update_user_meta()Updates user meta field based on user ID.
• WP_User::get_role_caps()Retrieves all of the capabilities of the user's roles, and merges them with individual user capabilities.
• WP_User::update_user_level_from_caps()Updates the maximum user level for the user.

Source

View on Trac ↗View on GitHub ↗

710	public function add_cap( $cap, $grant = true ) {711		$this->caps[ $cap ] = $grant;712		update_user_meta( $this->ID, $this->cap_key, $this->caps );713		$this->get_role_caps();714		$this->update_user_level_from_caps();715	}

History

Introduced in 2.0.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-includes/class-wp-user.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.