# get_editable_roles()

URL: https://chugunov.pro/api-wordpress/functions/get_editable_roles/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.8.0.

## Сигнатура

```php
get_editable_roles(): array[]
```

## Описание

Простая функция, основное назначение которой — позволить фильтровать список ролей в объекте $wp_roles, чтобы плагины могли убирать неподходящие роли в зависимости от ситуации или пользователя, вносящего изменения.
В частности, потому что без фильтрации любой, кто обладает правом доступа edit_users, может назначать другим роль администратора, даже будучи всего лишь редактором или автором. Этот фильтр позволяет администраторам делегировать управление пользователями.

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

`array[]`

## Исходный код

Файл: `wp-admin/includes/user.php:268`

```php
function get_editable_roles() {
	$all_roles = wp_roles()->roles;

	/**
	 * Filters the list of editable roles.
	 *
	 * @since 2.8.0
	 *
	 * @param array[] $all_roles Array of arrays containing role information.
	 */
	$editable_roles = apply_filters( 'editable_roles', $all_roles );

	return $editable_roles;
}
```

## История изменений

- 2.8.0 — Introduced.

## Связанные

Использует: [`wp_roles`](https://chugunov.pro/api-wordpress/functions/wp_roles/), [`WP_Roles`](https://chugunov.pro/api-wordpress/functions/wp_roles/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`wp_ensure_editable_role`](https://chugunov.pro/api-wordpress/functions/wp_ensure_editable_role/), `WP_REST_Users_Controller::check_role_update`, [`edit_user`](https://chugunov.pro/api-wordpress/functions/edit_user/), [`wp_dropdown_roles`](https://chugunov.pro/api-wordpress/functions/wp_dropdown_roles/), [`admin_created_user_email`](https://chugunov.pro/api-wordpress/functions/admin_created_user_email/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_editable_roles/