single_term_title() │ WP 3.1.0

Виводить на екран або отримує заголовок поточної таксономії (категорії, мітки тощо). Призначений для сторінок архівів.

Призначений для використання у файлі шаблону елемента таксономії (терміну) для відображення заголовка сторінки (назви терміна). Пробіл між префіксом і заголовком потрібно вказувати у параметрі $prefix , тобто. автоматично пробіл не додається.

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

1 раз – 0.000001 сек
(швидкість світла) | 50000 разів – 0.02 сек
(швидкість світла) |
PHP 7.1.11, WP 4.9.7

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

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

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

За замовчуванням: ”
$display (логічний): Якщо встановити цей параметр у 0 (false), результат функції буде повернуто, а чи не виведено на екран.

Типово: 1 (true)

Приклади

#1 Заголовок поточної таксономії

Виведемо на екран заголовок поточної таксономії “Підручники для школярів” із попереднім текстом “Ви переглядаєте розділ: “. Під таксономією розуміється довільна таксономія, або це може бути розділ категорії (рубрики), або мітка:

<p><?php single_term_title('Ви переглядаєте розділ:'); ?>.</p>

Отримаємо:Вы просматриваете раздел: Учебники для школьников

#2 Отримаємо заголовок у змінну

Приклад показує, як отримати заголовок у змінну $term_title , а не виводити його на екран:

<?php $term_title = single_term_title('', 0); ?>

список змін

З версії 3.1.0

Введено.

Код `single_term_title() single term title` ^{WP 6.0.2}

wp-includes/general-template.php

function single_term_title( $prefix = '', $display = true ) {
	$term = get_queried_object();

	if ( ! $term ) {
		return;
	}

	if ( is_category() ) {
		/**
		 * Filters the category archive page title.
		 *
		 * @ Since 2.0.10
		 *
		 * @param string $term_name Category name for archive being displayed.
		 */
		$term_name = apply_filters( 'single_cat_title', $term->name);
	} elseif (is_tag()) {
		/**
		 * Filters the tag archive page title.
		 *
		 * @ Since 2.3.0
		 *
		 * @param string $term_name Tag name for archive being displayed.
		 */
		$term_name = apply_filters( 'single_tag_title', $term->name);
	} elseif ( is_tax() ) {
		/**
		 * Filters the custom taxonomy archive page title.
		 *
		 * @ Since 3.1.0
		 *
		 * @param string $term_name Term name for archive being displayed.
		 */
		$term_name = apply_filters( 'single_term_title', $term->name);
	} else {
		return;
	}

	if (empty($term_name)) {
		return;
	}

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

single_term_title() │ WP 3.1.0

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

Приклади

#1 Заголовок поточної таксономії

#2 Отримаємо заголовок у змінну

список змін

Код single_term_title() single term title WP 6.0.2

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

title (заголовок)

Будь-які таксономії

Таксономії: рубрики, мітки, …

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

Код `single_term_title() single term title` ^{WP 6.0.2}