203  /  380
Справочник

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

Просмотров: 41765
Дата последнего изменения: 27.05.2021
Роберт Басыров
Сложность урока:
2 уровень - несложные понятия и действия, но не расслабляйтесь.
1
2
3
4
5
Недоступно в лицензиях:
Ограничений нет

Кастомизация стандартного компонента - копирование стандартного компонента в собственное пространство имён и изменение логики его работы с целью изменения/добавления функционала.

Большинство задач в Bitrix Framework реализуется через компоненты, и в шаблоне компонента вы оперируете массивами $arResult - это результат работы компонента (данные) и $arParams - это входные параметры.

Чтобы кастомизировать стандартный компонент необходимо:

  • Создать новое пространство имён компонентов в папке /local/components/, например создать директорию /local/components/my_components/.
  • В созданную папку необходимо скопировать папку с компонентом, который хотите изменить (копировать из папки /bitrix/components/bitrix/).
  • Изменить компонент под текущие задачи.
    • изменить описание компонента на свое в файлах .description.php и /lang/ru/.description.php;
    • исправить файлы .parameters.php и component.php, модифицировав (добавив необходимый) функционал с помощью API продукта;
  • Отредактировать шаблон компонента под текущие задачи.
  • Очистите кеш визуального редактора. В результате в визуальном редакторе отобразится кастомизированный компонент.

    Важно! У работы с копией компонента есть определенные недостатки, которые нужно учитывать:
    • Увеличивается общее количество компонентов, соответственно растет и количество выделяемых на их поддержку ресурсов.
    • Сложность в освоении новым разработчиком: сначала ему нужно будет найти, в чем отличие кастомизированного компонента от уже существующего стандартного.

Важно! Выполняя кастомизацию компонента помните, что все ключи в $MESS, содержащие название, описание и параметры компонента, а также идентификаторы веток компонента в дереве компонентов визуального редактора должны быть уникальными в рамках всего продукта.




20
Курсы разработаны в компании «1С-Битрикс»

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