Что такое «Шаблон компонента Битрикс»

Компонент в Битриксе разделён на логику и представление. Логика выбирает данные и складывает их в массив $arResult, шаблон решает, как их показать. Поэтому один и тот же bitrix:news.list выводит ленту новостей на главной, плитку акций и список вакансий — меняется шаблон, а не код выборки.

Из каких файлов состоит

  • template.php — разметка, единственный обязательный файл;
  • style.css и script.js — подключаются автоматически вместе с шаблоном;
  • result_modifier.php — дорабатывает $arResult перед выводом, результат попадает в кэш;
  • component_epilog.php — выполняется после шаблона при каждом показе, даже из кэша: здесь задают заголовок и мета-теги;
  • lang/ — языковые фразы, .parameters.php — дополнительные параметры шаблона.

Куда копировать

Стандартные шаблоны лежат в папке компонента внутри /bitrix/components/bitrix/, и править их нельзя — обновление вернёт всё как было. Шаблон копируют в папку шаблона сайта, лучше в /local/:

/local/templates/main/components/bitrix/news.list/promo/
├── template.php
├── result_modifier.php
├── style.css
└── lang/ru/template.php

Затем в вызове компонента указывают имя шаблона promo. Копировать удобно кнопкой в режиме правки: система сама разложит файлы.

Пример result_modifier.php

Задача — показать дату словами и пометить свежие новости значком «Новое». Логику компонента не трогают, а дорабатывают результат:

<?php if (!defined('B_PROLOG_INCLUDED') || B_PROLOG_INCLUDED !== true) die();

foreach ($arResult['ITEMS'] as &$item) {
    $ts = MakeTimeStamp($item['ACTIVE_FROM']);
    $item['DATE_LABEL'] = $ts ? FormatDate('j F Y', $ts) : '';
    $item['IS_NEW'] = $ts > strtotime('-7 days');
}
unset($item);

В template.php остаётся только вывести готовые значения. Почему правки внутри /bitrix/ пропадают и как этого избежать, — в статье об обновлении 1С-Битрикс без потери доработок.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «1С-Битрикс» ↗