remove_role

Удаляет роль из WordPress.

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

Хуков нет.

Возвращает

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

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

remove_role( $role );
$role(строка) (обязательный)
Название роли. Например: administrator, editor, author, contributor, subscriber.
По умолчанию: нет

Примеры

#1. Удалим роль “подписчик” (subscriber):

register_deactivation_hook( __FILE__, 'myplugin_deactivate' );
function myplugin_deactivate(){
	remove_role( 'subscriber' );
}

Код из


wp-includes/capabilities.php

WP 4.7.2

<?php
function remove_role( $role ) {
	wp_roles()->remove_role( $role );
}