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

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Локализация блока задается в файле манифеста и позволяет использовать переводы подписей для разных языков.

Ключи локализации в манифесте

Для локализации используются два ключа:

  • lang_original — исходный язык фраз в манифесте
  • lang — набор переводов по языкам

В массиве lang ключами выступают исходные фразы из манифеста, а значениями — переводы этих фраз.

Пример:

'lang_original' => 'ru',
        'lang' => [
            'en' => [
                'Заголовок с разделителем на светлом фоне' => 'Title with a separator on a light background',
                'Заголовок' => 'Title',
                'Текст' => 'Text',
                'Кнопка' => 'Button',
            ],
            'de' => [
                'Заголовок с разделителем на светлом фоне' => 'Titel mit Trennlinie auf hellem Hintergrund',
                'Заголовок' => 'Überschrift',
                'Текст' => 'Text',
                'Кнопка' => 'Schaltfläche',
            ],
        ],

Как применяется локализация

Система проходит по манифесту и для текстовых подписей ищет перевод в массиве lang:

  • сначала для текущего языка портала
  • если перевода нет и lang_original отличается от текущего языка портала, используется перевод из en

Если подходящий перевод не найден, остается исходная фраза из языка lang_original.

Предыдущая
Расширенное описание карточек
Следующая
Обзор блоков