Документация для разработчиков
Темная тема

Вставка включаемой области

Компонент располагается в шаблоне дизайна сайта и определяет место расположения включаемых областей страниц и разделов.


Описание main.include

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

В визуальном редакторе компонент расположен по пути: Служебные > Включаемые области > Вставка включаемой области.

Компонент относится к Главному модулю.



Параметры

Поле Параметр Описание
Показывать включаемую область AREA_FILE_SHOW Возможные значения:
  • sect — показывать для раздела, область будет являться включаемой для всего раздела,
  • page — показывать для страницы, область будет являться включаемой только для текущей страницы,
  • file — показывать информацию из файла. Если компонент расположить в шаблоне дизайна сайта, то информация из файла будет выводиться на всем сайте. Установка параметра доступна только пользователю с правами edit_php.
Путь к файлу области PATH Поле доступно, если выбрано Показывать включаемую область из файла. Задается полный путь от корня сайта к файлу с информацией, которую надо вывести в этой части сайта.
Суффикс имени файла включаемой области AREA_FILE_SUFFIX Поле предназначено для указания суффикса, который будет добавляться к именам файлов включаемых областей. Страницы с таким суффиксом будут восприниматься как включаемые области.
Рекурсивное подключение включаемых областей разделов AREA_FILE_RECURSIVE Настройка доступна, если в параметре AREA_FILE_SHOW выбрано значение sect (для раздела). Возможные значения:
  • Рекурсивный режим Y — если в текущем разделе нет файла области, система будет искать его в родительских разделах вплоть до корня сайта,
  • Нерекурсивный режим N — поиск файла области осуществляется только в текущем разделе.
Шаблон области по умолчанию EDIT_TEMPLATE Доступны все шаблоны страниц, созданные в системе. Они располагаются в разделе /bitrix/templates/.default/page_templates/. В данном поле можно указать любой другой файл в системе, указав полный путь к файлу-шаблону.


Пример вызова

<?$APPLICATION->IncludeComponent("bitrix:main.include","",Array(
		"AREA_FILE_SHOW" => "sect", 
		"AREA_FILE_SUFFIX" => "inc", 
		"AREA_FILE_RECURSIVE" => "Y", 
		"EDIT_TEMPLATE" => "standard.php" 
	)
);?>


© «Битрикс», 2001-2025, «1С-Битрикс», 2025