Что такое цикл the loop в WordPress

Начал отвечать на один из комментариев о цикле loop в WordPress и решил, что это тема выходит за рамки ответа на комментарий. Этот пост может стать полезен новечкам и тем кто еще плохо понимает как работает Цикл вывода записей в WordPress.

Что такое цикл the loop в WordPress?

Начну с того, что говорить, - "цикл loop" — это неправильно. Это тоже самое, что сказать, - "цикл цикл", т.е. loop = цикл — повторяющееся действие. Правильно говорить просто "Цикл WordPress". Далее в тексте "Цикл WordPress" — тоже самое, что "loop", "the loop" и даже "цикл the loop WordPress".

Итак, цикл в WordPress выглядит так:

<?php if (have_posts()) :  while (have_posts()) : the_post(); ?>
       <!-- здесь формирование вывода постов, -->
       <!-- где работают теги шаблона относящиеся к the loop -->
<?php endwhile; ?>
<?php endif; ?>

Однако у цикла WordPress (так называемого the loop) могут быть и другие обличья, например он может выглядеть еще и так:

<?php
global $post;
$myposts = get_posts('numberposts=5&offset=1&category=1');
foreach($myposts as $post){
setup_postdata($post);
?>
       <!-- здесь формирование вывода постов, -->
       <!-- где работают теги шаблона относящиеся к the loop -->
<?php } ?>

Если давать какое-то общее определение циклу в WordPress, то я бы сказал так: the loop - это цикл который перебирает массив содержащий в себе информацию о постах и во время перебора выводит информацию о каждом посте, при этом в цикле используются специальные для него теги шаблона (функции).

Вся информация о посте хранится в переменной $post. Предположим, что цикл обрабатывает массив содержащий в себе данные 10-ти постов, тогда у цикла будет 10 повторений и 10-раз будет меняться переменная $post, и при каждом повторении с переменной $post будет считываться информация о посте и выводится на экран, через теги шаблона. Также любой PHP или HTML код помещеный в цикл WordPress будет повторятся пока работает цикл: 10 итераций цикла - 10 повторений.

Типичный пример такого цикла это вывод постов на странице категорий, меток, на главной странице WordPress.

Для чего нужно различать цикл WordPress?

Понимать где используется цикл нужно, потому что в WordPress есть определенные теги шаблона, которые не работают за пределами цикла, например: the_title(), the_content(), the_excerpt() и т.д. Для того, чтобы каждая такая функция (тег шаблона) сработала, должна быть определена переменная $post, которая за пределами цикла WordPress не известна (точнее не корректна, если цикл запускался, то $post известна - она содержит  данные последнего, обработаного в цикле, поста, но это уже другая тема).

Полноценный пример цикла

Приведу пример цикла WordPress (взял из Кодекса), со встроенными в код комментариями (внутри <!-- -->)

<!-- Начало цикла. -->
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<!-- Здесь уже определилась переменная $post, -->
<!-- на основе которой будет строится дальнейший код. -->
<!-- $post будет меняться для каждого поста while( have_posts() ). -->
<!-- $post нужна, чтобы работали теги шаблона: in_category('3'), the_permalink() и т.д. -->

<!-- Проверка находится ли этот пост в категории 3. -->
<!-- Если да, то задаем CSS класс div-у class="post-cat-three". -->
<!-- Если нет, то класс будет post class="post". -->
<?php if ( in_category('3') ) { ?>
          <div class="post-cat-three">
<?php } else { ?>
          <div class="post">
<?php } ?>

<!-- Выводим заголовок поста, как ссылку на сам пост. -->
<h2><a href="<?php the_permalink() ?>" title="Ссылка на: <?php the_title_attribute(); ?>"><?php the_title(); ?></a></h2>

<!-- Выводим дату поста и ссылку на другие записи автора. -->
<small><?php the_time('F jS, Y') ?> Автор: <?php the_author_posts_link() ?></small>

<!-- Выводим текст поста в теге div. -->
<div class="entry">
   <?php the_content(); ?>
</div>

<!-- Выводим категории поста, через запятую. -->
<p class="postmetadata">Расположено в <?php the_category(', '); ?></p>
</div> <!-- закрываем основной тег div -->

<!-- Отсюда цикл начинает повторятся, если есть еще посты -->
<!-- Останавливаем цикл (endwhile), -->
<!-- если цикл не сработал (else), выводим сообщение. -->
<?php endwhile; else: ?>

<p>Нет постов в цикле.</p>

<!-- Полное окончание цикла. -->
<?php endif; ?>

if ( have_posts()