目录
OpenCart 技术要求
OpenCart一起使用的神经自动翻译需要使用 PHP 脚本(可以在下面下载)。 为了安装Linguise脚本,您需要满足以下要求:
- 运行 PHP 7+
- Apache、LiteSpeed、NGINX、IIS 服务器
- 通过 PrestaShop 配置激活 URL 重写
如何安装 OpenCart 翻译
1. 生成API Key激活翻译
OpenCart上激活翻译所需的密钥。 基本上,API 密钥将检查在哪个域上激活了哪种语言,并允许生成神经翻译页面。
复制 API 密钥并将其保存在剪贴板中。

然后,通过单击“Script PHP”选项卡,您将获得我们将在此处详细说明的安装说明。

2.上传 Linguise 脚本并与 OpenCart连接
需要将 Linguise 翻译脚本上传到安装 OpenCart 的服务器上:
脚本下载完成后,解压并上传至CMS安装根目录。
- 确保它位于您网站的根级别OpenCart文件所在的位置)
- 确保文件夹保持其默认名称“ linguise ”

如何访问 Linguise 脚本接口?
完成Linguise安装后,您可以通过以下URL格式访问网站:
https://www.domain.com/linguise
根据您的网站地址更改域地址*
确保Linguise具有适当的读写和写入许可*
设置密码和数据库连接
访问脚本接口后,您将提供一个设置屏幕,您可以在其中创建密码并连接到首选的数据库。
你可以:
- 设置一个密码,这是对将来访问此接口所需的密码。
- 根据您的设置和偏好,选择您的数据库类型 - MySQL或SQLite。
此初始设置可确保安全访问权限,并允许您根据环境配置脚本。

MySQL数据库连接
如果您选择MySQL,则会出现不同的接口,要求以下MySQL配置字段的以下连接详细信息:

确保信息是正确的,以建立与您的MySQL数据库的成功连接。
mysql vs sqlite - 有什么区别?
MySQL和SQLite都是流行的数据库系统,用于存储和管理网站和应用程序的数据。但是,它们是针对不同用例设计的,并且有一些关键差异:
特征 | sqlite | mysql |
---|---|---|
设置 | 非常简单(需要安装SQLite) | 需要服务器设置 |
贮存 | 单文件 | 由MySQL Server管理 |
表现 | 非常适合小型应用程序 | 更好的是大型高流量系统 |
使用案例 | 本地应用程序,测试,小网站 | Web应用程序,电子商务,企业系统 |
Linguise 脚本接口:PHP平台的设置
以前仅适用于 Joomla 和 WordPressLinguise 翻译仪表板现在向PHP和其他平台扩展了支持。此更新允许用户无缝配置语言设置(例如显示选项,标志样式和外观自定义),无论其CMS或框架如何,都可以从统一的界面中直接配置。

管理员可以更有效地管理 Linguise 设置,具有一致的功能,例如语言选择弹出窗口,阴影效果和特定于区域的标志选择变体。仪表板保留了其用户友好的设计,同时为各种网络环境提供了更广泛的兼容性。


3. 在 OpenCart中设置语言 URL
OpenCart上通常出于 SEO 目的而激活 URL 重写。 URL 重写使用服务器根目录下的 .htaccess 文件。

从OpenCart系统设置中,检查 URL 重写是否已激活。 使用OpenCart管理菜单:
系统 > 设置 > 默认 > 服务器

需要在 .htaccess 中配置按语言划分的 URL。 默认OpenCart 代码“RewriteBase /”之后即可。
RewriteEngine On
RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
确保您的服务器上的路径 linguise/linguise.php 相同, /linguise/ 是您解压缩脚本时的默认名称。
4. 激活语言切换器
您现在可以使用 URL 加载所有已翻译的页面,例如:www.domain.com/fr/

语言切换器是一个标志弹出窗口,用于选择您想要的语言。 要加载它,您需要复制所有页面OpenCart中给出的Linguise 然后将自动加载标志语言切换器。 您可以在以下位置找到脚本链接:
仪表板。linguise> 设置

然后,要将其添加到您的OpenCart安装中,请转到“设计”>“主题编辑器”并编辑模板的默认/标题。
默认情况下,语言切换器将显示在网站右上角的浮动位置。 您已准备好在下一步中从 Linguise 仪表板自定义它。

SEO 重要说明:您设置的语言数量对 SEO 有很大影响。 当您设置翻译语言时,如果您有大量索引页面 (>500),搜索引擎可能会花费大量时间来处理它们。 它可能会影响您的原始语言的 SEO。 这就是为什么我们建议首先添加最多 5 种语言,然后当它被编入索引时,您可以每月批量添加 3 种语言。
设置语言切换器
可以通过Linguise仪表板 > 设置 > 语言标记显示来自定义语言切换器。 这里的每一个修改都会反映在网站上。

在屏幕右侧,您可以预览语言切换器。 以下是您可以设置的元素:
- 3 种布局:并排、下拉或弹出
- 语言切换器位置
- 语言切换器内容
- 英语或母语的语言名称
- 旗帜形状和尺寸
- 颜色和盒子阴影
在 OpenCart 内容中加载语言切换器

要在CMS内容中的特定位置显示语言切换器,您应该将位置设置为“就地”。
Linguise中设置位置后,您可以添加下面的短代码以包含它。 单击下面的代码将其放入剪贴板。
[linguise]
添加后,在前端,您将在添加代码的 HTML 区域中显示标志和语言名称。
激活翻译本地缓存系统
作为一种选择,您可以激活存储 URL 及其相关多语言内容的本地缓存系统,以更快地为页面提供服务。 本地缓存将节省 Linguise 服务器和您的网站服务器之间的一些数据传输。 仅当页面已翻译且尚未更新时才使用缓存。 优先保留的缓存将是浏览次数最多的多语言页面的缓存。

作为一个选项,您可以定义存储的缓存量(以 MB 为单位)。 在以下示例中,缓存已激活并且要保留的缓存量为 500MB:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
OpenCart CMS 的特定设置
在 Configuration.php 文件中,我们还有一个设置,允许传递 CMS 的一些特定配置。 默认情况下,它是自动的,但支持团队可能会要求您对其进行个性化以使用一些特殊设置。
OpenCart添加的代码,这是小写的 CMS 名称:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'opencart';
从 SQLite 到 MySQL
仍然在 Configuration.php 中,有一个设置强制使用 MySQL 而不是 SQLite,以防服务器上未安装 SQLite。
在这种情况下,您需要在Configuration.php 文件的这一部分中填写 MySQL 信息:
/** Advanced database configuration **/
/*
* In case you don't want to use Sqlite, you can use MySQL
* To do so, you need to fill the following variables
* Linguise will create the tables for you
*/
public static $db_host = '';
public static $db_user = '';
public static $db_password = '';
public static $db_name = '';
public static $db_prefix = '';
Windows IIS 服务器上的自动翻译
在 Web.config 文件中添加与您的网站构建器相对应的行。
它应该在任何其他重定向之前设置,尤其是重定向到 PHP 主文件:
NGINX 服务器上的自动翻译
rewrite ^/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ /linguise/linguise.php?linguise_language=$1&original_url=$2 last;