get_the_term_list() │ WP 2.5.0

Выводит список ссылок на элементы таксономии (например метки), относящиеся к определенному посту.

Функцию можно использовать внутри Цикла WordPress, например, для того, чтобы через запятую вывести метки каждого поста.

Вместо стандартных меток можно выводить элементы произвольных таксономий.

Работает на основе: get_the_terms()

Основа для: get_the_tag_list(), the_terms()

1 раз — 0.004471 сек (очень медленно) | 50000 раз — 5.31 сек (быстро) | PHP 7.1.2, WP 4.7.3

Хуки из функции

term_links-(taxonomy)

term_links-category

term_links-post_tag

term_links-post_format

Возвращает

Строку|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

Введена.

Код `get_the_term_list() get the term list` ^{WP 6.5.2}

wp-includes/category-template.php

function get_the_term_list( $post_id, $taxonomy, $before = '', $sep = '', $after = '' ) {
	$terms = get_the_terms( $post_id, $taxonomy );

	if ( is_wp_error( $terms ) ) {
		return $terms;
	}

	if ( empty( $terms ) ) {
		return false;
	}

	$links = array();

	foreach ( $terms as $term ) {
		$link = get_term_link( $term, $taxonomy );
		if ( is_wp_error( $link ) ) {
			return $link;
		}
		$links[] = '<a href="' . esc_url( $link ) . '" rel="tag">' . $term->name . '</a>';
	}

	/**
	 * Filters the term links for a given taxonomy.
	 *
	 * The dynamic portion of the hook name, `$taxonomy`, refers
	 * to the taxonomy slug.
	 *
	 * Possible hook names include:
	 *
	 *  - `term_links-category`
	 *  - `term_links-post_tag`
	 *  - `term_links-post_format`
	 *
	 * @since 2.5.0
	 *
	 * @param string[] $links An array of term links.
	 */
	$term_links = apply_filters( "term_links-{$taxonomy}", $links );  // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

	return $before . implode( $sep, $term_links ) . $after;
}

Андрей

Тимур, подскажи пожалуйста, как поменять атрибуты в ссылках функции get_the_term_list.
Я вроде нашел что-то вроде на эту тему, но как прикрутить не знаю:

function get_the_term_list( $id, $taxonomy, $before = '', $sep = '', $after = '' ) {
	$terms = get_the_terms( $id, $taxonomy );

	if ( is_wp_error( $terms ) )
		return $terms;

	if ( empty( $terms ) )
		return false;

	foreach ( $terms as $term ) {
		$link = get_term_link( $term, $taxonomy );
		if ( is_wp_error( $link ) )
			return $link;
		$term_links[] = '<a href="' . esc_url( $link ) . '" rel="tag">' . $term->name . '</a>';
	}

	$term_links = apply_filters( "term_links-$taxonomy", $term_links );

	return $before . join( $sep, $term_links ) . $after;
}

10.4 года назад #

Kama9618
Вы код функции get_the_term_list нашли...

Вам нужно через фильтр "term_links-$taxonomy" отфильтровать вывод. Допустим вы выводите ссылки из таксономии mytax, тогда как-то так:
```
function change_attr_in_list_of_mytax( $term_links ){
	$out = array();
	foreach( $term_links as $link )
		$out[] = str_replace('rel="tag"', 'rel="nofollow"', $link);

	return $out;
}
add_filter('term_links-mytax', 'change_attr_in_list_of_mytax');
```
Где в term_links-mytax, mytax - название вашей таксономии.

Замена происходит тут:
```
str_replace('rel="tag"', 'rel="nofollow"', $link);
```
Этот код вызываете до того как вызвать функцию. Можно его в functions.php скопировать.
1

10.4 года назад #

Smile5

Добрый день, подскажите пожалуйста мне использовал код
echo get_the_term_list( $post->ID, 'brandy-detmir');

Получил примерно такое значение

<a href="person1" rel="nofollow">Эминем</a>, 
<a href="person2" rel="nofollow">Дуэйн Джонсон</a>,

Как можно записать значение Эминем в переменную, без ссылок, и без остальных значении. Мне нужно ток первое значение записать в переменную.

Заранее благодарен

8 лет назад #

Kama9618

Используйте get_the_terms()

$cur_terms = get_the_terms( $post_id = 10, $taxonomy = 'my_tax' );
$first_term = $cur_terms ? array_shift($cur_terms) : false;

mnemonic-3 mnemonic.su

Скажите, я вот на пень наехал, есть таксономия "sort", почему, когда вывожу echo get_the_term_list($post->ID, 'sort'); ?> , не РАБОТАЕТ, а когда меняю имя таксономии на taxonomy echo get_the_term_list($post->ID, 'taxonomy'); то РАБОТАЕТ, может, скажите, что не так

???

1.6 года назад #

get_the_term_list() │ WP 2.5.0

Хуки из функции

Возвращает

Использование

Примеры

#1 Список элементов таксономии

#2 Получим UL список

Список изменений

Код get_the_term_list() get the term list WP 6.5.2

Cвязанные функции

Список (wp_list списки)

term (термины таксономий)

Для записей

Таксономии: рубрики, метки, ...

Код `get_the_term_list() get the term list` ^{WP 6.5.2}