Описание функции the_search_query()
Функция the_search_query() возвращает текущий поисковый запрос, введенный пользователем. Эта функция полезна для отображения поисковых запросов на страницах результатов поиска, чтобы пользователи могли видеть, что они искали.
Функция используется в шаблонах WordPress, обычно на страницах поиска или в виджетах, где необходимо показать поисковый запрос.
Возвращаемое значение
Тип: string
Описание: Возвращает текущий поисковый запрос пользователя
Возможные значения:
• Строка с поисковым запросом
• Пустая строка, если запрос не был выполнен
Примеры использования
Базовый пример отображения поискового запроса
echo 'Вы искали: ' . the_search_query();
// Выводит: Вы искали: ваш_поисковый_запрос
Замените ваш_поисковый_запрос на фактический запрос
Пример с условием, чтобы избежать вывода пустого запроса
$search_query = the_search_query();
if ( ! empty( $search_query ) ) {
echo 'Вы искали: ' . esc_html( $search_query );
}
// Проверка на наличие поискового запроса
esc_html() используется для безопасного вывода
Безопасность
Валидация входных данных: Функция не принимает параметры, поэтому проверка входных данных не требуется
Санитизация: Рекомендуется использовать esc_html() перед выводом
Рекомендации: Используйте esc_html() для предотвращения XSS-уязвимостей
— Связанные функции
Получает текущий поисковый запрос без вывода
Проверяет, находитесь ли вы на странице результатов поиска
— Примечания
– Ограничения
Функция работает только на страницах с выполненным поиском
– Частые проблемы
- Пустая строка, если не выполнен поиск
- Не отображает запрос, если используется кэширование плагинов
