get_the_tag_list()
Отримує HTML рядок позначок поточного посту. Назва кожної мітки буде посиланням на архів постів з цією міткою. Використовується у циклі.
У параметрах функції, що передаються, можна використовувати HTML теги.
Ця функція нічого не виводить на екран, а лише отримує рядок для подальшої обробки. Якщо потрібно вивести мітки на екран, використовуйте the_tags() .
Працює на основі:
get_the_term_list()
get_the_term_list()
Основа для:
the_tags()
the_tags()
1 раз – 0.004159 сек
(дуже повільно) | 50000 разів – 3.69 сек
(швидко) |
PHP 7.1.2, WP 4.7.3
(дуже повільно) | 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.0.2
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 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 для використання між tags.
* @param string $after String для використання після Tags.
* @param int $post_id Post ID.
*/
return apply_filters( 'the_tags', $tag_list, $before, $sep, $after, $post_id );
}