get_the_archive_description() WP 4.1.0

Получает описание для страниц архивов: типов записей, меток, рубрик, элементов таксономий или архив автора.

Предназначен для использования на страницах архивов элементов таксономий (включая рубрики и метки), архивов типов записей или архива автора.

На странице автора описание берется из поля «Биография» (description). У элементов таксономии их поля «Описание» (description). У типов записей из функции get_the_post_type_description().

Используйте обертку the_archive_description(), чтобы сразу вывести результат на экран.

Является основой для: the_archive_description()

Работает на основе: get_the_author_meta(), term_description()

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

get_the_archive_description

Возвращает

Строку. Описание для страницы архива.

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

$desc = get_the_archive_description();

Примеры

#1 Выведем описание на любой странице архива (кроме архива по датам)

Допустим нам нужно одним кодом вывести описание для всех рубрик, меток, таксономий или авторов, если такое описание есть...

$description = get_the_archive_description();

if ( $description ) {
	echo "The description: $description";
}

Но лучше для таких целей использовать обертку для этой функции: the_archive_description(). В данном случае можно просто использовать параметр $before чтобы добавить текст перед описанием.

Заметки

Смотрите: term_description()

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

С версии 4.1.0	Введена.
С версии 4.7.0	Added support for author archives.
С версии 4.9.0	Added support for post type archives.

Код get the archive description: `wp-includes/general-template.php` ^{WP 5.3.2}

<?php
function get_the_archive_description() {
	if ( is_author() ) {
		$description = get_the_author_meta( 'description' );
	} elseif ( is_post_type_archive() ) {
		$description = get_the_post_type_description();
	} else {
		$description = term_description();
	}

	/**
	 * Filters the archive description.
	 *
	 * @since 4.1.0
	 *
	 * @param string $description Archive description to be displayed.
	 */
	return apply_filters( 'get_the_archive_description', $description );
}

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

Из метки: Описание (post term description)

Еще из раздела: Архивы

Петр

И куда вставлять, в какой файл

<?php
$desc = get_the_archive_description();
if( $desc ){
	echo $desc;
}
?>

Ответить04.Мар.2017 в 00:16 #

Kama7600

Туда где нужно вывести описание. Обычно это файл шаблона, отвечающий за страницу архива, например author.php. Подробнее смотри: иерархия файлов темы

Ответить10.Дек.2017 в 09:48 #

Aлексей Суслов

Здравствуйте, как получить описание кастомной рубрики(таксономии), в посте которой принадлежит данной таксономии?

Ответить20.Мар.2019 в 11:07 #