set_query_var()
Встановлює параметр запиту до глобальної змінної $wp_query .
Встановлюється змінна, що у властивості об’єкта $wp_query->query_vars
. Ці параметри можна отримати за допомогою get_query_var() або так:
global $wp_query; $wp_query->query_vars[ $query_var ]
1 раз – 0.000015 сек
(дуже швидко) | 50000 разів – 0.01 сек
(швидкість світла) |
PHP 7.0.2, WP 4.4.1
(дуже швидко) | 50000 разів – 0.01 сек
(швидкість світла) |
PHP 7.0.2, WP 4.4.1
Хуків немає.
Повертає
null
. Нічого.
Використання
set_query_var($var, $value);
-
$var
(рядок) (обов’язковий) - Назву параметра. Ключ.
-
$value
(змішаний) (обов’язковий) - Значення параметру.
Приклади
#1 Встановимо параметр запиту, а потім отримаємо його
// встановимо set_query_var( 'comments_per_page', 20); // Отримаємо $var = get_query_var( 'comments_per_page' ); echo $var; // 20
#2 Передача змінної у файл шаблону
Використовувати установку параметра можна наприклад передачі даних у файл шаблону під час виклику його за допомогою функції get_template_part() .
// When calling a template with get_template_part() set_query_var( 'my_form_id', 23); get_template_part( 'my-form-template');
Тепер у коді файлу шаблону дані можна отримати так:
// Inside my-form-template.php $my_form_id = get_query_var('my_form_id');
З версії WP 5.5 передавати дані файл шаблону можна через третій параметр функції get_template_part() .
нотатки
- Global. WP_Query. $wp_query WordPress Query object.
список змін
З версії 2.2.0 | Введено. |
Код set_query_var() set query var WP 6.0.2
function set_query_var( $var, $value ) { global $wp_query; $wp_query->set($var, $value); }