Добавление пользовательской таксономии тегов в схему
Мы можем добавлять теги к записям в WordPress (то есть используя таксономию с именем "post_tag"). Это уже отображено в схеме GraphQL через PostTag, связанный с записью Post.
Custom Post Types, определённые любой темой или плагином (например, "product"), также могут иметь собственную таксономию тегов (например, "product-tag"). Поскольку эти таксономии тегов не поставляются со своим специфическим типом для схемы GraphQL (это потребовало бы расширения через PHP-код), они разрешаются через тип GenericTag.
Для получения данных тегов мы используем поля tag и tags, которые указывают, к какой таксономии они относятся, с помощью аргумента поля taxonomy. Результат имеет тип объединения TagUnion, включающий записи как PostTag, так и GenericTag (в зависимости от таксономии записи).
Настройка запрашиваемых таксономий тегов
Таксономии тегов, доступные для запросов, должны быть явно настроены. Это можно сделать в 2 местах.
В настройках схемы (Schema Configuration), применяемых к endpoint, выбрав опцию "Use custom configuration" в разделе «Customize configuration, or use default from Settings?» и затем выбрав нужные элементы:
Этот список содержит все «неиерархические» таксономии, связанные с запрашиваемыми пользовательскими типами записей, то есть теми, которые выбраны в «Included custom post types» в настройках «Custom Posts». Пользовательские типы записей, связанные с каждой таксономией тегов, отображаются под (CPT: ...). Если нужная вам таксономия тегов не отображается здесь, убедитесь, что все связанные с ней пользовательские типы записей включены в этот список разрешённых.
В противном случае, если выбрана опция "Use configuration from Settings", используется значение, определённое в разделе «Included tag taxonomies» на странице настроек Schema Custom Posts:
Дополнительная настройка
Через настройки Schema Tags мы также можем задать:
- Количество элементов по умолчанию для получения (то есть когда аргумент поля
limitне задан) при запросе списка любой таксономии тегов - Максимальное количество элементов, которые можно получить за одно выполнение запроса
