Fanyi2 - AI 智能翻译

WordPress 多语言翻译插件，支持 6 种 AI 引擎、28 种语言、前端可视化编辑、WooCommerce 深度集成。

版本 9.0 · PHP ≥ 7.4 · WordPress ≥ 5.6 · WooCommerce ≥ 5.0（可选）

功能概览

安装

1. 将 woo-fanyi-main 文件夹上传至 /wp-content/plugins/
2. 在后台 插件 页面激活
3. 进入 Fanyi2 翻译 > 设置 配置 AI 引擎和语言

快速开始

1. 配置 AI 引擎

Fanyi2 翻译 > 设置 > AI引擎：选择引擎、填入 API Key、点击 测试连接。

支持的引擎：

所有引擎均支持自定义 API URL，可用于中转代理。

2. 设置语言

Fanyi2 翻译 > 设置 > 语言设置：

• 选择默认语言（网站主语言）
• 勾选要启用的目标语言

3. 翻译内容

方式一：前端可视化编辑器

访问任意前台页面 → 点击右下角 🌐 翻译 → 进入编辑器模式：

• 📥 抓取所有文本：扫描当前页面文本入库
• 🤖 一键抓取并翻译：抓取 + AI 批量翻译一步完成
• 点击翻译：点击页面上任意文本，弹出翻译面板单独编辑

方式二：后台翻译管理

Fanyi2 翻译 > 翻译管理：

• 搜索 / 筛选字符串（按状态、语言、来源）
• 点击语言徽章直接编辑翻译
• 支持 AI 翻译单条

方式三：整站批量预翻译

Fanyi2 翻译 > 整站翻译：

1. 点击 扫描整个站点（自动抓取所有页面、产品、分类、菜单等文本）
2. 选择目标语言和批量大小
3. 点击 开始翻译 或 翻译所有语言

语言切换器

内置浮动切换器

后台 设置 > 高级设置 中配置：

短代码

[fanyi2_switcher]
[fanyi2_switcher style="flags"]
[fanyi2_switcher style="minimal"]

导航菜单集成

外观 > 菜单 → 左侧 Fanyi2 语言切换器 面板 → 添加到菜单。

各语言选项自动作为子菜单显示，完全继承主题菜单样式，无额外 CSS。

也可手动添加自定义链接，URL 填 #fanyi2-language-switcher。

模板函数

// 在主题模板中渲染切换器
fanyi2_language_switcher('dropdown'); // dropdown | flags | minimal

URL 模式

子目录模式下，插件自动：

• 注册 WordPress 重写规则
• 重写所有内部链接（href / action）
• 保护切换器链接和 hreflang 标签不被重写
• 处理 canonical 重定向

WooCommerce 集成

翻译覆盖范围

gettext 拦截

自动翻译 __() · _e() · _x() · _n() 中 domain 为 woocommerce 和 default 的文本。

兼容性

• ✅ HPOS (High-Performance Order Storage)
• ✅ Cart & Checkout Blocks
• ✅ WooCommerce 5.0 – 9.6

货币联动

通过 woo_huilv_current_language filter 与 woo-huilv 汇率插件桥接，语言切换时自动切换对应货币和价格。

性能架构

三级翻译缓存

首次请求通过一条 SQL 查询加载当前语言的全部翻译，后续请求从缓存读取。翻译保存/删除时自动清除对应语言缓存。

安全替换机制

采用两阶段占位符替换，防止链式替换（翻译 A 的结果包含原文 B 时不会被二次替换）。替换前按原文长度降序排列，避免短文本截断长文本。

开发者接口

PHP 函数

// 获取当前语言代码
$lang = Fanyi2::get_current_language();                // 'en'

// 获取指定语言的当前页面 URL
$url = Fanyi2_Frontend::get_language_url('en');         // 基于当前页面
$url = Fanyi2_Frontend::get_language_url('en', $base);  // 基于指定 URL

// 获取所有支持的语言
$langs = Fanyi2::get_supported_languages();             // ['zh' => '中文', ...]

// 获取语言名称 / 旗帜 emoji
$names = Fanyi2_Frontend::get_language_names();         // ['zh' => '中文', ...]
$flags = Fanyi2_Frontend::get_language_flags();         // ['zh' => '🇨🇳', ...]

// RTL 检测
$is_rtl = Fanyi2_IP_Detector::is_rtl('ar');             // true
$rtl_langs = Fanyi2_IP_Detector::get_rtl_languages();   // ['ar','he','fa','ur']

// 手动清除翻译缓存
Fanyi2_Translator::clear_translation_cache('en');       // 清除特定语言
Fanyi2_Translator::clear_translation_cache();           // 清除所有语言

Hooks

JavaScript

前端 fanyi2_vars 全局对象可用：

fanyi2_vars.current_language  // 'en'
fanyi2_vars.default_language  // 'zh'
fanyi2_vars.enabled_languages // ['zh','en','ja',...]
fanyi2_vars.url_mode          // 'parameter' | 'subdirectory'
fanyi2_vars.home_url          // 'https://example.com/'
fanyi2_vars.is_rtl            // '0' | '1'
fanyi2_vars.ajax_url          // admin-ajax.php URL
fanyi2_vars.nonce             // AJAX nonce

支持的语言（28 种）

🇨🇳 中文 · 🇺🇸 English · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇫🇷 Français · 🇩🇪 Deutsch · 🇪🇸 Español · 🇷🇺 Русский · 🇸🇦 العربية · 🇧🇷 Português · 🇮🇹 Italiano · 🇹🇭 ไทย · 🇻🇳 Tiếng Việt · 🇮🇩 Bahasa Indonesia · 🇲🇾 Bahasa Melayu · 🇹🇷 Türkçe · 🇵🇱 Polski · 🇳🇱 Nederlands · 🇸🇪 Svenska · 🇩🇰 Dansk · 🇫🇮 Suomi · 🇳🇴 Norsk · 🇺🇦 Українська · 🇨🇿 Čeština · 🇬🇷 Ελληνικά · 🇮🇱 עברית · 🇮🇳 हिन्दी · 🇧🇩 বাংলা

RTL 自动适配：阿拉伯语、希伯来语、波斯语、乌尔都语。

数据库

插件创建两张表：

{prefix}fanyi2_strings — 源字符串

{prefix}fanyi2_translations — 翻译

目录结构

woo-fanyi-main/
├── fanyi2.php                          # 主插件文件、路由、子目录处理
├── README.md
├── admin/
│   └── class-fanyi2-admin.php          # 后台页面（控制台/翻译管理/整站翻译/设置）
├── assets/
│   ├── css/
│   │   ├── fanyi2-admin.css            # 后台样式
│   │   ├── fanyi2-editor.css           # 可视化编辑器样式
│   │   └── fanyi2-frontend.css         # 前端切换器样式
│   └── js/
│       ├── fanyi2-admin.js             # 后台交互（翻译管理/批量翻译/设置）
│       ├── fanyi2-editor.js            # 可视化编辑器（点选/抓取/翻译面板）
│       └── fanyi2-frontend.js          # 前端切换器逻辑
└── includes/
    ├── class-fanyi2-ai-engine.php      # AI 翻译引擎（6 种）
    ├── class-fanyi2-ajax.php           # 16 个 AJAX 端点
    ├── class-fanyi2-batch.php          # 整站扫描与批量预翻译
    ├── class-fanyi2-currency.php       # woo-huilv 货币联动桥接
    ├── class-fanyi2-database.php       # 数据库 CRUD
    ├── class-fanyi2-frontend.php       # 语言检测/切换器/hreflang/菜单集成
    ├── class-fanyi2-ip-detector.php    # IP 语言检测/RTL 检测
    └── class-fanyi2-translator.php     # 翻译引擎（缓存/输出缓冲/gettext/URL重写）

许可证

GPL v2 or later