Declaring module positions

From Joomla! Documentation

Revision as of 16:44, 22 September 2007 by Chris Davenport (talk | contribs) (New page: ===== Declaring module positions ===== In order for Module positions to be available for selection in the Module Manager they must be declared in the templateDetails.xml file for your tem...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
Declaring module positions[edit]

In order for Module positions to be available for selection in the Module Manager they must be declared in the templateDetails.xml file for your template. The <positions> element in this file contains sub-elements for each Module position that is supported by the template.

For example, here is a typical <positions> element in the templateDetails.xml file for a typical template.

<positions>
	<position>left</position>
	<position>right</position>
	<position>top</position>
	<position>user1</position>
	<position>user2</position>
	<position>user3</position>
	<position>user4</position>
</positions>

You can add and define new Module positions and give them any name you like, but it is recommended that you support at least those shown in the example above. This is so that some level of consistency is maintained when switching Templates or using multiple Templates on a single site.