Layout reference

You can customize the functionality and appearance of modules by editing their corresponding layouts. To make it easier to understand the concept, layouts are for modules what templates are for webpages.

Each individual module is rendered using one or in some cases more layouts.

Using tags

Tags are used inside Module templates or layouts and represent the data associated to a module, for example the "News" module can be rendered using 2 different layouts:

  • When you are viewing the list of news items you will be using the "List" layout which has a set of tags like {tag_subject} which outputs a hyperlink that takes you to the detail view, {tag_eventfromdate} which outputs the start date of the event
  • When you are viewing the news item itself the system will use the "Detail" layout which has its own set of possible tags.

Each layout has its own set of tags, you can think of tags as the properties for a particular item, for example a blog has a title, a body, a blog author and so on. Each of these properties is represented by a tag - {tag_blogtitle}, {tag_description} and {tag_blogpostauthor}.

Note: Tags are not transferrable, and cannot be shared across all modules. Each module has its own layouts which can contain only their own tags.

Even more layouts

Most modules have a fixed set of layouts they can use, for example the "list" or "detail" layout, each with its own set of tags.

Some modules though, can use custom templates (or custom layouts), this means you can create a layout of your own and configure the module to use this custom tag you have created, for example:

{module_productresults,2,_self,2,,,true template="/layouts/custom/productfeaturelist.tpl"} - this renders the product results using the default product list layout while using {module_productresults,2,_self,2,,,true template="/layouts/custom/productfeaturelist.tpl"} renders the same module using your own custom template. If your custom template cannot be found (it does not exist for example) the system defaults back to the List layout.

Please see the Custom templates (layouts) article for more information on how to use this feature and a list of modules support custom layouts.