Описание функции get_role()
Функция get_role() возвращает объект роли пользователя, если такая роль существует. Она используется для проверки или получения информации о конкретной роли, включая ее capabilities (возможности) и другие параметры.
Функция полезна при разработке плагинов и тем, где необходимо управлять доступом на основе ролей пользователей.
Параметры
$role
Тип: string
Обязательный: Да
Описание: Название роли, информацию о которой нужно получить
Возможные значения:
administrator: Администратор
editor: Редактор
author: Автор
contributor: Участник
subscriber: Подписчик
Возвращаемое значение
Тип: WP_Role|null
Описание: Объект WP_Role с информацией о роли или null, если роль не найдена
Возможные значения:
• Объект WP_Role при успешном выполнении
• null, если роль не существует
Примеры использования
Базовый пример получения информации о роли администратора
$admin_role = get_role('administrator');
if ($admin_role) {
echo 'Роль найдена: ' . $admin_role->name;
} else {
echo 'Роль не найдена';
}
Роль найдена: administrator
Проверка существования роли редактора перед выполнением действий
$editor_role = get_role('editor');
if ($editor_role) {
// Выполнить действия для редактора
} else {
// Роль не найдена
}
Роль не найдена не будет выполнять действия
Безопасность
Валидация входных данных: Входные параметры проверяются на наличие существующих ролей
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для предотвращения XSS
— Связанные функции
Добавляет новую роль в систему
Удаляет существующую роль
— Примечания
– Ограничения
Возвращает только роли, добавленные через функцию add_role()
– Частые проблемы
- null при неправильном названии роли
- Не существует роли, если она была удалена
