HTBD 基于百度翻译 API 的免费开源 WordPress 多语言插件 – hanyixuanten's Blog
HTBD 为 WordPress 接入百度翻译 API，支持文章、页面、标签、分类和 SEO 字段的多语言翻译，并生成独立语言链接。
HTBD：基于百度翻译 API 的免费开源 Wordpress 多语言插件
HTBD 是一款 WordPress 多语言翻译插件，通过百度翻译开放平台 API，将网站中的文章、页面及其他内容翻译为不同语言，并为译文生成独立的语言访问地址。
插件会将翻译结果保存在服务器的 {$wpdb->prefix}hyx_bd_translations 表中。除非用户主动刷新翻译，否则同一内容在同一目标语言下只需翻译一次。启用改名后的插件时，已有 {$wpdb->prefix}btranslate_translations 数据会自动迁移，无需在每次访问页面时重复调用翻译 API，有助于减少 API 请求量并提高页面加载速度。
项目地址
- 插件主页：https://www.vblg.top/index.php/archives/147
- GitHub 仓库：https://github.com/hanyixuanten/HTBD
- WordPress 插件主页：https://wordpress.org/plugins/hyx-translator-for-baidu-translate/
审核状态： HTBD 目前尚未通过 WordPress.org 插件目录审核，因此暂时无法直接通过 WordPress 后台插件市场安装。现阶段请从 GitHub 仓库下载并手动安装。
主要功能
百度翻译 API 集成
HTBD 使用百度翻译开放平台提供的翻译 API。用户可以在 WordPress 后台配置自己的 App ID 和密钥，由插件完成请求签名、翻译调用及错误处理。
文章和页面翻译
插件支持翻译 WordPress 文章与页面中的主要内容，包括：
- 标题
- 正文
- 摘要
- SEO 字段
- 图片替代文本
- 标签
- 分类目录
- 部分界面文本
多语言访问地址
HTBD 可以为不同语言生成独立的访问地址，支持：
- 语言子目录，例如
/en/、/jp/ - 不同语言绑定不同域名
- 根据配置生成对应语言的固定链接
翻译结果持久化
翻译完成后，结果会保存在 WordPress 服务器中。后续访问相同译文时，插件优先读取已经保存的结果，而不是重新请求百度翻译 API。
当原文发生变化时，对应译文会被标记为需要更新，从而避免继续使用与原文不一致的旧译文。
WordPress 内容兼容
插件在翻译内容时会尽量保留：
- Gutenberg 区块标记
- HTML 结构
- Shortcode 短代码
- 占位符
- URL
<pre>和<code>元素内的代码内容（不翻译）- 受保护的特殊内容
多语言 SEO
HTBD 为多语言页面提供必要的 SEO 支持，包括：
- 多语言固定链接
- Canonical URL
hreflang多语言链接- 站点地图兼容
- SEO 字段翻译
失败回退
如果百度翻译 API 请求失败，插件不会使网站页面报错：
- 如果没有可用译文，则显示网站的源语言内容。
- 如果存在以前成功保存的译文，则继续使用旧译文。
快速开始
一、获取百度翻译 API
- 打开百度翻译开放平台。
- 注册或登录百度账号。
- 进入管理控制台。
- 开通通用文本翻译 API 服务。
- 创建应用并填写应用信息。
- 在应用管理页面获取 APP ID 和 密钥。
APP ID 和密钥属于敏感信息，请勿提交到公开的 GitHub 仓库，也不要通过网页前端代码或公开日志暴露。
百度翻译 API 的具体开通方式、计费规则和调用限制，请参考百度翻译 API 官方文档。
二、安装插件
由于插件目前尚未通过 WordPress.org 审核，需要从 GitHub 手动安装。
方法一：上传 ZIP 压缩包
- 访问 HTBD GitHub 仓库。
- 点击 Releases。
- 从最新版本下载 zip 文件 hyx-translator-for-baidu-translate-*.zip
- 登录 WordPress 管理后台。
- 打开“插件” → “安装插件”。
- 点击“上传插件”。
- 选择下载的 ZIP 文件并开始安装。
- 安装完成后启用 HTBD。
方法二：上传到服务器
- 访问 HTBD GitHub 仓库。
- 点击 Releases。
- 从最新版本下载 zip 文件 hyx-translator-for-baidu-translate-*.zip
- 将
hyx-translator-for-baidu-translate目录上传到 WordPress 的插件目录：wp-content/plugins/hyx-translator-for-baidu-translate/ - 登录 WordPress 管理后台。
- 打开“插件” → “已安装插件”。
- 找到 HTBD 并点击“启用”。
三、配置插件
- 登录 WordPress 管理后台。
- 打开 HTBD 设置页面。
- 填写百度翻译开放平台提供的 APP ID 和 密钥。
- 设置网站的源语言，或勾选“自动识别源语言”以使用百度翻译的
auto源语言模式。 - 添加需要启用的目标语言。
- 选择语言 URL 模式，例如语言子目录或域名绑定。
- 保存设置。
修改语言路由设置后，建议在 WordPress 后台打开“设置” → “固定链接”，确认固定链接配置已经正确生效。
自动识别状态使用独立选项保存。未勾选自动识别时在源语言输入框中主动填写 auto，仍属于不同的配置状态。
四、开始使用
- 在 WordPress 后台打开需要翻译的文章或页面。
- 保存或更新内容。
- 使用 HTBD 提供的翻译功能生成目标语言译文。
- 等待翻译任务完成。
- 通过对应语言的访问地址检查译文。
例如，假设源语言页面地址为：
https://example.com/about/
英语使用 /en/ 子目录时，译文地址为：
https://example.com/en/about/
日语使用 /jp/ 子目录时，译文地址为：
https://example.com/jp/about/
通过目标语言子目录或绑定域名请求 wp-login.php、wp-admin 时，插件会重定向到源站对应地址，并保留查询参数。
插件会优先使用已保存的译文。只有在原文发生变化、译文失效或用户主动要求刷新时，才需要重新调用翻译 API。
使用建议
- 正式启用前，请先在测试环境中检查固定链接和多语言路由。
- 为百度翻译 API 设置合理的调用额度和安全策略。
- 不要在源代码、前端 JavaScript或公开日志中保存 API 密钥。
- 发布译文前，建议人工检查品牌名、专业术语和重要页面。
- 修改原文后，应检查对应语言的译文是否需要更新。
- 配置域名绑定时，需要同时完成 DNS、HTTPS 证书和服务器域名设置。
- 修改语言路由后，请检查 Canonical URL、
hreflang和站点地图是否正确。
系统要求
- WordPress 6.4 或更高版本
- PHP 8.1 或更高版本
- 可正常访问百度翻译 API 的服务器网络环境
- 有效的百度翻译开放平台 APP ID 和密钥
问题反馈与贡献
如果在使用过程中遇到问题，或者希望提交功能建议，可以前往 GitHub 仓库反馈：
https://github.com/hanyixuanten/HTBD
提交问题时，建议提供以下信息：
- WordPress 版本
- PHP 版本
- HTBD 版本
- 使用的语言和路由模式
- 问题复现步骤
- 已隐藏敏感信息的错误日志
欢迎通过 Issue 或 Pull Request 参与 HTBD 的改进。