Включаемые области: настройка и использование

Включаемая область — это отдельный файл с фрагментом контента, который подключается к странице или разделу и редактируется независимо от основного текста. Это удобный способ вынести баннеры, промо-блоки, контакты и подписи в единое редактируемое место.

Что такое включаемая область

Включаемая область — это небольшой самостоятельный файл, содержимое которого выводится внутри страницы через компонент bitrix:main.include. Основной шаблон или страница остаются неизменными, а редактор правит только сам блок.

Типичные сценарии применения:

• рекламные и промо-баннеры, которые повторяются в нескольких разделах;
• текстовые блоки под меню, в подвале или боковой колонке;
• контактная информация, реквизиты, телефоны;
• заголовки, вводные абзацы и подписи, единые для целого раздела.

Главное преимущество — разделение труда: программист один раз размещает компонент в шаблоне, а контент-менеджер правит содержимое через удобную визуальную кнопку, не трогая код.

Два типа областей: для страницы и для раздела

В 1С-Битрикс включаемые области бывают двух видов, и различие между ними принципиально:

Тип	Имя файла	Где действует
Для страницы	имя_страницы_ext.php	Только на конкретной странице
Для раздела	sect_include.php	На всех страницах раздела и вложенных подразделов

Область для страницы создаётся рядом с файлом страницы: например, для about.php это будет about_ext.php. Область для раздела подключается по цепочке — Битрикс ищет файл sect_include.php в текущей папке, а если не находит, поднимается на уровень выше, вплоть до корня сайта.

Такое наследование позволяет задать общий блок для всего раздела и при необходимости переопределить его в отдельной вложенной папке.

Размещение компонента в шаблоне или на странице

Чтобы область появилась, нужно вывести компонент bitrix:main.include в нужном месте. Обычно это делает разработчик в шаблоне сайта, но менеджер тоже может добавить его через визуальный редактор.

1. Откройте страницу или шаблон в режиме редактирования (визуальный редактор или PHP-код).
2. На вкладке компонентов найдите раздел Служебные → Подключение области.
3. Перетащите компонент main.include в нужное место.
4. В настройках выберите тип области — для страницы или для раздела, при необходимости укажите суффикс имени файла и режим «показывать кнопку редактирования».
5. Сохраните изменения.

Ключевые параметры компонента:

• AREA_FILE_SHOW — что подключать: page, sect или конкретный file;
• AREA_FILE_SUFFIX — суффикс для файла страницы (по умолчанию inc или ext);
• EDIT_TEMPLATE — шаблон-заготовка, который создаётся при первом редактировании пустой области.

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

Самый быстрый способ работы с включаемыми областями — прямо на сайте в режиме правки. Отдельная кнопка появляется рядом с областью.

1. Войдите в публичную часть под администратором и включите режим правки на административной панели.
2. Наведите курсор на включаемую область — вокруг неё появится рамка и кнопка с шестерёнкой.
3. Выберите Изменить область — откроется визуальный редактор с содержимым файла.
4. Отредактируйте текст и картинки, при необходимости переключитесь на HTML-код.
5. Нажмите Сохранить — изменения сразу отобразятся на всех страницах, где подключена область.

Если область ещё не создана, кнопка предложит Добавить область: Битрикс создаст файл по заготовке из параметра EDIT_TEMPLATE и откроет его на редактирование.

Создание области вручную через файловую систему

Иногда область удобнее создать напрямую — например, при переносе сайта или массовой правке. Файлы включаемых областей лежат рядом с обычными страницами.

1. Перейдите в Контент → Структура сайта → Файлы и папки.
2. Откройте нужную папку раздела.
3. Создайте файл: для раздела — sect_include.php, для страницы — <имя>_ext.php (суффикс зависит от настроек компонента).
4. Внесите содержимое как обычный HTML или PHP-фрагмент — без служебного пролога и подвала, только сам блок.
5. Сохраните файл и проверьте вывод на странице.

Внутри файла можно использовать не только текст, но и другие компоненты, PHP-код и вызовы API — область обрабатывается как обычный подключаемый PHP-файл.

Частые ошибки

Наиболее распространённые проблемы при работе с включаемыми областями:

• Область не отображается. Проверьте, что компонент main.include действительно выведен в нужном месте страницы или шаблона, а тип области (page/sect) совпадает с именем созданного файла.
• Правки не видны на части страниц. Скорее всего, вы редактируете область для страницы, а не для раздела. Для общего блока используйте sect_include.php.
• Нет кнопки редактирования. Включите режим правки на административной панели и убедитесь, что в настройках компонента разрешён показ кнопки, а у пользователя есть права на изменение файлов.
• Дублирование блока. Файл sect_include.php есть сразу в нескольких вложенных папках — Битрикс берёт ближайший. Удалите лишний или оставьте только на нужном уровне.
• Ошибка PHP при выводе. В файле области размещён некорректный PHP-код. Помните, что содержимое подключается напрямую, поэтому синтаксическая ошибка ломает всю страницу.

Итог

Включаемые области — простой и надёжный механизм для вынесения повторяющихся блоков в отдельно редактируемые файлы. Запомните главное:

• область для страницы действует локально, область для раздела наследуется на все вложенные страницы;
• вывод обеспечивает компонент bitrix:main.include, размещённый в шаблоне или на странице;
• редактировать удобнее всего прямо в публичной части в режиме правки;
• файлы можно создавать и вручную через Структуру сайта.

Грамотное использование включаемых областей упрощает поддержку сайта и снимает с контент-менеджера необходимость лезть в шаблон.