have_posts() WP 1.5

Проверяет есть ли у текущего запроса WP результаты для вывода, т.е. есть ли в наличии посты, которые можно вывести для текущей страницы. Условный тег.

В конце Цикла WordPress, функция автоматически возвращает метку, что запрос снова полный и готов для вывода, т.е. автоматически использует функцию: rewind_posts().

Хуков нет.

Возвращает

true/false. falsе, если результатов для вывода нет и true, если есть что выводить.

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

if( have_posts() ){
	// ...
}

Примеры

#1. Определим есть ли записи для вывода

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

<?php
if ( have_posts() ){
	while ( have_posts() ){
		the_post();
		// код вывода
	}
} else {
	echo wpautop( 'Постов для вывода не найдено.' );
}
?>

#2 Вызов have_posts() внутри Цикла WordPress

Вызов have_posts() внутри Цикла WordPress, означает бесконечный цикл. Смотрите пример:

while( have_posts() ){
	the_post();

	// Вывод поста
	if ( have_posts() ){
		// Если это последний пост, цикл начнется заново
		// Делаем что-нибудь, если это не не последний пост
	}
}

#2.1 Проверка есть ли еще посты в цикле

Если нужно проверить есть ли еще посты в текущем цикле, можно использовать следующую функцию. Функция будет возвращать:

• true - есть еще посты в запросе.
• false - выведен последний пост.

Использовать функцию more_posts() нужно будет вместо have_posts() из примера 2.

function more_posts() {
  global $wp_query;
  return $wp_query->current_post + 1 < $wp_query->post_count;
}

Заметки

• Global. WP_Query. $wp_query WordPress Query object.

Список изменений

Код have posts: wp-includes/query.php ^{WP 5.4.1}

<?php
function have_posts() {
	global $wp_query;
	return $wp_query->have_posts();
}

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

Из метки: query (запрос)

Еще из метки: Условные теги (все)

Еще из раздела: Запросы

Еще из тегов шаблона: Записи: посты, страницы, ...