WordPress 主题 functions.php 中注册自定义字段到GraphQL

以下是通用的实现代码，你可以直接复制到主题的 functions.php 文件中，我会以 “给文章（Post）类型添加自定义字段 custom_author_bio” 为例：

/**
 * 在 GraphQL 中注册文章的自定义字段
 * 适用于 WPGraphQL 插件环境
 */
add_action( 'graphql_register_types', 'register_custom_fields_to_graphql' );
function register_custom_fields_to_graphql() {

    // 1. 注册单个自定义字段（文章的自定义作者简介）
    register_graphql_field(
        'Post', // 要添加字段的 GraphQL 类型（Post=文章，Page=页面，User=用户等）
        'customAuthorBio', // GraphQL 中使用的字段名（遵循驼峰命名规范）
        [
            'type' => 'String', // 字段类型（String/Int/Boolean/ID 等）
            'description' => __( '自定义作者简介字段，用于GraphQL查询', 'your-theme-textdomain' ),
            // 解析函数：定义如何获取这个字段的值
            'resolve' => function( $post ) {
                // 获取文章的自定义字段值（这里的 custom_author_bio 是你在后台添加的自定义字段名）
                $custom_bio = get_post_meta( $post->databaseId, 'custom_author_bio', true );
                // 处理空值，避免返回 null
                return ! empty( $custom_bio ) ? $custom_bio : '';
            }
        ]
    );

    // 2. 扩展：注册多个自定义字段（示例：添加自定义阅读量字段）
    register_graphql_field(
        'Post',
        'customReadCount',
        [
            'type' => 'Int', // 整数类型
            'description' => __( '文章自定义阅读量', 'your-theme-textdomain' ),
            'resolve' => function( $post ) {
                $read_count = get_post_meta( $post->databaseId, 'custom_read_count', true );
                // 确保返回整数类型
                return intval( $read_count );
            }
        ]
    );

    // 扩展：给页面（Page）类型注册自定义字段
    register_graphql_field(
        'Page',
        'customPageBanner',
        [
            'type' => 'String',
            'description' => __( '页面自定义横幅图片URL', 'your-theme-textdomain' ),
            'resolve' => function( $page ) {
                return get_post_meta( $page->databaseId, 'custom_page_banner', true );
            }
        ]
    );
}

关键代码解释

1. 钩子触发：add_action( 'graphql_register_types', ... ) 是 WPGraphQL 提供的钩子，用于注册自定义 GraphQL 类型 / 字段，确保在 GraphQL 架构初始化时执行注册逻辑。
2. register_graphql_field 函数参数：
   • 第一个参数：目标 GraphQL 类型（如 Post/Page/User，需匹配 WPGraphQL 内置类型）；
   • 第二个参数：GraphQL 查询中使用的字段名（建议用驼峰命名，符合 GraphQL 规范）；
   • 第三个参数：字段配置数组：
     • type：字段数据类型（必填，支持 String/Int/Boolean/ID/Float 等基础类型，也支持自定义类型）；
     • description：字段描述（可选，便于在 GraphQL 调试工具中查看）；
     • resolve：解析函数（核心），接收目标对象（如文章对象）作为参数，通过 get_post_meta 获取自定义字段值并返回。
3. $post->databaseId：WPGraphQL 中，文章对象的 databaseId 对应 WordPress 原生的文章 ID，需用这个值来调用 get_post_meta 获取自定义字段。

测试 GraphQL 查询

query GetPostWithCustomFields {
  post( id: 1, idType: DATABASE_ID ) {
    id
    title
    customAuthorBio # 自定义字段
    customReadCount # 自定义字段
  }
}

{
  "data": {
    "post": {
      "id": "cG9zdDox",
      "title": "测试文章标题",
      "customAuthorBio": "这是自定义的作者简介",
      "customReadCount": 120
    }
  }
}