10. Добавить языковую переменную

О языках, переводах и языковых переменных

CS-Cart — мультиязычная платформа. Поддержка нескольких языков осуществляется с помощью специальных «языковых переменных». Практически все статические тексты представляют из себя языковые переменные. Каждая языковая переменная имеет значение для разных языков. При этом описания объектов (товаров, страниц и т.д.) не являются языковыми переменными.

Все языковые переменные в коде платформы имеют специальный синтаксис и перед названием имеют два нижних подчёркивания, например {__("first_addon.video")}.

Если у языковой переменной нет значения в базе данных, то она выглядит в браузере так:

Крайне рекомендуется вставлять любые тексты с помощью языковых переменных.

Вы можете просмотреть, создать или изменить языковые переменные на странице «Переводы» в панели администратора.

Примечание

Администрирование → Языки → Перевод

Есть несколько способов создать языковые переменные:

  • В панели администратора.

    Для исправления существующих текстов.

  • С помощью импорта .po файла.

    Для массового перевода платформы

  • С помощью модуля

    Практически каждый модуль содержит и создаёт языковые переменные

Создадим языковую переменную с помощью модуля

Нам нужно создать языковую переменную first_addon.video .

  1. Откройте файл addon.xml вашего модуля:

    /app/addons/first_addon/addon.xml

  2. Вставьте блок <language_variables> для добавления языковых переменных. И перечислите значения языковых переменных для разных языков:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    <?xml version="1.0"?>
    <addon scheme="3.0">
        <id>first_addon</id>
        <name>Мой первый модуль</name>
        <description>Создаём модуль для CS-Cart и Multi-Vendor</description>
    
        <status>active</status>
    
        <default_language>ru</default_language>
        <language_variables>
            <item lang="en" id="first_addon.video">YouTube Embed Code</item>
            <item lang="ru" id="first_addon.video">Код от видео с YouTube</item>
        </language_variables>
        
    </addon>
    

    Обязательно добавляйте значения для английского и русского языков.

  3. Переустановите модуль в панели администратора

    Было Стало
    Первый модуль Первый модуль

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

Идём дальше.