Chunk

Difference between revisions of "Module Position"

From Joomla! Documentation

m (update)
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Module positions==
+
==Understanding Module Positions==
 
Module positions are placeholders in a [[template]]. They identify positions within the template and tell the Joomla! application where to place output from modules assigned to a particular position. The template designer has complete control over module positions, creating variations between templates and the respective Joomla! default positions assigned to modules in the installation sample data.
 
Module positions are placeholders in a [[template]]. They identify positions within the template and tell the Joomla! application where to place output from modules assigned to a particular position. The template designer has complete control over module positions, creating variations between templates and the respective Joomla! default positions assigned to modules in the installation sample data.
  
 
For example, the module position '''Left''' could be defined to be on the left side of the template to display a site navigation menu. So if a module is assigned the '''Left''' position, it will be displayed wherever the designer puts that '''Left''' module position - not necessarily the left side of the page.
 
For example, the module position '''Left''' could be defined to be on the left side of the template to display a site navigation menu. So if a module is assigned the '''Left''' position, it will be displayed wherever the designer puts that '''Left''' module position - not necessarily the left side of the page.
  
 +
===Visualization===
 +
It's possible to visualize all modules set on a template by calling the <code>"tp=1"</code> query string on the front-end.
 +
<pre>
 +
http://www.example.com/index.php?tp=1
 +
</pre>
  
Since '''Joomla 1.5''' {{JVer|1.5}} you can see what positions are available in the template you are using by adding either ?tp=1 or &tp=1 to the end of the URL in the frontend.
+
'''Joomla 2.5''' {{JVer|2.5}} and '''Joomla 3.x''' {{JVer|3.x}} will show the template positions with ?tp=1 or &tp=1 if the '''Preview Module Positions mode''' in the Template Manager has been '''Enabled''':  
 
+
*{{rarr|Extensions,Template Manager}} then click the Options button in the toolbar.
'''Joomla 2.5''' {{JVer|2.5}} and newer will only show the template positions with ?tp=1 or &tp=1 if the '''Preview Module Positions mode''' in the Template Manager has been '''enabled''':  
+
*Under the '''Templates Tab''', make sure <u>''Preview Module Positions''</u> is set to '''Enabled'''.
Extensions > Template Manager > Options (upper right corner) > (templates tab) Preview Module Positions: Enabled.
 
 
<noinclude>[[Category:Glossary definitions|{{PAGENAME}}]]__NOINDEX__</noinclude>
 
<noinclude>[[Category:Glossary definitions|{{PAGENAME}}]]__NOINDEX__</noinclude>

Revision as of 17:12, 29 September 2013

Understanding Module Positions[edit]

Module positions are placeholders in a template. They identify positions within the template and tell the Joomla! application where to place output from modules assigned to a particular position. The template designer has complete control over module positions, creating variations between templates and the respective Joomla! default positions assigned to modules in the installation sample data.

For example, the module position Left could be defined to be on the left side of the template to display a site navigation menu. So if a module is assigned the Left position, it will be displayed wherever the designer puts that Left module position - not necessarily the left side of the page.

Visualization[edit]

It's possible to visualize all modules set on a template by calling the "tp=1" query string on the front-end.

http://www.example.com/index.php?tp=1

Joomla 2.5 Joomla 2.5 and Joomla 3.x Joomla 3.x will show the template positions with ?tp=1 or &tp=1 if the Preview Module Positions mode in the Template Manager has been Enabled:

  • Extensions  Template Manager then click the Options button in the toolbar.
  • Under the Templates Tab, make sure Preview Module Positions is set to Enabled.