Skip to content

Inplace SiteActives

With the help of Inplace SiteActives, dynamic content can be embedded into a web page without having to embed server site includes, a system service or an external template directly into an imperia document. All three components are now combined:
The SiteActive code is written directly into the document in which the dynamic content is to be displayed. The detour via an external template is not necessary. The settings that are normally made in the system service are also made directly in the document.

In addition, the SiteActive code now also allows you to access the context of the document in which it is executed. This opens up new ways of displaying your content:
For example, you may want to include all pages that are on the same category level. Or you can limit the evaluation to those pages that are thematically related. Either you can limit SiteActive to pages that are more up-to-date than the document in question.
In this process, the SiteActive code is executed on the spot.

Example for dynamic content

Configuring Inplace SiteActives#

  1. Start InplaceSiteActive with the following command: <!--SITEACTIVE-->
  2. Between the opening and closing of the inplace SiteActive command, create your SiteActive template. You pass the settings that you would normally make in the system service directly as parameters in the statement.
    Example:
    <!--SITEACTIVE:VERIFY-CATEGORY=/2/125:CATEGORY=/2/125-->
    <IMPERIA lang=perl>     
        # SiteActive-Anweisungen
    </IMPERIA>  
<!--/SITEACTIVE-->

Possible parameters#

The following table gives you an overview of the possible parameters. The SiteActive parameters are separated by a colon.

Parameter Description
VIEW=1 (optional) Use this parameter to specify that your SiteActive template is to be rendered in the view language.
TEMPLATE=myfolder/teaser.html (optional) This parameter specifies where to find the SiteActive template. Without a "/" in front of "myfolder", the template is searched under site/siteactives/myfolder. As soon as a "/" precedes "siteactives", the template is searched under "htdocs/myfolder".
VERIFY-REALM=Autor SiteActive will run if there is a new document that contains an Autor domain tag, or a document from that domain has been reparsed.
VERIFY-TAG=Mustermann SiteActive runs as soon as a new document is created with the Mustermann tag or an old document is reparsed.
VERIFY-CATEGORY=/2/125 SiteActive runs as soon as a new document is created in the "/2/125" category or an old document is reparsed.
VERIFY-DOCUMENT=/1/2 SiteActive will run once the "/1/2" document has been modified.

For additional SiteActive parameters, see System Services Within the SiteActive statement, you can now write your SiteActive template code. You can read more about how to create SiteActive templates in the SiteActives chapter.