Что такое «Цикл WordPress»

Когда посетитель открывает рубрику, поиск или отдельную статью, WordPress ещё до загрузки шаблона выполняет основной запрос и знает, какие записи нужно показать. Шаблону остаётся пройти по ним. Это и делает Цикл (The Loop): на каждой итерации функция the_post() делает следующую запись «текущей», после чего теги шаблона выводят её данные. Один и тот же код Цикла подходит и для списка из десяти записей, и для страницы одной статьи.

Пример классического Цикла

<?php if ( have_posts() ) : ?>
    <?php while ( have_posts() ) : the_post(); ?>
        <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
        <?php the_excerpt(); ?>
    <?php endwhile; ?>
    <?php the_posts_pagination(); ?>
<?php else : ?>
    <p>Ничего не найдено.</p>
<?php endif; ?>

Ветка else отвечает за пустой результат — например, поиск без совпадений.

Основной и дополнительный запросы

Цикл выше работает с основным запросом страницы. Если на ней нужен ещё один список, скажем «Похожие статьи» под текстом, создают отдельный объект WP_Query и проходят его своим циклом: $q->have_posts() и $q->the_post(). После такого цикла обязательно вызывают wp_reset_postdata(), иначе остальная часть шаблона продолжит показывать данные последней записи из дополнительного списка.

Типичные ошибки

  • query_posts() для изменения выборки. Функция подменяет основной запрос и ломает пагинацию и условные теги. Правильный способ изменить основной запрос — хук pre_get_posts, например чтобы показывать в рубрике 24 записи вместо 10.
  • Тяжёлые запросы внутри Цикла. Вызов get_posts() для каждой записи списка превращает одну страницу в десятки запросов к базе.
  • Вывод данных записи до Цикла. Теги без аргументов до вызова the_post() могут взять не ту запись.

В блочных темах Цикл в шаблонах явно не пишут: его роль выполняет блок запроса с вложенным шаблоном записи, но на сервере он строится на том же механизме.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «WordPress» ↗