get_query_var()
Отримує змінні запити (настройки запиту) з WP_Query , який встановлюється в глобальну змінну $wp_query .
Щоб встановити змінну запит, використовуйте set_query_var()
WP_Query::get()
(дуже швидко) | 50000 разів – 0.06 сек
(швидкість світла)
Хуків немає.
Повертає
Разное. Різні значення змінних.
Використання
$ var = get_query_var ($ var, $ default);
-
$var
(рядок) (обов’язковий) - Ключ змінної, яку потрібно отримати.
-
$default
(рядок) (WP 3.9) -
Значення, яке потрібно повернути, якщо запитуваний параметр не встановлено.
За замовчуванням: ”
Приклади
#1 Отримаємо поточний номер сторінки пагінації:
$paged = get_query_var('paged')? get_query_var('paged'): 1;
echo 'Ми знаходимося на сторінці: '. $paged;#2 Поточний номер сторінки пагінації на головній сторінці
Щоб отримати поточний номер пагінації на головній сторінці (вона вказана як статична, використовується шаблон сторінки), потрібно використовувати ключ page:
$paged = get_query_var('page')?: 1;
echo "Ми на сторінці:". $paged ." на головній сторінці блогу, вказаній як статична.#3 Запит пошуку
Отримаємо запит, введений у рядок пошуку, на сторінці результатів пошуку:
$search_query= get_query_var('s');
echo "За запитом '$search_query' нічого не знайдено.";#4 Запит пошуку за словами
Або ми можемо отримати пошуковий запит окремо за словами, записуються вони у змінну search_terms:
$search_terms = get_query_var('search_terms');
print_r($search_terms);Якщо запит був “гарні картинки”, то отримаємо:
Array( [0] => красиві [1] => зображення )
Список всіх ключів у get_query_var(‘ключ’) .
Деякі значення заповнюються на відповідних сторінках. Наприклад, ми не можемо отримати параметри запиту search_termsабо sякщо отримувати їх не на сторінці пошуку – ці параметри на всіх сторінках, крім пошуку будуть порожніми.
cpage — Сторінка коментарів paged - Пагінація s — Запит пошуку search_terms — Слова пошуку array() page - 0 pagename - Наприклад, якщо сторінка називається "Сторінка", то буде - stranica error post_parent attachment attachment_id name - Назва поста static page_id - 0 category_name - Uncategorized tag cat taxonomy tag_id meta_key meta_value author_name preview post_type posts_per_page - 10 comments_per_page - 10 order - DESC second minute hour day - 0 monthnum - 0 year - 0 // та ще subpost subpost_id w - 0 sentence fields menu_order feed m - 0 p - 0 tb ignore_sticky_posts suppress_filters cache_results update_post_term_cache - 1 update_post_meta_cache - 1 nopaging no_found_rows category__in — Array() category__not_in — Array() category__and — Array() post__in - Array() post__not_in - Array() tag__in - Array() tag__not_in — Array() tag__and - Array() tag_slug__in — Array() tag_slug__and — Array()
нотатки
- Global. WP_Query. $wp_query WordPress Query object.
список змін
| З версії 1.5.0 | Введено. |
| З версії 3.9.0 | The $default argument був введений. |
Код get_query_var() get query var WP 6.0.2
function get_query_var( $var, $default = '' ) {
global $wp_query;
return $wp_query->get($var, $default);
}