get_search_query()
Отримує пошуковий запит (рядок).
Запит обробляється функцією esc_attr() , щоб його можна було використовувати як атрибут html тега.
Хуки з функції
Повертає
Строку. Пошуковий запит.
Використання
get_search_query($escaped);
-
$escaped
(логічний) -
Очищати результат (true) чи ні (false). Якщо ви використовуєте false, переконайтеся, що перед виведенням рядок був очищений за допомогою
esc_attr() . Не виводьте рядок не очищеним.
Типово: true
Приклади
#1 Виведемо рядок запиту пошуку
Допустимо, користувач шукав слово “wordpress”, тоді цей код на сторінці виведення результатів пошуку виведе це слово:
<?php echo get_search_query(); ?>
#2 Результат змінної
Коли потрібно отримати результат у змінну, використовуємо такий варіант:
$search_query = get_search_query();
#3 Прогалини в рядку пошуку
Функція не видаляє прогалини на кінцях у рядку пошуку. Наприклад:
// у пошуку вказаний рядок з пробілами на кінцях "mail me" get_search_query(); // `mail me`
Видалити прогалини можна так:
$ squery = trim (get_search_query ());
список змін
| З версії 2.3.0 | Введено. |
Код get_search_query() get search query WP 6.0.2
function get_search_query( $escaped = true ) {
/**
* Filters contents of search query variable.
*
* @ Since 2.3.0
*
* @param mixed $search Контенти для search query variable.
*/
$query = apply_filters( 'get_search_query', get_query_var( 's' ) );
if ($escaped) {
$query = esc_attr($query);
}
return $query;
}