|
|
| (4 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | {{version|1.5,2.5}}{{JSplit}} | + | <noinclude><languages /></noinclude> |
| | + | {{Joomla version list/<translate><!--T:1--> en</translate>}} |
| | | | |
| − | == Preface ==
| + | {{other versions/navbox/<translate><!--T:2--> en</translate>| <translate><!--T:3--> The '''How do you add a new module position''' Tutorial is available in these versions:</translate>-| version}} |
| − | 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>).
| |
| − | *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:
| |
| − | | |
| − | <source lang="html4strict">
| |
| − | <div id="pathway">
| |
| − | <jdoc:include type="modules" name="breadcrumb" />
| |
| − | </div> | |
| − | <div class="clr"></div>
| |
| − | <div id="whitebox">
| |
| − | <jdoc:include type="modules" name="mynewposition" />
| |
| − | <div id="whitebox_t">
| |
| − | </source>
| |
| − | | |
| − | *Open the file "<your Joomla! home>/templates/rhuk_milkyway/templateDetails.xml" for editing and find the "<positions>" section of the file. Add the new entry for "mynewposition" as shown below:
| |
| − | <source lang="xml">
| |
| − | <positions>
| |
| − | <position>breadcrumb</position>
| |
| − | <position>left</position>
| |
| − | <position>right</position>
| |
| − | <position>top</position>
| |
| − | <position>user1</position>
| |
| − | <position>user2</position>
| |
| − | <position>user3</position>
| |
| − | <position>user4</position>
| |
| − | <position>footer</position>
| |
| − | <position>debug</position>
| |
| − | <position>syndicate</position>
| |
| − | <position>mynewposition</position>
| |
| − | </positions>
| |
| − | </source>
| |
| − | | |
| − | Now, when you look at your site with the "?tp=1" URL, you should see the new position as shown below:
| |
| − | | |
| − | [[Image:New_template_position2.png]]
| |
| − | | |
| − | In the Module:[Edit] screen, the new position should display in the drop-down list box of available positions, as shown below.
| |
| − | | |
| − | [[Image:New_template_position1.png]]
| |
| − | | |
| − | | |
| − | <noinclude>
| |
| − | [[Category:Version 1.5 FAQ]]
| |
| − | [[Category:Template Development]]
| |
| − | [[Category:Template Development]]</noinclude>
| |
