category_description с версии 1.0.0

Описание

Получает описание рубрики, которое указывается на странице редактирования рубрики в админ-панели (посты > рубрики).

Если category_description() используется на странице архивов, отличной от category.php, то перед тем как использовать функцию нужно проверить, что генерируется страница категорий, а не какая-нибудь страница меток, авторов, дат и т.д.. Сделать это можно условным тегом is_category().

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

Функция возвращает текст, описание категории.

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

<?php echo category_description( $category_id ); ?>

Параметры

$category_id (число)

ID категории, описание которой нужно получить.
По умолчанию: текущая категория (в запросе)

Примеры

1. Обычный пример использования.
Выведем на экран описание категории 3 (id категории), используя оператор echo. echo нужен для вывода описания категории на экран, так как функция просто возвращает описание и ничего не выводит.

<div><?php echo category_description(3); ?></div>

В результате, получим описание категории 3.

Важно: если у категории нет описания, функция возвращает html тег br.

2. Выведем на экран описание категории (рубрики), используя слаг (альтернативное название категории), а не ID как в прошлом примере. Для этого получим ID с помощью функции get_category_by_slug().

<?php echo category_description( get_category_by_slug('category-slug')->term_id ); ?>

Заметка: это скорее наглядный пример и использовать его я не рекомендую, потому что нет необходимости получать все данные категории, лишь для того, чтобы получить ID категории.
Пример выше можно так же заменить на этот, тоже будет получено описание категории по слагу:

<?php echo get_category_by_slug('category-slug')->description; ?>

category_description()

function category_description( $category = 0 ) {
	return term_description( $category, 'category' );
}

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

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

Прогресс в компьютерной технике не стоит на месте и уже сейчас доступна карта памяти xD, которую можно смело назвать ультра-компактной, и которая обладает потрясающей скоростью передачи данных. Приобрести такие карты можно в интернет-магазине: sotmarket.ru