Зміст
Технічні вимоги Kirby CMS
Нейронний автоматичний переклад, який використовуватиметься з Kirby CMS, потребуватиме використання сценарію PHP (можна завантажити нижче). Щоб установити сценарій Linguise , вам знадобляться такі вимоги:
- Запустіть PHP 7+
- Сервер Apache, IIS або NGINX
- Переконайтеся, що на вашому сервері активовано перезапис URL-адрес
Згенеруйте ключ API
Після підключення або реєстрації на інформаційній панелі Linguise вам потрібно буде спочатку налаштувати новий домен і зберегти його налаштування, щоб отримати ключ API.
Ви можете вибрати платформу «Інша PHP», щоб продовжити реєстрацію домену Linguise , як-от ця документація, вихідна та цільова мови.
Після цього ви отримаєте:
- Ключ API, який підтверджує ваше членство
- Посилання на сценарій Linguise для перемикача мов
Ключ API – це те, що потрібно для активації перекладу на вашому веб-сайті Kirby CMS. По суті, ключ API перевірить, яку мову активовано у вашому домені, і дозволить автоматичний переклад вмісту.
Наразі ви можете скопіювати ключ API і зберегти його в буфері обміну.
Завантажте та підключіть сценарій перекладу Linguise
Сценарій перекладу Linguise потрібно завантажити на ваш сервер, де встановлено Kirby CMS. Завантажте його тут.
Після завантаження сценарію розпакуйте його та завантажте в кореневу папку, де встановлено Kirby CMS.
- Переконайтеся, що його розміщено на кореневому рівні вашого веб-сайту (де знаходяться ваші файли Kirby CMS)
- Переконайтеся, що папка зберігає назву за замовчуванням « 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 |
| Продуктивність | Чудово підходить для невеликих додатків | Краще для великих систем високого руху |
| Випадок використання | Місцеві програми, тестування, невеликі сайти | Веб -додатки, електронна комерція, корпоративні системи |
Інтерфейс Linguise Script: Налаштування платформи PHP
Інформаційна панель перекладу Linguise , раніше доступна лише для Joomla та WordPress, тепер розширює підтримку на PHP та додаткові платформи. Це оновлення дозволяє користувачам безперешкодно налаштувати параметри мов - такі як параметри відображення, стилі прапора та налаштування зовнішності - прямо з єдиного інтерфейсу, незалежно від їх CMS або рамок.
Адміністратори можуть більш ефективно керувати параметрами Linguise , з такими функціями, як спливаючі вікна вибору мови, тіньові ефекти та варіанти варіантів прапора, специфічні для регіону. Інформаційна панель зберігає свій зручний дизайн, пропонуючи більш широку сумісність для різних веб-середовищ.
Налаштуйте перезапис URL-адрес Kirby CMS
За замовчуванням перезапис URL-адрес активний у Kirby CMS. Якщо це не так, ви можете активувати його у свого хостинг-провайдера.
URL-адресу за мовою потрібно налаштувати в .htaccess. Просто скопіюйте наведений нижче код після коду “ RewriteEngine on ”, який доступний у типовому Kirby CMS .
<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>
Тепер ви можете завантажити всі свої перекладені сторінки за допомогою URL-адреси, наприклад: www.shop.com /fr/
Давайте тепер завантажимо перемикач мов.
Активуйте перемикач мов
Завантажте сценарій Linguise Javascript
Посилання Linguise Javascript потрібно завантажити на всі ваші сторінки Kirby CMS, щоб відображати перемикач мов із прапорцями та альтернативними URL-адресами у ваших заголовках HTML (з метою SEO).
Щоб скопіювати посилання на сценарій, на інформаційній панелі Linguise перейдіть до налаштувань домену та скопіюйте посилання на сценарій.
Найпростіший спосіб завантажити цей код у Kirby CMS – це додати його у файл header.php або код.
Ви можете налаштувати це, виконавши такі кроки: Відкрийте кореневу папку , а потім перейдіть до сайту > Фрагменти > файл header.php . За замовчуванням ви можете використовувати цей метод.
Відредагуйте файл сценарію, щоб включити посилання на сценарій у розділ заголовка, як показано нижче.
Перемикач мов за замовчуванням відображатиметься у плаваючому верхньому правому місці на вашому веб-сайті. Ви можете налаштувати його, як описано в наступному розділі.
Важлива примітка щодо SEO: кількість налаштованих мов має великий вплив на SEO. Під час налаштування мов перекладу, якщо у вас є велика кількість проіндексованих сторінок (>500), пошуковій системі може знадобитися багато часу для їх обробки. Це може вплинути на ваше SEO мовою оригіналу. Ось чому ми рекомендуємо спочатку додавати максимум 5 мов, а потім, коли буде проіндексовано, ви зможете додавати мови по 3 на місяць.
Налаштуйте перемикач мов
Перемикач мов можна налаштувати на інформаційній панелі Linguise > Налаштування > Відображення позначок мови. Кожна зміна тут буде відображена на веб-сайті.
У правій частині екрана є попередній перегляд перемикача мов. Ось елементи, які ви можете налаштувати:
- 3 макети: поруч, спадне або спливаюче
- Положення перемикача мов
- Вміст перемикача мов
- Назви мов англійською або рідною мовою
- Форми та розміри прапорів
- Кольори та коробка тіні
Завантажте перемикач мов у вміст Kirby CMS
Щоб відобразити перемикач мов у певному місці вмісту CMS, вам слід встановити позицію «На місці».
Після того як ви встановили позицію на Linguise , ви можете додати короткий код нижче, щоб включити його. Натисніть на наведений нижче код, щоб помістити його в буфер обміну.
<div>[linguise]</div>
Після додавання на інтерфейсі ви матимете прапор і назви мов, які відображатимуться в області 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;
Автоматичний переклад на серверах 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>
Від 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 = '';