WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru Платформа для конвертации и монетизации трафика

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 5.6.2

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

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

2 коммента
    Войти