Как я кастомизировал портал

Представим узкую, но возможную на реальном проекте задачу — в стандартном шаблоне копроративного портала 1с-Битрикс изменить страницу, которая отвечает за вывод универсального списка в группе. По опыту работы с БУС и общим принципам устройства шаблонов компонентов сразу видится план:
— скопировать шаблон комплексного компонента;
— удалить из него все кроме нужной страницы, чтобы не терять обновления (почему так читаем тут);
— отредактировать нужную страницу.

Первая часть плана реализуется в несколько кликов — из визуального интерфейса «Эрмитажа» копируем шаблон комплексного компонента bitrix:socialnetwork_group.

Теперь нужно узнать имя файла, отвечающего за вывод универсального списка. Для этого на нужной странице нажимаем «Редактировать шаблон компонента»:

Сюрприз!

Да, мы узнали что файл называется group_lists.php. Но почему код обычной статической страницы? Где вызов компонента bitrix:lists.lists? Намеченное решение оказалось не таким уж простым, нужно искать дальше.

Лезем в код комплексного компонента bitrix:socialnetwork_group посмотреть, откуда же берется нужная нам страница. В функции подключения шаблона участвует массив $arCustomPagesPath, из которого видно, что файл group_lists.php лежит в ядре продукта /bitrix/modules/lists/socnet/. Правильность его нахождения именно там оставим на совести разработчиков:) Компонент редактировать очень не хочется, поэтому продолжаем исследование.

Интересует, прежде всего, массив $arCustomPagesPath. Повезло, что строится он при обработке события OnParseSocNetComponentPath (о котором официальная документация конечно же не знает).

$events = GetModuleEvents("socialnetwork", "OnParseSocNetComponentPath");
while ($arEvent = $events->Fetch())
    ExecuteModuleEventEx($arEvent, array(&$arDefaultUrlTemplates404, &$arCustomPagesPath, $arParams));

Мы можем навесить свой обработчик с достаточно большой сортировкой в /bitrix/php_interface/init.php и удалить ненужное нам значение массива. Тогда файл будет подгружаться из шаблона комплексного компонента.

AddEventHandler("socialnetwork", "OnParseSocNetComponentPath", "MyOnParseSocNetComponentPath", 10000); 
function MyOnParseSocNetComponentPath($arFields, $arCustomPagesPath, $arParams) { 
   unset($arCustomPagesPath["group_lists"]);
}

Теперь можно удалить из шаблона комплексного компонента все лишнее и скопировать в него файл /bitrix/modules/lists/socnet/group_lists.php

Работает! :)