------
Модуль позволяет вставлять любой код в любой текст.
1. Создайте включаемый файл file_name.php с произвольным кодом.
2. Напишите где-нибудь:
<?CAskaronInclude::IncludeFile("file_name.php");?> |
4. Вместо CAskaronInclude::IncludeFile можете написать текст (например, в тексте новости или в описании товара):
<!--askaron.include file_name.php --> |
5. Способ выше позволяет вставить включаемый код, но при этом нарушается порядок выполнения кода страницы, потому что вызов включаемого кода происходит в конце страницы. Чтобы сделать вызов включаемого кода не в конце работы страницы, а раньше, используйте пару StartBuffer и PrintBuffer.
<?CAskaronInclude::StartBuffer();?> ... <? вызов компонента, внутри которого кешируется шаблон, и внутри шаблона вызвать CAskaronInclude::IncludeFile("file_name.php"); ?> ... <?CAskaronInclude::PrintBuffer();?> |
Редактор сайта может вставлять любой код в контент. Например, баннер или голосование прямо в текст новости.
Программист может, например, в список товаров быстро вставить компонент "Мне нравится" или кнопку "добавить в корзину / товар в корзине".
Типичная задача - вставить в детальную страницу товара список комментариев или список сопутствующих товаров.
Заметно ускоряется разработка там, где в компонент с включенным кешем надо добавить некешируемую область.
Модуль корректно работает даже, если ваш код подключает какие-либо стили, js-файлы, устанавливает заголовки и свойства страницы.
В составе решения есть готовые примеры:
- текущая дата,
- голосование за рейтинг,
- баннер
- текущий опрос
- голосование
- форма обратной связи.
Другие модули могут добавлять дополнительные примеры, например, «Честное голосование»:
https://ox8.ru/catalog/detail/askaron.ibvote/
С версии 2.0.0 корректно работает встроенный ajax во включаемых компонентах ("AJAX_MODE" => "Y"). Например, комплексный компонент «Текущий опрос» или отзывы о товаре.
Статьи в документации об использовании «Включаемого кода»:
- для размещения компонента «Список отзывов для товара»:
- для размещения компонента «Честное голосование»
Документация по модулю «Включаемый код»:
https://askaron.ru/api_help/course1/chapter041/