Btranslate：基于百度翻译 API 的免费开源 WordPress 多语言插件

BTranslate 是一款 WordPress 多语言翻译插件，通过百度翻译开放平台 API，将网站中的文章、页面及其他内容翻译为不同语言，并为译文生成独立的语言访问地址。

插件会将翻译结果保存在服务器中。除非用户主动刷新翻译，否则同一内容在同一目标语言下只需翻译一次，无需在每次访问页面时重复调用翻译 API，有助于减少 API 请求量并提高页面加载速度。

项目地址

GitHub 仓库：https://github.com/hanyixuanten/btranslate
WordPress 插件主页：https://wordpress.org/plugins/btranslate/

审核状态： BTranslate 目前尚未通过 WordPress.org 插件目录审核，因此暂时无法直接通过 WordPress 后台插件市场安装。现阶段请从 GitHub 仓库下载并手动安装。

主要功能

百度翻译 API 集成

BTranslate 使用百度翻译开放平台提供的翻译 API。用户可以在 WordPress 后台配置自己的 App ID 和密钥，由插件完成请求签名、翻译调用及错误处理。

文章和页面翻译

插件支持翻译 WordPress 文章与页面中的主要内容，包括：

标题
正文
摘要
SEO 字段
图片替代文本
标签
分类目录
部分界面文本

多语言访问地址

BTranslate 可以为不同语言生成独立的访问地址，支持：

语言子目录，例如 /en/、/ja/
不同语言绑定不同域名
根据配置生成对应语言的固定链接

翻译结果持久化

翻译完成后，结果会保存在 WordPress 服务器中。后续访问相同译文时，插件优先读取已经保存的结果，而不是重新请求百度翻译 API。

当原文发生变化时，对应译文会被标记为需要更新，从而避免继续使用与原文不一致的旧译文。

WordPress 内容兼容

插件在翻译内容时会尽量保留：

Gutenberg 区块标记
HTML 结构
Shortcode 短代码
占位符
URL
受保护的特殊内容

多语言 SEO

BTranslate 为多语言页面提供必要的 SEO 支持，包括：

多语言固定链接
Canonical URL
hreflang 多语言链接
站点地图兼容
SEO 字段翻译

失败回退

如果百度翻译 API 请求失败，插件不会使网站页面报错：

如果没有可用译文，则显示网站的源语言内容。
如果存在以前成功保存的译文，则继续使用旧译文。

快速开始

一、获取百度翻译 API

打开百度翻译开放平台。
注册或登录百度账号。
进入管理控制台。
开通通用文本翻译 API 服务。
创建应用并填写应用信息。
在应用管理页面获取 APP ID 和密钥。

APP ID 和密钥属于敏感信息，请勿提交到公开的 GitHub 仓库，也不要通过网页前端代码或公开日志暴露。

百度翻译 API 的具体开通方式、计费规则和调用限制，请参考百度翻译 API 官方文档。

二、安装插件

由于插件目前尚未通过 WordPress.org 审核，需要从 GitHub 手动安装。

方法一：上传 ZIP 压缩包

访问 BTranslate GitHub 仓库。
点击 Releases。
从最新版本下载 zip 文件 btranslate-*.zip
登录 WordPress 管理后台。
打开“插件” → “安装插件”。
点击“上传插件”。
选择下载的 ZIP 文件并开始安装。
安装完成后启用 BTranslate。

方法二：上传到服务器

访问 BTranslate GitHub 仓库。
点击 Releases。
从最新版本下载 zip 文件 btranslate-*.zip
将 btranslate 目录上传到 WordPress 的插件目录： wp-content/plugins/btranslate/
登录 WordPress 管理后台。
打开“插件” → “已安装插件”。
找到 BTranslate 并点击“启用”。

三、配置插件

登录 WordPress 管理后台。
打开 BTranslate 设置页面。
填写百度翻译开放平台提供的 APP ID 和密钥。
设置网站的源语言。
添加需要启用的目标语言。
选择语言 URL 模式，例如语言子目录或域名绑定。
保存设置。

修改语言路由设置后，建议在 WordPress 后台打开“设置” → “固定链接”，确认固定链接配置已经正确生效。

四、开始使用

在 WordPress 后台打开需要翻译的文章或页面。
保存或更新内容。
使用 BTranslate 提供的翻译功能生成目标语言译文。
等待翻译任务完成。
通过对应语言的访问地址检查译文。

例如，假设源语言页面地址为：

https://example.com/about/

英语使用 /en/ 子目录时，译文地址为：

https://example.com/en/about/

日语使用 /ja/ 子目录时，译文地址为：

https://example.com/ja/about/

插件会优先使用已保存的译文。只有在原文发生变化、译文失效或用户主动要求刷新时，才需要重新调用翻译 API。

使用建议

正式启用前，请先在测试环境中检查固定链接和多语言路由。
为百度翻译 API 设置合理的调用额度和安全策略。
不要在源代码、前端 JavaScript或公开日志中保存 API 密钥。
发布译文前，建议人工检查品牌名、专业术语和重要页面。
修改原文后，应检查对应语言的译文是否需要更新。
配置域名绑定时，需要同时完成 DNS、HTTPS 证书和服务器域名设置。
修改语言路由后，请检查 Canonical URL、hreflang 和站点地图是否正确。

系统要求

WordPress 6.4 或更高版本
PHP 8.1 或更高版本
可正常访问百度翻译 API 的服务器网络环境
有效的百度翻译开放平台 APP ID 和密钥

问题反馈与贡献

如果在使用过程中遇到问题，或者希望提交功能建议，可以前往 GitHub 仓库反馈：

https://github.com/hanyixuanten/btranslate

提交问题时，建议提供以下信息：

WordPress 版本
PHP 版本
BTranslate 版本
使用的语言和路由模式
问题复现步骤
已隐藏敏感信息的错误日志

欢迎通过 Issue 或 Pull Request 参与 BTranslate 的改进。