Как добавить шаблон в 1С-Битрикс

Шаблон в 1С-Битрикс (Управление сайтом) — это набор файлов, которые определяют внешний вид страниц: шапку, подвал, стили, скрипты и расположение областей вывода контента. Добавить шаблон можно двумя путями: установить готовое решение из Marketplace или скопировать файлы шаблона вручную в нужную директорию на сервере. Оба способа рабочие, но требуют разных действий и разной аккуратности.

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

Ниже разобраны оба способа добавления шаблона, его назначение сайту, подключение ресурсов и проверка результата. Инструкция актуальна для типовых редакций 1С-Битрикс: Управление сайтом.

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

Система ищет шаблоны в двух каталогах: /bitrix/templates/ (стандартное расположение) и /local/templates/ (рекомендуемое место для пользовательских доработок, которое не затрагивается при обновлениях платформы). Каждый шаблон — отдельная папка, имя которой становится его идентификатором в админке.

Минимальный состав шаблона: файлы header.php (шапка, всё до области контента) и footer.php (подвал). Обычно рядом лежат styles.css или template_styles.css, script.js, папка images, а также необязательный файл description.php с названием и описанием шаблона, которое отображается в административной панели.

Способ 1: установка шаблона (решения) из Marketplace

Самый простой путь — установить готовое решение через административный раздел. Перейдите в Marketplace → Каталог решений, найдите подходящий шаблон и нажмите «Установить». Система скачает файлы, установит решение и предложит мастер настройки: выбор цветовой схемы, структуры демо-данных и назначения сайту.

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

Способ 2: ручное добавление файлов шаблона

Если шаблон разработан отдельно (верстальщиком или вами), его нужно загрузить на сервер вручную. Подключитесь по FTP/SFTP или через файловый менеджер хостинга и создайте папку /local/templates/my_template/, где my_template — латинское имя без пробелов и спецсимволов.

1. 1
   Создайте папку /local/templates/my_template/ на сервере
2. 2
   Загрузите в неё header.php, footer.php, стили, скрипты и изображения
3. 3
   Добавьте description.php с именем и описанием шаблона
4. 4
   В админке откройте Настройки → Сайты → Шаблоны и убедитесь, что шаблон появился в списке
5. 5
   Назначьте шаблон сайту и очистите кеш

Файл description.php имеет простую структуру и задаёт отображаемое имя шаблона:

<?
$arTemplate = array(
"NAME" => "Мой шаблон",
"DESCRIPTION" => "Основной шаблон сайта",
);
?>

Внутри header.php обязательно должны быть вызовы служебных методов ядра: $APPLICATION->ShowHead() для вывода метатегов, стилей и скриптов, а также подключение пролога require($_SERVER["DOCUMENT_ROOT"]."/bitrix/header.php"); на публичных страницах. Без ShowHead() сломаются SEO-поля, административная панель и подключение ресурсов компонентами.

Назначение шаблона сайту

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

Условия позволяют показывать разные шаблоны в разных ситуациях: например, упрощённый шаблон для страницы оформления заказа (условие «для страницы или папки» /order/) или отдельный шаблон по параметру URL для печатной версии. Если условие не задано, шаблон применяется по умолчанию ко всему сайту.

Подключение стилей и скриптов внутри шаблона

Файл template_styles.css ядро подключает автоматически. Для остальных ресурсов используйте API в header.php, а не прямые теги с абсолютными путями — так ресурсы корректно попадут в объединённый и сжатый вывод при включённой оптимизации.

<?
use Bitrix\Main\Page\Asset;
Asset::getInstance()->addCss(SITE_TEMPLATE_PATH."/css/custom.css");
Asset::getInstance()->addJs(SITE_TEMPLATE_PATH."/js/main.js");
?>

Константа SITE_TEMPLATE_PATH всегда указывает на папку текущего активного шаблона, поэтому код не сломается при переименовании папки. Проверьте, что в настройках главного модуля (Настройки → Настройки продукта → Настройки модулей → Главный модуль) при необходимости включены объединение и сжатие CSS/JS — после их изменения кеш тоже нужно сбросить.

Проверка результата и очистка кеша

После назначения шаблона сбросьте кеш: кнопка на административной панели «Сбросить кеш» или раздел Настройки → Настройки продукта → Автокеширование. Затем откройте главную страницу и несколько внутренних разделов в режиме инкогнито, чтобы исключить влияние браузерного кеша.

Контрольные точки

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

Внешний вид страниц

Норма

Применяется новая шапка, подвал и стили

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

Старый дизайн или страница без стилей

Исходный код страницы

Норма

Пути к CSS ведут в папку нового шаблона

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

Ссылки на старую папку шаблона

Консоль браузера

Норма

Нет ошибок 404 для CSS/JS и ошибок JS

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

Файлы не найдены, скрипты падают

Админ-панель

Норма

Панель отображается и работает

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

Панель пропала — вероятно, нет ShowHead()

Если страница отображается без стилей, первым делом проверьте права на файлы и папки шаблона и корректность путей в исходном коде. Если пропала административная панель — почти наверняка в header.php отсутствует вызов $APPLICATION->ShowHead().

Типичные ошибки при добавлении шаблона

Отдельная частая ситуация — шаблон добавлен, но в списке шаблонов сайта его нет. Проверьте, что папка лежит именно в /local/templates/ или /bitrix/templates/, а не вложена глубже (например, распакован архив с лишним уровнем вложенности вида /local/templates/my_template/my_template/).

FAQ

Куда лучше загружать шаблон: в /bitrix/templates/ или /local/templates/?

Рекомендуется /local/templates/: эта папка предназначена для пользовательских доработок и не затрагивается при обновлениях платформы. Каталог /bitrix/ система считает своим и может перезаписать его содержимое.

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

Да. В настройках сайта на вкладке «Шаблон» добавьте несколько строк с условиями: «для страницы или папки», «по параметру URL» и другие. Срабатывает первое подходящее условие сверху вниз, поэтому строку без условия ставьте в конец списка.

Шаблон загружен, но не появляется в списке. Что проверить?

Убедитесь, что папка находится непосредственно в /local/templates/ или /bitrix/templates/ без лишней вложенности, имя папки написано латиницей без пробелов, а внутри есть header.php и footer.php. Затем обновите страницу настроек сайта.

Что делать, если после смены шаблона страницы открываются без стилей?

Сбросьте кеш Битрикс и браузера, проверьте в исходном коде пути к CSS-файлам, права доступа к папке шаблона и наличие ошибок 404 в консоли браузера. Часто причина — неверный путь или отсутствие файла template_styles.css.

Удалится ли старый шаблон после назначения нового?

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