Оригинал этой страницы на английском . Этот перевод мой. Ссылки отображённые красным текстом, неактивны
Описание
Генерирует строку HTML дескрипторов (тэгов) связанных с текущей записью. Имя каждой метки будет связанна с соответствующей 'меткой' страницы. Вы можете вызывать функцию со строкой до и после всех меток, и между метками. Эта функция используется в цикле 'The Loop'.
Применение
<?php $tag_list = get_the_tag_list( $before = 'before', $sep = 'seperator', $after = 'after' ) ?>
Эта функция ничего не отображает - если хотите поместить это на страницу, применяйте
echo (get_the_tag_list())
Альтернативно, вы можете назначить переменную и вызывать в дальнейшем её
$foo = get_the_tag_list()
Все переменные дополнительные, и устанавливаются в порядке до 'before', разделитель 'separator', после 'after'. Вы можете использовать дескрипторы HTML в каждом из полей.
Пример
Основной пример
Вывод списка меток внутри параграфа, с разделителем запятой, между метками.
<?php echo get_the_tag_list('<p>Tags: ',', ','</p>'); ?>
Это будет выглядеть так.
<p> Метки: <a href="tag1" mce_href="tag1">Tag 1</a>, <a href="tag2" mce_href="tag2">Tag 2</a>, ... </p>
Более сложный пример
Прверяет есть ли в записи любые метки, и если есть, выводит их в стандартный неупорядоченный список.
<?php if(get_the_tag_list()) { get_the_tag_list('<ul><li>','</li><li>','</li></ul>'); } ?>
Это выглядит в такой форме:
<ul> <li><a href="tag1" mce_href="tag1">Tag 1</a></li> <li><a href="tag2" mce_href="tag2">Tag 2</a></li> ... </ul>
Вы можете добавить классы и стили с CSS, по мере необходимости.
Параметры
- до $before
- (строковой) (дополнительный) Предваряющий текст
- По умолчанию: 'Метки: '
- разделитель $sep
- (строковой) (дополнительный) Строка разделения текста
- Default: ', '
- после $after
- (строковой) (дополнительный) Завершающий текст
- По умолчанию: отсутствует