|
|
Принцип работы модуля:
Вы создаете включаемый файл и размещаете где-нибудь на странице специальный комментарий:
<!--askaron.include
file_name.php
-->
Модуль найдет этот текст и вызовет включаемый и файл в конце выполнения страницы. Результат выполнения включаемого файла поставится вместо вашего комментария.
Класс CAskaronInclude
Функция
void CAskaronInclude::IncludeFile( string $file, array $arParams = array() )
Функция пишет на странице специальный комментарий, вместо которого потом будет подключен включаемый файл.
Функция серьезно облегчает работу по размещению комментария в тексте сайта, чтобы не писать его вручную и не вспоминать формат:
<!--askaron.include
file_name.php
-->
Имя функции и параметры специально напоминают метод $APPLICATION->IncludeFile.
Когда файл подключится, в него точно так же передается массив $arParams.
Пример:
<?CAskaronInclude::IncludeFile(
"file_name.php",
array(
"IBLOCK_ID" => "3",
"ELEMENT_ID" => "15",
)
);?>
напишет на странице аналог для подстановки:
<!--askaron.include
file_name.php
<PARAMS>
<IBLOCK_ID>3</IBLOCK_ID>
<ELEMENT_ID>15</ELEMENT_ID>
</PARAMS>
-->
Функция
void CAskaronInclude::StartBuffer()
Начинает буферизацию вывода. Работает вместе с функцией CAskaronInclude::PrintBuffer.
Функция
void CAskaronInclude::PrintBuffer()
Заканчивает буферизацию вывода. Выводит содержимое на экран. При этом содержимое разбирает и вызывает включаемые файлы в нужных местах (где был специальный комментарий или вызывалась CAskaronSettings::IncludeFile).
Функцию следует использовать, если надо сразу вывести включаемые файлы и не дожидаться событий окончания страницы.
События окончания страницы срабатывают всегда, но иногда происходят ошибки. Ошибки могут быть при подключении включаемых компонентов в режиме AJAX ("AJAX_MODE" => "Y"), или при выводе кнопок интерфейса эрмитаж.
Если на странице сразу вызвать CAskaronInclude::StartBuffer() и CAskaronInclude::PrintBuffer() отложенные функции Битрикса сработают, как надо.
Формат для подключения включаемых файлов |
Описание курса
| Безопасность
|