Добавить новую фразу

Три способа. Первый требует участия разработчика, но на практике оказывается самым коротким.

1. Прямо из шаблона

Разработчик добавляет в вёрстку вызов:

<?= LANG_VAR('NEW_CODE', 'Запасной текст') ?>

Как только страница откроется, модуль сам создаст запись в словаре: код NEW_CODE, текст «Запасной текст» на базовом языке. Дальше вы правите её как обычную фразу.

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

Подробности для разработчика — Lang::get и LANG_VAR.

2. Через админку

Highload-блоки → Словарь сайта → Добавить элемент. Заполните UF_CODE латиницей и переводы на нужных языках.

Так делают, когда фраза нужна раньше, чем вёрстка, — например, её надо отдать переводчику заранее.

3. Импортом из таблицы

Экран Словарь HL, вкладка «Импорт». Годится, когда фраз сразу много: Импорт и экспорт CSV.

Как называть коды

Код — это адрес фразы в словаре, и жить он будет долго. Несколько правил, которые окупаются:

• латиница, цифры и подчёркивание, без пробелов;
• по смыслу, а не по месту: SUBMIT_BTN переживёт переезд кнопки, а FOOTER_LEFT_TEXT2 — нет;
• одинаковые по смыслу фразы — один код. Соблазн завести отдельный код на каждую кнопку «Отправить» велик, а потом их приходится править по десятку.

Отдельно про коды, которые собираются в коде из кусков — 'STATUS_' . $id. Такие фразы работают, но индексатор их не видит и всегда считает неиспользуемыми. Они будут попадать в список кандидатов на удаление, и удалять их нельзя. Подробнее — Индексация.