Функция wp_roles(): работа с ролями в WordPress

Функция wp_roles() в WordPress позволяет получить глобальный экземпляр класса WP_Roles, который управляет ролями и их возможностями в системе. Если экземпляр класса еще не был создан, функция инициирует его. Это ключевая функция, которая предоставляет доступ к объекту ролей для их получения, изменения, удаления и добавления.

wp_roles(): WP_Roles

Описание: Возвращает глобальный экземпляр WP_Roles. Если он еще не был инициализирован, функция создает его и кэширует в глобальной переменной $wp_roles.

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

• WP_Roles — Объект, который представляет все роли в системе, а также связанные с ними возможности.

Где хранится информация о ролях?

Информация о ролях сохраняется в базе данных WordPress в таблице wp_options в поле wp_user_roles. Этот массив содержит роли пользователей и набор их возможностей (capabilities), что позволяет контролировать доступ к различным действиям в админ-панели и на сайте.

1. Получение названия роли

Чтобы получить название конкретной роли, например администратора:

echo wp_roles()->roles['administrator']['name']; // > Администратор

2. Получение всех ролей и их возможностей

Этот код выведет весь объект WP_Roles, содержащий все роли и их соответствующие возможности.

print_r( wp_roles() );

Вывод может выглядеть так:

WP_Roles Object
(
    [roles] => Array
        (
            [administrator] => Array
                (
                    [name] => Administrator
                    [capabilities] => Array
                        (
                            [switch_themes] => 1
                            [edit_themes] => 1
                            [activate_plugins] => 1
                            [edit_plugins] => 1
                            [edit_users] => 1
                            [manage_options] => 1
                            [edit_posts] => 1
                            // И другие возможности...
                        )
                )
            [editor] => Array
                (
                    [name] => Editor
                    [capabilities] => Array
                        (
                            [moderate_comments] => 1
                            [edit_posts] => 1
                            [edit_pages] => 1
                            // И другие возможности...
                        )
                )
            // Остальные роли...
        )
)

3. Получение объектов ролей

Этот пример показывает, как можно получить объект роли, который содержит возможности роли:

$role_objects = wp_roles()->role_objects;
$administrator_role = $role_objects['administrator'];
print_r($administrator_role);

4. Получение списка всех доступных ролей

Можно получить список всех доступных ролей, используя следующую конструкцию:

$all_roles = wp_roles()->role_names;
print_r($all_roles); 
// Выведет: Array ( [administrator] => Administrator [editor] => Editor [author] => Author ... )

Примечания

• wp_roles() — это обертка для получения глобального объекта ролей, что делает работу с ролями удобнее.
• Класс WP_Roles используется для управления ролями, например, добавления новых ролей с помощью add_role() или удаления существующих через remove_role().

Заключение

Функция wp_roles() — мощный инструмент для работы с ролями в WordPress. Она предоставляет доступ к глобальному объекту ролей, позволяя вам легко управлять правами пользователей и создавать новые уровни доступа в системе.