Функция the_taxonomies() используется для отображения всех таксономий, связанных с конкретным постом. Эта функция позволяет гибко настроить формат вывода и может быть использована как внутри цикла, так и вне его.
the_taxonomies( array $args = array() )
Описание
С помощью этой функции вы можете отображать таксономии для поста без указания его ID. Если функция используется вне цикла, можно передать ID поста.
Параметры
- $args(необязательный)
Массив параметров для настройки вывода таксономий. Вот основные параметры, которые вы можете использовать:- post (число|WP_Post): ID поста, для которого нужно получить таксономии. По умолчанию используется текущий пост.
- before (строка): текст, который будет выводиться перед списком таксономий. По умолчанию пустая строка.
- sep (строка): строка, которая будет использоваться для разделения таксономий. По умолчанию пробел.
- after (строка): текст, который будет выводиться после списка таксономий. По умолчанию пустая строка.
- template (строка): шаблон вывода списка таксономий. По умолчанию:
'%s: %l.'. - term_template (строка): шаблон вывода каждого термина. По умолчанию:
'<a href="%1$s">%2$s</a>'.
Возвращаемое значение
Функция возвращает null, но выводит на экран список ссылок на таксономии, связанные с постом.
Пример 1: Простое использование в цикле
Выведем таксономии для текущего поста без дополнительных параметров:
<?php the_taxonomies(); ?>Результат
Рубрики: <a href="ССЫЛКА">Программирование</a>. Метки: <a href="ССЫЛКА">PHP</a> и <a href="ССЫЛКА">WordPress</a>.Пример 2: Вывод с кастомным текстом и разделителем
Используем кастомный текст перед списком таксономий и изменим разделитель:
<?php the_taxonomies(array(
'before' => '<div class="taxonomies">',
'sep' => ' | ',
'after' => '</div>'
)); ?>
Результат:
<div class="taxonomies">
Рубрики: <a href="ССЫЛКА">Программирование</a> | Метки: <a href="ССЫЛКА">PHP</a> и <a href="ССЫЛКА">WordPress</a>.
</div>
Пример 3: Вывод таксономий для конкретного поста
Выведем таксономии для поста с ID 25:
<?php the_taxonomies(array('post' => 25)); ?>
Пример 4: Настройка шаблона вывода
Создадим пользовательский шаблон для отображения таксономий:
<?php the_taxonomies(array(
'before' => '<div class="custom-taxonomies">',
'template' => '<span class="taxonomy-name">%s:</span> <span class="taxonomy-term-list">%l</span>',
'term_template' => '<a href="%1$s" rel="tag">%2$s</a>',
'after' => '</div>'
)); ?>
Результат:
<div class="custom-taxonomies">
<span class="taxonomy-name">Рубрики:</span> <span class="taxonomy-term-list"><a href="ССЫЛКА">Программирование</a></span>.
</div>
Заключение
Функция the_taxonomies() является мощным инструментом для вывода таксономий, связанных с постами в WordPress. С помощью гибкой настройки параметров вы можете легко адаптировать вывод таксономий под нужды вашего сайта, улучшая навигацию и представление информации для пользователей.