Функция has_tag() в WordPress: обзор, использование и примеры кода

HAS_TAG() │ WP 2.6.0

Функция has_tag() проверяет, имеются ли у текущего поста какие-либо из заданных тегов. Это условная функция.

Значения, переданные в параметре $tag, будут проверены на наличие у поста. Проверка осуществляется по следующим критериям: ID тегов, их названия или "человеко-читаемые" слуги (slugs). Если вы передали только числа, то функция будет проверять только по ID тегов.

Если параметры не указаны, функция проверит, есть ли у поста хотя бы один тег.

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

  • 1 раз — 0.001853 секунды (очень медленно)
  • 50,000 раз — 96.58 секунд (очень медленно)

Нет хуков.

Возвращаемое значение

true или false. Вернет true, если у текущего поста есть хотя бы один из переданных тегов (или любой тег, если теги не указаны). В противном случае вернется false.

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

has_tag( $tag, $post );
  • $tag (string/int/array) — Название тега, его ID, слуг или массив тегов, по которым нужно выполнить проверку. По умолчанию: ''.
  • $post (int/object) — Пост, который нужно проверить вместо текущего. По умолчанию: null.

Примеры

Пример 1: Проверка наличия тегов у текущего поста

if( has_tag() )
    echo 'У текущего поста есть теги!';

Пример 2: Проверка наличия тега «kino» у поста

if( has_tag( 'kino' ) )
    echo 'У текущего поста есть тег kino';

Пример 3: Проверка наличия тегов с ID 45 и 89 у поста с ID 56

if( has_tag( [45, 89], 56 ) )
    echo 'У поста с ID 56 есть теги с ID 45 и 89';

Изменения

С момента версии 2.6.0 функция была представлена.

  • С версии 2.7.0: Теги, переданные как целые числа, проверяются только по ID тегов.
  • С версии 2.7.0: Функцию можно использовать вне цикла WordPress, если указан параметр $post.

Код функции HAS_TAG()

function has_tag( $tag = '', $post = null ) {
    return has_term( $tag, 'post_tag', $post );
}

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

Условные теги

  • cat_is_ancestor_of()
  • category_exists()
  • comments_open()
  • email_exists()
  • has_block()
  • has_category()
  • has_custom_header()
  • has_excerpt()
  • has_nav_menu()
  • has_post_thumbnail()
  • has_shortcode()
  • has_term()
  • have_comments()
  • have_posts()
  • in_category()
  • is_404()
  • is_active_sidebar()
  • is_admin()
  • is_category()
  • is_single()
  • is_tag()
  • и другие...

Для постов

  • get_the_tags()
  • get_the_category()
  • wp_get_post_tags()
  • wp_set_post_tags()
  • и другие...

Эта информация поможет вам лучше разобраться With toim частью функциональности WordPress. Если вам нужно что-то еще, не стесняйтесь спрашивать!

Leave a Reply

Ваш адрес email не будет опубликован. Обязательные поля помечены *