При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Локализация блока», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.

Локализация блока

Тут может не хватать некоторых данных — дополним в ближайшее время

• нужны правки под стандарт написания

Локализация блоков возможна с версии 18.5.6. Перевод возможен на любое количество языков. Для локализации:

1. Создайте блок под свой родной язык.
2. В манифесте добавьте два ключа:

    'lang' => [
        'en' => [
            'Заголовок с разделителем на светлом фоне' => 'Title with a separator on a light background (translated)'
        ],
        'de' => [
            'Заголовок с разделителем на светлом фоне' => 'Überschrift mit einem Trennzeichen auf einem hellen Hintergrund'
        ]
    ],
    'lang_original' => 'ru'

Где:

• lang_original – язык, на котором манифест блока сделан. Внимание: именно фразы манифеста.
• lang – все иные языки, минимально хотя бы один, иначе какой смысл локализации. (Никто не запрещает создавать блоки на французов и русских только, например.)

Рассмотрим подробнее массив lang. В его ключах перечислены все возможные поля name в вашем манифесте. Это и название самого блока, и название нод, стилей, атрибутов и их значений.

Система производит обход всего манифеста, и если встречает ключ name, ищет ему подходящую замену в массиве языков (либо текущий язык, либо en, если язык портала отличается от родного языка блока) и заменяет.