# wp_dropdown_cats()

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

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

> Устаревший элемент. Помечен устаревшим с версии 3.0.0.

## Сигнатура

```php
wp_dropdown_cats( int $current_cat, int $current_parent, int $category_parent, int $level, array $categories ): void|false
```

## Описание

См. alsowp_dropdown_categories()

## Параметры

- `$current_cat` `int` — необязательный. Идентификатор текущей рубрики. Значение по умолчанию — 0.
- `$current_parent` `int` — необязательный. Идентификатор текущей родительской рубрики. Значение по умолчанию — 0.
- `$category_parent` `int` — необязательный. Идентификатор родителя, для которого извлекаются рубрики. Значение по умолчанию — 0.
- `$level` `int` — необязательный. Количество уровней вложенности для отображения. Значение по умолчанию — 0.
- `$categories` `array` — необязательный. Рубрики, включаемые в элемент управления. Значение по умолчанию — 0.

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

`void|false`

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

Файл: `wp-admin/includes/deprecated.php:137`

```php
function wp_dropdown_cats( $current_cat = 0, $current_parent = 0, $category_parent = 0, $level = 0, $categories = 0 ) {
	_deprecated_function( __FUNCTION__, '3.0.0', 'wp_dropdown_categories()' );
	if (!$categories )
		$categories = get_categories( array('hide_empty' => 0) );

	if ( $categories ) {
		foreach ( $categories as $category ) {
			if ( $current_cat != $category->term_id && $category_parent == $category->parent) {
				$pad = str_repeat( '&#8211; ', $level );
				$category->name = esc_html( $category->name );
				echo "\n\t<option value='$category->term_id'";
				if ( $current_parent == $category->term_id )
					echo " selected='selected'";
				echo ">$pad$category->name</option>";
				wp_dropdown_cats( $current_cat, $current_parent, $category->term_id, $level +1, $categories );
			}
		}
	} else {
		return false;
	}
}
```

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

- 3.0.0 — Deprecated. Use wp_dropdown_categories()
- 1.2.0 — Introduced.

## Связанные

Использует: [`wp_dropdown_cats`](https://chugunov.pro/api-wordpress/functions/wp_dropdown_cats/), [`get_categories`](https://chugunov.pro/api-wordpress/functions/get_categories/), [`esc_html`](https://chugunov.pro/api-wordpress/functions/esc_html/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/).
Используется в: [`wp_dropdown_cats`](https://chugunov.pro/api-wordpress/functions/wp_dropdown_cats/).

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