Функция the_terms() используется для отображения терминов (элементов таксономии), связанных с конкретным постом, в виде списка ссылок. Эта функция удобна для отображения категорий, меток или пользовательских таксономий в теме WordPress.
the_terms( int $post_id, string $taxonomy, string $before = '', string $sep = ', ', string $after = '' ): void|false
Параметры
- $post_id (int, обязательный): ID поста, термины которого необходимо получить.
- $taxonomy (string, обязательный): Название таксономии, элементы которой будут отображены.
- $before (string, необязательный): Текст, который будет показан перед списком терминов. По умолчанию:
''. - $sep (string, необязательный): Текст-разделитель, который будет показан между элементами. По умолчанию:
', '. - $after (string, необязательный): Текст, который будет показан после списка. По умолчанию:
''.
Возвращаемое значение
- void: Функция выводит список на экран и ничего не возвращает.
- false: Возвращает
falseв случае ошибки.
Как работает функция
Функция the_terms() выводит список ссылок на термины, к которым прикреплён указанный пост. Она фактически использует под капотом функцию get_the_term_list(), которая получает термины и формирует HTML-код для их отображения.
Хуки
the_terms: Хук, вызываемый при выводе терминов.
Пример 1: Получение категорий текущего поста
В этом примере мы получаем список категорий для текущего поста:
<?php the_terms( $post->ID, 'category', 'Категории: ', ' / ' ); ?>
В результате выполнения кода вы получите строку, подобную следующей:
Категории: <a href="#">ТВ</a> / <a href="#">Динамик</a> / <a href="#">Монитор</a>
Пример 2: Использование параметров для кастомизации вывода
Вы можете использовать параметры before, sep и after для настройки вывода терминов:
<?php the_terms( $post->ID, 'tags', '<strong>Теги:</strong> ', ' | ', ' <em>конец</em>' ); ?>
Этот код создаст вывод в формате:
Теги: <strong><a href="#">Тег1</a></strong> | <strong><a href="#">Тег2</a></strong> <em>конец</em>
Заключение
Функция the_terms() — мощный инструмент для отображения терминов, связанных с постом, в WordPress. Она предоставляет возможность легко формировать списки категорий, меток и других таксономий, делая контент более структурированным и удобным для навигации. Используя параметры функции, вы можете кастомизировать вывод в соответствии с вашими потребностями.