WP_User::remove_cap() – Method | Developer.WordPress.org

Removes capability from user.

Parameters

$capstringrequired: Capability name.

More Information

Changing the capabilities of a user is persistent, meaning the removed capability will stay in effect until explicitly granted.

This setting is saved to the database (in table wp_options, field 'wp_user_roles'), so you should run this only once, on theme/plugin activation and/or deactivation.

Source

public function remove_cap( $cap ) {
	if ( ! isset( $this->caps[ $cap ] ) ) {
		return;
	}
	unset( $this->caps[ $cap ] );
	update_user_meta( $this->ID, $this->cap_key, $this->caps );
	$this->get_role_caps();
	$this->update_user_level_from_caps();
}

View all references View on Trac View on GitHub

Uses	Description
WP_User::update_user_level_from_caps()`wp-includes/class-wp-user.php`	Updates the maximum user level for the user.
WP_User::get_role_caps()`wp-includes/class-wp-user.php`	Retrieves all of the capabilities of the user’s roles, and merges them with individual user capabilities.
update_user_meta()`wp-includes/user.php`	Updates user meta field based on user ID.

Changelog

Version	Description
2.0.0	Introduced.

User Contributed Notes

Skip to note 2 content

Akira Tachibana 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
From Codex
```
// Remove a capability from a specific user.
$user_id = // The ID of the user to remove the capability from.
$user = new WP_User( $user_id );
$user->remove_cap( 'read_private_posts' );
```
Log in to add feedback

WP_User::remove_cap( string $cap )

In this article

Parameters

More Information

Source

Changelog

User Contributed Notes

WP_User::remove_cap( string $cap )

In this article

Parameters

More Information

Source

Related

Changelog

User Contributed Notes