the_terms() WP 2.5.0

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

Хуки из функции

Возвращает

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

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

<?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: wp-includes/category-template.php ^{WP 5.2.1}

<?php
function the_terms( $id, $taxonomy, $before = '', $sep = ', ', $after = '' ) {
	$term_list = get_the_term_list( $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 (термины таксономий)

Еще из раздела: Любые таксономии

Еще из тегов шаблона: Таксономии: рубрики, метки, ...