WordPress как на ладони
rgbcode is looking for WordPress developers.

get_the_tag_list()WP 2.3.0

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

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

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

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

Возвращает

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

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

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

Примеры

0

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

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

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

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

#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 классы и стили, если необходимо.

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

С версии 2.3.0 Введена.

Код get_the_tag_list() WP 6.4.3

function get_the_tag_list( $before = '', $sep = '', $after = '', $post_id = 0 ) {
	$tag_list = get_the_term_list( $post_id, 'post_tag', $before, $sep, $after );

	/**
	 * 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 the tags.
	 * @param string $sep      String to use between the tags.
	 * @param string $after    String to use after the tags.
	 * @param int    $post_id  Post ID.
	 */
	return apply_filters( 'the_tags', $tag_list, $before, $sep, $after, $post_id );
}
1 комментарий
    Войти