get_role()
Отримує масив (об’єкт) даних із можливостями зазначеної ролі.
Ця функція повертає об’єкт WP_Roles , а вже через нього можна використовувати методи класу WP_Roles .
Підключається до класу wp_roles() .
1 раз – 0.000068 сек
(дуже швидко) | 50000 разів – 2.29 сек
(швидко)
(дуже швидко) | 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.0.2
function get_role( $role ) {
return wp_roles()->get_role( $role );
}