query_posts() │ WP 1.5.0

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

query_posts() — это способ изменить основной запрос WordPress, который создается для отображения конетнта на странице. Это достигается, заменой основного запроса (делается еще одни запрос и заменяется основной).

Хуков нет.

Возвращает

WP_Post[]|int[]. Глобальный объект WP_Query.

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

Функция query_posts() должна вызываться перед Циклом WordPress, потому что при вызове query_posts() создается новый объект WP_Query, который затем будет использоваться в цикле. При этом WordPress игнорирует параметры, полученные через URL (например, номер страницы или категорию):

<?php
query_posts( $query );

// Цикл WordPress
if( have_posts() ){
	  while( have_posts() ){
		   the_post();
	  }
	  wp_reset_query();
} else {
   // текст, если постов нет
}
?>

$query(array|string) (required)

Массив или строка параметров запроса. Список возможных ключей смотрите в WP_Query.

Эта функция может принимать массу различных параметров, которые можно указывать как в виде массива, так и в виде строки: cat=4&posts_per_page=5.

WP_Query лежит в основе query_posts(), поэтому может получать все теже параметры.

Альтернатива

Для изменения основого запроса настоятельно рекомендуется использовать событие pre_get_posts с проверкой is_main_query().

Пример: вместо

query_posts('posts_per_page=5');

используйте в functions.php:

add_action( 'pre_get_posts', 'five_posts_on_homepage' );
function five_posts_on_homepage( $query ) {
	if ( $query->is_home() && $query->is_main_query() ) {
		$query->set( 'posts_per_page', 5 );
	}
}

Предупреждения

Изменяет основной цикл

query_posts() заменяет основной запрос, влияя на глобальные переменные и теги шаблона, которые могут работать неправильно после query_posts().

Если использовать query_posts() в шаблоне, WordPress уже сделал основной запрос к базе. Использование query_posts() означает повторный SQL-запрос, игнорируя результаты предыдущего. Это может быть неэффективно на больших сайтах.

Вторичные циклы

Для вторичных списков (например, похожие записи внизу страницы или ссылки в сайдбаре) лучше использовать get_posts(). Если всё же используете query_posts(), обязательно вызовите wp_reset_query() после завершения.

Пагинация

Пагинация не будет работать правильно без правильной установки параметра paged.

Дополнительные SQL-запросы

Разработчикам крупных сайтов стоит рассмотреть альтернативы, например, фильтр request для изменения запроса до его выполнения, или фильтры parse_query и pre_get_posts для редактирования объекта $query.

Особенности

Сохраним существующие параметры запроса

После вызова query_posts() WordPress не будет учитывать параметры полученные через УРЛ (например, номер страницы или категории). Если нужно сохранить параметры основного запроса, то можно использовать глобальную переменную $query_string (содержит текущие параметры для query_posts).

Например, давайте изменим порядок сортировки постов, при этом не затрагивая остальные параметры запроса, для этого нужно написать такой код перед Циклом WordPress:

global $query_string;
query_posts( $query_string . '&order=ASC' );

В этом примере "порция" добавочных аргументов должна претворятся знаком амперсанд (&)

Также параметры можно передать в виде массива. Для этого смержим базовые параметры и наши састомные:

global $wp_query;
$custom_params = [
	'post_type' => 'product'
];
$args = array_merge( $wp_query->query_vars, $custom_params );
query_posts( $args );

Комбинирование параметров

#1. Комбинирование в строке

Вы наверняка заметили, что параметры соединяются между собой символом амперсанд - &, именно этим символом параметры комбинируются (объединяются).

query_posts( 'cat=3&year=2004' );

Получим посты из категории 1, имеющие метку apples:

query_posts( 'cat=1&tag=apples' );

#2. Комбинирование с переменными

Посты из категории 13 за текущий месяц на главной странице блога:

if ( is_home() ) {
	query_posts( $query_string . '&cat=13&monthnum=' . date( 'n', current_time('timestamp') ) );
}

#3. Комбинирование массивом

Вернет только 2 поста, из категории 1 и 3, отсортированные в обратном порядке по заголовку:

query_posts( [
   'category__and'  => [ 1, 3 ],
   'posts_per_page' => 2,
   'orderby'        => 'title',
   'order'          => 'DESC',
] );

Примеры

query_posts( [
	'cat'      => 22,
	'year'     => $current_year,
	'monthnum' => $current_month,
	'order'    => 'ASC',
] );

<?php
$category_var = $cat; // задаем переменной $category_var ID текущей категории
$query = 'cat=' . $category_var . '&orderby=date&order=ASC'; // собираем запрос
query_posts( $query ); // запускаем запрос к БД
?>

<?php
$current_month = date('m');
$current_year = date('Y');

query_posts("cat=22&year=$current_year&monthnum=$current_month&order=ASC");
?>
<!-- здесь идет Цикл WordPress -->

<?php
global $wp_query;
$wp_query = new WP_Query( $query_string . '&posts_per_page=-1');
while( have_posts() ){
	the_post();
	// здесь идет Цикл WordPress
}

wp_reset_query(); // сброс глобальной $wp_query
?>

global $wp_query;

query_posts( array_merge(
	[ 'cat' => 1 ], // это параметр который добавили мы
	$wp_query->query   // это массив базового запроса текущей страницы
) );

if ( is_home() ) {
	query_posts( 'cat=-3' );
}

if ( is_home() ) {
	query_posts( "cat=-1,-2,-3" );
}

<?php

// retrieve one post with an ID of 5
query_posts('p=5');

global $more;

// set $more to 0 in order to only get the first part of the post
$more = 0;

// the Loop
while ( have_posts() ) {
	the_post();

	// the content of the post
	the_content( 'Read the full post »' );
}
?>

<?php
query_posts( 'p=5' );
?>

<?php
query_posts( 'page_id=7' );
?>

<?php
query_posts( 'pagename=o-saite' );
?>

<?php
query_posts( 'pagename=o-saite/avtori' ); 
?>

Добавить свой пример

—