Использование функции is_search() в WordPress: руководство для разработчиков

# IS_SEARCH() │ WP 1.5.0

Функция is_search() используется, когда на экране отображаются результаты поиска. Это так называемый *условный тег*.

Для получения дополнительной информации о данной функции и подобных ей, смотрите раздел об *Условных тегах* в [Справочнике для разработчиков тем](https://developer.wordpress.org/themes/basics/conditional-tags/).

### Использование
Функция WP_Query::is_search() позволяет определить, выполняется ли запрос на поиск.

**Возвращаемое значение:**
- true или false: указывает, является ли запрос поисковым.

### Пример использования
```php

Примеры

Встраивание поиска Google на странице результатов поиска

Пример того, как можно встроить поиск Google на странице результатов поиска WordPress:

if ( is_search() ) {
    // Здесь вы можете вставить код поиска от Google
}

Примечания

• Глобальная переменная: $wp_query — это объект запроса WordPress.

История изменений

• С версии 1.5.0: функция была добавлена.

Код функции

Функция is_search() реализована в файле wp-includes/query.php следующим образом:

function is_search() {
    global $wp_query;

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

    return $wp_query->is_search();
}

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

В WordPress есть много других условных тегов, например:

• is_404() — проверяет, является ли страница ошибкой 404
• is_admin() — определяет, выводится ли админская панель
• is_home() — указывает, отображается ли главная страница блога

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

Заключение

Функция is_search() — это полезный инструмент в WordPress, который позволяет разработчикам проверять, находится ли пользователь на странице результатов поиска. Используя эту функцию, можно улучшить взаимодействие с пользователем и предоставить более точный контент.