34. Інтеграція GraphQL | Field Forge - Кастомні поля, створені для швидкості

Field Forge автоматично реєструє рідні типи та резолвери з WPGraphQL, коли плагін WPGraphQL активний. WPGraphQL для ACF не є обов’язковим. Резолвери читають значення з таблиць Field Forge, тому мігрувані поля продовжують працювати після деактивації ACF.

Запит полів через GraphQL

query GetProduct($id: ID!) {
  product(id: $id, idType: DATABASE_ID) {
    title
    fieldForgeProductFields {
      price
      saleBadge
      productGallery {
        databaseId
        sourceUrl
        mediaItemUrl
        altText
      }
      featuredProduct {
        __typename
        databaseId
        contentTypeName
        uri
      }
      specifications {
        label
        value
      }
    }
  }
}

Відображення типів GraphQL

Тип Field Forge	Тип GraphQL
`text`, `textarea`, `email`, `url`, `password`	`String`
`number`, `range`	`Float`
`true_false`	`Boolean`
`image`, `file`	`MediaItem`
`select`, `radio`, `button_group`	`String`
`checkbox`	`[String]`
`gallery`	`[MediaItem]`
`post_object`	`ContentNode` або `[ContentNode]`, коли активовано множинний вибір
`relationship`	`[ContentNode]`
`taxonomy`	`TermNode` або `[TermNode]` для полів checkbox / multi-select
`user`, `page_link`	`String` в поточному контексті рідного резолвера
`date_picker`, `time_picker`, `color_picker`	`String`
`repeater`	Користувацький тип списку
`group`	Користувацький тип об’єкта
`flexible_content`	Користувацький тип списку з `acfFcLayout` та підполями макета

Правила найменування

Кожен відповідний тип поста отримує одне поле на групу Field Forge: fieldForge + назва групи в PascalCase. Приклад: Product Fields стає fieldForgeProductFields.
Імена полів перетворюються з snake_case або kebab-case в camelCase. Приклад: hero_title стає heroTitle.
Гнучкий контент відкриває назву макета як acfFcLayout.
Якщо два імені GraphQL збігаються в одному типі об’єкта, Field Forge додає стабільний суфікс з ключа поля або ID групи.

Рідні резолвери охоплюють скалярні значення, структуровані форми Групи / Повторювача / Гнучкого контенту та поля, що підтримуються об’єктами. image, file та gallery резолвуються в об’єкти WPGraphQL MediaItem; post_object та relationship резолвуються в ContentNode; taxonomy резолвується в TermNode. Те ж саме відображення об’єктів працює всередині вкладених підполів Групи, Повторювача та Гнучкого контенту.

Для анонімних запитів Field Forge фільтрує недоступні приватні, чернеткові, захищені паролем або не-GraphQL об’єкти постів перед їх поверненням. Поля одного об’єкта повертають null; спискові поля пропускають недоступні вузли. Термін повертається лише тоді, коли їх таксономія відкрито для WPGraphQL.

—