Функция THE_TAGS() │ WP 2.3.0

Функция the_tags() используется для получения ссылок на теги записи в WordPress. Эта функция должна быть вызвана внутри цикла WordPress.

Как изменить вывод функции

Чтобы изменить, как выглядит результат работы этой функции, можно использовать следующие хуки:

• the_tags
• term_links-post_tag

Для работы функции используется: get_the_tag_list()

Время выполнения

• 1 вызов — 0.005842 сек (медленно)
• 50,000 вызовов — 5.53 сек (быстро)

Возврат

Функция возвращает null и выводит HTML-код на экран.

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

Параметры функции

• $before (string) — строка, которая будет отображаться перед тегами. По умолчанию: Tags:
• $separator (string) — строка, которая будет использоваться между тегами. По умолчанию: ', '
• $after (string) — строка, которая будет отображаться после тегов. По умолчанию: ''

Примеры

Пример 1: Ссылки на теги записи

Выводим ссылки на теги, разделенные запятыми. По умолчанию перед ссылками будет текст "Tags:":

Вывод:
Tags: WordPress, Компьютеры, Блогинг

Пример 2: Изменение начального текста и разделителя между тегами

 '); ?>

Вывод:
Связанные темы: WordPress > Компьютеры > Блогинг

Пример 3: Отображение тегов в списке <ul>

','
','
'); ?>

Вывод:

• WordPress
• Компьютеры
• Блогинг

Код функции

function the_tags( $before = null, $sep = ', ', $after = '' ) {
    if ( null === $before ) {
        $before = __( 'Tags: ' );
    }

    $the_tags = get_the_tag_list( $before, $sep, $after );

    if ( ! is_wp_error( $the_tags ) ) {
        echo $the_tags;
    }
}

Связанные функции

• get_the_author()
• get_the_author_link()
• get_the_content()
• get_the_excerpt()
• get_the_ID()
• get_the_tag_list()
• get_the_tags()
• setup_postdata()
• the_author()
• the_content()
• the_date()
• the_excerpt()
• the_ID()
• the_permalink()
• the_post()
• the_time()

Заключение

Функция the_tags() полезна для вывода тегов ваших постов, позволяя пользователям легко перейти к связанным записям. Вы можете настроить, как именно будут отображаться теги, добавляя свои текстовые символы и разделители.