IS_TAG(): Что это за функция в WordPress и как ее использовать

## IS_TAG() │ WP 2.3.0

### Что такое IS_TAG()?

Функция is_tag() в WordPress используется для проверки, является ли текущая страница архивом существующей метки (тега). Если вы укажете параметр $tag, эта функция также проверит, совпадает ли текущая метка с одной из указанных.

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

Функция возвращает:
- true, если текущая страница — архив тега
- false, если это не так

### Использование функции

```php
is_tag( $tag );

Параметры

  • $tag (int | string | int[] | string[]): ID метки, имя, слаг (URL-формат) или массив таких значений для проверки.
  • По умолчанию: '' (пустая строка)

Примеры использования

Пример 1: Проверка для любой метки

is_tag();
// Возвращает true, если показывается любая страница архива меток.

Пример 2: Проверка по ID метки

is_tag( '30' );
// Возвращает true, если показывается страница с меткой ID 30.

Пример 3: Проверка по слагу метки

is_tag( 'metka' );
// Возвращает true, если показывается страница с меткой 'metka'.

Пример 4: Проверка по имени метки

is_tag( 'Tag' );
// Возвращает true, если показывается страница с именем метки 'Tag'.

Пример 5: Проверка по списку меток

is_tag( [ 30, 'metka', 'Tag' ] );
// Возвращает true, если показывается страница с постами с метками, 
// которые имеют ID 30, слаг 'metka' или имя 'Tag'.

Примечания

  • Глобальная переменная: $wp_query — объект запроса WordPress. Убедитесь, что функция вызывается после инициализации запроса, иначе она всегда будет возвращать false.

Изменения

  • С версии 2.3.0: Функция была впервые введена.

Код функции

Функция is_tag() реализована следующим образом:

function is_tag( $tag = '' ) {
    global $wp_query;

    if ( ! isset( $wp_query ) ) {
        _doing_it_wrong( __FUNCTION__, __( 'Условные теги не работают до выполнения запроса. До этого момента они всегда возвращают false.' ), '3.1.0' );
        return false;
    }

    return $wp_query->is_tag( $tag );
}

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

Существует множество других условных тегов, которые могут быть полезны:

  • is_404()
  • is_admin()
  • is_archive()
  • is_category()
  • is_single()

Эти функции помогут вам проверить различные условия и типы страниц в WordPress, улучшая взаимодействие с вашим сайтом.

Leave a Reply

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