post_type_archive_title() │ WP 3.1.0

Виводить або повертає заголовок архівної сторінки довільного типу постів.

Цей Тег шаблону призначений для використання на сторінках, які відображаються файлами шаблону: archive.phpі archive-{posttype}.php.

Основа для:
wp_get_document_title()

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

<?php post_type_archive_title( $prefix, $display ); ?>

$prefix (рядок): Текст, який буде заголовком.

За замовчуванням: ”
$display (логічний): true – виведе на екран, false – просто, поверне для обробки.

Типово: true

Приклади

#1 Як працює функція

Допустимо, у нас є зареєстрований тип запису (див. register_post_type() ) movie у якого параметр lableдорівнює “фільми” і параметр has_archiveдорівнює true (тобто у типу є архівна сторінка). Тепер, якщо ми викличемо цю функцію на сторінці архіву http://example.com/movie, ми повинні побачити наступний заголовок:

<?php post_type_archive_title('Записи типу:'); ?>

Виведе: “Записи типу: Фільми”

список змін

З версії 3.1.0

Введено.

Код `post_type_archive_title() post type archive title` ^{WP 6.0.2}

wp-includes/general-template.php

function post_type_archive_title( $prefix = '', $display = true ) {
	if ( ! is_post_type_archive() ) {
		return;
	}

	$post_type = get_query_var( 'post_type');
	if ( is_array( $post_type ) ) {
		$post_type = reset($post_type);
	}

	$post_type_obj = get_post_type_object($post_type);

	/**
	 * Filters the post type archive title.
	 *
	 * @ Since 3.1.0
	 *
	 * @param string $post_type_name Post type 'name' label.
	 * @param string $post_type Post type.
	 */
	$title = apply_filters( 'post_type_archive_title', $post_type_obj->labels->name, $post_type );

	if ($display) {
		echo $prefix . $title;
	} else {
		return $prefix . $title;
	}
}

post_type_archive_title() │ WP 3.1.0

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

Приклади

#1 Як працює функція

список змін

Код post_type_archive_title() post type archive title WP 6.0.2

Зв’язані функції

archive (архіви записів)

Типи записів

Основні

Залишити відповідь Скасувати коментар

Код `post_type_archive_title() post type archive title` ^{WP 6.0.2}