К статье
Практический материал

Разработка и Конфигурация · 9 мин

Шаблоны 1С-Битрикс: где находятся и как их найти

Где находятся шаблоны 1С-Битрикс: структура папок /bitrix/templates и /local/templates, шаблоны компонентов, порядок подключения и правила безопасного редактирования.

В продукте «1С-Битрикс: Управление сайтом» шаблоны хранятся в файловой системе на сервере, а не в базе данных. Основные места — каталоги /bitrix/templates/ и /local/templates/ в корне сайта. Именно там лежат файлы header.php, footer.php, styles.css и другие ресурсы, формирующие внешний вид страниц.

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

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

Где находятся шаблоны сайта: структура папок

Шаблон сайта — это набор файлов, отвечающих за общий каркас страниц: шапку, подвал, подключение стилей и скриптов. Физически он располагается в одной из двух директорий корня сайта:

  • /bitrix/templates/название_шаблона/ — шаблоны из дистрибутива и установленные решения из маркетплейса;
  • /local/templates/название_шаблона/ — рекомендуемое место для собственных и доработанных шаблонов.

Внутри папки шаблона обычно находятся файлы header.php (верхняя часть страницы), footer.php (нижняя часть), styles.css и template_styles.css (стили), script.js (скрипты), description.php (название и описание шаблона, видимые в админке), а также служебные папки images, components, page_templates.

Папка /local/ существует не всегда — она создаётся вручную или появляется после установки некоторых решений. Если шаблон сайта разработан подрядчиком, ищите его в первую очередь в /local/templates/: правильно организованный проект не хранит пользовательский код в /bitrix/.

Как узнать, какой шаблон используется на странице

Самый быстрый способ — посмотреть настройки сайта в административной части. Откройте Настройки → Сайты → Список сайтов, выберите нужный сайт и прокрутите до блока «Шаблон сайта». Там перечислены шаблоны и условия их применения: например, один шаблон для всех страниц, другой — для раздела с определённым URL.

Второй способ — включить режим правки на публичной странице (кнопка «Разработка» или панель вверху сайта) и навести курсор на область компонента. Битрикс покажет подсказку с полным путём к шаблону компонента. Это особенно удобно, когда нужно понять, какой файл отвечает за конкретный блок на странице.

Третий способ — посмотреть исходный код страницы в браузере. В HTML часто встречаются пути вида /bitrix/templates/main_styles.css?... или подключения из /local/templates/... — по ним видно имя активного шаблона.

Порядок действий
  1. 1
    Войдите в админку и откройте Настройки → Сайты → Список сайтов.
  2. 2
    Откройте нужный сайт и посмотрите блок «Шаблон сайта»: там указано имя шаблона и условие применения.
  3. 3
    Подключитесь к серверу по FTP/SFTP или через файловый менеджер хостинга.
  4. 4
    Проверьте папку /local/templates/имя_шаблона/ — если её нет, откройте /bitrix/templates/имя_шаблона/.
  5. 5
    Убедитесь, что внутри есть header.php и footer.php — это подтверждает, что папка найдена верно.

Где находятся шаблоны компонентов

Компоненты (каталог товаров, новости, формы, меню) имеют собственные шаблоны, которые определяют HTML-разметку конкретного блока. Шаблон компонента может находиться в трёх местах, и Битрикс ищет их в определённом порядке приоритета:

  1. /local/templates/имя_шаблона_сайта/components/пространство_имён/компонент/шаблон/ — скопированный и доработанный шаблон внутри шаблона сайта;
  2. /local/components/пространство_имён/компонент/templates/шаблон/ — для собственных компонентов;
  3. /bitrix/components/пространство_имён/компонент/templates/шаблон/ — системный шаблон по умолчанию.

Например, шаблон «bootstrap_v4» компонента «Новости» (bitrix:news), скопированный в шаблон сайта main, будет лежать по пути /local/templates/main/components/bitrix/news/bootstrap_v4/. Внутри — папки для каждой страницы комплексного компонента и файлы .php с разметкой.

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

Шаблоны печатных форм и почтовых шаблонов

Отдельная категория — шаблоны, которые не лежат в папках templates. Почтовые шаблоны (письма о заказах, регистрации, восстановлении пароля) хранятся в базе данных и редактируются через админку: Настройки → Почтовые события → Почтовые шаблоны. Там задаются тема, текст письма и доступные макроподстановки.

Шаблоны печатных форм документов (счета, акты в модуле интернет-магазина) настраиваются в разделе Магазин → Настройки → Печатные формы либо через обработчики платёжных систем. Файлы таких форм могут находиться в папках соответствующих модулей и обработчиков.

Шаблоны страниц и включаемых областей, которые контент-менеджер выбирает при создании новой страницы, лежат в папке page_templates внутри шаблона сайта, а глобальные — в /bitrix/modules/fileman/templates/ и в /local/php_interface/ при переносе через настройки модуля «Управление структурой».

Условия применения нескольких шаблонов

На одном сайте может работать несколько шаблонов одновременно. В настройках сайта для каждого шаблона задаётся условие: без условия (шаблон по умолчанию), для раздела или страницы (по маске URL), по параметру в адресной строке, по типу устройства через PHP-выражение.

Типичный сценарий: основной шаблон без условия, упрощённый шаблон для страницы оформления заказа (условие «для папки или файла» = /personal/order/) и пустой шаблон для страниц, выводимых во всплывающих окнах. Порядок строк в списке важен — Битрикс проверяет условия сверху вниз и применяет первое подошедшее.

Безопасное редактирование и типичные ошибки

Перед любыми правками сделайте копию изменяемых файлов или полную резервную копию сайта штатным средством Битрикса. Редактировать файлы лучше через IDE с подключением по SFTP, а не через встроенный файловый менеджер админки — он не сохраняет историю изменений и при ошибке в синтаксисе PHP можно получить неработающий сайт.

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

Типичные ошибки
01
Правка системных файлов в /bitrix/ — изменения затираются обновлением, а сайт перестаёт корректно обновляться.
02
Копирование шаблона компонента вручную с нарушением структуры папок — Битрикс не находит шаблон и молча использует системный.
03
Правка не того шаблона: на сайте несколько шаблонов с условиями, и изменён неактивный. Проверяйте условия в настройках сайта.
04
Забытый сброс кеша — кажется, что правка не сработала, и вносятся лишние изменения.
05
Изменение header.php без бэкапа с синтаксической ошибкой — сайт полностью падает с белым экраном.
Контрольные точки

Как проверить результат

Путь к файлу в подсказке режима правки
Норма

Указан путь в /local/templates/ с вашим шаблоном

Тревожный признак

Путь ведёт в /bitrix/components/ — правится системный шаблон

Внешний вид страницы после правки
Норма

Изменения видны гостю в режиме инкогнито после сброса кеша

Тревожный признак

Изменения видны только администратору или не видны вовсе

Обновление системы
Норма

После обновления правки сохранились

Тревожный признак

Правки пропали — значит, редактировались файлы ядра

FAQ

Чем отличается папка /bitrix/templates от /local/templates?

В /bitrix/templates лежат шаблоны из дистрибутива и маркетплейса — они могут перезаписываться при обновлениях. Папка /local/templates предназначена для пользовательских шаблонов и не затрагивается обновлениями ядра. Для собственных доработок используйте только /local/.

Как найти шаблон, если нет доступа к серверу по FTP?

Используйте встроенный файловый менеджер: в админке откройте Контент → Структура сайта → Файлы и папки и перейдите в bitrix/templates или local/templates. Путь к активному шаблону подскажет режим правки на публичной странице или настройки сайта в разделе «Список сайтов».

Почему после правки файла шаблона на сайте ничего не изменилось?

Чаще всего виноват кеш: очистите его через Настройки → Автокеширование или кнопкой сброса на панели. Также проверьте, что правите именно активный шаблон (на сайте может быть несколько шаблонов с условиями), и что шаблон компонента не переопределён в другой папке с более высоким приоритетом.

Можно ли редактировать шаблоны прямо из админки?

Да, через Контент → Структура сайта → Файлы и папки есть встроенный редактор с подсветкой синтаксиса. Но он не хранит историю изменений: при ошибке в PHP-коде сайт может перестать открываться, и откатить правку будет нечем. Перед редактированием скачайте копию файла.

Где лежат шаблоны писем о заказах?

Почтовые шаблоны хранятся в базе данных, а не в файлах. Они редактируются в разделе Настройки → Почтовые события → Почтовые шаблоны. Для каждого типа события (новый заказ, смена статуса, регистрация) существует один или несколько шаблонов с макроподстановками вида #ORDER_ID#.

Что делать, если сайт «упал» после правки header.php?

Восстановите файл из резервной копии через FTP или файловый менеджер хостинга. Если копии нет, временно переключите сайт на другой шаблон в настройках (Настройки → Сайты), чтобы получить доступ к админке, затем исправьте синтаксическую ошибку — чаще всего это незакрытая скобка, кавычка или пропущенная точка с запятой.