# wp_tag_cloud()

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

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

## Сигнатура

```php
wp_tag_cloud( array|string $args = '' ): void|string|string[]
```

## Описание

Выводит список меток в виде так называемого «облака меток», где размер каждой метки определяется тем, сколько раз эта метка была присвоена записям.

## Параметры

- `$args` `array|string` — необязательный, по умолчанию `''`. Массив или строка аргументов для отображения облака меток. Полные списки аргументов, которые можно передать в $args, см. в wp_generate_tag_cloud() и get_terms().
  
  number intКоличество меток для отображения. Принимает любое положительное целое число или ноль для возврата всех. Значение по умолчанию 45.
  
  link stringОтображать ли ссылки на редактирование терминов или постоянные ссылки терминов.
  
  Принимает 'edit' и 'view'. Значение по умолчанию 'view'.
  
  post_type stringТип записи. Используется для подсветки нужного пункта меню типа записи на связанной странице редактирования. По умолчанию используется первый тип записи, связанный с таксономией.
  
  echo boolВыводить ли возвращаемое значение. Значение по умолчанию true.

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

`void|string|string[]` — 'echo' 'format'

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

Файл: `wp-includes/category-template.php:716`

```php
function wp_tag_cloud( $args = '' ) {
	$defaults = array(
		'smallest'   => 8,
		'largest'    => 22,
		'unit'       => 'pt',
		'number'     => 45,
		'format'     => 'flat',
		'separator'  => "\n",
		'orderby'    => 'name',
		'order'      => 'ASC',
		'exclude'    => '',
		'include'    => '',
		'link'       => 'view',
		'taxonomy'   => 'post_tag',
		'post_type'  => '',
		'echo'       => true,
		'show_count' => 0,
	);

	$args = wp_parse_args( $args, $defaults );

	$tags = get_terms(
		array_merge(
			$args,
			array(
				'orderby' => 'count',
				'order'   => 'DESC',
			)
		)
	); // Always query top tags.

	if ( empty( $tags ) || is_wp_error( $tags ) ) {
		return;
	}

	foreach ( $tags as $key => $tag ) {
		if ( 'edit' === $args['link'] ) {
			$link = get_edit_term_link( $tag, $tag->taxonomy, $args['post_type'] );
		} else {
			$link = get_term_link( $tag, $tag->taxonomy );
		}

		if ( is_wp_error( $link ) ) {
			return;
		}

		$tags[ $key ]->link = $link;
		$tags[ $key ]->id   = $tag->term_id;
	}

	// Here's where those top tags get sorted according to $args.
	$return = wp_generate_tag_cloud( $tags, $args );

	/**
	 * Filters the tag cloud output.
	 *
	 * @since 2.3.0
	 *
	 * @param string|string[] $return Tag cloud as a string or an array, depending on 'format' argument.
	 * @param array           $args   An array of tag cloud arguments. See wp_tag_cloud()
	 *                                for information on accepted arguments.
	 */
	$return = apply_filters( 'wp_tag_cloud', $return, $args );

	if ( 'array' === $args['format'] || empty( $args['echo'] ) ) {
		return $return;
	}

	echo $return;
}
```

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

- 4.8.0 — Added the show_count argument.
- 2.8.0 — Added the taxonomy argument.
- 2.3.0 — Introduced.

## Связанные

Использует: [`wp_generate_tag_cloud`](https://chugunov.pro/api-wordpress/functions/wp_generate_tag_cloud/), [`get_term_link`](https://chugunov.pro/api-wordpress/functions/get_term_link/), [`get_terms`](https://chugunov.pro/api-wordpress/functions/get_terms/), [`get_edit_term_link`](https://chugunov.pro/api-wordpress/functions/get_edit_term_link/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`is_wp_error`](https://chugunov.pro/api-wordpress/functions/is_wp_error/).
Используется в: `WP_Widget_Tag_Cloud::widget`.

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