The list of available positions where you can insert a [[module]] is controlled by the [[template]] you are using. It is possible to add new positions to a template. In this example, we will add a new position to the default rhuk_milkyway template. Here are the steps.

+

+

== Preface ==

+

The list of available positions where you can insert a [[module]] is controlled by the [[template]] you are using. It is possible to add new positions to a template.

+

+

== Joomla! 2.5 {{JVer|2.5}} ==

+

=== Inserting the code ===

+

*Open the index.php file of the Template you wish to edit

+

*Locate the place in the Template where you wish to put the new position.

+

*Insert

+

<jdoc:include type="modules" name="newposition" />

+

*The variable can be used (between existing <div></div> tags) to replace an image by replacing the ''<img src="xxx" border="0" alt="">''. Or By creating a new <div></div> tag with its own class/id.

+

*Open the Template's TemplateDetails.xml file and locate the

+

<positions></positions> Start and end tags

+

*Then add

+

<position>newposition</position>

+

*Example

+

<source lang="xml">

+

<positions>

+

<position>debug</position>

+

<position>position-0</position>

+

<position>position-1</position>

+

<position>position-2</position>

+

<position>position-3</position>

+

<position>position-4</position>

+

<position>position-5</position>

+

<position>position-6</position>

+

<position>position-7</position>

+

<position>position-8</position>

+

<position>position-9</position>

+

<position>position-10</position>

+

<position>position-11</position>

+

<position>position-12</position>

+

<position>position-13</position>

+

<position>position-14</position>

+

<position>position-15</position>

+

<position>newposition</position>

+

</positions>

+

</source>

+

+

=== Viewing the changes ===

+

With Joomla 2.5 to see all of the existing template locations in your browser edit the Template manager options.[[File:Template_manager_options.png|left|Template manager options]]

+

+

+

+

+

+

+

+

+

+

+

+

+

+

Then append "?tp=1",to the end of your normal URL (for example, <nowiki>"http://www.yoursite.com/?tp=1"</nowiki>).

+

+

+

+

== Joomla! 1.5 {{JVer|1.5}} ==

+

In this example, we will add a new position to the default rhuk_milkyway template. Here are the steps.

*Open the file "<your Joomla! home>/templates/rhuk_milkyway/index.php" for editing and determine where your new position will be on the page. Note that you can see all of the existing template locations in your browser by adding "?tp=1" to the end of your normal URL (for example, <nowiki>"http://www.yoursite.com/?tp=1"</nowiki>).

*Open the file "<your Joomla! home>/templates/rhuk_milkyway/index.php" for editing and determine where your new position will be on the page. Note that you can see all of the existing template locations in your browser by adding "?tp=1" to the end of your normal URL (for example, <nowiki>"http://www.yoursite.com/?tp=1"</nowiki>).

*In our example, we will add a new location after the "breadcrumb" position called "mynewposition". To do this, find the line in the file <code><nowiki><div id="whitebox"></nowiki></code> and insert a new line <code><jdoc:include type="modules" name="mynewposition" /></code> as shown below:

*In our example, we will add a new location after the "breadcrumb" position called "mynewposition". To do this, find the line in the file <code><nowiki><div id="whitebox"></nowiki></code> and insert a new line <code><jdoc:include type="modules" name="mynewposition" /></code> as shown below:

Line 40:

Line 99:

[[Image:New_template_position1.png]]

[[Image:New_template_position1.png]]

−

=== Joomla! 1.0 {{JVer|1.0}} ===

−

−

To create a "new" position, choose one of the names from the list of positions shown in Site > [[Template Manager]] > Module Positions.

−

[[Category:FAQ]]

+

<noinclude>

−

[[Category:Template FAQ]]

+

[[Category:Template Development]]

−

[[Category:Version 1.0 FAQ]]

+

[[Category:Template Development]]

−

[[Category:Version 1.5 FAQ]]

+

[[Category:Template Development FAQ]]

+

[[Category:Modules]]

+

</noinclude>

Latest revision as of 21:21, 21 June 2013

This article is for Joomla! CMS Version(s)

Split Page into Specific Joomla! Versions - J2.5 and J3.1

It has been suggested that this article or section be split into specific version Namespaces. (Discuss). If version split is not obvious, please allow split request to remain for 1 week pending discussions. Proposed since 19 months ago.

Viewing the changes

With Joomla 2.5 to see all of the existing template locations in your browser edit the Template manager options.

Then append "?tp=1",to the end of your normal URL (for example, "http://www.yoursite.com/?tp=1").

Joomla! 1.5

In this example, we will add a new position to the default rhuk_milkyway template. Here are the steps.

Open the file "<your Joomla! home>/templates/rhuk_milkyway/index.php" for editing and determine where your new position will be on the page. Note that you can see all of the existing template locations in your browser by adding "?tp=1" to the end of your normal URL (for example, "http://www.yoursite.com/?tp=1").

In our example, we will add a new location after the "breadcrumb" position called "mynewposition". To do this, find the line in the file <div id="whitebox"> and insert a new line <jdoc:include type="modules" name="mynewposition" /> as shown below: