Документация BILLmanager 5

Добавление нового языка в панель управления

ISPSystem

В этой статье рассматривается как добавить в панель управления новый язык. В качестве примера взят шведский язык.

Как добавить язык в панель


Чтобы в поле выбора языков появился новый язык, создайте файл /usr/local/mgr5/etc/xml/<mgrname>_msg_<sv>.xml со следующим содержанием:

<?xml version="1.0" encoding="UTF-8"?>
<mgrdata>
<lang name="sv">
</lang>
</mgrdata>

<mgrname> — сокращённое название панели управления. Файл <mgrname>_msg_sv.xml нужно называть в соответствии с именем панели, то есть для BILLmanager файл будет называться billmgr_msg_<язык>.xml, для VMmanager файл будет называться vmmgr_msg_<язык>.xml и т.д.

Сокращённые названия панелей управления:

  • ispmgr — ISPmanager;
  • billmgr — BILLmanager;
  • vmmgr — VMmanager KVM или Cloud;
  • vemgr — VMmanager OVZ;
  • dcimgr — DCImanager;
  • ipmgr — IPmanager;
  • dnsmgr — DNSmanager.

<sv> — код языка. Используйте произвольное значение.

Чтобы в панели управления отображалось название языка, создайте файл /usr/local/mgr5/etc/xml/core_mod_sv.xml со следующим содержанием:

<?xml version="1.0" encoding="UTF-8"?>
<mgrdata>
<lang name="en">
       <messages name="label_langs">
       <msg name="sv">Svenska</msg>
       </messages>
</lang>
</mgrdata>

Svenska — название языка.

sv — код языка. Используйте значение, которое указывали в файле <mgrname>_msg_<sv>.xml.

После того, как оба файла добавлены, перезапустите панель управления командой:

killall core

В панели появится возможность выбрать шведский язык на странице авторизации или на странице изменения языка пользователя.

Новый язык на форме авторизации


Как сделать перевод интерфейса панели


После того, как новый язык добавлен, можно переводить интерфейс панели управления на этот язык. Переводить можно двумя способами:

Способ 1

  1. В панели управления переключитесь на новый язык. Это можно сделать на странице авторизации или в настройках пользователя. Так как новых сообщений для этого языка вы ещё не добавляли, то весь интерфейс будет на языке, который установлен по умолчанию.
  2. Выделите в панели любой текст для перевода и нажмите Ctrl + Enter. Откроется окно, в котором нужно ввести перевод.
  3. После того, как вы ввели новое сообщение и сохранили изменения, в интерфейсе сообщение сразу изменится на новое.

Все изменения, которые вы будете производить с помощью Ctrl + Enter, будут сохраняться в файл /usr/local/mgr5/etc/xml/<mgrname>_mod_local_msg.xml.

После того, как перевод будет завершён, все сообщения языка будут находиться в файле <mgrname>_mod_local_msg.xml.

В итоге у вас получится три файла языка:

  • core_mod_sv.xml — содержит название языка. Файл необходим, чтобы в списке выбора языка отображалось название языка, а не его короткое обозначение;
  • <mgrname>_msg_<sv>_msg.xml — файл с описанием языка;
  • <mgrname>_mod_local_msg.xml — файл с описанием языка и всеми переведёнными сообщениями.

Вы можете объединить файлы <mgrname>_msg_<sv>_msg.xml и <mgrname>_mod_local_msg.xml. Для этого скопируйте все сообщения из <mgrname>_mod_local_msg.xml в <mgrname>_msg_<sv>_msg.xml.

Либо переименуйте <mgrname>_mod_local_msg.xml в <mgrname>_msg_<sv>_msg.xml, но тогда новые правки при помощи Ctrl + Enter запишутся в новый файл <mgrname>_mod_local_msg.xml.

<mgrname> — короткое название панели управления.

<sv> — код языка. Используйте произвольное значение.

Способ 2

Первый способ позволяет делать перевод напрямую из интерфейса панели, но не всегда это удобно, и не все сообщения удаётся перевести таким образом. В этом случае можно использовать второй способ.

  1. Возьмите за основу файл с английскими сообщениями <mgrname>_msg_en.xml и скопируйте его:

    cp /usr/local/mgr5/etc/xml/<mgrname>_msg_en.xml /usr/local/mgr5/etc/xml/<mgrname>_msg_<sv>.xml

    <mgrname> — сокращённое название панели управления. Возможные варианты:

    • ispmgr — ISPmanager;
    • billmgr — BILLmanager;
    • vmmgr — VMmanager KVM или Cloud;
    • vemgr — VMmanager OVZ;
    • dcimgr — DCImanager;
    • ipmgr — IPmanager;
    • dnsmgr — DNSmanager.

    <sv> — код языка. Используйте произвольное значение.

  2. В новом файле <ispmgr>_msg_sv.xml измените <lang name="en"> на <lang name="sv">. Вы получите файл для шведского языка, в котором уже есть все возможные сообщения панели управления.
  3. Переведите сообщения в файле с английского языка на шведский.
  4. Чтобы изменения вступили в силу, перезапустите панель управления:

    killall core

Спасибо за ваш отзыв!
Была ли полезна статья?
Уточните, почему:

статья не соответствует названию

статью сложно понять

в статье нет ответа на мой вопрос

рекомендации из статьи не помогли

другая причина

Расскажите, что вам не понравилось в статье: