the_taxonomies()
Выводит ссылки на термины поста. Используется внутри Цикла WordPress
Также функцию можно использовать на отдельной странице поста, чтобы вывести элементы таксономии, к которым он относится.
Работает на основе: get_the_taxonomies()
1 раз — 0.009228 сек (очень медленно) | 50000 раз — 51.10 сек (очень медленно) | PHP 7.1.2, WP 4.7.3
Хуков нет.
Возвращает
null
. Выводит на экран список ссылок на элементы таксономии (термины), текущего поста.
Использование
<?php the_taxonomies( $args ); ?>
- $args(строка/массив)
- Аргументы отвечающие за вывод.
По умолчанию: предустановленные
Аргументы параметра $args
- post(число)
- ID поста, термины которого нужно получить.
По умолчанию: текущий пост - before(строка)
- Что выводить до списка.
По умолчанию: '' - sep(строка)
- Разделитель между ссылками.
По умолчанию: ' ' - after(строка)
- Что выводить после списка.
По умолчанию: '' - template(строка)
- Шаблон вывода списка. Где %s - название таксономии, а %l - список элементов в формате указанном в параметре
$term_template
.
По умолчанию: '%s: %l.' - term_template(строка)
- Формат вывода каждого элемента таксономии.
По умолчанию: '<a href="%1$s">%2$s</a>',
Примеры
#1 Демонстрация вывода
Пример вывода для обычных постов, которые прикрепляются к рубрикам и меткам.
<?php the_taxonomies('post=119'); ?>
Выведет:
Рубрики: <a href="ССЫЛКА">Кодекс</a>. Метки: <a href="ССЫЛКА">Хаки</a> и <a href="ССЫЛКА">Хуки</a>.
#2 Демонстрация вывода для произвольных таксономий
<?php the_taxonomies('post=7363'); ?>
Выведет:
Таксономия: <a href="ССЫЛКА">Кодекс</a>. Другая таксономия: <a href="ССЫЛКА">Хаки</a> и <a href="ССЫЛКА">Хуки</a>.
#3 Выведем список «обвернув» его в тег <div>:
<?php the_taxonomies( array( 'post' =>119, 'before' =>'<div class="foo">', 'after' =>'</div>' ) ); ?>
Выведет:
<div class="foo"> Рубрики: <a href="ССЫЛКА">Кодекс</a>. Метки: <a href="ССЫЛКА">loop</a> и <a href="ССЫЛКА">Новичкам</a>. </div>
Список изменений
С версии 2.5.0 | Введена. |
Код the_taxonomies() the taxonomies WP 6.6.2
function the_taxonomies( $args = array() ) { $defaults = array( 'post' => 0, 'before' => '', 'sep' => ' ', 'after' => '', ); $parsed_args = wp_parse_args( $args, $defaults ); echo $parsed_args['before'] . implode( $parsed_args['sep'], get_the_taxonomies( $parsed_args['post'], $parsed_args ) ) . $parsed_args['after']; }