Функция get_the_tag_list() используется для получения списка меток записи в формате HTML. Она возвращает строку с тегами, которые могут быть окружены дополнительным HTML-кодом до и после, а также разделены произвольным разделителем. Это удобный способ выводить метки записи в ваших темах или плагинах WordPress.
get_the_tag_list( string $before = '', string $sep = '', string $after = '', int $post_id = false ): string|false|WP_Error
Описание параметров
- $before (необязательный)
Строка, которая будет добавлена перед списком меток. Можно использовать HTML теги.
По умолчанию: пустая строка. - $sep (необязательный)
Разделитель между метками. Можно указать любой символ, например запятую, пробел или HTML-тег.
По умолчанию: пустая строка. - $after (необязательный)
Строка, которая будет добавлена после списка меток. Также можно использовать HTML теги.
По умолчанию: пустая строка. - $post_id (необязательный)
ID поста, для которого нужно получить метки. Если не указано, используется текущий пост в цикле WordPress.
По умолчанию: текущий пост.
Возвращаемое значение
Возвращает строку с HTML-кодом, содержащим метки записи, или false, если меток нет. Если произошла ошибка, функция вернет объект WP_Error.
Пример 1: Вывод меток поста в параграфе с разделением запятыми
Этот пример выводит метки записи внутри тега <p>, разделяя их запятыми:
echo get_the_tag_list('<p>Метки: ', ', ', '</p>');
Результат:
<p>Метки:
<a href="/tag/wordpress">WordPress</a>,
<a href="/tag/programming">Программирование</a>,
<a href="/tag/blogging">Блогинг</a>
</p>
Пример 2: Проверка наличия меток и вывод их в списке <ul>
Этот пример проверяет, есть ли метки у записи, и если они есть, выводит их в ненумерованном списке <ul>:
if ( get_the_tag_list() ) {
echo get_the_tag_list('<ul><li>', '</li><li>', '</li></ul>');
}
Результат:
<ul>
<li><a href="/tag/wordpress">WordPress</a></li>
<li><a href="/tag/programming">Программирование</a></li>
<li><a href="/tag/blogging">Блогинг</a></li>
</ul>
Заключение
Функция get_the_tag_list() предоставляет удобный способ получения и форматирования списка меток для записи. Вы можете легко кастомизировать вывод меток с помощью HTML тегов и стилей, а также разделять их произвольными символами. Это делает её полезным инструментом для создания гибких шаблонов WordPress.