Функция SINGLE_TERM_TITLE() │ WP 3.1.0

Данная функция отображает или возвращает название текущей таксономии (категории, тега и т.д.) и используется на страницах архивов терминов.

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

Используется в

• single_tag_title()
• single_cat_title()
• wp_get_document_title()

Время выполнения

• 1 раз — 0.000001 сек (реакция света)
• 50000 раз — 0.02 сек (реакция света)

Советы по использованию

• Функции, связанные с данной функцией:
  • single_cat_title
  • single_tag_title
  • single_term_title

Возврат значения

Функция возвращает строку или null. Она возвращает название текущего термина (категории, тега и т.д.). Если заголовок не найден, будет возвращено null.

Пример использования

Параметры:

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

Примеры

Пример 1: Отображение названия текущей таксономии

Давайте выведем название текущего термина таксономии "Учебники для студентов" с предшествующим текстом "Вы находитесь в разделе: ".

.

Вывод:

Вы находитесь в разделе: Учебники для студентов

Пример 2: Получение названия термина как переменной

В этом примере мы получаем имя термина для переменной $term_title, но не выводим его на экран:

Изменения

• С версии 3.1.0 функция была введена в WordPress.

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

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

    if ( ! $term ) {
        return;
    }

    if ( is_category() ) {
        $term_name = apply_filters( 'single_cat_title', $term->name );
    } elseif ( is_tag() ) {
        $term_name = apply_filters( 'single_tag_title', $term->name );
    } elseif ( is_tax() ) {
        $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;
    }
}

Похожие функции

• get_admin_page_title() — Получить заголовок страницы администрирования
• get_the_archive_title() — Получить заголовок архива
• get_the_title() — Получить заголовок поста
• single_month_title() — Получить заголовок месяца
• single_post_title() — Получить заголовок поста
• the_archive_title() — Вывести заголовок архива
• the_title() — Вывести заголовок
• the_title_attribute() — Вывести атрибут заголовка
• wp_get_document_title() — Получить заголовок документа

Эти функции позволяют работать с заголовками и терминами в WordPress.