set_query_var() WP 2.2.0

Встановлює параметр запиту до глобальної змінної $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

Хуків немає.

Повертає

null. Нічого.

Використання

set_query_var($var, $value);
$var
(рядок) (обов’язковий)
Назву параметра. Ключ.
$value
(змішаний) (обов’язковий)
Значення параметру.

Приклади

0

#1 Встановимо параметр запиту, а потім отримаємо його

// встановимо
set_query_var( 'comments_per_page', 20);

// Отримаємо
$var = get_query_var( 'comments_per_page' );
echo $var; // 20
0

#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() WP 6.0.2

function set_query_var( $var, $value ) {
	global $wp_query;
	$wp_query->set($var, $value);
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *