Функция REMOVE_ROLE() в WordPress 2.0.0

Функция remove_role() используется для удаления роли из WordPress. Это может быть полезно, если вы хотите ограничить доступ определенным пользователям, удаляя их роли.

Где хранятся настройки

Настройки ролей хранятся в базе данных (в опции wp_user_roles таблицы wp_options). Рекомендуется изменять их при активации или деактивации плагина или темы.

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

Функция вызывается следующим образом:

remove_role( $role );

Параметры:

• $role (строка) — название роли, которую вы хотите удалить. Например: administrator, editor, author, contributor, subscriber. Это обязательный параметр.

Пример использования

Вот простой пример, который показывает, как удалить роль "подписчик" при деактивации плагина:

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

Этот код связывает событие деактивации плагина с функцией myplugin_deactivate, которая удаляет роль "подписчик".

Изменения в версии

• С версии 2.0.0: Функция была впервые добавлена в WordPress.

Как работает функция

Функция remove_role() на самом деле вызывает метод remove_role() объекта wp_roles, который управляет ролями в WordPress. Вот как выглядит код функции:

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

Связанные функции

Для работы с ролями и их возможностями существуют и другие функции:

• add_role()
• author_can()
• current_user_can()
• get_editable_roles()
• get_role()
• grant_super_admin()
• is_super_admin()
• map_meta_cap()
• user_can()
• wp_roles()
• WP_Roles::add_cap()
• WP_User::add_cap()

Эти функции помогут вам управлять ролями и правами пользователей в WordPress.