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

Гибкая вставка кода в любые страницы и элементы контента

Модуль «Включаемый код» решает задачу, которая раньше требовала вмешательства разработчика: теперь любой код можно разместить прямо внутри текста новости, описания товара или в шаблоне компонента. Вам не нужно править файлы вручную или создавать сложные конструкции. Достаточно создать файл с произвольным PHP-кодом и вызвать его с помощью простой функции. Система сама подставит результат в нужное место, даже если страница закеширована. Это особенно полезно, когда надо быстро добавить интерактивный элемент — опрос, форму связи или кнопку «Мне нравится» — без переписывания шаблонов.

Демо-версия полностью функциональна в течение 30 дней. Вы можете оценить работу модуля на реальных задачах, прежде чем принимать решение о покупке. Никаких ограничений по функционалу в пробном периоде нет — все возможности доступны сразу.

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

Первый способ подходит для разработчиков: вы используете функцию CAskaronInclude::IncludeFile('file_name.php') в любом месте шаблона или компонента. Результат выполнения файла появится именно там, где стоит вызов. Важно, что это работает даже внутри закешированных областей — модуль корректно обрабатывает такие ситуации, не ломая кеш и не замедляя сайт.

Второй способ создан для редакторов и контент-менеджеров. Вы просто пишете в тексте новости или описании товара специальный комментарий, например, и содержимое указанного файла автоматически вставляется на это место. Никакого программирования — только текст. Однако стоит помнить, что при таком подходе вызов кода происходит в конце загрузки страницы. Если вам нужно, чтобы код выполнился раньше (например, для формирования заголовков или подключения стилей), используйте пару функций StartBuffer и PrintBuffer. Они позволяют управлять порядком выполнения и избежать конфликтов.

Работа с AJAX, стилями и скриптами без потери производительности

Модуль корректно обрабатывает подключение CSS-файлов, JavaScript и установку заголовков страницы. Даже если ваш включаемый код загружает стили или скрипты, страница не «сломается» — все ресурсы будут подключены в нужном порядке. Это критично для сложных компонентов, которые зависят от внешних библиотек.

Начиная с версии 2.0.0 модуль поддерживает встроенный AJAX во включаемых компонентах. Если вы используете AJAX_MODE => Y в компоненте (например, в «Текущем опросе» или блоке отзывов), он будет работать корректно прямо внутри вставленного кода. Никаких дополнительных настроек не требуется — модуль сам обрабатывает AJAX-запросы, сохраняя динамику страницы.

Готовые примеры для быстрого старта и расширения функционала

В составе решения вы найдете несколько рабочих примеров, которые можно сразу использовать на сайте: отображение текущей даты, голосование за рейтинг, баннер, опрос, форма обратной связи. Это не просто «рыба», а полностью рабочие блоки. Вы можете взять их за основу и адаптировать под свои задачи.

Кроме того, модуль поддерживает интеграцию с другими решениями из каталога Битрикс. Например, вы можете подключить «Честное голосование» или список отзывов о товаре — и они будут корректно работать внутри контента. Документация содержит конкретные примеры размещения таких компонентов, что заметно ускоряет разработку. Типичные сценарии: вставка кнопки «добавить в корзину» в список товаров, размещение комментариев на детальной странице, добавление сопутствующих товаров без правки шаблонов.

Ускорение разработки и удобство для команды

Модуль особенно полезен в проектах, где часть страниц закеширована, но требуется добавить динамические, некешируемые элементы. Раньше для этого приходилось переписывать логику кеширования или создавать отдельные компоненты. Теперь достаточно одного вызова функции — и модуль сам решает, как корректно вставить код в закешированный блок без потери производительности.

Для программистов это экономит часы работы: не нужно создавать новые шаблоны или править существующие. Для редакторов и контент-менеджеров — возможность самостоятельно добавлять сложные элементы (опросы, формы, виджеты) прямо в текст, не отвлекая разработчиков. Модуль становится мостом между технической и контентной частями сайта, позволяя каждому работать в своей зоне без лишних согласований.