query_posts() — описание функции WordPress на русском

Сигнатура

query_posts( array|string $query ): WP_Post[]|int[]

Описание

Примечание: полностью переопределяет основной запрос и не предназначена для использования в плагинах или темах. Её чрезмерно упрощённый подход к изменению основного запроса может привести к проблемам, и его следует избегать везде, где это возможно. В большинстве случаев есть более удачные и производительные способы изменить основной запрос — например, через действие ‘pre_get_posts’ внутри WP_Query.
Нельзя использовать внутри Цикла WordPress.

Оригинал (английский)

Note: This function will completely override the main query and isn’t intended for use by plugins or themes. Its overly-simplistic approach to modifying the main query can be problematic and should be avoided wherever possible. In most cases, there are better, more performant options for modifying the main query such as via the ‘pre_get_posts’ action within WP_Query.

This must not be used within the WordPress Loop.

Параметры

$query array|string обязательный

Массив или строка аргументов WP_Query.

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

WP_Post[]|int[]

Исходный код

wp-includes/query.php:97

function query_posts( $query ) {
	$GLOBALS['wp_query'] = new WP_Query();
	return $GLOBALS['wp_query']->query( $query );
}

История изменений

Версия	Описание
1.5.0	Introduced.