Fecify 多语言插件

商城的多语言插件，也就是将商品，商品专辑，博客文章，博客专辑，自定义页面，菜单，首页seo等数据进行翻译，翻译的结果保存到数据库

多语言翻译内容

1.将商品，商品专辑，博客文章，博客专辑，自定义页面，菜单，首页seo等数据进行翻译，翻译的结果保存到数据库

2.加入了自动翻译api，可以通过google api，deep翻译api，自动将数据翻译成相应的语言自动填写

3.您可以手动翻译，也可以使用自动翻译api单个翻译，也可以使用自动翻译api进行批量翻译

多语言配置

参数配置：

• 开启状态：是否开启多语言插件，开启多语言翻译
• 产品翻译二次搜索：开启之后，当在翻译语言下搜索产品返回个数为0，则会对产品 原始数据进行搜索，返回相应结果，关闭后，当在翻译语言下搜索产品返回个数为0，则直接返回空列表，不会对产品原始数据进行搜索
• 默认语言翻译：当您编辑商品使用的是中文填写的商品信息，您店铺默认语言设置为中文， 当您 想更改店铺默认语言为英语，而您的商品数据是中文，您希望使用多语言插件里面的 翻译，那么就可以开启该选项，开启后，商品数据加载英文翻译部分

翻译Api配置

• Api翻译功能：开启后在翻译语言时可以使用该功能一键翻译
• 默认语言翻译：默认语言是否进行自动翻译，譬如您设置网站语言是英文，而您的产品数据导入的是中文，那么您可以开启该选项，那么访问商城主页显示的英文数据。
• Api翻译引擎：自动翻译的引擎，有google翻译引擎，deep翻译引擎，阿里云翻译等
• Api key：Api Key，获取参看：Rapidapi申请多语言翻译Api Key

关于api翻译引擎，有的支持html标签，有的不支持html标签，我们推荐大家使用的翻译引擎

• 阿里云翻译（支持html标签）：阿里云翻译-获取AccessKey Id和AccessKey Secret
• google翻译（支持html标签）：使用的是官方开通的翻译api，得到key直接填写即可
• 云上曲率翻译（国产翻译，支持html标签）
• RapidApi AI翻译(支持html标签翻译)，开通地址：https://rapidapi.com/haizibinbin-owyntKc0a48/api/ai-translate

批量翻译

1.您需要先配置好翻译Api，然后才能使用批量翻译

2.您可以设置各个数据的翻译设置

3.点击 点击开始 按钮, 就会加入task任务，您可以点击task管理按钮，前往task列表查看具体的执行.

商品，商品专辑，博客，自定义页面，编辑商品自动翻译

当您开启了多语言，并在翻译api配置中开启Api翻译功能（开启Api翻译功能，请务必填写Api Key）, 您可以在产品编辑页面看到：

• 强制翻译覆盖：保存商品后，将会强制翻译，即使您之前已经翻译了该产品数据，也会强制翻译覆盖。
• 只翻译为空的多语言：只对为空的部分进行翻译、
• 不翻译：不翻译产品数据

商品翻译

点击商品列表，然后在产品行中点击翻译按钮，对当前产品进行多语言翻译

您也可以点击右上角的 自定翻译按钮，使用Api自动翻译，不过前提是，在多语言插件翻译api配置，您开启了api翻译功能，并配置了翻译api引擎,否则调用将失败。

对于其他的一些数据，和商品翻译类似，这里不一一列举。

自定义翻译引擎

fecify多语言翻译引擎，以及支持了多种翻译api，如果您想扩展自己的翻译api，那么您可以按照fecify自定义翻译api的要求，开发一个api，然后进行配置即可

一：翻译api规范

您需要按照fecify要求的方式，进行翻译api的开发，规范要求：

• 验证key（秘钥）
• 请求的post参数格式
• 返回的参数格式

翻译api有2种模式：

• 单文本翻译模式：一次只能翻译一个字符串
• 多文本翻译模式：一次可以翻译多个字符串（数组格式），翻译效率更高。

时间要求：

• api请求响应时间，不要超过60秒。否则将断开

二：翻译api规范详细

1.单文本翻译模式

api：https://www.domaincom/api/xxx/xxx1?key=customlanguagetest2025

• key:验证key，通过get参数的方式进行传递

Request Header 参数:

Get数据格式如下：

post数据格式如下：

post数据示例：

{
    "q": "我的标题",
    "target":"en"
}

返回数据如下：

{
    "code": 200,
    "data": {
        "translates": "my title"
    },
    "message": "success"
}

postman截图：

2.多文本翻译模式

api：https://www.domaincom/api/xxx/xxx2?key=customlanguagetest2025

• key:验证key，通过get参数的方式进行传递

Request Header 参数:

Get数据格式如下：

post数据格式：

post数据示例：

{
    "q": [
        "我的标题",
        "我的描述"
    ],
    "target":"en"
}

返回数据如下：

{
    "code": 200,
    "data": {
        "translates": [
            "my title",
            "my description"
        ]
    },
    "message": "success"
}

postman截图：

三：配置自定义翻译引擎

按照上面的api，以及自身的情况，您可以开发单文本翻译模式，或者多文本翻译模式。 开发完成后，您在配置的部分要对应翻译模式

商家端后台，进入多语言插件，点击菜单：翻译Api配置，进入页面后，Api翻译引擎（下拉条），进行选择：自定义翻译引擎, 选择后，进行配置子项

• api url：您开发的翻译api的完整url，譬如：https://www.domain.com/api/mutil-text-custom-language
• key（秘钥）：您进行安全验证的秘钥key
• 翻译模式：单文本/多文本

翻译模式-说明：

• 如果您的api是单文本翻译模式，那么您需要选择单文本翻译模式
• 如果您的api是多文本翻译模式，那么您需要选择多文本翻译模式
• 必须要对应好,否则将无法翻译