# list_cats()

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

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

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

## Сигнатура

```php
list_cats( int $optionall = 1, string $all = 'All', string $sort_column = 'ID', string $sort_order = 'asc', string $file = '', bool $list = true, int $optiondates, int $optioncount, int $hide_empty = 1, int $use_desc_for_title = 1, bool $children = false, int $child_of, int $categories, int $recurse, string $feed = '', string $feed_image = '', string $exclude = '', bool $hierarchical = false ): null|false
```

## Описание

См. alsowp_list_categories()

## Параметры

- `$optionall` `int` — необязательный, по умолчанию `1`. Default:1
- `$all` `string` — необязательный, по умолчанию `'All'`. Значение по умолчанию: 'All'
- `$sort_column` `string` — необязательный, по умолчанию `'ID'`. Значение по умолчанию: 'ID'
- `$sort_order` `string` — необязательный, по умолчанию `'asc'`. Значение по умолчанию: 'asc'
- `$file` `string` — необязательный, по умолчанию `''`. Default:''
- `$list` `bool` — необязательный, по умолчанию `true`. Значение по умолчанию: true
- `$optiondates` `int` — обязательный
- `$optioncount` `int` — обязательный
- `$hide_empty` `int` — необязательный, по умолчанию `1`. Default:1
- `$use_desc_for_title` `int` — необязательный, по умолчанию `1`. Default:1
- `$children` `bool` — необязательный, по умолчанию `false`. Значение по умолчанию: false
- `$child_of` `int` — обязательный
- `$categories` `int` — обязательный
- `$recurse` `int` — обязательный
- `$feed` `string` — необязательный, по умолчанию `''`. Default:''
- `$feed_image` `string` — необязательный, по умолчанию `''`. Default:''
- `$exclude` `string` — необязательный, по умолчанию `''`. Default:''
- `$hierarchical` `bool` — необязательный, по умолчанию `false`. Значение по умолчанию: false

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

`null|false`

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

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

```php
function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0,
				$optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,
				$recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {
	_deprecated_function( __FUNCTION__, '2.1.0', 'wp_list_categories()' );

	$query = compact('optionall', 'all', 'sort_column', 'sort_order', 'file', 'list', 'optiondates', 'optioncount', 'hide_empty', 'use_desc_for_title', 'children',
		'child_of', 'categories', 'recurse', 'feed', 'feed_image', 'exclude', 'hierarchical');
	return wp_list_cats($query);
}
```

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

- 2.1.0 — Deprecated. Use wp_list_categories()
- 0.71 — Introduced.

## Связанные

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

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