Разработчикам

Lang-файлы компонент - использовать или нет

Академия 1С-Битрикс выпускников

Тема:	Битрикс PHP Framework
Описание:	А у нас будет своя академия, с блекджеком и девочками.

[ Закрыто ] Lang-файлы компонент - использовать или нет

Долганин Антон

Гуру

Сообщений: 8512Баллов: 1056 Авторитет: 2 Регистрация: 17.05.2007

11.03.2011 19:07:35

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

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

Теперь в шаблонах не применяю ланг-фразы. Во-первых (на данный момент), до ланг-фраз сложно добраться потом, чтобы поправить какую-то деталь. Во-вторых, без модуля локализации в эти файлы не хорошо вообще лезть редакторам.

В компонентах выношу в ланг-файлы, просто потому что это системная часть и там хотелось бы видеть порядок. К тому же, никогда не знаешь с какой кодировкой в IDE ты срочно полезешь править компоненту (не увидишь и сохранишь не в той, и конец).

Как-то так такие мысли вот.

Изменено: Долганин Антон - 11.03.2011 19:08:05

Педан Евгений Гуру Сообщений: 2435Баллов: 547 Авторитет: 0 Регистрация: 09.08.2006 оО	#2 1 11.03.2011 19:42:26 эмм ну а как же утф ? если в шаблоне будет кирилица, то на утф сайте будут кракозябры так что однозначно все надо писать в lang файлы Компания "АЛТАСИБ" http://www.altasib.ru

Нейман Андрей

Постоянный посетитель

Сообщений: 129Баллов: 15 Авторитет: 1 Регистрация: 30.04.2008

11.03.2011 19:50:07

Так даже если делать лэнг-файл, всё равно придётся вручную перекодировать в случае установки методом копипаста - не шаблон, так локализацию(конверт из win1251 в утф идёт же только через установке сайта/модуля, но Антон этот вариант вычеркнул в первом же абзаце)

Изменено: Нейман Андрей - 11.03.2011 19:51:24

Малков Евгений

Гуру

Сообщений: 1313Баллов: 284 Авторитет: 1 Регистрация: 15.06.2005

Чтоб жить до глубокой старости, нужно подняться на вершину блаженства бытия

11.03.2011 19:52:11

Цитата
Антон Долганин пишет: время на разработку тратится все равно больше, а вероятность что каждый сайт будут переводить - ничтожно мала.

Это точно.

Надо придерживаться правила всегда, т.е. писать все языковые фразы в lang-файлы.
Сам частенько грешу тем, что пишу в шаблоны сайта и компонентов.
Даже если вероятность мала, она есть. Не раз нарывался.

Прекрасная жизнь начинается с прекрасных мыслей...

Малков Евгений Гуру Сообщений: 1313Баллов: 284 Авторитет: 1 Регистрация: 15.06.2005 Чтоб жить до глубокой старости, нужно подняться на вершину блаженства бытия	#5 0 11.03.2011 20:00:18 Приходится клиентам объяснять, что эту фразочку они сами поправить не смогут и что она запрятана далеко. Прекрасная жизнь начинается с прекрасных мыслей...

Месилов Максим

Гуру

Сообщений: 1556Баллов: 250 Авторитет: 0 Регистрация: 15.08.2007

1С-Рарус

12.03.2011 12:26:23

LANG файлы, да, использую, но поскольку сайты только для зоны RU, то и язык ессно только один.

Мне кажется, что для компонентов гораздо важнее на этом же движке использование HELP файлов. Именно они отвечают за контекстные подсказки для настроек компонента.

1. Там можно использовать HTML, а значит ссылки на документацию, выделение полужирным начертанием итд.
2. Когда разрабатываются собственные компоненты, то не факт, что у другого человека не будет вопросов по поводу особенностей его настройки. А так - всё под рукой.

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

Махнюк Максим

Постоянный посетитель

Сообщений: 85Баллов: 17 Авторитет: 1 Регистрация: 31.12.2008

12.03.2011 12:53:55

В шаблонах их не использую и, более того, - удаляю если имеются. Во-первых, - это сокращает время разработки и упрощает дальнейшие правки шаблонов; во-вторых происходит "экономия на спичках" во время исполнения.

В компонентах использую, хотя кроме меня ими никто не пользуется. В компонентах должен быть полный порядок.

При необходимости локализации:

1. Пишется команда на shell или php, которая проходит по структуре шаблона сайта и показывает для каждого файла число строк в которых присутствуют киррилистические символы, автоматически создавая пустую структуру языковых файлов для ru там где надо.
3. Всё, что необходимо локализовать вносится из шаблонов в языковые файлы.
4. Структура ru дублируется в en и производится локализация.
5. Работают тестировщики.

В итоге, у меня в шаблонах нет GetMessage и проблем, либо он есть и это сигнал к тому, что есть локализация.

K Andrew

Постоянный посетитель

Сообщений: 107Баллов: 18 Авторитет: 1 Регистрация: 12.04.2008

12.03.2011 13:33:50

Lang-файлы...
в шаблонах - стараюсь использовать, но зачастую не использую

.
В компонентах и модулях - использую (но, как правило только русскую локализацию). На время разработки модуля или компонента (в локалке, естественно

) - подменяю функцию GetMessage своей - если в выхлопе пусто, возвращает имя переменной и место вызова. Время очень сильно экономит.
И да, в модулях, в админской части всегда есть вкладка "Справка": назначение, пример вызова и настройки, описание параметров.

Махнюк Максим

Постоянный посетитель

Сообщений: 85Баллов: 17 Авторитет: 1 Регистрация: 31.12.2008

12.03.2011 13:44:35

Цитата
Win32DllError пишет: подменяю функцию GetMessage своей

Используете runkit (форк оного?) или просто в коде заменяете?

Ban Dmitry

Гуру

Сообщений: 4830Баллов: 571 Авторитет: 0 Регистрация: 24.11.2005

#10

12.03.2011 14:00:35

Имхо языковые файлы нужно использовать в двух случаях:
* многоязычный сайт;
* тиражное решение.

Бонусы от использования языковых файлов:
* упрощается перевод на другой язык;
* упрощается перевод сайта в другую кодировку;
* можно переопределить значения языковых переменных через /bitrix/php_interface/user_lang/XX/lang.php

При разработке обычного сайта (без многоязычности, в известной кодировке) эти бонусы ничего не дают. Соответственно, я перестал париться с языковыми файлами при написании компонент. И в component.php, и в .parameters.php, и в .description.php, и в шаблоне.

«Да не могут же они!»

Ban Dmitry

Гуру

Сообщений: 4830Баллов: 571 Авторитет: 0 Регистрация: 24.11.2005

#11

12.03.2011 14:04:56

Цитата
Максим Месилов пишет: Поэтому я бы вывел совет: если пишешь свой компонент, то контекстная справка для его настроек - обязательна.

Зачем? Много ли разработчиков найдётся, которые будут включать режим редактирования, вызывать настройки компонента и читать хелп, а не полезут сразу в component.php? Вот там и надо писать пояснения.

«Да не могут же они!»

Долганин Антон

Гуру

Сообщений: 8512Баллов: 1056 Авторитет: 2 Регистрация: 17.05.2007

#12

12.03.2011 14:10:16

С хелпом битриксы промахнулись, я даже не помню как там надо структуру хелпа делать - сложно все. Ну почему не включили в parametrs.php доп.ключом в массиве?

Из-за этого никто и не пользует хелп. Я среди таких.

Цитата
Dmitry Ban пишет: Зачем?

Ну, например, свойство называется "URL страницы", и как вы припишите какие маркеры допускаются? Частенько пригождается хелп, но из-за проблемы выше просто пишу в скобочках рядом.

K Andrew

Постоянный посетитель

Сообщений: 107Баллов: 18 Авторитет: 1 Регистрация: 12.04.2008

#13

12.03.2011 14:11:40

Цитата
Максим Махнюк пишет: Используете runkit (форк оного?) или просто в коде заменяете?

в коде. лениво мне:

Код
wget http://pecl.php.net/get/runkit-0.9.tgz tar xzvf runkit-0.9.tgz cd runkit-0.9 phpize ./configure make && make install

Месилов Максим

Гуру

Сообщений: 1556Баллов: 250 Авторитет: 0 Регистрация: 15.08.2007

1С-Рарус

#14

12.03.2011 17:26:22

Цитата
Dmitry Ban пишет: Много ли разработчиков найдётся, которые будут включать режим редактирования, вызывать настройки компонента и читать хелп, а не полезут сразу в component.php?

Ммм я делаю так:
1. Создал раздел
2. Бросил компонент на страницу и настроил его
3. Если понадобилось, то уже лезу в него.

Если компоненты самописные, то справка в пункте 2 становится неоценимой, т.к. там частенько довольно хитрые параметры. Ну наверное я один такой извращенец xD

Структура хелпа - да, сам тоже долго первый раз ковырялся, пока сообразил как и чего. Имхо, подобные вещи как и документирование кода нужны. Без фанатизма конечно.

Цитата
Частенько пригождается хелп, но из-за проблемы выше просто пишу в скобочках рядом

Не ты один. Та же беда.

В шаблонах сайтов локализацией не пользуюсь по причине того, что сайты только для зоны RU. А если и делаются английские версии, то там они гораздо беднее и шаблон свой.

Zontov Alexander

Эксперт

Сообщений: 1323Баллов: 155 Авторитет: 1 Регистрация: 08.04.2010

#15

09.07.2011 20:03:11

Цитата
Имхо языковые файлы нужно использовать в двух случаях: * многоязычный сайт; * тиражное решение.

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

Цитата
Приходится клиентам объяснять, что эту фразочку они сами поправить не смогут и что она запрятана далеко.

You must have chaos within you to give birth to a dancing star.
Friedrich Nietzsche

lemontree

Постоянный посетитель

Сообщений: 107Баллов: 11 Авторитет: 1 Регистрация: 22.02.2017

#16

06.02.2019 12:04:28

Цитата
Антон Долганин написал: Как-то так такие мысли вот.

Привет!
Как передать в /lang/ru переменную из $arResult?
Дело в том, что есть фраза: "В работе * заявок". Можно создать два ключа массива $MESS со значениями: array(0 => "В работе", 0 => "заявок"). Но мне, конечно, это не нравится.

Большагин Вячеслав Эксперт Сообщений: 350Баллов: 61 Авторитет: 1 Регистрация: 10.11.2006	#17 0 07.02.2019 00:52:18 У меня почти все проекты не предполагают иностранного языка, рассчитаны на внутреннего пользователя(98%). Поэтому тоже перестал делать

Большагин Вячеслав

Эксперт

Сообщений: 350Баллов: 61 Авторитет: 1 Регистрация: 10.11.2006

#18

07.02.2019 01:27:37

Цитата
LemonTree написал: Как передать в /lang/ru переменную из $arResult? Дело в том, что есть фраза: "В работе * заявок". Можно создать два ключа массива $MESS со значениями: array(0 => "В работе", 0 => "заявок"). Но мне, конечно, это не нравится.

https://dev.1c-bitrix.ru/api_d7/bitrix/main/localization/loc/getmessage.php
lang файл

Код
$MESS['TEST'] = 'В работе amount заявок';

В шаблоне

Код
echo Bitrix\Main\Localization\Loc::getMessage("TEST", ['amount' => $arResult['amount']]);

Бонус - удобная функция просклонять числительные

Код

function formatByCount($count, $form1, $form2, $form3)
{
    $count = abs($count) % 100;
    $lСount = $count % 10;
    if ($count >= 11 && $count <= 19) return $form3;
    if ($lСount >= 2 && $lСount <= 4) return $form2;
    if ($lСount == 1) return $form1;
    return $form3;
}

echo formatByCount(
    8, //Количество яблок
    'яблоко', // Одно
    'яблокa', // Два
    'яблок' // Пять
); //яблок

Группы на сайте создаются не только сотрудниками «1С-Битрикс», но и партнерами компании. Поэтому мнения участников групп могут не совпадать с позицией компании «1С-Битрикс».

Продукты

Решения

Внедрение

Контакты

1С-Битрикс http://www.1c-bitrix.ru Общие вопросы info@1c-bitrix.ru Приобретение и лицензирование продуктов: sales@1c-bitrix.ru Маркетинг/мероприятия/PR marketing@1c-bitrix.ru Партнерская программа partners@1c-bitrix.ru Мы работаем с 10:00 до 19:00 по московскому времени. Офис в Москве 127287 Россия Московская область Москва 2-я Хуторская улица дом 38А строение 9 Офис в Калининграде +7 (4012) 51-05-64 Офис в Калининграде 236001 Россия Калининградская область Калининград Московский проспект 261 Офис в Киеве ukraine@1c-bitrix.ru Телефон в Киеве +3 (8044)221-55-33 Офис в Киеве 01033 Украина Калининградская область Киев улица Шота Руставели 39/41 офис 1507

Lang-файлы компонент - использовать или нет

Академия 1С-Битрикс выпускников

Продукты

Управление сайтом

Битрикс24

Интернет-магазин + CRM

Решения

Для интернет-магазинов

Каталог готовых решений

Внедрение

Выбрать партнера

Проверить партнера

Стать партнером