0267 WP Terms Query

🔷 Блок: Terms Query / Запрос терминов

📌 Что это

Terms Query — это блок Gutenberg для автоматического вывода списка или сетки терминов таксономии.

Проще говоря, он может показать:

категории;
теги;
пользовательские таксономии, если они есть на сайте.

Например:

Gutenberg
Media Blocks
Design Blocks
Widgets
CSS
Hosting

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

Terms Query = Query Loop, но не для записей, а для категорий, тегов и других терминов.

Если Query Loop выводит записи, то Terms Query выводит группы записей: категории, теги или другие таксономии. WordPress описывает Terms Query как блок для отображения taxonomy terms в виде списка или сетки.

⚙️ Функции

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

показывать категории;
показывать теги;
показывать пользовательские таксономии;
выводить термины списком;
выводить термины сеткой;
показывать только выбранные термины;
показывать или скрывать пустые термины;
показывать вложенные термины;
ограничивать максимальное количество терминов;
сортировать термины;
настраивать шаблон одного термина;
добавлять внутрь Term Name, Term Description, Term Count;
оформлять каждый термин как карточку.

В структуре Terms Query есть несколько важных частей: Terms Query, Term Template, Term Name, Term Description и Term Count.

🎯 Зачем нужен

Чтобы создать автоматический каталог разделов сайта.

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

Разделы справочника

И внутри вывести:

Gutenberg — 32 материала
Media Blocks — 8 материалов
Design Blocks — 10 материалов
Widgets — 18 материалов
CSS — 6 материалов
Hosting — 4 материала

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

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

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

⚠️ Важно

Terms Query обычно не показывает сами записи.

Он показывает именно категории, теги или другие термины.

Например:

Категория: Design Blocks
Описание: Блоки для структуры, сеток, кнопок и отступов
Количество: 10 материалов

А уже после клика на категорию пользователь может перейти к списку записей внутри неё.

⚠️ Terms Query или Query Loop

Это главный момент.

Query Loop выводит записи:

Блок Group
Блок Row
Блок Stack
Блок Grid

Terms Query выводит категории или теги:

Media Blocks
Design Blocks
Widgets
Theme Blocks

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

Query Loop = список материалов
Terms Query = список разделов

⚠️ Terms Query или Categories List

Categories List — простой автоматический список категорий.

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

Например, через Terms Query можно сделать не просто список:

Design Blocks
Widgets
Media Blocks

а карточки:

[Design Blocks]
Блоки для структуры и композиции.
10 материалов

То есть:

Categories List = быстро и просто
Terms Query = гибко и красиво

⚠️ Вложенная структура

Terms Query состоит из вложенных блоков.

Пример:

Terms Query
 └─ Term Template
     ├─ Term Name
     ├─ Term Description
     └─ Term Count

Если ты меняешь Term Template, WordPress применяет этот дизайн ко всем терминам в списке.

Это очень похоже на Query Loop:

Query Loop → Post Template
Terms Query → Term Template

⚠️ Требования

По документации WordPress, для Terms Query нужны:

WordPress 6.9 или новее;
block theme;
таксономия должна быть публичной и доступной в редакторе.

То есть если ты не видишь этот блок или он работает не так, как ожидаешь, причина может быть в версии WordPress, теме или настройках таксономии.

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

Terms Query — это блок для вывода категорий, тегов или других разделов сайта.

Если нужно показать статьи — используй Query Loop.
Если нужно показать разделы, категории или теги — используй Terms Query.