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

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

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


Описание 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" 
	)
);?>


Пользовательские комментарии

Помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
6
Алена Манчукова
Для примера:

<?$APPLICATION->IncludeComponent("bitrix:main.include","",Array(
       "AREA_FILE_SHOW" => "page",
       "AREA_FILE_SUFFIX" => "example",
       "EDIT_TEMPLATE" => ""
   )
);?>

Это означает, что для определенной страницы "page" будет показан файл с названием "index_example.php" (index в названии файла обязателен, т.к. компонент не будет находить файл )
© «Битрикс», 2001-2025, «1С-Битрикс», 2025
Наверх