get_role()
Получает массив (объект) данных с возможностями указанной роли.
Эта функция возвращает 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() get role WP 6.5.2
function get_role( $role ) {
return wp_roles()->get_role( $role );
}