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

Битрикс: вставка включаемой области

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

Компонент стандартный, в визуальном редакторе находится по адресу Служебные - Включаемые области - Вставка включаемой области.

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

Код вызова компонента без настроек:

<?$APPLICATION->IncludeComponent(
	"bitrix:main.include",
	"",
	Array(
	)
);?>

Рассмотрим самые актуальные случаи использования компонента.

Выводим содержимое включаемой области из файла в шаблон сайта

Типичный пример - вывод контактов и времени работы на сайте.

Создаем папку include в корне сайта. В папке создаем файл contact.php. Добавляем в него нужную информацию с контактами. Редактируем параметры компонента, получаем такой код:

<?$APPLICATION->IncludeComponent(
  "bitrix:main.include",
  "",
  Array(
    "AREA_FILE_SHOW" => "file", //Показывать информацию из файла
    "AREA_FILE_SUFFIX" => "",
    "EDIT_TEMPLATE" => "",
    "PATH" => "/include/contact.php" //Указываем путь к файлу
  )
);?>

Этот код необходимо вставить в нужное место в шаблоне сайта. К примеру, сделаем вывод этих контактов в шапке сайта на всех страницах. В нужном месте header.php в папке с шаблоном сайта вставляем код и сохраняем.

Можно сделать все настройки используя визуальный редактор.

После этого разместить код вызова компонента в нужном месте шаблона сайта.

Выводим содержимое включаемой области в заданных разделах сайта

Допустим требуется вывести разные телефоны для 2 разделов.

Первый раздел имеет каталог /fizicheskie-lica, второй раздел /juridichiskie-lica.

Настраиваем компонент следующим образом:

<?$APPLICATION->IncludeComponent(
	"bitrix:main.include", 
	".default", 
	array(
		"AREA_FILE_SHOW" => "sect", //Показывать включаемую область для раздела
		"AREA_FILE_SUFFIX" => "phone_inc", //Суффикс имени файла включаемой области
		"EDIT_TEMPLATE" => "",
		"PATH" => "",
		"AREA_FILE_RECURSIVE" => "Y" //Рекурсивное подключение включаемых областей разделов
	),
	false
);?>

Чтобы не запутаться в названиях, в суффикс включ. области добавим слово phone, т.к. в будущем количество файлов в каталогах может вырасти.

Теперь создаем файлы с именем sect_phone_inc.php со своими индивидуальными номерами телефонов в разделах /fizicheskie-lica и /juridichiskie-lica.

Теперь при открытии этих разделов будет показано разное содержимое из разных подключаемых файлов.

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

Более короткая запись с использованием метода IncludeFile

Аналогично. Метод IncludeFile служит для подключения файлов. Пример записи:

$APPLICATION->IncludeFile(SITE_DIR."inc/file.php",Array(),Array("MODE"=>"html"));