# wp_popular_terms_checklist()

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

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

## Сигнатура

```php
wp_popular_terms_checklist( string $taxonomy, int $default_term, int $number = 10, bool $display = true ): int[]
```

## Описание

Если аргумент $display равен true, выводятся элементы списка флажков , помеченные названиями выбранных терминов.
Если глобальная переменная $post_ID не пуста, термины, связанные с этой записью, будут отмечены.

## Параметры

- `$taxonomy` `string` — обязательный. Таксономия, из которой извлекаются термины.
- `$default_term` `int` — необязательный. Не используется.
- `$number` `int` — необязательный, по умолчанию `10`. Количество извлекаемых терминов.
- `$display` `bool` — необязательный, по умолчанию `true`. Отображать ли также список.

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

`int[]`

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

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

```php
function wp_popular_terms_checklist( $taxonomy, $default_term = 0, $number = 10, $display = true ) {
	$post = get_post();

	if ( $post && $post->ID ) {
		$checked_terms = wp_get_object_terms( $post->ID, $taxonomy, array( 'fields' => 'ids' ) );
	} else {
		$checked_terms = array();
	}

	$terms = get_terms(
		array(
			'taxonomy'     => $taxonomy,
			'orderby'      => 'count',
			'order'        => 'DESC',
			'number'       => $number,
			'hierarchical' => false,
		)
	);

	$tax = get_taxonomy( $taxonomy );

	$popular_ids = array();

	foreach ( (array) $terms as $term ) {
		$popular_ids[] = $term->term_id;

		if ( ! $display ) { // Hack for Ajax use.
			continue;
		}

		$id      = "popular-$taxonomy-$term->term_id";
		$checked = in_array( $term->term_id, $checked_terms, true ) ? 'checked="checked"' : '';
		?>

		<li id="<?php echo $id; ?>" class="popular-category">
			<label class="selectit">
				<input id="in-<?php echo $id; ?>" type="checkbox" <?php echo $checked; ?> value="<?php echo (int) $term->term_id; ?>" <?php disabled( ! current_user_can( $tax->cap->assign_terms ) ); ?> />
				<?php
				/** This filter is documented in wp-includes/category-template.php */
				echo esc_html( apply_filters( 'the_category', $term->name, '', '' ) );
				?>
			</label>
		</li>

		<?php
	}
	return $popular_ids;
}
```

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

- 2.5.0 — Introduced.

## Связанные

Использует: [`disabled`](https://chugunov.pro/api-wordpress/functions/disabled/), [`wp_get_object_terms`](https://chugunov.pro/api-wordpress/functions/wp_get_object_terms/), [`get_terms`](https://chugunov.pro/api-wordpress/functions/get_terms/), [`current_user_can`](https://chugunov.pro/api-wordpress/functions/current_user_can/), [`esc_html`](https://chugunov.pro/api-wordpress/functions/esc_html/), [`get_taxonomy`](https://chugunov.pro/api-wordpress/functions/get_taxonomy/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: [`_wp_ajax_add_hierarchical_term`](https://chugunov.pro/api-wordpress/functions/_wp_ajax_add_hierarchical_term/), [`link_categories_meta_box`](https://chugunov.pro/api-wordpress/functions/link_categories_meta_box/), [`post_categories_meta_box`](https://chugunov.pro/api-wordpress/functions/post_categories_meta_box/).

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