Зміст
Технічні вимоги
Щоб запустити сценарій перекладу Linguise , вам знадобиться таке:
- Запустіть PHP 7+ і Laravel
- Сервер Apache, LiteSpeed, NGINX, IIS
- Активуйте перезапис URL-адрес у конфігурації вашого сервера
- Коренева папка Laravel public », переконайтеся, що Linguise в цій папці
1. Згенеруйте ключ API
Після підключення до інформаційної панелі Linguise вам спочатку потрібно буде налаштувати новий домен і зберегти його налаштування, щоб отримати ключ API.
Ключ API – це те, що потрібно для активації перекладу на вашому веб-сайті. По суті, ключ API перевірить, яка мова активована в якому домені, і дозволить створити сторінки нейронного перекладу.
Скопіюйте ключ API і збережіть його в буфері обміну.
Потім, клацнувши на вкладці «Сценарій PHP», ви отримаєте інструкції зі встановлення, які ми докладно дотримуватимемося тут.
2. Завантажте та підключіть сценарій перекладу Linguise
Сценарій перекладу Linguise потрібно завантажити на ваш сервер, у папку, де встановлено Laravel , його можна завантажити тут:
Після завантаження сценарію розпакуйте його та завантажте в кореневу папку, де встановлено Laravel .
- Переконайтеся, що він знаходиться на кореневому рівні вашої Laravel (зазвичай Laravel встановлює кореневу папку « загальнодоступна » папка, де можна встановити Linguise )
- Переконайтеся, що папка називається « linguise » (ім’я за замовчуванням, коли папку розпаковано)
Ключ Linguise потрібно буде скопіювати в папку: …/ linguise /Configuration.php файл, який ви завантажили на свій сервер, відредагуйте файл і скопіюйте ключ API між простими лапками, замініть текст REPLACE_BY_TOUR TOKEN.
3. Налаштуйте мовні URL-адреси
URL-адресу за мовою потрібно налаштувати у файлі .htaccess. Якщо у вашому файлі є «RewriteBase /», просто скопіюйте після цього весь наступний код:
<IfModule mod_rewrite.c>
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]
</IfModule>
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:
<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>
Автоматичний переклад на серверах 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;