Оглавление
Технические требования
Чтобы запустить скрипт перевода Linguise , вам понадобится следующее:
- Запустите PHP 7+ и Laravel
- Apache, LiteSpeed, NGINX, сервер IIS
- Активируйте перезапись URL в конфигурации вашего сервера
- Корневая папка Laravel общедоступной » папке, обязательно установите Linguise в эту папку.
1. Создайте ключ API.
После подключения к панели управления Linguise вам необходимо сначала настроить новый домен и сохранить его настройки, чтобы получить ключ API.
Ключ API — это то, что необходимо для активации перевода на вашем сайте. По сути, ключ API проверит, какой язык в каком домене активирован, и позволит генерировать страницы нейронного перевода.
Скопируйте ключ API и сохраните его в буфере обмена.
Затем, щелкнув вкладку «Script PHP», вы получите инструкции по установке, которым мы будем следовать здесь подробно.
2. Загрузите и подключите скрипт перевода Linguise
Скрипт перевода Linguise необходимо загрузить на свой сервер, в папку, где установлен Laravel , его можно скачать здесь:
После того как скрипт скачается, разархивируйте его и загрузите в корневую папку, где установлен Laravel .
- Убедитесь, что он находится на корневом уровне вашей Laravel (обычно Laravel устанавливает корень в « общедоступную » папку, в которую вы можете установить Linguise )
- Убедитесь, что папка называется « linguise » (имя по умолчанию, когда папка распакована).
Ключ Linguise необходимо будет скопировать в папку: …/ linguise /Configuration.php файл, который вы загрузили на свой сервер, отредактируйте файл и скопируйте свой ключ API между простыми кавычками, замените текст REPLACE_BY_TOUR TOKEN.
3. Настройте языковые URL-адреса
URL-адрес по языку необходимо настроить в файле .htaccess, если у вас есть «RewriteBase/» в вашем файле, просто скопируйте после этого весь следующий код:
RewriteEngine On
RewriteRule ^linguise/linguise.php$ - [L]
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]
4. Активируйте переключатель языка в Laravel .
Переключатель языка — это всплывающее окно с флажком для выбора нужного языка. Чтобы загрузить его, вам нужно скопировать код, указанный в конце конфигурации веб-сайта (панель управления Linguise ).
Сценарий должен быть загружен в заголовок ваших HTML-страниц, обрабатываемых Laravel . Переключатель языка флага будет загружен автоматически.
Переключатель языка по умолчанию будет отображаться в плавающем верхнем правом положении на вашем веб-сайте. Вы можете настроить его по своему усмотрению с помощью CSS.
Важное замечание по SEO: количество языков, которые вы устанавливаете, оказывает большое влияние на SEO. При настройке языков перевода, если у вас большое количество проиндексированных страниц (> 500), поисковой системе может потребоваться много времени для их обработки. Это может повлиять на SEO на исходном языке. Вот почему мы рекомендуем сначала добавить максимум 5 языков, а затем, когда он будет проиндексирован, вы сможете добавлять языки пакетами по 3 в месяц.
Настройте переключатель языка
Переключатель языка можно настроить на панели управления Linguise > Настройки > Отображение флагов языка. Каждое изменение здесь будет отражено на веб-сайте.
В правой части экрана у вас есть предварительный просмотр переключателя языка. Вот элементы, которые вы можете настроить:
- 3 макета: рядом, раскрывающийся список или всплывающее окно
- Положение переключателя языка
- Содержимое переключателя языка
- Названия языков на английском или родном языке
- Формы и размеры флагов
- Цвета и тень коробки
Загрузите переключатель языка в контент Laravel
Чтобы отобразить переключатель языка в определенном месте Laravel , вам следует установить позицию «На месте».
После того, как вы установили положение на Linguise , вы можете добавить приведенный ниже шорткод, чтобы включить его. Нажмите на код ниже, чтобы поместить его в буфер обмена.
После добавления во внешнем интерфейсе в области HTML, в которую вы добавили код, будут отображаться названия флагов и языков.
Локальная система кэширования для страниц Laravel
В качестве опции вы можете активировать локальную систему кэширования, в которой хранятся URL-адреса и связанный с ними многоязычный контент для более быстрого обслуживания страниц. Локальный кеш уменьшит передачу данных между сервером Linguise и сервером вашего веб-сайта. Кэш используется только тогда, когда страница уже переведена и не обновлялась. Кэш, сохраняемый в приоритете, будет кешем самых просматриваемых многоязычных страниц.
Как вариант, вы можете определить объем кэша, хранящегося в МБ. В следующем примере кэш активирован, и объем сохраняемого кэша составляет 500 МБ:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Особые настройки для платформы Laravel
В файле Configuration.php у нас также есть настройка, которая позволяет передавать некоторую конкретную конфигурацию для CMS или не-CMS. По умолчанию это происходит автоматически, но служба поддержки может попросить вас персонализировать его, используя некоторые специальные настройки.
Вот код, который нужно добавить для Laravel , это имя CMS в нижнем регистре:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'laravel';
От SQLite к MySQL
Тем не менее, в Configuration.php есть настройка, позволяющая принудительно использовать MySQL вместо SQLite, если SQLite не установлен на сервере.
В этом случае вам нужно будет заполнить информацию MySQL в этой части файла Configuration.php:
/** 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 = '';
Автоматический перевод на серверах Laravel + Windows IIS
Добавьте строку, соответствующую вашему конструктору веб-сайтов, в файл Web.config.
Его следует устанавливать перед любым другим перенаправлением, особенно перед перенаправлением на основной файл PHP:
Автоматический перевод на серверах Laravel + 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;