WP_User::add_cap() │ public │ WP 2.0.0

Добавляет или удаляет право (возможность) у указанного пользователя.

Изменение права записывается в базу данных. Поэтому вызывать эту функцию нужно единожды, при активации/деактивации плагина или темы.

Это метод класса: WP_User{}

Используйте WP_Roles::add_cap(), чтобы добавить/удалить право целиком у роли WordPress.

Метод класса: WP_User{}

Хуков нет.

Возвращает

null. Ничего.

Использование

$WP_User = new WP_User();
$WP_User->add_cap( $cap, $grant );

$cap(строка) (обязательный): Название возможности. Таблица прав по умолчанию смотрите здесь.
$grant(true/false): Разрешить выполнять эту возможность (true) или наоборот запретить (false).
По умолчанию: true

Примеры

#1 Добавим новую возможность отдельному пользователю

Дадим возможность пользователю 20 редактировать посты.

$user = new WP_User( 20 );
$user->add_cap( 'can_edit_posts' );

Список изменений

С версии 2.0.0

Введена.

Код `WP_User::add_cap() WP User::add cap` ^{WP 6.2.2}

wp-includes/class-wp-user.php

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