Как использовать функцию single_tag_title() в WordPress

# Функция SINGLE_TAG_TITLE() │ WP 2.3.0

Функция single_tag_title() используется для отображения или получения названия страницы архива постов по метке (тегу).

Это полезно для файлов шаблонов тегов, когда необходимо отобразить название страницы с тегом. Префикс не добавляет пробел автоматически, поэтому если требуется пробел, его нужно добавить в конце значения параметра.

## Возвращаемое значение

- **String|null**: Название, когда вы запрашиваете его.

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

```php
single_tag_title( $prefix, $display );

• $prefix (строка) — что отображать перед названием.
  • По умолчанию: ''
• $display (boolean) — нужно ли отображать или получать название.
  • По умолчанию: true

Примеры

Пример 1: Заголовок текущих тегов с предшествующим текстом

Предположим, мы просматриваем страницу тегов "продвижение сайта".

.

В результате мы получаем: "Вы просматриваете тег: Продвижение сайта".

Пример 2: Получение заголовка в переменную

Этот пример показывает, как получить название в переменную $current_tag вместо того, чтобы отображать его.

$current_tag = single_tag_title( '', false );
echo $current_tag;

Изменения

• С версии 2.3.0 — добавлена в систему.

Код функции SINGLE_TAG_TITLE()

Код функции находится в файле:

wp-includes/general-template.php

function single_tag_title( $prefix = '', $display = true ) {
    return single_term_title( $prefix, $display );
}

Связанные функции

Теги

• edit_tag_link()
• get_tag_link()
• get_tags()
• tag_description()
• tag_exists()
• wp_generate_tag_cloud()
• wp_tag_cloud()

Таксономии (категория, тег)

• category_description()
• get_the_term_list()
• in_category()
• single_cat_title()
• single_term_title()
• term_description()
• the_taxonomies()
• the_terms()
• wp_dropdown_categories()
• wp_list_categories()