Мова віджета

Інтерфейс віджета (форма, її підказки, кнопки і повідомлення) доступний 17 мовами. Яку з них побачить відвідувач, вирішує опція locale у коді вставки. Є три способи нею користуватись.

Відкрита форма зворотного зв’язку із заголовком «Leave feedback», підказкою «Describe the issue or share your opinion», полем email і кнопкою Submit — Ось ті написи, які змінює налаштування мови: заголовок форми, підказки в полях, кнопка і повідомлення, які відвідувач бачить після надсилання. Усе навколо — ваша власна сторінка.

1. Фіксована мова

Задайте в locale один із підтримуваних кодів, і кожен відвідувач отримає цю мову:

var __rm__config = {
  projectId: 'YOUR_PROJECT_ID',
  locale: 'de'
};

Підтримувані коди: en англійська, ua українська (приймається і uk), ru російська, pt португальська, es іспанська, de німецька, fr французька, it італійська, pl польська, nl нідерландська, tr турецька, cs чеська, ro румунська, hu угорська, sv шведська, ja японська, zh китайська. Невідомий код, як і відсутня locale, дає англійську.

Саме це робить селект «Widget language» у налаштуваннях проєкту: він записує обраний код у згенерований код вставки.

2. Автоматично: мова браузера відвідувача

var __rm__config = {
  projectId: 'YOUR_PROJECT_ID',
  locale: 'auto'
};

Зі значенням 'auto' віджет дивиться на мови, яким браузер відвідувача віддає перевагу (navigator.languages), і бере першу, яку підтримує, інакше англійську. Нові проєкти створюються саме з цим налаштуванням. Це правильний вибір для сайту з міжнародною аудиторією, де віджет має просто говорити мовою відвідувача.

3. Мова вашого сайту

Якщо ваш сайт багатомовний і віджет має слідувати за мовою сторінки, а не браузера, задайте locale зі свого коду до того, як виконається скрипт віджета. Підійде будь-яке значення, яке вже знають ваші шаблони, наприклад атрибут lang сторінки:

<script>
var __rm__config = {
  projectId: 'YOUR_PROJECT_ID',
  locale: document.documentElement.lang || 'auto'
};
</script>
<script src="https://widget.revisionme.com/app.js" defer id="rm_app_script"></script>

Або виводьте код одразу з серверного шаблону, наприклад locale: '<?= $currentLang ?>'. Віджет читає __rm__config один раз, при старті, тож значення має бути на місці до завантаження app.js; зміна пізніше на тій самій сторінці нічого не дасть до перезавантаження.

Що мова не змінює

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