Includeable Code

What this solution does

The demo version of the module is fully functional and available for a 30-day trial period.

This module enables the integration of arbitrary PHP code into any text content on the site. To use it, create a .php file containing the required code and call the IncludeFile function at the desired location within a template or component. The output of the script will appear exactly where the function is invoked, even if that location is inside a cached component template.

An alternative method involves using a specific comment within a news article text or product description. When such a comment is present, the content of the specified file is inserted at that point. However, this approach has a limitation: the code executes at the end of page processing, which may disrupt the intended output order. To execute code at a specific point during page generation, use the StartBuffer and PrintBuffer function pair.

The module expands content editing capabilities. Editors can embed banners, voting forms, or other dynamic code directly into article text. Developers can quickly integrate components, such as 'Like' buttons or shopping cart elements, into product lists without modifying the core template logic.

This module is designed to insert dynamic blocks into static pages, such as comment lists or related product lists on a product detail page. It is particularly effective for adding non-cached elements to components with caching enabled, significantly speeding up development.

The solution functions correctly even when the included code connects external stylesheets, JavaScript files, or modifies page headers and properties.

The package includes ready-to-use component examples:

- current date display;

- rating voting;

- banner;

- current poll;

- feedback form.

Additional examples may be provided by third-party modules, such as the 'Fair Voting' component.

Starting from version 2.0.0, built-in AJAX is supported in included components when the AJAX_MODE parameter is set to Y. This allows dynamic elements like the 'Current Poll' complex component or product reviews to function correctly.

Further information is available in the module documentation and articles regarding the placement of specific components.

General iT can connect “Includeable Code”, install and configure the module, and make sure the integration works correctly.