# wp_category_checklist()

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

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

## Сигнатура

```php
wp_category_checklist( int $post_id, int $descendants_and_self, int[]|false $selected_cats = false, int[]|false $popular_cats = false, Walker $walker = null, bool $checked_ontop = true )
```

## Описание

См. alsowp_terms_checklist()

## Параметры

- `$post_id` `int` — необязательный. Запись, для которой генерируется список категорий с флажками. Значение по умолчанию 0.
  
  $selected_cats не должен быть массивом. Значение по умолчанию 0.
- `$descendants_and_self` `int` — необязательный. ID категории, которую нужно вывести вместе с её потомками.
  
  Значение по умолчанию 0.
- `$selected_cats` `int[]|false` — необязательный, по умолчанию `false`. Массив ID категорий, которые нужно отметить как выбранные.
- `$popular_cats` `int[]|false` — необязательный, по умолчанию `false`. Массив ID категорий, которым присваивается класс "popular-category".
- `$walker` `Walker` — необязательный, по умолчанию `null`. Объект Walker для построения вывода.
  
  По умолчанию — экземпляр Walker_Category_Checklist.
- `$checked_ontop` `bool` — необязательный, по умолчанию `true`. Перемещать ли отмеченные элементы из иерархии в начало списка.

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

Файл: `wp-admin/includes/template.php:40`

```php
function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $selected_cats = false, $popular_cats = false, $walker = null, $checked_ontop = true ) {
	wp_terms_checklist(
		$post_id,
		array(
			'taxonomy'             => 'category',
			'descendants_and_self' => $descendants_and_self,
			'selected_cats'        => $selected_cats,
			'popular_cats'         => $popular_cats,
			'walker'               => $walker,
			'checked_ontop'        => $checked_ontop,
		)
	);
}
```

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

- 2.5.1 — Introduced.

## Связанные

Использует: [`wp_terms_checklist`](https://chugunov.pro/api-wordpress/functions/wp_terms_checklist/).
Используется в: [`dropdown_categories`](https://chugunov.pro/api-wordpress/functions/dropdown_categories/).

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