Включаемые области в 1С-Битрикс (IncludeFile)
Во время разработки сайта на 1С-Битрикс довольно часто возникает необходимость выводить один и тот же блок сразу в нескольких местах. Это могут быть номера телефонов, адреса, время работы, реквизиты компании, формы обратной связи или любые другие повторяющиеся элементы.
Конечно, можно просто копировать HTML-код в каждый шаблон. Но если потом потребуется изменить телефон или текст, придется искать все места, где он используется. Гораздо удобнее воспользоваться включаемыми областями.
Включаемая область представляет собой обычный PHP- или HTML-файл, который можно подключить в любом месте сайта через метод $APPLICATION->IncludeFile().
Создаем включаемую область
Для начала создайте папку, в которой будут храниться все включаемые области. Обычно ее размещают в корне сайта и называют include.
Название файлов может быть любым. Главное — придерживаться понятной структуры. Например:
include/
├── contacts.php
├── feedback.php
├── footer_text.php
├── worktime.php
└── phones.phpЧерез некоторое время это значительно упростит поддержку проекта.
Подключение включаемой области
Для вывода содержимого используется метод $APPLICATION->IncludeFile().
<?
$APPLICATION->IncludeFile(
SITE_DIR . "include/feedback_static.php",
Array(),
Array(
"MODE" => "php"
)
);
?>Что означает параметр MODE
Последний параметр определяет режим редактирования файла в административной панели.
text— обычный текст без HTML;html— HTML-редактор (используется чаще всего);php— позволяет размещать PHP-код внутри файла.
Если внутри включаемой области находится только HTML-разметка, достаточно использовать режим html. Если же планируется подключать компоненты, выполнять запросы или использовать условия, выбирайте режим php.
Что можно хранить во включаемых областях
Многие считают, что включаемые области подходят только для хранения небольших текстовых блоков. На самом деле туда можно вынести практически любой повторяющийся код:
- контактную информацию;
- баннеры;
- формы обратной связи;
- меню;
- повторяющиеся блоки шаблона;
- подключение компонентов Битрикс;
- любой PHP-код.
Например, в интернет-магазине можно вынести во включаемую область блок с информацией о доставке, контактах или рекламной акции и подключать его сразу в нескольких шаблонах.
Использование включаемых областей позволяет избавиться от дублирования кода и значительно упрощает поддержку сайта. Вместо поиска одинаковых блоков по десяткам файлов достаточно изменить содержимое одной включаемой области — изменения автоматически появятся везде, где она подключена.
Комментарии
Будем рады вашему мнению и вопросам по статье.