WPML GraphQL 扩展插件介绍
这套扩展解决无头 WordPress 的多语言查询问题。WPGraphQL 本身不懂”这篇有英文版”，WPML GraphQL 把语言维度接到 schema 上，前端按语言取数据。
它加了什么能力
- 按语言过滤：posts、taxonomies、comments、menus、menu items 都能带 language 条件，传
all取全部语言。 - 语言字段：
language返回语言代码、国旗地址、本地名、译名与首页地址；languageCode只给代码，要轻量就用后者。 - translations 字段：取文章与分类项的译文列表，用来做语言切换器。
- 跨语言取单篇：按 ID 或 slug 查，
idType用 SLUG 或 DATABASE_ID。 - 连接自动跟随语言：查一篇 post 时，它的 categories、tags 默认给同语言版本，不用手动再筛。
依赖与授权范围
- 必装 WPGraphQL。这套只是 WPML 侧的适配层，没有 WPGraphQL 就没有 schema。
- 需要 WPML 核心。官方把它归在 Multilingual CMS 与 Multilingual Agency 两档账号的附加组件里，不是所有账号都有。
- 后台有 Query Composer。GraphQL → GraphQL IDE 里能拼查询，调试比手写快。
无头多语言站真正的坑
- 路由要自己建。WPML 的 /en/、/zh/ 前缀在无头架构里不生效，Next.js 或 Nuxt 要自己做语言路由与 301 规则。
- hreflang 要自己输出。搜索引擎靠 hreflang 认语言版本，API 不会替你生成，得在前端按 translations 拼。
- 缓存策略。CDN 与 ISR 要按语言分键，混在一个缓存里会出现”英文站显示中文”。
- ACF 字段要多语言。自定义字段的翻译靠 ACFML，不在这个扩展的职责内。
- 导航与菜单。menu items 能按语言筛，但菜单结构在各语言里要分别建，别指望自动镜像。
适合谁
用 Next.js、Nuxt、Astro、Gatsby 做前端、后端用 WordPress 出内容的团队；做多语言 SaaS 官网、跨境电商内容站的技术方。传统主题站用不上这套，装 WPML 加语言切换器就够。
nulled 版本适合本地把 schema 与查询跑通、验证字段结构，正式站请支持正版。下载在芒果下载页，装完核对文件完整。
多语言插件合集见WordPress 多语言标签，WPML 相关资源在WPML 标签。
插件总目录在WordPress 插件列表页，多语言专题在网站多语言翻译插件推荐。
本站所有资源收集自网络，所有软件版权归属原作者。
