Функция GET_ROLE() │ WP 2.0.0

Функция GET_ROLE() позволяет пол��чить объект с возможностями указанной роли пользователя в WordPress.

Эта функция возвращает экземпляр объекта класса WP_Roles, с помощью которого можно использовать методы данного класса.

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

Функция используется в классе WP_Roles и вызывается через функцию wp_roles().

Производительность:

• 1 раз — 0.000068 сек (очень быстро)
• 50000 раз — 2.29 сек (быстро)

Хуки:
Нет хуков.

Возвращаемое значение

Функция возвращает объект типа WP_Role, если роль найдена. Если указанная роль не существует, будет возвращено null.

Пример использования

get_role( $role );

Параметр:

• $role (строка) — название роли (обязательный параметр).

Пример 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

Ниже приведен пример, в котором добавляется новая возможность для роли автора:

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()

В WordPress код функции выглядит следующим образом:

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

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

Ниже приведены функции, связанные с ролями и возможностями:

• add_role()
• author_can()
• current_user_can()
• get_editable_roles()
• grant_super_admin()
• is_super_admin()
• map_meta_cap()
• remove_role()
• user_can()
• wp_roles()
• WP_Roles::add_cap()
• WP_User::add_cap()

Эти функции помогут вам управлять ролями и правами пользователей в вашем WordPress-сайте, позволяя настраивать доступ и возможности каждого пользователя в зависимости от его роли.