Цикл записей в WordPress

<?php
// проверяем есть ли посты в глобальном запросе - переменная $wp_query
if( have_posts() ){
	// перебираем все имеющиеся посты и выводим их
	while( have_posts() ){
		the_post();
		?>

		<div <?php post_class(); ?> id="post-<?php the_ID(); ?>">
			<h1><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h1>
			<?php the_content(); ?>
		</div>

		<?php
	}
	?>

	<div class="navigation">
		<div class="next-posts"><?php next_posts_link(); ?></div>
		<div class="prev-posts"><?php previous_posts_link(); ?></div>
	</div>

	<?php
}
// постов нет
else {
	echo "<h2>Записей нет.</h2>";
}

«Уже существующие» данные находятся в глобальной переменной $wp_query и для каждого типа страниц WordPress определяются автоматически, т.е. WordPress заранее делает запрос в БД, на основе того какая страница сейчас отображается (категория, метка, статья, постоянная страница и т.д.) и результат запроса записывается в $wp_query, а затем мы используем эти данные для создания цикла. Интересно, что такой запрос делается функцией query_posts(), которую мы разберем ниже.

<?php
global $query_string; // параметры базового запроса

// базовый запрос + свои параметры
query_posts( $query_string .'&cat=-6,-9&order=ASC&posts_per_page=20' );

[СТАНДАРТНЫЙ ЦИКЛ WORDPRESS]

wp_reset_query(); // сброс запроса
?>

Полный список параметров, которыми можно сформировать нужный нам вывод, смотрите в описании функции query_posts().

Но все же, изменять базовый запрос WP рекомендуется через фильтр pre_get_posts, а не через query_posts().

query_posts( 'cat=-6,-9&order=ASC' );

<?php
query_posts( 'p=9' );

if( have_posts() ){
	while( have_posts() ){
		the_post();

		the_title();
		the_content();
	}
}
else {
	echo 'Записей нет';
}

?>

if( is_category() ) echo 'Это страница категории'; // не сработает
if( is_single() )   echo 'Это страница поста';     // сработает

• для исключения рубрики/метки (например, на главной странице).
• изменение направления сортировки.
• ограничения количества выводимых постов
• исключения определенных постов из категории/метки
• и т.п.

• нужно вывести 10 последних постов в сайдбаре.
• нужно вывести 10 случайных записей в подвале.
• нужно вывести все картинки прикрепленные к посту.
• нужно вывести записи с определенным произвольным полем.

• suppress_filters=true (можно изменить)
• posts_per_page=5 (можно изменить)
• ignore_sticky_posts=true (нельзя изменить)
• no_found_rows=true (нельзя изменить)

<?php

$args = [
    'post_type' => 'post',
    // args...
];

$posts = get_posts($args);

foreach ($posts as $post) {
?>
    <div class="post">
        <h2><?php echo $post->post_title; ?></h2>
        <div class="content">
            <p><?php echo $post->post_content; ?></p>
        </div>
    </div>
<?php
}

• Всегда, когда нужно просто вывести записи из БД в любом месте шаблона.
• Когда нужно создать несколько циклов.
• Когда не нужно знать сколько всего записей подходят под выборку.
• Так как get_posts() принимает те же параметры что и query_posts(), её очень удобно использовать для вывода записей по самым разным критериям.

Интересно, что WP_Query является ядром функций query_posts() и get_posts(), т.е. обе эти функции работают на основе этого класса.

<?php

$args = [
    'post_type' => 'post',
    'posts_per_page' => 5,
    // args...
];

$query = new WP_Query($args);

foreach ($query->posts as $post) {
?>
    <div class="post">
        <h2><?php echo $post->post_title; ?></h2>
        <div class="content">
            <p><?php echo $post->post_content; ?></p>
        </div>
    </div>
<?php
}

• Если нужно вывести записи не затрагивая основной цикл (допустим записи в боковой панели).
• Если нужно создать множественные запросы.
• Если нужно сколько всего постов удовлетворяют условиям выборки (для этого в SQL запрос добавляется флаг SQL_CALC_FOUND_ROWS — это создает дополнительную нагрузку на запрос). Так циклы WP_Query() дополнительно нагружают запрос, то чаще нам будет подходить циклы с помощью get_posts().