WordPress как на ладони
wordpress jino

get_the_tag_list() WP 2.3

Получает HTML строку меток текущего поста. Название каждой метки, будет ссылкой на архив постов с этой меткой. Используется в цикле.

В параметрах передаваемых функции можно использовать HTML теги.

Эта функция ничего не выводит на экран, а лишь получает строку, для дальнейшей обработки. Если нужно вывести метки на экран, используйте the_tags().

Используется в: the_tags().
Работает на основе: get_the_term_list()
✈ 1 раз = 0.004159с = очень медленно | 50000 раз = 3.69с = быстро PHP 7.1.2, WP 4.7.3
Хуки из функции:
Возвращает

Строку. Ссылки меток текущей записи, разделенные параметром $sep.

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

get_the_tag_list( $before, $sep, $after );
$before(строка)
Начальный текст. Можно использовать HTML теги.
По умолчанию: ''
$sep(строка)
Разделитель между ссылками.
По умолчанию: ''
$after(строка)
Закрывающий текст. Можно использовать HTML теги.
По умолчанию: ''

Примеры

#1. Выведет метки внутри параграфа, разделенные запятыми:

echo get_the_tag_list('<p>Метки: ',', ','</p>');

В результате получим что-то подобное:

<p>Tags: 
<a href="tag1">Метка 1</a>,
<a href="tag2">Метка 2</a>,
...
</p>

#2. Проверит есть ли у поста метки и если есть выведет их в UL списке:

if( get_the_tag_list() ){
	echo get_the_tag_list('<ul><li>','</li><li>','</li></ul>');
}

В итоге получи нечто подобное:

<ul>
	<li><a href="tag1">Метка 1</a></li>
	<li><a href="tag2">Метка 2</a></li>
	 ... 
</ul>

Можно добавить CSS классы и стили, если необходимо.

Код get the tag list: wp-includes/category-template.php VER 4.9.1

<?php
function get_the_tag_list( $before = '', $sep = '', $after = '', $id = 0 ) {

	/**
	 * Filters the tags list for a given post.
	 *
	 * @since 2.3.0
	 *
	 * @param string $tag_list List of tags.
	 * @param string $before   String to use before tags.
	 * @param string $sep      String to use between the tags.
	 * @param string $after    String to use after tags.
	 * @param int    $id       Post ID.
	 */
	return apply_filters( 'the_tags', get_the_term_list( $id, 'post_tag', $before, $sep, $after ), $before, $sep, $after, $id );
}

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

Из метки: loop (Цикл WP)

Еще из раздела: Для записей

get_the_tag_list Комментариев нет

Здравствуйте, !

Ваш комментарий