the_post() │ WP 1.5.0

Устанавливает следующий пост в глобальную переменную global $post. Также устанавливает все данные поста с помощью setup_postdata().

В глобальную переменную global $post будет установлен следующий пост из цикла, см WP_Query::next_post(). Если цикл только начался, то туда будет установлен первый пост из цикла.

Далее, на базе установленной глобальной переменной $post, будет установлены все важные данные поста - см. setup_postdata( $post ).

Также, включает свойство WP_Query::in_the_loop = true. Это говорим о том, что цикл запущен - это нужно, чтобы функция in_the_loop() работала правильно.

while ( have_posts() ) {
	the_post();

	the_title();
}

$query = new WP_Query( $args );

while ( $query->have_posts() ) {
	$query->the_post();

	the_title();
}

wp_reset_postdata(); // ВАЖНО вернуть global $post обратно

Хуков нет.

Возвращает

null. Ничего не возвращает.

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

while ( have_posts() ) {
	the_post();

	// ...
}

Примеры

<?php the_post(); have_posts(); ?>

<h1><?php the_title() ?></h1>

<?php the_content(); ?>

while( have_posts() ){
	the_post();

	echo '<h2>';
	the_title();
	echo '</h2>';
	the_content();
}

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