WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru Рекомендуемые продукты со скидкой от Template Monster

get_role() WP 2.0

Получает массив (объект) данных с возможностями указанной роли.

Эта функция возвращает WP_Roles объект, а уже через него можно использовать методы класса WP_Roles.

Подключается к классу WP_Roles, используя функцию wp_roles().

Работает на основе: wp_roles(), WP_Roles()
✈ 1 раз = 0.000068с = очень быстро | 50000 раз = 2.29с = быстро

Хуков нет.

Возвращает

WP_Role/null. Объект класса WP_Role или null, если роль не существует.

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

get_role( $role );
$role(строка) (обязательный)
Название роли, например, administrator.

Примеры

#1. Демонстрация работы функции:

$role = get_role( 'author' );
print_r($role);

Получим:

WP_Role Object
(
	[name] => author
	[capabilities] => Array
		(
			[upload_files] => 1
			[edit_posts] => 1
			[edit_published_posts] => 1
			[publish_posts] => 1
			[read] => 1
			[level_2] => 1
			[level_1] => 1
			[level_0] => 1
			[delete_posts] => 1
			[delete_published_posts] => 1
		)

)

#2. Пример подключения к классу WP_Roles

и использования его методов через wp_role(). Код ниже добавит новую возможность к роли author:

add_action( 'admin_init', 'add_theme_caps' );
function add_theme_caps(){
	$role = get_role( 'author' );

	$role->add_cap( 'edit_others_posts' ); 
}

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

С версии 2.0.0 Введена.

Код get role: wp-includes/capabilities.php WP 5.2.3

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

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

Из метки: Роли и возможности (role capabilities)

2 коммента
  • Андрей mskrepair.ru

    Как отобразить русское название роли?
    Например Автор или Редактор

    1
    Ответить5 мес назад #
Здравствуйте, !     Войти . Зарегистрироваться