Язык виджета

Интерфейс виджета (форма, её подсказки, кнопки и сообщения) доступен на 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; изменение позже на той же странице ничего не даст до перезагрузки.

Что язык не меняет

Язык влияет только на интерфейс посетителя. Сообщения, веб-приложение и письма с уведомлениями остаются теми же, а в технических данных сообщения всегда сохраняется язык браузера посетителя.