许多 WordPress 主题和插件会将附加内容保存在自定义字段中。
例如：
- SEO 标题
- SEO 描述
- 产品副标题
- 课程介绍
- 下载说明
- 视频简介
- 自定义内容模块
GaaaiTranslator 支持按 Meta Key 白名单翻译这些字段。
一、什么是 Meta Key
WordPress 自定义字段由两部分组成：
- Meta Key：字段名称
- Meta Value：字段内容
例如：
| Meta Key | Meta Value |
|---|---|
| seo_title | WordPress 批量翻译插件 |
| seo_description | 用于批量翻译网站内容 |
| product_subtitle | 高效处理历史文章 |
插件需要先知道 Meta Key，才能确定应该翻译哪个字段。
二、使用调试工具查找字段
进入：
WordPress 后台 → GaaaiTranslator → 批量翻译
找到“自定义字段调试”区域。
输入一篇包含目标字段的文章 ID，然后点击：
查看当前文章自定义字段
插件会列出该文章使用的 Post Meta Keys。
三、判断需要翻译的字段
调试结果中可能包含很多字段。
不要将所有字段都直接加入翻译范围。
一般只翻译保存可读文字的字段，例如：
- seo_title
- seo_description
- product_intro
- course_summary
不要翻译以下类型的字段：
- 图片附件 ID
- 数字价格
- 时间戳
- 布尔开关
- 序列化配置
- JSON 配置
- 下载链接
- 授权信息
- 插件内部状态
四、填写自定义字段白名单
在“翻译字段”中勾选：
自定义字段
然后在下方文本框中，每行填写一个 Meta Key，例如：
seo_title
seo_description
product_intro
course_summary保存设置后，文章翻译任务会同时处理这些字段。
五、使用星号翻译全部字段
插件支持使用：
*
表示处理符合条件的全部普通自定义字段。
但这种方式风险较高。
虽然插件会跳过以下划线开头的字段和插件自身字段，但其他插件的普通字段中仍可能包含：
- URL
- 配置数据
- 状态值
- 数组内容
- 非文本信息
因此，正式网站建议使用明确的字段白名单，不建议直接使用星号。
六、先进行单篇测试
开启自定义字段翻译后，应先选择具体页面或少量文章测试。
检查：
- 字段内容是否被正常翻译
- 页面模块是否正常显示
- SEO 插件数据是否完整
- 是否误改价格或链接
- 是否出现序列化数据损坏
确认无误后，再开始批量任务。
七、自定义字段翻译建议
最安全的做法是：
- 找到一篇具有代表性的文章
- 使用调试工具查看 Meta Key
- 只选择明确保存文字的字段
- 备份数据库
- 翻译单篇文章
- 检查前台页面
- 批量处理其他文章
这样可以减少误翻译插件配置数据的风险。