remove_cap

Удаляет возможность у указанной роли пользователя или у конкретного пользователя.

Изменив возможность один раз, изменение останется навсегда, пока не будет переменено еще раз.

Эти настройки сохраняются в БД (в таблицу wp_options, поле wp_user_roles), поэтому эту функцию нужно запускать единожды при активации/деактивации плагина или темы.

remove_cap() не публичная функция – это метод класса WP_Roles, WP_Role и WP_User, поэтому она должна вызываться из экземпляров этих классов, как показано в примерах.

Хуков нет.

Возвращает

Ничего не возвращает.

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

global $wp_roles;
$wp_roles->remove_cap( $role, $cap );

// или
$role = get_role( 'author' );
$role->remove_cap( $cap );
$role(строка) (обязательный)
Название роли: Super Admin, Administrator, Editor, Author, Contributor, Subscriber.
По умолчанию: нет
$cap(строка) (обязательный)
Название возможности. Таблица с ролями и их возможностями по умолчанию.
По умолчанию: нет

Примеры

#1. Запретим чтение приватных постов, пользователям в ролью editor

Функцию нужно вызывать во время активации плагина, т.е. один раз, а не постоянно:

function remove_editor_read_private_posts() {

	// get_role возвращает экземпляр класса WP_Role.
	$role = get_role( 'editor' );
	$role->remove_cap( 'read_private_posts' );
}

// тоже самое можно сделать через класс WP_Roles:
function remove_editor_read_private_posts(){
	global $wp_roles;
	$wp_roles->remove_cap( 'editor', 'read_private_posts' );
}

2. Удалим возможность у конкретного пользователя

Удалим возможность чтения приватных постов у пользователя с ID 5:

$user_id = 5;
$user = new WP_User( $user_id );
$user->remove_cap( 'read_private_posts' );

3. Удаление нескольких возможностей

Удалим некоторые возможности у пользователей с ролью “редактор” editor:

// вызывайте функцию один раз, при активации плагина/темы
function wpcodex_set_capabilities() {
	// получаем объект роли.
	$editor = get_role( 'editor' );

	// Список возможностей, которые нужно удалить у editor
	$caps = array(
		'moderate_comments',
		'manage_categories',
		'manage_links',
		'edit_others_posts',
		'edit_others_pages',
		'delete_posts',
	);

	foreach ( $caps as $cap ) {
		$editor->remove_cap( $cap );
	}
}