the_terms() WP 2.5.0

Выводит список ссылок на термины (элементы таксономии), относящиеся к указанному посту.

Возвращает

null|false. Выводит на экран список ссылок на термины, к которым прикреплен объект (запись).

Использование

<?php the_terms( $id, $taxonomy, $before, $sep, $after ); ?>

$id(число) (обязательный)

ID записи, элементы таксономии которой нужно получить.
По умолчанию: нет

$taxonomy(строка) (обязательный)

Название таксономии, элементы которой нужно получить.
По умолчанию: нет

$beforeстрока

Текст, который будет показан перед списком.
По умолчанию: ''

$sepстрока

Текст-разделитель, который будет показан между выводимыми элементами (тегами).
По умолчанию: ', '

$afterстрока

Замыкающий текст (текст в конце списка).
По умолчанию: ''

Примеры

#1. Выведем список элементов таксономии planets

Предположим у нас есть произвольная таксономия planets и пост с ID 67, который относится к 2-м элементам этой таксономии: Земля, Марс. Тогда код:

<?php the_terms( 67, 'planets', 'В разделах: '); ?>

// выведет на экран:
// В разделах: <a href="#">Земля</a>, <a href="#">Марс</a>

Список изменений

Код the_terms() the terms ^{WP 5.9}

function the_terms( $post_id, $taxonomy, $before = '', $sep = ', ', $after = '' ) {
	$term_list = get_the_term_list( $post_id, $taxonomy, $before, $sep, $after );

	if ( is_wp_error( $term_list ) ) {
		return false;
	}

	/**
	 * Filters the list of terms to display.
	 *
	 * @since 2.9.0
	 *
	 * @param string $term_list List of terms to display.
	 * @param string $taxonomy  The taxonomy name.
	 * @param string $before    String to use before the terms.
	 * @param string $sep       String to use between the terms.
	 * @param string $after     String to use after the terms.
	 */
	echo apply_filters( 'the_terms', $term_list, $taxonomy, $before, $sep, $after );
}

Cвязанные функции

term (термины таксономий)

Любые таксономии

Таксономии: рубрики, метки, ...