get_the_term_list()
Выводит список ссылок на элементы таксономии (например метки), относящиеся к определенному посту.
Функцию можно использовать внутри Цикла WordPress, например, для того, чтобы через запятую вывести метки каждого поста.
Вместо стандартных меток можно выводить элементы произвольных таксономий.
Возвращает
Строку|false|WP_Error
.
-
Строка
— список элементов таксономии в виде ссылок на соответствующие страницы архивов. -
false
— если не удалось получить элементы таксономии. - WP_Error — если не удалось получить ссылку на любой из полученных элементов таксономии. Это редкий случай и связан с ошибкой в структуре WordPress...
Использование
get_the_term_list( $id, $taxonomy, $before, $sep, $after );
- $id(число/WP_Post) (обязательный)
- ID поста, элементы таксономии которого нужно получить.
- $taxonomy(строка) (обязательный)
- Название таксономии, элементы которой нужно получить.
- $before(строка)
- Текст, который будет показан перед списком.
По умолчанию: '' - $sep(строка)
- Текст-разделитель, который будет показан между выводимыми элементами (тегами).
По умолчанию: '' - $after(строка)
- Замыкающий текст (текст в конце списка).
По умолчанию: ''
Примеры
#1 Список элементов таксономии
Такой код можно использовать внутри Цикла WordPress, чтобы вывести на экран элементы (метки) таксономии "heroes" для каждого поста:
<?php echo get_the_term_list( $post->ID, 'people', 'Знаменитости: ', ',', '' ); ?>
В результате мы получим примерно следующий список для каждого поста:
Знаменитости: <a href="person1">Эминем</a>, <a href="person2">Дуэйн Джонсон</a>, ...
#2 Получим UL список
Пример показывает как вывести элементы таксономии styles
в виде маркированного
(ненумеровонного) списка.
echo get_the_term_list( $post->ID, 'styles', '<ul class="styles"><li>', ',</li><li>', '</li></ul>' );
Получим:
<ul class="styles"> <li><a href="person1">Style 1</a>,</li> <li><a href="person2">Style 2</a></li> </ul>
Список изменений
С версии 2.5.0 | Введена. |