Функция GET_QUERY_VAR() в WordPress: примеры использования, параметры и изменения

# Функция GET_QUERY_VAR() в WordPress

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

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

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

## Использование

Чтобы использовать функцию, пишите в следующем формате:

```php
get_query_var( $query_var, $default_value );

Параметры:

• $query_var (строка) (обязательный): ключ переменной, значение которой нужно получить.
• $default_value (смешанный): значение, которое вернется, если переменная запроса не установлена. По умолчанию – пустая строка.

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

Пример 1: Получение текущего номера страницы пагинации

$paged = get_query_var('paged') ? get_query_var('paged') : 1;
echo 'Вы на странице: '. $paged;

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

Пример 2: Текущий номер страницы на главной странице

$paged = get_query_var('page') ?: 1;
echo "Вы на странице: ". $paged ." на главной странице блога, отмеченной как статическая.";

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

Пример 3: Поиск по запросу

$search_query = get_query_var('s');
echo "Ничего не найдено по запросу '$search_query'";

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

Пример 4: Поиск запросов по словам

$search_terms = get_query_var('search_terms');
print_r($search_terms);

Если запрос был "красивые картинки", то результат будет:

Array(
    [0] => красивый
    [1] => картинки
)

Примечания

• Глобальная переменная: WP_Query. Используется объект $wp_query. Это поможет получить данные о текущем запросе WordPress.

Изменения

• С версии 1.5.0: функция была введена.
• С версии 3.9.0: добавлен параметр $default_value.

Код функции

Функция get_query_var проста и выглядит следующим образом:

function get_query_var( $query_var, $default_value = '' ) {
    global $wp_query;
    return $wp_query->get( $query_var, $default_value );
}

Связанные функции

Вот некоторые функции, которые могут быть полезны в работе с запросами:

• esc_sql()
• get_boundary_post()
• get_children()
• get_page_by_title()
• get_pages()
• get_posts()
• get_queried_object()
• have_posts()
• query_posts()
• wp_get_recent_posts()
• WP_Query()

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