excodus / oc-translate-extended
扩展默认翻译插件的十月CMS插件
dev-master
2021-07-23 08:23 UTC
Requires
- php: >=5.5.9
- composer/installers: ~1.0
This package is not auto-updated.
Last update: 2022-09-28 22:46:51 UTC
README
此插件扩展了Rainlab的翻译插件(http://octobercms.com/plugin/rainlab-translate)的默认行为,具有以下功能:
- 检测浏览器语言(可选)
- 显示(并保存到会话中)首选的浏览器语言而不是默认语言(可选)
- 在每次访问时强制检测浏览器语言(可选)
- 将所有路由前缀设置为SEO友好的区域简码(可选)
使用方法
翻译插件有两种显示翻译内容的情况
http://website/lang/
将显示具有 'lang' 简码的语言。http://website/
将显示默认语言,除非用户选择首选语言
安装翻译扩展后,当您访问主页URL时
- 插件将获取最首选的用户语言(从浏览器设置中获取)并尝试将其与Rainlab翻译插件中启用的翻译匹配
- 如果找到匹配项,则此首选项将保存到用户会话中并立即显示
- 如果没有找到匹配项,则网站将显示默认语言(从Rainlab翻译插件设置中获取)
- 路由将SEO友好,自动使用适当的语言简码作为前缀
更改路由后,它将自动使用选择的语言作为前缀。如果您手动在地址栏中输入语言URI,它将被保存到用户会话中并立即显示。
注意:默认情况下,最首选的浏览器语言在第一次访问时保存到用户会话中。因此,下次用户进入网站时,地区将不会自动检测(它将从用户会话中恢复)。可以在后端区域的“翻译扩展”设置中强制在每个访问时检测语言。
扩展区域选择器
插件中有自定义的区域选择器组件。如果您想在URL中使用区域前缀,Rainlab翻译中的默认区域选择器可能无法正确工作。扩展区域选择器“强制”使用正确的区域前缀,因为它使用 href 属性而不是AJAX处理程序。
设置
翻译扩展在“翻译”类别下有几个设置可用(因此位于翻译插件设置所在的位置)
语言简码
为了正常运行,翻译扩展需要在Rainlab的翻译插件中设置正确的语言代码。语言代码需要与在HTTP头“HTTP_ACCEPT_LANGUAGE”中传输的ISO 639语言代码相同。http://www.metamodpro.com/browser-language-codes