WP_ROLES() │ WP 4.3.0

Эта функция предоставляет глобальный экземпляр класса WP_Roles и создает его при необходимости.

Используется в

• get_editable_roles()
• get_role()
• add_role()
• remove_role()

Быстродействие

• 1 раз — 0.000017 секунд (очень быстро)
• 50,000 раз — 0.01 секунд (скорость света)

Описание

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

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

Вы можете вызвать функцию так:

wp_roles();

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

Пример 1: Получение имени роли

Вы можете получить имя роли, например, администратора, следующим образом:

echo wp_roles()->roles['administrator']['name']; // > Administrator

Пример 2: Получение всего класса

Чтобы вывести информацию о всех ролях, используйте следующую команду:

print_r(wp_roles());

Результат:

WP_Roles Object
(
    [roles] => Array
        (
            [administrator] => Array
                (
                    [name] => Administrator
                    [capabilities] => Array
                        (
                            [switch_themes] => 1
                            [edit_themes] => 1
                            ...
                        )
                )
            ...
        )
)

Здесь вы видите объекты ролей и их возможности.

Доступные роли

В WordPress есть несколько предустановленных ролей:

• Администратор (Administrator): полный контроль над сайтом.
• Редактор (Editor): может редактировать любые посты и страницы.
• Автор (Author): может писать и публиковать свои посты.
• Участник (Contributor): может писать посты, но не может их публиковать.
• Подписчик (Subscriber): может только читать содержимое.

Примечания

• Глобальная переменная: WP_Roles $wp_roles — объект управления ролями WordPress.

Изменения

Функция была представлена в версии 4.3.0 WordPress.

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

Вот несколько функций, связанных с управлением ролями и правами:

• add_role()
• author_can()
• current_user_can()
• get_editable_roles()
• get_role()
• grant_super_admin()
• is_super_admin()
• map_meta_cap()
• remove_role()
• user_can()