Документация для разработчиков
Темная тема

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

Локализация блоков возможна с версии 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, если язык портала отличается от родного языка блока) и заменяет.



© «Битрикс», 2001-2023, «1С-Битрикс», 2023