Создание выпадающего списка ролей пользователей в WordPress

## WP_DROPDOWN_ROLES() │ WP 2.1.0

Функция wp_dropdown_roles() позволяет создать HTML-элементы <option> для всех ролей пользователей в элементе <select>. Это полезно, если вы хотите предоставить пользователям возможность выбрать роль из списка.

### Подключение необходимых файлов

Если вы хотите использовать эту функцию на фронтенде (в пользовательской части сайта), вам нужно подключить следующие файлы:

```php
require_once ABSPATH . 'wp-admin/includes/user.php';
require_once ABSPATH . 'wp-admin/includes/template.php';

Примечание

Эта функция не использует хуки.

Возврат значения

Функция ничего не возвращает (null).

Использование функции

Чтобы использовать wp_dropdown_roles(), вызовите ее следующим образом:

wp_dropdown_roles( $selected );

Параметры

• $selected (строка) — это слаг (уникальный идентификатор) роли, которая должна быть уже выбрана. По умолчанию: '' (ничего не выбрано).

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

Пример 1: Список выбора ролей

Вот пример того, как вы можете использовать функцию в HTML-коде для создания выпадающего списка ролей:

// Подключите необходимые файлы
require_once ABSPATH . 'wp-admin/includes/user.php';
require_once ABSPATH . 'wp-admin/includes/template.php';

echo '';
    wp_dropdown_roles();
echo '';

Изменения в функции

Функция была введена в версии 2.1.0.

Код функции

Вот исходный код функции wp_dropdown_roles():

function wp_dropdown_roles( $selected = '' ) {
$r = '';

$editable_roles = array_reverse( get_editable_roles() );

foreach ( $editable_roles as $role => $details ) {
    $name = translate_user_role( $details['name'] );
    // Предварительное выделение указанной роли.
    if ( $selected === $role ) {
        $r .= "nt$name";
    } else {
        $r .= "nt$name";
    }
}

echo $r;

}

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

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

• _dropdown (выбор списка опций)
• page_template_dropdown()
• parent_dropdown()
• wc_dropdown_variation_attribute_options()

Другие функции пользователя:

• auth_redirect()
• count_many_users_posts()
• count_user_posts()
• email_exists()
• get_current_user_id()
• get_userdata()
• wp_get_current_user()
• wp_dropdown_users()

В этом переводе текст стал более доступным и понятным для начинающих пользователей. Сложные термины объяснены простыми словами, структура четкая, и добавлен пример кода, чтобы пользователям было легче понять, как использовать функцию.