Налаштуйте локалізацію

Віджет чату HelpCrunch вже локалізовано кількома мовами (GE, FR, ES, PT, RU, PL). Але ви також можете додавати власні фрази та локалізації.

---

Створіть список фраз

КРОК 1. Щоб локалізувати текст новою мовою, увійдіть у свій обліковий запис HelpCrunch і перейдіть у Налаштування → Канали → Веб-віджети → [Оберіть ваш віджет] → Вкладка «Локалізація» і натисніть кнопку "Додати локалізацію".

КРОК 2. Назвіть новий список фраз, вказавши потрібну мову — наприклад, нідерландська (NL). Якщо ви хочете, щоб ця локалізація відображалася за замовчуванням, встановіть відповідний прапорець.

КРОК 3. Заповніть усі поля новими фразами відповідною мовою та натисніть "Застосувати", щоб зберегти зміни.

Перейдіть на свій сайт і оновіть сторінку, щоб перемкнути чат на вибрану мову.

---

Оберіть локалізацію за замовчанням

Після того, як ви позначите одну з локалізацій як таку, що має стояти за замовчанням, і вимкнете зайві мови в списку, у вас є два різних варіантів подальших дій:

• Ви можете вказати, яку локалізацію ви хочете відображати для яких сторінок. Наприклад, відображати французьку локалізацію для www.yourdomain.com/fr і українську локалізацію для www.yourdomain.com.ua. 
• Показувати локалізації на основі мови браузера відвідувача. Якщо у відвідувача вказана мова браузера, яка не підтримується у вашому віджеті (вимкнена в списку локалізацій)  - замість неї відображатиметься мова за замовчуванням.

---

Вказати, яку локалізацію ви хочете відображати на певних сторінках

КРОК 1. Перш за все, вам потрібно назвати свій список фраз двобуквеним стандартним кодом (як «en» для англійської). Перегляньте повний список кодів ISO 639-1, якщо вам потрібна допомога з назвами.

КРОК 2. Додайте наступну команду до JS-коду віджета чату на своєму сайті:

HelpCrunch('setLocalization', 'en');

Тепер фрази віджетів чату автоматично відображатимуться англійською або будь-якою іншою мовою, яку ви виберете.

---

Визначте локалізацію автоматично на основі мови браузера відвідувача

Ви можете автоматично визначати мову браузера відвідувача та відображати віджет чату з відповідною локалізацією.

КРОК 1. Усі списки фраз мають бути названі за допомогою стандартних двобуквених кодів мови (повний список кодів ISO 639-1).

КРОК 2. Додайте наступну команду до JS-коду віджета чату на своєму сайті:

HelpCrunch('setLocalization', navigator.language.slice(0,2));

Тепер вам не потрібно перемикати локалізацію вручну. Фрази віджета чату будуть автоматично вибрані з доступних локалізацій і відображатимуться мовою відвідувача.

---

Задайте мову Бази знань у віджеті чату

Списки фраз охоплюють лише тексти чату. База знань у віджеті має власну мову. За замовчуванням вона збігається з мовою віджета, і відвідувачі можуть змінити її вручну (детальніше про багатомовну Базу знань читайте тут).

Щоб примусово задати певну мову Бази знань, наприклад синхронізувати її з вашим сайтом, використовуйте:

Параметри:
locale: string: дволітерний код мови (ISO 639-1), наприклад en, es, de.

HelpCrunch('setKnowledgeBaseLocalization', locale);

Приклад:
На вашому сайті є перемикач мов. Коли відвідувач перемикається на іспанську, покажіть Базу знань теж іспанською:

HelpCrunch('setLocalization', 'es');
HelpCrunch('setKnowledgeBaseLocalization', 'es');

Щоб синхронізувати і чат, і Базу знань з мовою браузера відвідувача:

var lang = navigator.language.slice(0, 2);
HelpCrunch('setLocalization', lang);
HelpCrunch('setKnowledgeBaseLocalization', lang);

Як це працює:

• Мова змінюється одразу. Метод можна викликати будь-коли.
• Якщо метод не викликати, нічого не зміниться. База знань залишиться мовою, яку обрав відвідувач.