Container

A container is a markup element in a layout. It serves as a placeholder for a module that can be inserted using a template. Container is a systemwide ressource.

In order to add a new container to your layout, you have to add its markup right at the place, you later want to output dynamic content.

Container element

The syntax of a container is XML as follows:

<container id="ID" name="NAME">Default</container>

The container element can be configured with more, optional attributes.

Attribute name Description
id
requiredEach container needs a numeric ID, which has to be unique for the layout. This ID is important, so modules can be assigned clearly. Usually these IDs are multiples of ten so that additional container can be inserted afterwards without interfering with other containers.
name
requiredThe name of the container should be short and descriptive. It is displayed in the template overview to help you, where your module is assigned.
types
optionalThe attribute "types" may contain a comma separated list of module types. You then can only assign modules of the apropriate type(s) to this container.
default
optionalThe attribute "default" can contain the name of the module, which is assigned per default to this container.
mode
optionalThe "mode" parameter with the value "fixed" can fix the default module to the container, so no other modules can be assigned.

The "content" of the container element later gets replaced by the output of the module you have assigned to it. The content of this element is only displayed on the template preview page. This can be used to check the functionality of your layout and prevent errors.

Please check if this still is true

  • Both tags of the container element have to be located on the same line.
  • The ID attribute has to be the first attribute.