term_description с версии 2.8.0

Описание

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

term_description() используется в: tag_description(), category_description().

term_description() работает на базе get_term_field().

Функция возвращает текст, описание термина или пусто ('').

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

<?php echo term_description( $term_id, $taxonomy ) ?> 

Параметры

$term_id (число)

ID термина (элемента таксономии), описание которого нужно получить. Если этот параметр не указать, то функция попытается получить описание термина который в данный момент находится в запросе (например, если отображается страница категории "SEO", то функция получит описание этой категории).
По умолчанию: ID текущего термина в запросе

$taxonomy (строка)

Название таксономии, к которой принадлежит термин, описание которого нужно получить. Может быть: category, post_tag, link_category или произвольная таксономия.
По умолчанию: 'post_tag'

Примеры

1. Получим описание текущего термина (категории, метки и т.п.):

<?php $description = term_description(); ?>

2. Выведем на экран описание раздела таксономии my_tax, ID которого равен 28:

<?php echo 'Описание раздела: ' . term_description('28', 'my_tax'); ?>

term_description()

function term_description( $term = 0, $taxonomy = 'post_tag' ) {
	if ( !$term && ( is_tax() || is_tag() || is_category() ) ) {
		$term = get_queried_object();
		$taxonomy = $term->taxonomy;
		$term = $term->term_id;
	}
	$description = get_term_field( 'description', $term, $taxonomy );
	return is_wp_error( $description ) ? '' : $description;
}

Связанные Функции

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.