# wp_dropdown_languages()

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

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

## Сигнатура

```php
wp_dropdown_languages( string|array $args = array() ): string
```

## Описание

См. alsoget_available_languages()

wp_get_available_translations()

## Параметры

- `$args` `string|array` — необязательный, по умолчанию `array()`. Массив или строка аргументов для вывода селектора языка.
  
  id stringАтрибут ID элемента select. Значение по умолчанию 'locale'.
  
  name stringАтрибут name элемента select. Значение по умолчанию 'locale'.
  
  languages string[]Список установленных языков, содержит только локали.
  
  translations arrayСписок доступных переводов. По умолчанию — результат wp_get_available_translations().
  
  selected stringЯзык, который должен быть выбран.
  
  echo bool|intСледует ли выводить сформированную разметку. Принимает 0, 1 или их логические эквиваленты. Значение по умолчанию 1.
  
  show_available_translations boolСледует ли показывать доступные переводы. Значение по умолчанию true.
  
  show_option_site_default boolСледует ли показывать вариант возврата к локали сайта. Значение по умолчанию false.
  
  show_option_en_us boolСледует ли показывать вариант English (United States). Значение по умолчанию true.
  
  explicit_option_en_us boolИспользует ли вариант English (United States) явное значение en_US вместо пустого значения. Значение по умолчанию false.

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

`string`

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

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

```php
function wp_dropdown_languages( $args = array() ) {

	$parsed_args = wp_parse_args(
		$args,
		array(
			'id'                          => 'locale',
			'name'                        => 'locale',
			'languages'                   => array(),
			'translations'                => array(),
			'selected'                    => '',
			'echo'                        => 1,
			'show_available_translations' => true,
			'show_option_site_default'    => false,
			'show_option_en_us'           => true,
			'explicit_option_en_us'       => false,
		)
	);

	// Bail if no ID or no name.
	if ( ! $parsed_args['id'] || ! $parsed_args['name'] ) {
		return;
	}

	// English (United States) uses an empty string for the value attribute.
	if ( 'en_US' === $parsed_args['selected'] && ! $parsed_args['explicit_option_en_us'] ) {
		$parsed_args['selected'] = '';
	}

	$translations = $parsed_args['translations'];
	if ( empty( $translations ) ) {
		require_once ABSPATH . 'wp-admin/includes/translation-install.php';
		$translations = wp_get_available_translations();
	}

	/*
	 * $parsed_args['languages'] should only contain the locales. Find the locale in
	 * $translations to get the native name. Fall back to locale.
	 */
	$languages = array();
	foreach ( $parsed_args['languages'] as $locale ) {
		if ( isset( $translations[ $locale ] ) ) {
			$translation = $translations[ $locale ];
			$languages[] = array(
				'language'    => $translation['language'],
				'native_name' => $translation['native_name'],
				'lang'        => current( $translation['iso'] ),
			);

			// Remove installed language from available translations.
			unset( $translations[ $locale ] );
		} else {
			$languages[] = array(
				'language'    => $locale,
				'native_name' => $locale,
				'lang'        => '',
			);
		}
	}

	$translations_available = ( ! empty( $translations ) && $parsed_args['show_available_translations'] );

	// Holds the HTML markup.
	$structure = array();

	// List installed languages.
	if ( $translations_available ) {
		$structure[] = '<optgroup label="' . esc_attr_x( 'Installed', 'translations' ) . '">';
	}

	// Site default.
	if ( $parsed_args['show_option_site_default'] ) {
		$structure[] = sprintf(
			'<option value="site-default" data-installed="1"%s>%s</option>',
			selected( 'site-default', $parsed_args['selected'], false ),
			_x( 'Site Default', 'default site language' )
		);
	}

	if ( $parsed_args['show_option_en_us'] ) {
		$value       = ( $parsed_args['explicit_option_en_us'] ) ? 'en_US' : '';
		$structure[] = sprintf(
			'<option value="%s" lang="en" data-installed="1"%s>English (United States)</option>',
			esc_attr( $value ),
			selected( '', $parsed_args['selected'], false )
		);
	}

	// List installed languages.
	foreach ( $languages as $language ) {
		$structure[] = sprintf(
			'<option value="%s" lang="%s"%s data-installed="1">%s</option>',
			esc_attr( $language['language'] ),
			esc_attr( $language['lang'] ),
			selected( $language['language'], $parsed_args['selected'], false ),
			esc_html( $language['native_name'] )
		);
	}
	if ( $translations_available ) {
		$structure[] = '</optgroup>';
	}

	// List available translations.
	if ( $translations_available ) {
		$structure[] = '<optgroup label="' . esc_attr_x( 'Available', 'translations' ) . '">';
		foreach ( $translations as $translation ) {
			$structure[] = sprintf(
				'<option value="%s" lang="%s"%s>%s</option>',
				esc_attr( $translation['language'] ),
				esc_attr( current( $translation['iso'] ) ),
				selected( $translation['language'], $parsed_args['selected'], false ),
				esc_html( $translation['native_name'] )
			);
		}
		$structure[] = '</optgroup>';
	}

	// Combine the output string.
	$output  = sprintf( '<select name="%s" id="%s">', esc_attr( $parsed_args['name'] ), esc_attr( $parsed_args['id'] ) );
	$output .= implode( "\n", $structure );
	$output .= '</select>';

	if ( $parsed_args['echo'] ) {
		echo $output;
	}

	return $output;
}
```

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

- 5.9.0 — Introduced the explicit_option_en_us argument.
- 5.1.0 — Introduced the show_option_en_us argument.
- 4.7.0 — Introduced the show_option_site_default argument.
- 4.3.0 — Introduced the echo argument.
- 4.0.0 — Introduced.

## Связанные

Использует: [`wp_get_available_translations`](https://chugunov.pro/api-wordpress/functions/wp_get_available_translations/), [`esc_attr_x`](https://chugunov.pro/api-wordpress/functions/esc_attr_x/), [`selected`](https://chugunov.pro/api-wordpress/functions/selected/), [`_x`](https://chugunov.pro/api-wordpress/functions/_x/), [`esc_attr`](https://chugunov.pro/api-wordpress/functions/esc_attr/), [`esc_html`](https://chugunov.pro/api-wordpress/functions/esc_html/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/).
Используется в: [`login_footer`](https://chugunov.pro/api-wordpress/functions/login_footer/), [`show_blog_form`](https://chugunov.pro/api-wordpress/functions/show_blog_form/).

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