Описание модуля
40 / 177
Модуль «Включаемый код» предназначен для подстановки любого PHP-кода в любое место на сайте. 

Модуль решает проблему подстановки какого-либо кода в шаблоны компонентов с включенным кэшированием.

Можно вставлять код прямо в текст элементов инфоблоков, сообщения блогов, уроков учебных курсов и т. д.

Страница решения в Маркетплейсе: 

Работает на: 
«1С-Битрикс: Управление сайтом» - любые редакции.
«1С-Битрикс: Корпоративный портал» - любые редакции.

Демо-версия полностью функциональная. Срок демо-периода 30 дней.

В составе решения есть готовые примеры:
- текущая дата,
- голосование за рейтинг,
- баннер,
- текущий опрос,
- голосование
- форма обратной связи.

Другие модули могут добавлять дополнительные примеры, например, «Честное голосование»:

Живой пример внутри текста! Это не картинка, а компонент, который вставлен с помощью модуля «Включаемый код»:

(Голосов: 200, Рейтинг: 3.58)


Принцип работы:

1. В папке /bitrix/php_interface/include/askaron.include/ создайте файл file_name.php с любым содержимым.

Допускается использовать папку local: /local/php_interface/include/askaron.include/

2. В любом месте сайта напишите специальный комментарий. Допускаются пробелы, знаки табуляции и переносы строк:

<!--askaron.include
file_name.php
-->


В конце работы страницы ваш текст <!--...--> заменится на результат работы включаемого файла.

3. Начиная с версии модуля 2.0.0 этот комментарий можно не писать. Рекомендуем вызвать функцию, которая напишет этот комментарий.

<?CAskaronInclude::IncludeFile("file_name.php");?>

Функция CAskaronInclude::IncludeFile похожа на $APPLICATION->IncludeFile, но работает отложенно и может использоваться в закешированных шаблонах.


4. Вы можете вызвать включаемый файл и передать в него параметры

<?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> 
 --> 


5. Во включаемом файле можно, размещать компоненты, подключать css- и javascript-файлы, устанавливать заголовок и свойства страницы. 

6. Выполнение включаемых файлов и подстановка результата происходит автоматически в конце работы страницы. Однако, можно использовать функции CAskaronInclude::StartBuffer() и CAskaronInclude::PrintBuffer() и вызвать включаемый файл раньше. Это бывает нужно, когда включаемый компонент работает в режиме AJAX или использует интерфейс Эрмитаж.



Инструменты отладки:

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

Отладка. Включаемый код

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

Результат отладки







Допускаются пробелы, знаки табуляции и переносы строк
0  


 Включаемый код | Описание курса | Пример использования включаемого кода