Fecshop 多语言 ¶
fecshop 支持多语言翻译,可以通过多个途径进行语言的切换,一共分为四个大部分: 数据库数据的翻译,网页内容数据的翻译,网站提示和报错等信息的翻译,邮件内容的 语言翻译,当您为一个store指定了语言,那么就会按照上面四种途径进行相应的语言翻译, ,进而形成对应语言的翻译语言。
fecshop是支持多store的,store一般是用来构建多语言站点, 可以为每一个store指定不同的语言和url结构,设置不同的语言,默认货币,模板等。
Fecshop-2.x更新说明 ¶
2版本更新为后台配置
Fecshop-1.x ¶
一:语言的配置 ¶
1.配置语言项:
在fecshop FecshopLang 服务 中可以配置语言选项,你可以在
@app/config/fecshop_local_services/FecshopLang.php
(@app是入口,代指@appfront,@apphtml5等) 中进行配置语言项,譬如:
'fecshoplang' => [
//'class' => 'fecshop\services\FecshopLang',
// mongoSearchLangName 在各个语言下字段参考资料如下:(不支持中文)
// https://docs.mongodb.com/manual/reference/text-search-languages/#text-search-languages
'allLangCode' => [
# 'en_US' 是标准语言简码 code对应的值en取 “标准语言简码”的前两位字符,
# 该值设置后,进行了产品分类数据的添加后,不能修改,否则会出现部分翻译语言丢失。
'en_US' => [
'code' => 'en',
],
'fr_FR' => [
'code' => 'fr',
],
'de_DE' => [
'code' => 'de',
],
'es_ES' => [
'code' => 'es',
],
'ru_RU' => [
'code' => 'ru',
],
'pt_PT' => [
'code' => 'pt',
],
'zh_CN' => [
'code' => 'zh',
],
],
# 默认语言。
'defaultLangCode' => 'en',
],
上面是fecshop默认的几个语言配置,您可以根据自己的业务需求进行语言的设置和添加。
fecshop的每个store设置的不同语言,以及对应的产品搜索(mongodb full search需要根据语言进行切词),都要依赖上面的配置。
通过上面,配置了fecshop商城里面可用的各个语言配置,各个store可以切换的语言就是从上面的配置数组中获取。
2.配置各个入口的i18n组件(yii2的i18n组件的配置)
fecshop的翻译,是基于yii2的i18n组件(component),因此,我们需要对其进行配置, 下面的配置是在各个入口的配置文件中进行的,因此,您可以让你的各个入口的i18n组件进行不同的配置, 一般都是相同的配置,下面是详细的说明
打开@app/config/main.php(@app是各个入口的统称,可以以@appfront为例子)
找到下面的配置
'i18n' => [
'translations' => [
'appfront' => [
'basePaths' => [
'@appfront/languages',
],
// base language code
'sourceLanguage' => 'en_US',
/**
* @var bool whether to force message translation when the source and target languages are the same.
* Defaults to false, meaning translation is only performed when source and target languages are different.
* see: @yii/i18n/MessageSource.php @property $forceTranslation
*/
'forceTranslation' => true,
],
],
],
basePaths
: 配置各个入口本地翻译文件所在的路径,默认为 '@appfront/languages'
sourceLanguage
: 当前入口的基础语言,默认语言
forceTranslation
:是否强制翻译,当入口store的当前语言
== sourceLanguage
(上面配置的选项),是否强制翻译,
fecshop默认配置了true
,譬如: 上面设置了 en_US
, 如果store的当前语言也是 en_US
, 那么,
forceTranslation
设置为true
后, 会去 @appfront/languages/en_US/appfront.php 文件
去找相应的翻译内容,因此对于fecshop的默认英文语句,如果你想更改,
可以通过翻译的访问(开启forceTranslation)
如果你想做中文商城,你仍然可以让基础语言设置en_US,然后中文使用翻译的方式进行, 在文档的末尾处有说明。
二:翻译 ¶
对于内容部分的翻译,分为4部分:网页文字内容的多语言,数据库数据的多语言,邮件内容的多语言翻译, 错误信息提示信息等内容的多语言翻译,下面是详细说明
数据库数据 ¶
数据库中的数据,譬如产品表中的产品名字,产品描述等,分类表中的分类名字和分类描述, 在数据库表中都是保存了多份语言数据
下面图片中显示的各个语言的选项,就是上面第一部分
配置语言项
配置数组的各个语言,在配置语言项
配置数组中添加其他语言后,下面就会显示添加的语言,您可以编辑保存该语言的内容
在网站前台展示数据的时候,根据当前的store设置的语言,将相应语言的数据取出来展示即可。 如果相应语言的值在数据库中没有添加,那么将会把默认语言的值取出来作为当前语言的值。
网页内容语言的翻译 ¶
网站内容语言的翻译,是依靠的翻译文件,在实现方面依赖的Yii::t()
函数,关于
Yii2多语言翻译的知识,可以参看地址 Yii2多语言
对于fecshop的翻译,是基于yii2的Yii::t()
函数实现,也就是page translate services类,
使用方式如下:
Yii::$service->page->translate->__('Product Review');
详细的代码您可以去这个services参考详细代码,总体来说,该函数,在翻译文件(下一部分说的翻译文件)
中查找Product Review
字符串是否在相应语言中存在翻译,如果存在,则使用翻译后的字符串。
对于存在变量的翻译,可以使用下面的方式:
$review_count = 5;
Yii::$service->page->translate->__('based on {review_count} Customer Reviews',['review_count' => $review_count])
在翻译文件中添加翻译:
'based on {review_count} Customer Reviews' => '基于{review_count}条用户评论',
即可。
另外,fecshop可能有一些地方存在翻译疏漏,您可以自己找到相应的字符串位置, 修改一下,通过上面的函数返回,然后在翻译文件中添加相应的翻译即可。
邮件内容的翻译 ¶
邮件内容的模板,是在theme中,譬如appfront的邮件模板,是在
@fecshop/app/appfront/theme/base/default/mailer
下面,其中,
@fecshop/app/appfront/theme
是模板文件夹路径,base
是模板包名,
default
是模板名,mailer
是邮件theme文件夹,在mailer路径下,打开
customer/account/forgotpassword
,里面是用户忘记密码发送的邮件,
其中subject_
开头的都是邮件的标题,body_
开头的都是邮件的内容
en
结尾的代表英文语言的邮件,zh
结尾的代表中文语言的邮件,打开相应文件
从en
复制一份到对应的语言,然后修改里面的语言即可,
有一些语言,里面没有对应的文件,您新建即可。
添加或者修改邮件内容,举例:
如果您想修改 @fecshop/app/appfront/theme/base/default/mailer/customer/account/forgotpassword/body_zh.php
,
里面的内容,你可以在 @appfront/theme/terry/theme01/里面新建文件 mailer/customer/account/forgotpassword/body_zh.php
(如果存在,则不需要创建)
然后将上面的文件内容复制到新建的文件中,进行修改即可,这样就完成了邮件内容的添加或者重写。
通过以上四种方式的翻译,我们就完成了整个fecshop多语言翻译的闭环。
注意: 如果您不添加翻译,则默认就会使用英语的翻译。
关于邮件更详细的介绍,可以参看:Fecshop 邮件
提示报错信息的翻译 ¶
在网站顶部,会出现一些提示信息和报错信息,譬如您注册邮箱的时候,会提示你的格式不正确等, 这些数据也是用翻译文件的方式,方法上上面类似,都是在一个同一个文件中 添加翻译内容,方法和方式同上。
Fecshop的翻译文件路径为:(举例appfront入口) ¶
@vendor/fancyecommerce/fecshop/app/appfront/languages/
,在这个文件夹下面可以看到
各个语言的文件包,进入相应语言,就可以看到翻译文件,譬如中文的翻译文件路径为
:@vendor/fancyecommerce/fecshop/app/appfront/languages/zh_CN/appfront.php
,在这个文件里面就可以看到所有的中文翻译内容,如果您想重写或者添加新
的翻译,可以到 @appfront/languages/zh_CN/appfront.php
中添加或者重写翻译
数组,注意,这里使用的是php的数组,需要按照相应格式填写,否则会报错。
在翻译文件中,您可能看到这样的带有{}的部分,譬如下面的 {passwdMinLength}
,
这是一个动态变量,这个请不要翻译和做其他的任何改动,直接复制上去即可,譬如下面的
翻译,这个值是由php动态计算而来。
'Password length must be greater than or equal to {passwdMinLength}'
=> '密码长度必须大于或等于{passwdMinLength}',
'Password length must be less than or equal to {passwdMaxLength}'
=> '密码长度必须小于或等于{passwdMaxLength}',
'The passwords are inconsistent'
=> '密码不一致',
三:各个入口的语言配置 ¶
当我们在上面的步骤中设置了语言,以及各个语言对应的翻译文件后, 我们需要为各个入口设置对应的默认语言
设置各个域名下面的默认语言 ¶
打开 @app/config/fecshop_local_services/Store.php
<?php
return [
'store' => [
'class' => 'fecshop\services\Store',
'stores' => [
// store key:域名去掉http部分,作为key,这个必须这样定义。
'fecshop.appfront.fancyecommerce.com' => [
'language' => 'en_US', // 语言简码需要在@common/config/fecshop_local_services/FecshopLang.php 中定义。
'languageName' => 'English', // 语言简码对应的文字名称,将会出现在语言切换列表中显示。
'localThemeDir' => '@appfront/theme/terry/theme01', // 设置当前store对应的模板路径。关于多模板的方面的知识,您可以参看fecshop多模板的知识。
'thirdThemeDir' => [], // 第三方模板路径,数组,可以多个路径
'currency' => 'USD', // 当前store的默认货币,这个货币简码,必须在货币配置中配置
/*
* 当设备满足什么条件的时候,进行跳转。
* 这种方式不怎么高效,最好的方式是在nginx中配置。
*/
...
设置:
language
:第一部分中, @common/config/fecshop_local_services/FecshopLang.php
中进行配置语言项,
这里填写的值,必须该配置文件中出现。
languageName
自定义语言label,这个会在前端显示出来具体的名字(因为简码,用户
是看不明白的),譬如在appfront端的顶部左侧显示的多语言切换列表,apphtml5端
首页底部显示的多语言切换列表
然后就可以访问查看了,当把该入口的各个域名对应的默认语言设置好后, 访问这个语言,就可以看到相应的语言了。
四:如何添加一门新语言 ¶
参看文档:fecshop 如何新增一门语言,并相应的添加一个store,将store设置成该语言
五:如何只保留中文语言,去掉其他的语言 ¶
参看文档:Fecshop 如何只保留中文语言,去掉其他的所有语言?
六:后台如何添加多语言 ¶
后台如何添加多语言:http://www.fecshop.com/topic/1586