34. Integración de GraphQL | Field Forge - Campos personalizados, diseñados para la velocidad

Field Forge registra automáticamente tipos nativos y resolutores con WPGraphQL cuando el plugin WPGraphQL está activo. WPGraphQL para ACF no es necesario. Los resolutores leen valores de las tablas de Field Forge, por lo que los campos migrados continúan funcionando después de desactivar ACF.

Consultando Campos a través de 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
      }
    }
  }
}

Mapeo de Tipos de GraphQL

Tipo de Field Forge	Tipo de 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` o `[ContentNode]` cuando la selección múltiple está habilitada
`relationship`	`[ContentNode]`
`taxonomy`	`TermNode` o `[TermNode]` para campos de checkbox / selección múltiple
`user`, `page_link`	`String` en el ámbito actual del resolutor nativo
`date_picker`, `time_picker`, `color_picker`	`String`
`repeater`	Tipo de lista personalizada
`group`	Tipo de objeto personalizado
`flexible_content`	Tipo de lista personalizada con `acfFcLayout` y subcampos de diseño

Reglas de Nomenclatura

Cada tipo de publicación coincidente obtiene un campo por grupo de Field Forge: fieldForge + el título del grupo en PascalCase. Ejemplo: Product Fields se convierte en fieldForgeProductFields.
Los nombres de los campos se convierten de snake_case o kebab-case a camelCase. Ejemplo: hero_title se convierte en heroTitle.
Flexible Content expone el nombre del diseño como acfFcLayout.
Si dos nombres de GraphQL colisionan en el mismo tipo de objeto, Field Forge añade un sufijo estable del campo clave o ID del grupo.

Los resolutores nativos cubren valores escalares, formas estructuradas de Grupo / Repetidor / Contenido Flexible, y campos respaldados por objetos. image, file, y gallery se resuelven a objetos MediaItem de WPGraphQL; post_object y relationship se resuelven a ContentNode; taxonomy se resuelve a TermNode. El mismo mapeo de objetos funciona dentro de subcampos anidados de Grupo, Repetidor y Contenido Flexible.

Para solicitudes anónimas, Field Forge filtra objetos de publicación privados, borradores, protegidos por contraseña o no GraphQL antes de devolverlos. Los campos de objeto único devuelven null; los campos de lista omiten nodos inaccesibles. Los términos se devuelven solo cuando su taxonomía está expuesta a WPGraphQL.

—