| Excerpt |
|---|
| 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:
| Code Block |
|---|
|
<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 a numeric ID, which is has to be unique in for the whole 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 | 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 may contain a comma separated list of module types | , which only can be assigned . You then can only assign modules of the apropriate type(s) to this container. |
default | optional | The attribute "default" can contain the name of the module, which is assigned per default to this container. |
mode | optional | The "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.
| Note |
|---|
| title | 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.
|