Функция get_query_var() в WordPress: Получение переменной запроса

Функция get_query_var() в WordPress используется для получения значения конкретной переменной из запроса. Это полезно, когда нужно работать с пользовательскими параметрами запросов или проверять стандартные переменные WordPress.

Описание функции

Функция get_query_var() возвращает значение указанной переменной из текущего запроса.

get_query_var( $var, $default = '' )

Параметры

• $var (строка, обязательный): Имя переменной запроса, значение которой нужно получить.
• $default (разное, необязательный): Значение по умолчанию, если переменная не найдена. По умолчанию это пустая строка.

Возвращаемое значение

• (разное): Значение указанной переменной запроса или значение по умолчанию, если переменная не найдена.

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

Пример 1. Получение стандартной переменной запроса

Этот пример показывает, как получить номер текущей страницы. Если переменная paged не установлена, используется значение 1.

$page_number = (get_query_var('paged')) ? get_query_var('paged') : 1;
echo 'Текущая страница: ' . $page_number;

Пример 2: Получение ID и ярлыка текущей рубрики

Этот пример работает только на страницах категорий. Он показывает, как получить ID и ярлык текущей рубрики.

// Получение ID рубрики
$cat_ID = get_query_var('cat');
echo 'ID рубрики: ' . $cat_ID;

// Получение ярлыка рубрики
$cat_name = get_query_var('category_name');
echo 'Ярлык рубрики: ' . $cat_name;

Пример 3: Получение ID и ярлыка текущей метки

Этот код работает на страницах архивов меток и показывает, как получить ID и ярлык текущей метки.

// Получение ID метки
$tag_ID = get_query_var('tag_id');
echo 'ID метки: ' . $tag_ID;

// Получение ярлыка метки
$tag_name = get_query_var('tag');
echo 'Ярлык метки: ' . $tag_name;

Пример 4: Получение значений таксономий

Этот пример показывает, как получить название текущей таксономии и ярлык текущего элемента таксономии.

// Название таксономии
$taxonomy_name = get_query_var('taxonomy');
echo 'Название таксономии: ' . $taxonomy_name;

// Ярлык элемента таксономии
$term_name = get_query_var('term');
echo 'Ярлык элемента таксономии: ' . $term_name;

Пример 5: Получение поисковых запросов

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

// Поисковый запрос в виде строки
$search_string = get_query_var('s');
echo 'Поисковый запрос: ' . $search_string;

// Поисковый запрос в виде массива
$search_array = get_query_var('search_terms');
echo 'Поисковый запрос (массив): ';
print_r($search_array);

/*
например поисковой запрос был "функции WordPress", тогда массив будет следующий:
Array
(
    [0] => функции
    [1] => WordPress
)
*/

Заключение по get_query_var

Функция get_query_var() является мощным инструментом для работы с переменными запроса в WordPress. Она позволяет легко получать значения различных параметров запроса, что делает её незаменимой при разработке сложных тем и плагинов.