get_role

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

get_role() подключается к экземпляру класса WP_Roles, а это значит что через нее можно использовать методы класса WP_Roles.

Использует глобальную переменную $wp_roles или подключается к классу WP_Roles.
✈ 1 раз = 0.000068с = очень быстро | 50000 раз = 2.29с = быстро

Хуков нет.

Возвращает

Объект класса WP_Role или null, если не удалось получить данные.

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

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

Примеры

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

$role = get_role( 'author' );
print_r($role);
function add_theme_caps() {
	$role = get_role( 'author' );

	$role->add_cap( 'edit_others_posts' ); 
}
add_action( 'admin_init', 'add_theme_caps');

Код из


wp-includes/capabilities.php

WP 4.7.2

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