post_type_archive_title()

Позволяет получить заголовок для страниц архивов типов записей.

Функция ничего не возвращает и не выводит при использовании её не на страницах архивов, проверка кстати выполняется функцией is_post_type_archive().

Заголовок кстати является не чем иным, как свойством объекта WP_Post_Type ->labels->name, который мы можем сами указывать при регистрации типа поста.

А вообще, рекомендую моё подробное руководство по произвольным типам записей.

post_type_archive_title( $prefix = '', $display = true )

Параметры

$prefix
(строка) Укажите в этом параметре любой текст или HTML-код, который хотите добавить непосредственно перед заголовком. На этот параметр не влияет действие фильтра post_type_archive_title.
$display
(логическое) Укажите в значение false, если хотите, чтобы функция вернула заголовок, а не вывела его.

Примеры

Самое частый вариант использования функции вот такой:

<h1><?php post_type_archive_title(); ?></h1>

Но мы можем сделать этот пример чуточку интересней:

echo post_type_archive_title( 'Архивы: ', false );

Хуки

post_type_archive_title

$title = apply_filters( 'post_type_archive_title', $post_type_obj->labels->name, $post_type );
$post_type_obj->labels->name
(строка) Это как раз значение свойства labels, которое и будет заголовком.
$post_type
(строка) Название типа записи, для архивов которого получаем заголовок.

В примере выше мы добавили перед заголовком Архивы: . Давайте попробуем сделать то же самое при помощи этого фильтра.

add_filter( 'post_type_archive_title', 'true_change_cpt_archive_title', 25, 2 );
 
function true_change_cpt_archive_title( $title, $post_type ) {
	// сделаем это только типа записи "game"
	if( 'game' === $post_type ) {
		$title = 'Архивы: ' . $title;
	}
	return $title;
}

Тут главное будьте осторожны, чтобы ваш префикс не добавился дважды 😉

Источник: Блог Миши Рудрастых

Миша Рудрастых

Путешествует по миру и рассказывает всем о WordPress лично, у себя в блогах и на курсах в Санкт-Петербурге. Умеет просто объяснять сложные вещи, делает это красиво. Организовывает неплохие WordCamp's, но совсем не умеет слушать чужие доклады.

Добавить комментарий

%d такие блоггеры, как: