Описание функции the_terms()
Функция the_terms() выводит список терминов таксономии, связанных с определенной записью. Она используется для отображения тегов, категорий и других пользовательских таксономий на страницах записи. Функция позволяет указать формат вывода и предоставляет возможность управлять отображением через параметры.
Термины выводятся в виде HTML, что упрощает интеграцию с темой
Параметры
$id
Тип: int
Обязательный: Да
Описание: ID записи, для которой необходимо получить термины
Возможные значения:
$taxonomy
Тип: string
Обязательный: Да
Описание: Имя таксономии, для которой нужно получить термины
Возможные значения:
$before
Тип: string
Обязательный: Нет
Описание: HTML перед выводом терминов
Возможные значения:
$sep
Тип: string
Обязательный: Нет
По умолчанию: ,
Описание: Разделитель между терминами
Возможные значения:
$after
Тип: string
Обязательный: Нет
Описание: HTML после вывода терминов
Возможные значения:
Возвращаемое значение
Тип: void
Описание: Функция не возвращает значения, а выводит термины напрямую
Возможные значения:
• Выводит термины в виде HTML
• Если термины отсутствуют, ничего не выводит
Примеры использования
Вывод всех категорий, связанных с текущей записью
the_terms( get_the_ID(), 'category' );
Выводит термины без дополнительного HTML
Выводит теги текущей записи с пользовательским текстом и разделителем
the_terms( get_the_ID(), 'post_tag', 'Теги: ', ', ');
Теги: тег1, тег2
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Входные данные автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для безопасности
— Связанные функции
Получает термины таксономии в виде массива, а не выводит их
Получает категории конкретной записи
— Примечания
– Ограничения
Не выводит термины, если они отсутствуют
– Частые проблемы
- Проблемы с выводом, если ID записи неверен
- Неверное имя таксономии вернет пустой результат