wp_dropdown_roles() — описание функции WordPress на русском

Сигнатура

wp_dropdown_roles( string $selected = '', array $editable_roles = null )

Описание

Печатает элементы option для селекторов ролей.

Параметры

$selected string необязательный = ''

Слаг роли, которая должна быть уже выбрана.

$editable_roles array необязательный = null

Массив ролей для включения в выпадающий список. По умолчанию — все роли, которые текущий пользователь имеет право редактировать.

Исходный код

wp-admin/includes/template.php:976

function wp_dropdown_roles( $selected = '', $editable_roles = null ) {
	$r = '';

	if ( null === $editable_roles ) {
		$editable_roles = array_reverse( get_editable_roles() );
	}

	foreach ( $editable_roles as $role => $details ) {
		$name = translate_user_role( $details['name'] );
		// Preselect specified role.
		if ( $selected === $role ) {
			$r .= "\n\t<option selected='selected' value='" . esc_attr( $role ) . "'>$name</option>";
		} else {
			$r .= "\n\t<option value='" . esc_attr( $role ) . "'>$name</option>";
		}
	}

	echo $r;
}

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

Версия	Описание
7.0.0	Added $editable_roles parameter.
2.1.0	Introduced.