функция since 2.3.0

wp_tag_cloud()

Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.

Сигнатура

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

Описание

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

Оригинал (английский)

Outputs a list of tags in what is called a ‘tag cloud’, where the size of each tag is determined by how many times that particular tag has been assigned to posts.

Параметры

$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

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.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.