get_the_archive_description() WP 4.1.0

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

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

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

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

Возвращает

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

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

$desc = get_the_archive_description();

Примеры

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

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

$desc = get_the_archive_description();
if( $desc ){
	echo $desc;
}

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

<?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)

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