Модуль «Включаемый код» предназначен для подстановки любого PHP-кода в любое место на сайте.
Модуль решает проблему подстановки какого-либо кода в шаблоны компонентов с включенным кэшированием.
Можно вставлять код прямо в текст элементов инфоблоков, сообщения блогов, уроков учебных курсов и т. д.
Страница решения в Маркетплейсе:
Работает на:
«1С-Битрикс: Управление сайтом» - любые редакции.
«1С-Битрикс: Корпоративный портал» - любые редакции.
Демо-версия полностью функциональная. Срок демо-периода 30 дней.
В составе решения есть готовые примеры:
- текущая дата,
- голосование за рейтинг,
- баннер,
- текущий опрос,
- голосование
- форма обратной связи.
Живой пример внутри текста! Это не картинка, а компонент, который вставлен с помощью модуля «Включаемый код»:
|
|
|
|
|
(Голосов: 295, Рейтинг: 3.69) |
Принцип работы:
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 или использует интерфейс Эрмитаж.
Инструменты отладки:
При вызове включаемого файла можно легко себя проверить, нажав кнопку на панели наверху:
При включенной отладке вы увидите, рядом с вызовом включаемого файла свой специальный комментарий и параметры, которые передаем:
Допускаются пробелы, знаки табуляции и переносы строк
Включаемый код |
Описание курса
| Пример использования включаемого кода
|