快速开始指南

只需数分钟,即可将标准单语言 WordPress 站点构建为高效的多语言平台。本指南将逐步介绍环境要求、插件安装、设置向导及站点关系配置。

1. 运行环境要求

WPMMCC ATS 采用高内聚低依赖设计,无需特殊编译拓展或常驻 Redis 守护进程:

  • WordPress 版本: 6.2 或更高(单站点或 Multisite 多站点网络均支持)。
  • PHP 版本: 7.4、8.0、8.1、8.2 或 8.3+。
  • 数据库: MySQL 5.7+ 或 MariaDB 10.3+。
  • 固定链接: 已启用伪静态固定链接格式(例如 /%postname%/)。
  • 开源授权: GPL-2.0-or-later 自由软件协议。完全免费,不设付费升级限制。

2. 安装插件

可通过以下任一标准方法安装 WPMMCC ATS:

方式一:通过 WordPress 后台在线安装(推荐)

  1. 以管理员身份登录 WordPress 后台(wp-admin)。
  2. 进入 插件 → 安装插件。
  3. 在搜索栏中输入 WPMMCC ATS。
  4. 在搜索结果中点击 现在安装,安装完毕后点击 启用。

方式二:手动上传 ZIP 压缩包

  1. 前往官方 GitHub Releases 发行页 下载最新版发布的 ZIP 包。
  2. 在 wp-admin 中进入 插件 → 安装插件 → 上传插件。
  3. 选择下载的 ZIP 文件并点击 现在安装,然后点击 启用插件。
多站点网络说明: 在 WordPress Multisite 多站点网络下,可在网络后台中“在整个网络中启用”,使所有子站点共享多语言能力,也可以在各子站点中单独按需启用。

3. 运行设置向导

启用插件后,点击 wp-admin 左侧主菜单中的 WPTSALL。内置设置向导将引导完成初始配置:

  • 确认主站点语言: 确认站点的默认源语言(如 zh_CN 或 en_US)。
  • 选择目标语言: 勾选站点需要拓展的目标语言(如英语 en_US、日语 ja 等)。
  • 自动扫描内容插件: 自动触发 AST 扫描程序,全面检测当前已启用的内容插件与主题结构。

4. 查看模型与字段扫描结果

进入 WPTSALL → 模型。插件将汇总列出扫描器探测到的所有内容模型,包括 WooCommerce 产品、ACF 自定义字段、Elementor 模板及核心文章。

扫描器将自动为各字段归类并生成规则:

  • Translate (翻译) — 待翻译的标题、正文、摘要及 HTML 富文本区块。
  • Sync (同步) — 价格、SKU、库存数量、发布日期等在各语言间保持一致的数值型配置。
  • ID-Map (ID 映射) — 特色图像、相册媒体附件及分类法 Term ID,系统自动建立语言间的 ID 映射映射表。
  • Compute (计算派生) — 派生指标与统计数值,例如平均评分、评价次数等。
  • Skip (忽略) — 内部 Nonce、临时缓存或无需维护的临时 Meta 项。
统一规则集: 在“模型”中建立的规则集由后台双栏手动翻译编辑器与 WPTSALL 客户端 API 共同读取,无需重复配置两次。

5. 创建首个站点关系

进入 WPTSALL → 站点 建立语言间的路由与关联:

  1. 点击 添加站点关系。
  2. 选择 源语言(例如 简体中文 (zh_CN))。
  3. 选择 目标语言(例如 English (en_US))。
  4. 指定 虚拟 URL 前缀(例如 /en_us/)。
  5. 点击 保存关系。

虚拟站点将立即生效。在该关系下翻译的内容即可通过 /en_us/ 前缀直接访问,页面头部会自动注入规范链接(canonical)与 hreflang 标签。

固定链接刷新提示: 若访问虚拟目录时出现 404 错误,只需前往 设置 → 固定链接,无需修改任何内容直接点击一次 保存更改 即可刷新 WordPress 重写规则。

后续步骤

手动翻译使用手册 →

了解如何在 wp-admin 内使用双栏对照编辑器及翻译记忆库翻译首篇文章。

自动翻译与 Worker 指南 →

对接免费的本地优先 WPTSALL 客户端,使用自选 AI 模型(DeepSeek/OpenAI)批量自动化翻译。