目录
技术要求
要运行 Linguise 翻译脚本，您’需要以下内容：
- 运行 PHP 7+
- Apache、LiteSpeed、NGINX、IIS 服务器
- 在服务器配置中激活 URL 重写
视频中如何安装脚本
1. 生成 API 密钥
在您连接到您的 Linguise dashboard 您需要先设置一个新域名并保存其设置以获取 API 密钥。
API 密钥是激活您网站翻译所必需的。基本上，API 密钥会检查哪个语言在何种域名上被激活，并允许生成神经翻译页面。.
复制 API 密钥并将其保存到剪贴板中。.
然后点击标签 “Script PHP”，您将获得我们将在此详细遵循的安装说明。.
2. 上传并连接 Linguise 翻译脚本
需要将 Linguise 翻译脚本上传到您的服务器，可在此处下载：
脚本下载后，解压并上传到 CMS 所在的根文件夹。.
- 确保它’位于 根级别 您的网站（通常是 CMS 文件所在的位置）
- 确保文件夹 被命名为 “linguise”（文件夹解压后默认的名称）
如何访问 Linguise 脚本界面？
完成 Linguise 安装后，您可以通过以下 URL 格式访问您的网站仪表板：
https://www.domain.com/linguise
根据您网站的地址更改域名地址*
确保 Linguise 拥有适当的读写权限*
设置密码和数据库连接
一旦您访问脚本界面，系统将呈现一个设置屏幕，您可以在此创建密码并连接到您偏好的数据库。.
您可以：
- 设置密码，未来访问此界面时将需要该密码。.
- 选择您的数据库类型——可以是 MySQL 或 SQLite，取决于您的设置和偏好。.
此初始设置确保安全访问，并允许您根据环境配置脚本。.
MySQL 数据库连接
如果您选择 MySQL，将出现一个不同的界面，要求填写以下 MySQL 配置字段的连接详细信息：
确保信息正确，以成功连接到您的 MySQL 数据库。.
MySQL 与 SQLite – 有何区别？
MySQL 和 SQLite 都是流行的数据库系统，用于存储和管理网站及应用程序的数据。然而，它们针对不同的使用场景设计，并且存在一些关键差异：
| 特性 | SQLite | MySQL |
|---|---|---|
| 设置 | 非常容易（需要安装 SQLite） | 需要服务器设置 |
| 存储 | 单文件 | 由 MySQL 服务器管理 |
| 性能 | 非常适合小规模应用 | 更适合大型高流量系统 |
| 使用场景 | 本地应用、测试、小型站点 | Web 应用、电子商务、企业系统 |
Linguise 脚本接口：PHP 平台设置
Linguise 翻译仪表板，之前仅适用于 Joomla 和 WordPress，现在已扩展对 PHP 及其他平台的支持。此更新允许用户从统一界面无缝配置语言设置—例如显示选项、旗帜样式和外观自定义—，无论其 CMS 或框架为何。.
管理员可以更高效地管理 Linguise 设置，具备一致的功能，如语言选择弹窗、阴影效果以及地区特定的旗帜选项变体。仪表板保持用户友好的设计，同时为多样的网络环境提供更广泛的兼容性。.
3. 设置语言 URL
需要在 .htaccess 文件中配置按语言的 URL。如果您的文件中有 “RewriteBase /”，只需在其后复制以下所有代码。最好将代码放在文件的开头：
<IfModule mod_rewrite.c> 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] </IfModule>
4. 激活语言切换器
该 语言切换器 是用于选择所需语言的旗帜弹出窗口。要加载它，您’需要复制提供的代码，以在您的网站配置或模板文件中的任何位置加载脚本。
最重要的是在所有页面的头部加载脚本。.
语言切换器默认会在您网站的右下角浮动位置显示。欢迎您从 Linguise 仪表板进行自定义。.
SEO重要提示： 您设置的语言数量对SEO有很大影响。当您设置翻译语言时，如果有大量已索引的页面（>500），搜索引擎可能需要很长时间来处理它们。这可能会影响您原始语言的SEO。因此我们建议您一开始最多添加5种语言，等它们被索引后，您可以每月批量添加3种语言。
设置语言切换器
语言切换器可以从 Linguise 仪表板 > 设置 > 语言标志显示。 此处的每次修改都将在网站上体现。
屏幕右侧是语言切换器的预览。您可以设置以下元素：
- 三种布局：并排、下拉菜单或弹出式
- 语言切换员职位
- 语言切换器内容
- 英语或母语中的语言名称
- 旗帜的形状和尺寸
- 颜色和阴影
在 PHP 内容中加载语言切换器
要在特定位置显示语言切换器，在 PHP 内容中，您应将位置设置为 “In place”。
在 Linguise 仪表板中设置位置后，您可以添加以下短代码以将其包含进去。点击下面的代码将其复制到剪贴板。
<div>[linguise]</div>
添加完成后，前端会在您添加代码的 HTML 区域中显示国旗和语言名称。.
激活本地缓存系统
作为一种选项，您可以激活本地缓存系统，该系统存储 URL 及其相关的多语言内容，以加快页面加载速度。本地缓存将减少 Linguise 服务器与您网站服务器之间的数据传输。仅在页面已翻译且未更新时才使用缓存。优先保留的缓存将是访问量最高的多语言页面的缓存。.
作为选项，您可以定义以 MB 为单位的缓存容量。在下面的示例中，缓存已启用，需保留的缓存容量为 500MB：
/** 基本配置 **/ public $cache_enabled = true; public $cache_max_size = 500; // 以兆字节为单位
Windows IIS 服务器上的自动翻译
在您的 Web.config 文件中添加对应于您网站构建器的行。
它应在任何其他重定向之前设置，尤其是重定向到您的 PHP 主文件：
<rule name="Linguise" stopProcessing="true"> <match url="^(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)(?:$|/)(.*)$" ignoreCase="false" /> <conditions logicalGrouping="MatchAll" trackAllCaptures="false" /> <action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&original_url={R:2}" appendQueryString="true" /> </rule>
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;