Функция single_term_title() в WordPress используется для вывода или получения заголовка текущего элемента таксономии (категории, метки и т.п.) на страницах архивов таксономий. Она особенно полезна при создании пользовательских шаблонов для страниц архива таксономий, где необходимо вывести название текущего термина.
Функция может как отображать заголовок, так и возвращать его в виде строки для дальнейшего использования в коде. При этом можно задать префикс, который будет отображен перед заголовком, однако между префиксом и заголовком пробел автоматически не добавляется, его нужно прописывать вручную.
string|void single_term_title( string $prefix = '', bool $display = true )
Параметры
- $prefix (строка, необязательный): Текст, который будет выведен перед заголовком. По умолчанию:
''. - $display (логический, необязательный): Указывает, будет ли заголовок выведен непосредственно на экран (true) или возвращен для использования в переменной (false). По умолчанию: true.
Возвращаемое значение
- string|null: Возвращает заголовок текущего элемента таксономии, если параметр
$displayустановлен в false. Если заголовок не найден или вывод осуществляется на экран, возвращает null.
1. Вывод заголовка текущей таксономии на страницу
Этот пример демонстрирует вывод заголовка текущего термина с текстом перед ним.
<p><?php single_term_title('Вы находитесь на: '); ?>.</p>
2. Получение заголовка в переменную
Если необходимо сохранить заголовок в переменную для дальнейшего использования в коде, можно использовать следующий пример:
$term_title = single_term_title('', false);
Заключение
Функция single_term_title() — это удобный инструмент для вывода заголовков страниц таксономий в WordPress. Она позволяет настроить вывод заголовка с префиксом и дает возможность возвращать заголовок в виде строки для использования в коде. Эта функция помогает улучшить пользовательский интерфейс на страницах архивов таксономий, таких как категории, метки или пользовательские таксономии.