get_the_tag_list()
Получает 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 теги.
По умолчанию: ''
Примеры
#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 классы и стили, если необходимо.
Список изменений
С версии 2.3.0 | Введена. |
Код get_the_tag_list() 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 ); }