Зміст
Технічні вимоги PyroCMS
Нейронний автоматичний переклад, який використовуватиметься з PyroCMS , потребуватиме використання сценарію PHP (можна завантажити нижче). Щоб установити сценарій Linguise , вам знадобляться такі вимоги:
- Запустіть PHP 7+
- Сервер Apache, LiteSpeed, NGINX, IIS
- Переконайтеся, що на вашому сервері активовано перезапис URL-адрес
- PyroCMS 3 і вище
1. Згенеруйте ключ API
Після підключення або реєстрації на інформаційній панелі Linguise вам потрібно буде спочатку налаштувати новий домен і зберегти його налаштування, щоб отримати ключ API.
Ви можете вибрати платформу «Інша PHP», щоб продовжити реєстрацію домену Linguise , як-от ця документація, вихідна та цільова мови.
Після цього ви отримаєте:
- Ключ API, який підтверджує ваше членство
- Посилання на сценарій Linguise для перемикача мов
Ключ API – це те, що потрібно для активації перекладу на вашому веб-сайті PyroCMS . По суті, ключ API перевірить, яку мову активовано у вашому домені, і дозволить автоматичний переклад вмісту.
Наразі ви можете скопіювати ключ API і зберегти його в буфері обміну.
2. Завантажте та підключіть сценарій перекладу Linguise
Скрипт перекладу Linguise необхідно завантажити на ваш сервер, де встановлено PyroCMS :
Після завантаження сценарію розпакуйте його та завантажте в кореневу папку, де встановлено PyroCMS .
- Переконайтеся, що він знаходиться на кореневому рівні вашого веб-сайту (де знаходяться ваші файли PyroCMS за замовчуванням він знаходиться в папці /public )
- Переконайтеся, що папка зберігає назву за замовчуванням « linguise »
Будь ласка, дайте нам знати Зв'яжіться з нами .
Ключ Linguise API потрібно буде скопіювати у Configuration.php , який ви завантажили на свій сервер, відредагуйте файл і скопіюйте свій ключ API між простими лапками, замініть текст REPLACE_BY_TOUR TOKEN.
3. Налаштуйте перезапис URL-адрес PyroCMS
За замовчуванням перезапис URL-адрес активний у PyroCMS . Якщо це не так, ви можете активувати його у свого хостинг-провайдера.
URL-адресу за мовою потрібно налаштувати в .htaccess. Просто скопіюйте наведений нижче код після коду « RewriteEngine on » , доступного в стандартній PyroCMS .htaccess.
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]
Нарешті, ваш PyroCMS .htaccess має виглядати приблизно так:
Options -MultiViews
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]
RewriteBase /
# Redirect trailing slashes
RewriteRule ^(.*)/$ /$1 [L,R=301]
Тепер ви можете завантажити всі свої перекладені сторінки за допомогою URL-адреси, наприклад: www.shop.com /fr/
Давайте тепер завантажимо перемикач мов.
4. Активуйте перемикач мов
4.1 Завантажте сценарій Linguise JS
Посилання на сценарій Linguise JS потрібно завантажити на всі ваші сторінки PyroCMS , щоб відображати перемикач мов із прапорцями та альтернативними URL-адресами у ваших заголовках HTML (з метою SEO).
Щоб скопіювати посилання на сценарій, на інформаційній панелі Linguise перейдіть до налаштувань домену та скопіюйте посилання на сценарій.
Найпростіший спосіб завантажити цей код у PyroCMS — додати його в заголовок веб-сайту або код. PyroCMS постачається зі спеціальним середовищем і має спеціальний файл для додавання сценарію до заголовка.
Він розташований у файлі scripts.twig , який ви можете знайти, перейшовши до папки інсталяції CMS тут:
vendor/ pyrocms /*ВАША_ТЕМА*/resources/views/partials/scripts.twig . За замовчуванням PyroCMS є початковою.
Відредагуйте файл сценарію, щоб включити посилання на сценарій у розділ заголовка, як показано нижче.
Перемикач мов за замовчуванням відображатиметься у плаваючому верхньому правому місці на вашому веб-сайті. Ви можете налаштувати його, як описано в наступному розділі.
Важлива примітка щодо SEO: кількість налаштованих мов має великий вплив на SEO. Під час налаштування мов перекладу, якщо у вас є велика кількість проіндексованих сторінок (>500), пошуковій системі може знадобитися багато часу для їх обробки. Це може вплинути на ваше SEO мовою оригіналу. Ось чому ми рекомендуємо спочатку додавати максимум 5 мов, а потім, коли буде проіндексовано, ви зможете додавати мови по 3 на місяць.
Налаштуйте перемикач мов у PyroCMS
Перемикач мов можна налаштувати на інформаційній панелі Linguise > Налаштування > Відображення позначок мови. Кожна зміна тут буде відображена на веб-сайті.
У правій частині екрана є попередній перегляд перемикача мов. Ось елементи, які ви можете налаштувати:
- 3 макети: поруч, спадне або спливаюче
- Положення перемикача мов
- Вміст перемикача мов
- Назви мов англійською або рідною мовою
- Форми та розміри прапорів
- Кольори та коробка тіні
Завантажте перемикач мов у вміст PyroCMS
Щоб відобразити перемикач мов у певному місці у PyroCMS , вам слід встановити позицію «На місці».
Після того як ви встановили позицію на Linguise , ви можете додати короткий код нижче, щоб включити його. Натисніть на наведений нижче код, щоб помістити його в буфер обміну.
Після додавання на інтерфейсі ви матимете прапор і назви мов, які відображатимуться в області HTML, до якої ви додали код.
Активуйте опцію системи локального кешу
Як варіант, ви можете активувати систему локального кешу, яка зберігає URL-адреси та відповідний багатомовний вміст для швидшого обслуговування сторінок. Локальний кеш заощадить передачу даних між сервером Linguise та сервером вашого веб-сайту. Кеш використовується лише тоді, коли сторінку вже перекладено й не оновлено. Кеш-пам’ять, яка буде мати пріоритет, буде кеш-пам’яттю багатомовних сторінок, які найчастіше переглядаються.
Щоб доповнити це, ви можете визначити обсяг кешу, що зберігається в МБ. У наведеному нижче прикладі кеш активовано, а обсяг кешу, який потрібно зберегти, становить 500 МБ.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Автоматичний переклад на серверах 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;