# translate_user_role()

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

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

## Сигнатура

```php
translate_user_role( string $name, string $domain = 'default' ): string
```

## Описание

Поскольку имена ролей хранятся в базе данных, а не в исходном коде, для попадания их в POT-файл существуют фиктивные вызовы gettext, и эта функция корректно переводит их обратно.
Вызов before_last_bar() необходим, потому что в более старых установках роли хранятся в старом формате контекста: ‘Role name|User role’, и просто отбросить содержимое после последней вертикальной черты проще, чем исправлять их в базе данных. Новые установки этой проблемы лишены.

## Параметры

- `$name` `string` — обязательный. Имя роли.
- `$domain` `string` — необязательный, по умолчанию `'default'`. Текстовый домен. Уникальный идентификатор для получения переведённых строк.
  
  Значение по умолчанию: 'default'.

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

`string`

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

Файл: `wp-includes/l10n.php:1532`

```php
function translate_user_role( $name, $domain = 'default' ) {
	return translate_with_gettext_context( before_last_bar( $name ), 'User role', $domain );
}
```

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

- 5.2.0 — Added the $domain parameter.
- 2.8.0 — Introduced.

## Связанные

Использует: [`translate_with_gettext_context`](https://chugunov.pro/api-wordpress/functions/translate_with_gettext_context/), [`before_last_bar`](https://chugunov.pro/api-wordpress/functions/before_last_bar/).
Используется в: `WP_Users_List_Table::get_role_list`, [`wp_dropdown_roles`](https://chugunov.pro/api-wordpress/functions/wp_dropdown_roles/), `WP_Users_List_Table::get_views`, [`admin_created_user_email`](https://chugunov.pro/api-wordpress/functions/admin_created_user_email/).

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