WordPress как на ладони
wordpress jino

get_role() WP 2.0

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

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

Использует глобальную переменную $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);

Получим:

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(). Код ниже добавит новую возможность к роли autor:

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

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

Код get role: wp-includes/capabilities.php VER 4.9.1

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

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

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

Еще из раздела: Роли и возможности

get_role Комментариев нет

Здравствуйте, !

Ваш комментарий