the_search_query() – выводит текущий поисковой запрос

  2.1.0     wp-includes / general-template.php  /  Кодекс WordPress

Кстати, про то, как создать поиск на сайте WordPress, у меня есть отдельный видеоурок.

the_search_query()

У функции нет никаких параметров.

Кроме того, она очень похожа на функцию get_search_query(), за небольшим исключением:

  • Выводит, а не возвращает поисковой запрос (спасибо, кэп).
  • Перед выводом применяем фильтр-хук the_search_query (подробнее ниже).
  • Всегда очищает результат перед выводом функцией esc_attr().

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

Тут явно ничего сверхсложного:

<p>Результаты поиска по запросу &raquo;<?php the_search_query() ?>&laquo;</p>

Хук the_search_query

Для наглядности, так хук выглядит в исходном коде функции:

...
 
	echo esc_attr( apply_filters( 'the_search_query', get_search_query( false ) ) );
}
Кодекс WordPress: Цикл: get_children(), get_delete_post_link(), get_edit_post_link(), get_extended(), get_next_posts_link(), get_permalink(), get_post_type(), get_posts(), get_previous_posts_link(), get_queried_object_id(), get_query_var(), get_search_query(), get_the_author(), get_the_content(), get_the_date(), get_the_excerpt(), get_the_ID(), get_the_time(), get_the_title(), has_excerpt(), has_post_thumbnail(), have_posts(), next_posts_link(), paginate_links(), post_class(), previous_posts_link(), query_posts(), setup_postdata(), the_author(), the_content(), the_date(), the_excerpt(), the_ID(), the_permalink(), the_post(), the_search_query(), the_time(), the_title(), the_title_attribute(), wp(), WP_Query, wp_reset_postdata(), wp_reset_query()

Миша

Недавно я осознал, что моя миссия – способствовать распространению WordPress. Ведь WordPress – это лучший движок для разработки сайтов – как для тех, кто готов использовать заложенную структуру этой CMS, так и для тех, кто предпочитает headless решения.

Сам же я впервые познакомился с WordPress в 2009 году. Организатор WordCamp. Преподаватель в школах Epic Skills и LoftSchool.

Если вам нужна помощь с вашим сайтом или может даже разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда сделаем вам всё на лучшем уровне.