A container is a markup element in a layout. It serves as a placeholder for a module that can be inserted using a template.
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 | required | Each container needs an ID, which is unique in the whole layout. This ID is important, so modules can be assigned clearly. |
name | required | The name of the container should be short and descriptive. It is displayed in the template overview to help you, where your module is assigned. |
mode | optional | The "mode" parameter with the value "fixed" can fix a module to its container, so no other modules can assigned to this container. |
types | optional | The attribute "types" can contain a comma separated list of module types, which only can be assigned to this container. |
default | optional | The attribute "default" can contain the name of the module, which is assigned per default to this container. |
The "content" of the container element later gets replaced by the module you have assigned to it. The content of this element is only displayed on the template preview page.