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

Разработчиком данного модуля является Аскарон системс

Описание
Установка
История
Техподдержка

Включает в себя: Модуль
Категории: Для разработчиков, Инструменты

Название компании-партнера: Аскарон системс
Последняя версия: 3.0.0
Дата обновления: 05.01.2023
Дата публикации: 27.08.2012
Число установок: 500 - 999 раз
Адаптивность: Да
Поддержка композита: Да
Совместимо с Сайты24: Нет

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

------

Модуль позволяет вставлять любой код в любой текст.

1. Создайте включаемый файл file_name.php с произвольным кодом.

2. Напишите где-нибудь:

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

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

4. Вместо CAskaronInclude::IncludeFile можете написать текст (например, в тексте новости или в описании товара):

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

Содержимое файла отобразится в том месте, где вы напишите комментарий.

5. Способ выше позволяет вставить включаемый код, но при этом нарушается порядок выполнения кода страницы, потому что вызов включаемого кода происходит в конце страницы. Чтобы сделать вызов включаемого кода не в конце работы страницы, а раньше, используйте пару StartBuffer и PrintBuffer.

<?CAskaronInclude::StartBuffer();?>
...
<?
вызов компонента, внутри которого кешируется шаблон, 
и внутри шаблона вызвать
CAskaronInclude::IncludeFile("file_name.php");
?>
...
<?CAskaronInclude::PrintBuffer();?>

Модуль предоставляет совершенно новые возможности:

Редактор сайта может вставлять любой код в контент. Например, баннер или голосование прямо в текст новости.

Программист может, например, в список товаров быстро вставить компонент "Мне нравится" или кнопку "добавить в корзину / товар в корзине".

Типичная задача - вставить в детальную страницу товара список комментариев или список сопутствующих товаров.

Заметно ускоряется разработка там, где в компонент с включенным кешем надо добавить некешируемую область.

Модуль корректно работает даже, если ваш код подключает какие-либо стили, js-файлы, устанавливает заголовки и свойства страницы.

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

Другие модули могут добавлять дополнительные примеры, например, «Честное голосование»:
https://www.webdebug.ru:443/marketplace/askaron.ibvote/

С версии 2.0.0 корректно работает встроенный ajax во включаемых компонентах ("AJAX_MODE" => "Y"). Например, комплексный компонент «Текущий опрос» или отзывы о товаре.

Статьи в документации об использовании «Включаемого кода»:
- для размещения компонента «Список отзывов для товара»:
- для размещения компонента «Честное голосование»

Документация по модулю «Включаемый код»:
http://askaron.ru/api_help/course1/chapter041/