Home

🔷 Блок: Query Loop / Цикл запросов

📌 Что это

Query Loop — это продвинутый блок Gutenberg для автоматического вывода записей, страниц или других типов контента по заданным условиям.

Например, он может показать:

последние записи блога;
записи из конкретной категории;
записи с определённым тегом;
страницы;
портфолио;
карточки товаров, если это поддерживает плагин;
подборку материалов по фильтру.

Простыми словами:

Query Loop = умный блок для вывода списка контента.

Он похож на Latest Posts, но намного гибче. WordPress описывает Query Loop как advanced block, который показывает posts по заданным параметрам, примерно как PHP loop, но без кода.

⚙️ Функции

Блок позволяет:

выводить записи автоматически;
выбирать шаблон отображения;
начать с готового pattern / паттерна;
начать с пустого шаблона;
показывать записи списком;
показывать записи сеткой;
настраивать количество записей на странице;
настраивать offset / пропуск первых записей;
выбирать post type / тип контента;
сортировать записи по дате, алфавиту или порядку;
фильтровать записи по категориям;
фильтровать записи по тегам;
фильтровать записи по автору;
фильтровать по ключевым словам;
работать с pagination / пагинацией;
добавлять блок No Results, если ничего не найдено;
добавлять внутрь Post Title, Post Excerpt, Featured Image, Post Date, Post Author и другие блоки;
настраивать внешний вид карточки записи;
использовать wide width / full width, если тема поддерживает.

🎯 Зачем нужен

Чтобы создавать не просто ручной список, а автоматическую ленту материалов.

Например, для WP Guide можно сделать страницу:

Gutenberg Blocks

И вывести там только записи из категории:

Gutenberg

Или сделать секцию на главной:

Последние материалы по WordPress

где новые записи будут появляться автоматически.

📍 Где используется чаще всего

страница блога;
страница новостей;
главная страница;
страница категории;
архивы;
портфолио;
каталог;
база знаний;
справочник;
обучающий сайт;
шаблоны в Site Editor.

⚠️ Важно

Query Loop — один из самых мощных, но и самых сложных блоков.

Он состоит не из одного элемента, а из вложенной структуры.

Пример:

Query Loop
 ├─ Post Template
 │   ├─ Featured Image
 │   ├─ Post Title
 │   ├─ Post Excerpt
 │   └─ Post Date
 │
 ├─ Pagination
 │   ├─ Previous Page
 │   ├─ Page Numbers
 │   └─ Next Page
 │
 └─ No Results

То есть ты настраиваешь не только сам запрос, но и то, как каждая запись будет выглядеть.

⚠️ Query Loop или Latest Posts

Они похожи, но уровень разный.

Latest Posts — простой блок: быстро показать последние записи.

Последние 3–5 записей

Query Loop — продвинутый блок: можно настроить, какие записи показывать и как именно они выглядят.

Записи из категории Gutenberg
Показать 6 штук
Сетка 3 колонки
Картинка + заголовок + отрывок + дата

Простыми словами:

Latest Posts = быстро и просто
Query Loop = гибко и профессионально

⚠️ Inherit query from template

В Query Loop есть важная настройка:

Inherit query from template

Смысл такой:

если включено — блок берёт условия из текущего шаблона;
если выключено — ты сам настраиваешь, какие записи показывать.

Например, на странице категории шаблон уже “знает”, что нужно показывать записи этой категории. Тогда можно использовать inherit query.

А если ты сам создаёшь секцию на главной странице и хочешь вывести только записи из категории “News” — inherit query лучше выключить и настроить фильтры вручную.

⚠️ Post Template

Очень важная часть Query Loop — это Post Template.

Это шаблон одной карточки записи.

Например:

Post Template
 ├─ Featured Image
 ├─ Post Title
 ├─ Post Excerpt
 └─ Read More

Если ты меняешь Post Template, меняется внешний вид всех записей внутри Query Loop.

То есть ты не оформляешь каждую карточку отдельно.
Ты оформляешь один шаблон, а WordPress повторяет его для всех найденных записей.

⚠️ Pagination

Если записей много, можно добавить пагинацию:

← Previous   1  2  3   Next →

Это нужно, когда Query Loop показывает не все записи сразу, а, например, по 6 или 9 штук на странице.

⚠️ No Results

Если по выбранным условиям ничего не найдено, можно показать сообщение:

Материалы не найдены.

Это лучше, чем пустое место на странице.

⚠️ Query Loop в Site Editor

Query Loop часто используется в шаблонах сайта:

Blog template
Archive template
Category template
Search results template

Если ты редактируешь Query Loop в шаблоне, изменения могут повлиять не на одну страницу, а на весь тип страниц.

Например, если изменить Query Loop в шаблоне архива, это может изменить отображение всех архивов.

⚠️ Тема может влиять

Тема может влиять на:

доступные patterns;
стили карточек;
ширину блока;
отступы;
сетки;
типографику;
цвета;
поведение Query Loop в шаблонах;
доступность wide/full width.

Если Query Loop выглядит не так, как ожидалось, часто причина в теме или в выбранном шаблоне.

🧠 Простыми словами

Query Loop — это продвинутый блок для автоматического вывода записей по правилам.

Если нужно просто показать последние записи — используй Latest Posts.

Если нужно сделать полноценную страницу блога, каталог, архив, базу знаний или красивую сетку материалов — используй Query Loop.