Классы и функции
45 / 178
Принцип работы модуля:

Вы создаете включаемый файл и размещаете где-нибудь на странице специальный комментарий:

<!--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() отложенные функции Битрикса сработают, как надо.



0  


 Формат для подключения включаемых файлов | Описание курса | Безопасность