WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

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()
Хуки из функции
Возвращает

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

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

$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

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

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

3 коммента
  • Петр

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

    <?php
    $desc = get_the_archive_description();
    if( $desc ){
    	echo $desc;
    }
    ?>
    1
    Ответить04.Мар.2017 в 00:16 #
  • Aлексей Суслов

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

    Ответить20.Мар.2019 в 11:07 #
Здравствуйте, !     Войти . Зарегистрироваться