Joomla! Documentation - User contributions [en]

DocType header for templates

2010-02-24T18:13:49Z

Arcturusweb:

=== Which DocType header to use ===

Current thinking is that XHTML 1.0 Transitional should be used for Joomla! templates.

{{:Recommended DocTypes|}}

{{:References about DocTypes|}}

<noinclude>
[[Category:Beginners]]
[[Category:Templates]]
[[Category:Topics]]
[[Category:HTML|DocType]]
[[Category:Template FAQ]]
</noinclude>

Setting up page width

2010-02-24T18:10:53Z

Arcturusweb:

{{review}}

=== Setting up Page Width ===

Some templates provide the opportunity to select the type of page width, through its parameter settings. In case this does not meet the requirements, the template manager also allows the modification of the cascading style sheets. It is in those files, usually with the extension .css, that most, if not all, of the style (graphical) attributes are defined.

'''What is CSS?'''

CSS stands for Cascading Style Sheet. HTML tags specify the graphical flow of the elements, be it text, images or flash animations, on a webpage. CSS allows us to define the appearances of those html tags with their content, somewhere, so that other pages, if want be, may adhere to. This brings along consistency throughout a website. The cascading effect stipulates that the style of a tag (parent) may be inherited by other tags (children) inside it.

'''CSS Statements'''

The definition of an html tag is as follows:

tagname { attribute: value; attribute: value; }

Tagname may be any html tag but for the sake of setting up page width, what is of interest to us is an html tag that gives structure to a webpage. Some webpages are constructed from div tags while others are constructed on table tags. Usually, the tag has a 'width' attribute. You set up a page width by varying the value of the 'width' attribute.

Sometimes, html tags are not defined directly. They are given an id or a class name and CSS refers to those specific tags by their ids or their class names.

The definition of an id in CSS is as follows:

#idname { attribute: value; attribute: value; }

while the definition of a class in CSS is as follows:

.classname { attribute: value; attribute: value; }

Again setting up a page width means modifying the value of the 'width' attribute of any one of these definitions.

'''Value of the 'width' attribute'''

The value of the 'width' attribute may be in pixels or percentage. Pixels are fixed values; hence in this case, the width does not vary according to window resizing or changing screen resolutions. Percentage usually means that the width is a fraction of the width of its container. So if we have a screen resolution of 1024 pixels by 768 pixels and our page width is set to 80% of the browser window container, our page would be approximately 820 pixels (80% of 1024) provided that the window browser is open at its fullest.

References about DocTypes

2010-02-24T18:10:19Z

Arcturusweb:

=== References about DocTypes ===

References about recommended DocTypes:

* http://www.w3.org/QA/2002/04/Web-Quality
* http://www.alistapart.com/stories/doctype
* http://htmlhelp.com/tools/validator/doctype.html
* http://vivalaweb.info/blog/musing/2005/05/14/choosing-the-right-doctype-a-straight-forward-guide/
* http://hsivonen.iki.fi/doctype/

<noinclude>[[Category:Reference]]</noinclude>
<noinclude>[[Category:Templates]]</noinclude>
<noinclude>[[Category:Itemised lists]]</noinclude>

Recommended DocTypes

2010-02-24T18:09:23Z

Arcturusweb:

===Recommended DocTypes===
List of recommended DocTypes for different circumstances:-

* HTML 4.01 Strict: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
* HTML 4.01 Transitional: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
* HTML 4.01 Frameset: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
* XHTML 1.0 Strict: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
* XHTML 1.0 Transitional: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
* XHTML 1.0 Frameset: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
* XHTML 1.1 DTD: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<noinclude>[[Category:Reference]]</noinclude>
<noinclude>[[Category:Templates]]</noinclude>
<noinclude>[[Category:Itemised lists]]</noinclude>

Horizontal centering

2010-02-24T18:07:56Z

Arcturusweb:

=== Headline text ===

Horizontal centering is achieved with CSS in one of two ways, depending on what you are centering.

For the first example, let's say you have a horizontal menu at the top of your page that you want centered in your layout. You would do it with a block of code in the linked CSS file like this:

#horz_menu {margin: auto; width: 800px; height: 25px; }

The "auto" value in the "margin" attribute centers the item, so this would create a menu area that is 800 pixels wide and 25 pixels tall and would be centered in whatever space it is placed in.

If you need to add some margin space above and below the menu and still keep it centered you would adjust the code like this:

#horz_menu { margin: 20px auto 20px auto; width: 800px; height: 25px; }

This would add 20 pixles of space on the top and bottom of the menu while keeping the left and right margin in a centered mode.

The second example is when you simply want to center text, in which case you just add the "text-align" code.

#horz_menu a { padding: .75em 0 .52em 0; font-size: 0.8em; font-weight: bold; color: #0033CC; background-color: transparent; text-align: center; }

This would cause any links within the horz_menu div tag of the html code to be centered in the horizontal menu. They would also have .75em of padding above and .52em of padding below them.

These same techniques work for the overall page layout as well. Let's say you want the shell content area of your page to be 900 pixels wide and to be centered on the page and that you want the headline to be centered within it. Your CSS code would look something like this:

#page_container {margin: auto; width: 900px; background-color: #FFFFFF; border: 1pt solid #660000; }

#page_container h1 {margin: 50px 0 20px 0 ; font-size: 1.25em; font-weight: bold; color: #0033CC; background-color: transparent; text-align: center; }

This would create a page that has a main content box centered in the browser window with a white background and a brown border.

Any text inside a h1 tag that is inside the page_container div tag in the html code of the page would also be centered inside that main content box.

Of course the example above is a simplified example for demonstration and you would have more structure involved (left column, right column, etc).

So as you can see, horizontal centering for structural items is achieved with the "margin" attribute whereas horizontal centering for text items is achieved using the "text-align" attribute.

--[[User:Daganray|daganray]] 09:54, 15 November 2009 (UTC)

Finding module positions on any given page

2010-02-24T18:06:53Z

Arcturusweb: /* Finding module positions on any given page */

===Finding module positions on any given page ===

To get a visual indication of all module positions used on a page you can follow this procedure:-

* navigate to the page in your web browser.
* click into the URL field in your browser.
* look for any "parameters" at the end of the URL. These are separated from the main part of the URL by a question mark. For example, in the URL <tt><nowiki>http://mydomain.com/index.php?id=17</nowiki></tt>, the "id=17" is a parameter.
* if there are no parameters, append "?tp=1" to the URL and press RETURN. For example, <tt><nowiki>http://mydomain.com/index.php?tp=1</nowiki></tt>.
* if there are already parameters in the URL, append "&tp=1" to the URL and press RETURN. For example, <tt><nowiki>http://mydomain.com/index.php?id=17&tp=1</nowiki></tt>.
* the module positions will be outlined in red.

Note that in some circumstances there may be module positions available that are not outlined in red. This can happen when a template defines those module positions as conditional on there being modules enabled in that position. If there are no modules enabled in that position then the template may adapt and the position will not be visible.
<noinclude>[[Category:Modules]][[Category:Procedures]][[Category:Templates]]</noinclude>

Changing the site favicon

2010-02-24T18:06:16Z

Arcturusweb: /* Changing the Site Favicon */

===Changing the Site Favicon===

# '''Create a 16x16 pixel image.''' You may use graphic software such as [[wikipedia:Photoshop|Photoshop]], [[wikipedia:Gimp|Gimp]] or [[wikipedia:Windows_Paint|Windows Paint]] or an online tool such as http://antifavicon.com/
# '''Convert to ico format''' using free online sites such as:
#* http://converticon.com/
#* http://www.favicongenerator.com/
#* http://www.htmlkit.com/services/favicon/
#* http://tools.dynamicdrive.com/favicon/
#* http://www.favicon.cc/
# The file you created in this way will have the extension .ico. '''Copy the file''' to the /joomla/templates/<your template> directory and '''name it''' favicon.ico.
# Open a browser. Do you see your new icon? If so, congratulations. If not, that doesn't necessarily mean you did anything wrong. Browsers are designed to minimize data traffic, so they don't refresh the favicon every time they show a page. Even refreshing the page (F5) wont help. So you need to refresh more thoroughly:
#* ''Mozilla / Firefox / Safari'': hold down Shift while clicking Reload, or press Ctrl-Shift-R (Cmd-Shift-R on Apple Mac);
#* ''IE'': hold Ctrl while clicking Refresh, or press Ctrl-F5;
#* ''Konqueror'': simply click the Reload button, or press F5;
#* ''Opera'' users may need to completely clear their cache in Tools→Preferences.
If this doesn't work you will need to delete the temporary internet files and the history and then open your page again.

Some templates contain code that redirects the browser to another directory or another icon file. To determine where your new favicon should be, examine http://yoursite.com/templates/your_template/index.php and look for code that contains the text <link rel="shortcut icon". There you will find the directory and the name of the icon file. Copy your icon to that place and give it the the name that link is pointing to (you might want to backup the old file). Make sure you set the security correctly such that you webserver has access to that file. Look at the example below. <source lang="html4strict"><link rel="shortcut icon" href="http://yoursite.com/templates/your_template/icon/favicon.ico" /></source>

If you don't want to just change the '''favicon.ico''' file in its respective template directory you can find the reference to the '''favicon.ico''' file in the '''html.php''' document. The path is '''"........\libraries\joomla\document\html\html.php"'''. This should prevent the icon from toggling if you use
<source lang="html4strict"><link rel="shortcut icon" href="http://yoursite.com/templates/your_template/icon/youricon.ico" /></source>
in the template html and you don't remove the favicon.ico file. (why call the icon twice?)

From the html.php
<source lang="php">
// Try to find a favicon by checking the template and root folder
$path = $directory . DS;
$dirs = array( $path, JPATH_BASE . DS );
foreach ($dirs as $dir )
{
$icon = $dir . 'favicon.ico';
if (file_exists( $icon ))
{
$path = str_replace( JPATH_BASE . DS, '', $dir );
$path = str_replace( '\\', '/', $path );
$this->addFavicon( JURI::base(true).'/'.$path . 'favicon.ico' );
break;''

</source>

<noinclude>
[[Category:Templates]]
</noinclude>

Adding images

2010-02-24T18:05:50Z

Arcturusweb: /* Adding Images */

===Adding Images===
* Upload Using Media Manager
The simplest way to add images is to upload them from your computer using the Media Manager. First, of course, you have to download the image onto your computer and be able to find it. Then, from the Control Panel (back-end administrative interface) navigate to Site -> Media Manager.

On the left is a directory tree, with the root directory "Media". This corresponds to the default "images" directory, yoursite/joomla/images. Pick a subdirectory where you want the image located, or else do nothing to upload the image to the default images directory.

At the bottom of the page is a typical Upload box. Click "Browse" to locate the image on your computer, then "Upload" to upload the file to the server.

* FTP

Of course, you can upload images to a server using any standard FTP client. You might find this handier for adding images to template directories; however, if you have FTP set up, you probably don't need an explanation of how to add an image. Also, many server administration panels such as Cpanel and Plesk have upload capabilities.

* Extensions

There are several extensions, available from the Joomla extensions section, that handle image uploads.

[[Category:FAQ]]
[[Category:Administration FAQ]]
[[Category:Getting Started FAQ]]
[[Category:Version 1.5 FAQ]]

More advanced Joomla! templates

2010-02-24T18:04:13Z

Arcturusweb:

{{:Quirks mode and how to avoid it|Quirks mode and how to avoid it}}

{{:Which DocType header to use|Which DocType header to use}}

{{:Setting up page width|Setting up page width}}

{{:About CSS page layouts|About CSS page layouts}}

{{:Source ordering|Source ordering}}

{{:Horizontal centering|Horizontal centering}}

{{:PHP essentials|PHP essentials}} (eg. echo, if-then-else)

{{:Adding images|Adding images}}

{{:Declaring module positions|Declaring module positions}}

{{:Finding module positions on any given page|Finding module positions on any given page}}

{{:Changing the site favicon|Changing the site favicon}}

<noinclude>[[Category:Templates]]</noinclude>
<noinclude>[[Category:Tutorials]]</noinclude>

More advanced Joomla! templates

2010-02-24T18:03:38Z

Arcturusweb: Undo revision 21870 by Arcturusweb (Talk)

==== Quirks mode and how to avoid it ====
{{:Quirks mode and how to avoid it|Quirks mode and how to avoid it}}
==== Which DocType header to use ====
{{:Which DocType header to use|Which DocType header to use}}

{{:Setting up page width|Setting up page width}}

{{:About CSS page layouts|About CSS page layouts}}

{{:Source ordering|Source ordering}}

{{:Horizontal centering|Horizontal centering}}

{{:PHP essentials|PHP essentials}} (eg. echo, if-then-else)

{{:Adding images|Adding images}}

{{:Declaring module positions|Declaring module positions}}

{{:Finding module positions on any given page|Finding module positions on any given page}}

{{:Changing the site favicon|Changing the site favicon}}

<noinclude>[[Category:Templates]]</noinclude>
<noinclude>[[Category:Tutorials]]</noinclude>

More advanced Joomla! templates

2010-02-24T18:03:21Z

Arcturusweb: Undo revision 21869 by Arcturusweb (Talk)

==== Quirks mode and how to avoid it ====
{{:Quirks mode and how to avoid it|Quirks mode and how to avoid it}}
==== Which DocType header to use ====
{{:Which DocType header to use|Which DocType header to use}}
====Setting up page width====
{{:Setting up page width|Setting up page width}}
====About CSS page layouts====
{{:About CSS page layouts|About CSS page layouts}}
====Source Ordering====
{{:Source ordering|Source ordering}}
====Horizontal Centering====
{{:Horizontal centering|Horizontal centering}}
====PHP Essentials====
{{:PHP essentials|PHP essentials}} (eg. echo, if-then-else)
====Adding Images====
{{:Adding images|Adding images}}
====Declaring Module Positions====
{{:Declaring module positions|Declaring module positions}}
====Finding module positions on any given page====
{{:Finding module positions on any given page|Finding module positions on any given page}}
====Changing the site favicon====
{{:Changing the site favicon|Changing the site favicon}}

<noinclude>[[Category:Templates]]</noinclude>
<noinclude>[[Category:Tutorials]]</noinclude>

More advanced Joomla! templates

2010-02-24T18:02:26Z

Arcturusweb: Undo revision 21865 by Arcturusweb (Talk)

PHP essentials

2010-02-24T18:01:29Z

Arcturusweb: Undo revision 21867 by Arcturusweb (Talk)

{{review}}
===PHP essentials===
----
Many web designers and casual website owners are not conversant with the
PHP language in which Joomla! is written and since Joomla! templates
usually contain PHP statements it is necessary to understand at least a
little of the language in order to be able to create or customize
templates. This chunk will describe, in simple terms, how to use each aspect of PHP in the
context of a Joomla! template. For example, a simple explanation of the PHP
if-then-else syntax using extracts from a template for illustration.

The best resource to learn PHP is probably hands on experience and Joomla can provide that to you thanks to it's native PHP code. This can be overwhelming for people who have not programmed before. Though Joomla is easy enough to [[Installation|install]] with the help of the community and a little of your time you'll have people asking you to do their websites.

One place that has a nice short list if functions and examples is http://en.wikiversity.org/wiki/25_Essential_PHP_Functions which is good to get familiar with PHP. Though for an extensive function list, explanations, and examples go to http://www.php.net.

Once you have the basics of PHP you'll need to get the basics of the Joomla PHP syntax. Start by looking at some existing {{jsite|ext|extensions}} and check out the code and also take a look at some these Tutorials about Joomla:

[http://developer.joomla.org/tutorials/184-how-to-create-a-joomla-plugin.html How to create a Joomla! Plugin]

[http://docs.joomla.org/Developing_a_Model-View-Controller_Component_-_Part_1 Developing a Model-View-Controller Component - Part 1]

[http://docs.joomla.org/Developing_a_Model-View-Controller_Component_-_Part_2_-_Adding_a_Model Developing a Model-View-Controller Component - Part 2 - Adding a Model]

[http://docs.joomla.org/Developing_a_Model-View-Controller_Component_-_Part_3_-_Using_the_Database Developing a Model-View-Controller Component - Part 3 - Using the Database]

[http://docs.joomla.org/Developing_a_Model-View-Controller_Component_-_Part_4_-_Creating_an_Administrator_Interface Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface]

That will help you get familiar with some of the functions available within Joomla's system and what they do (using the API). Take particular care to understand the MVC (model view control) setup.

If however, you are absolutely new to PHP, following may help as very brief introduction to PHP.

==== PHP Introduction ====
PHP is a scripting language and is designed primarily for producing dynamic web pages. It is in general embedded into a HTML page with tags like <?php ... ?>. When such a page is passed on to the PHP engine, the engine translates the PHP tags into HTML and which can then be rendered by a browser. Further during translation the script may require to pull data from a database and thus a database is needed. So for creating PHP pages we require in general, the PHP engine, a database typically MySQL and finally the webserver which will co-ordinate these actions and forward the final HTML to the browser. These 3 components can be installed separately, however, for convenience we have packages like WAMP for windows, MAMP for mac and LAMP for Linux. Installing the packages is discussed next.

==== PHP Installation ====
The packages can be downloaded from [http://www.wampserver.com/en/download.php WAMP]. WAMP stands for Windows Apache MySQL PHP. The instructions can be followed as given in the site and is pretty straightforward. The installation can be done is any directory (say D:/wamp). Once installed, it can be started from the program->start->WampServer. This should give a small icon in the system tray using which the server can be started/stopped/restarted. It also gives links to all important files like php.ini and other configuration files. For Mac users MAMP can be found [http://www.macupdate.com/info.php/id/16197 here]. For the purpose of this tutorial [http://www.apachefriends.org/en/xampp.html XAMPP] can also be used.

==== PHP Round trip ====
Our primary target here is to write a small PHP page and get it rendered by the Apache web server. To render a page WAMP by default looks into the www folder of the WAMP install directory referred henceforth as WAMP_HOME for convenience. Fire up your primary text editor and create a page say first.php and save it in the WAMP_HOME/www/x/y folder, where x, y are folders (which you can create for organizing your scripts). Write the following in the script

<source lang="php">
<html>
<head>
<title>Basic PHP Page</title>
</head>
<body>
<?php
echo ("My first php snippet");
?>
</body>
</html>
</source>

Save this file and point your browser to http://localhost/x/y/first.php and you should be able to see the echo message.

Primary things to note here are <pre>
1. It is strongly advised to start any PHP code by "<?php" and end with a "?>" tag.
2. To have a semicolon after each PHP statement.
3. The directory in which this script resides needs to be given in the URL.
</pre>

This completes our round trip. Now for the sake of learning either you can keep including new elements in this file or may create separate scripts and load them in the browser.

==== PHP Variable declaration and Data types ====
For any programming we need to hold data. In PHP following are the ways in which you can define variables.
<ol>
<li>$variable_name = 0; </li>
Note here we did not define what is the type of variable, whether integer or string that the variable should hold. This is referred to as dynamic scoping.
<li> the variable names should start with an alphabet and can contain alphanumeric characters and "_"
<li> Defining constants - <source lang="php"> define ("NAME_OF_THE_CONSTANT" , $value); </source> </li>
</ol>

==== Basic operators ====
The general operators are as below and explained.
<pre>
a. + e.g. 6 + 3, addition operator, answer is 9
b. – e.g. 6 - 3, subtraction operator, answer is 3
c. / e.g. 6 / 3, division operator, answer is 2
d. * e.g. 6 * 3, multiplication operator, answer is 18
e. % e.g. 6 % 3, modulus operator, answer is 0
f. . e.g. '6'.'3', concatenation operator, gives string '63'
g. += e.g. $x += 6, adds 6
h. -= e.g. $x -= 6, subtracts 6
i. /= e.g. $x /= 6, divides by 6
j. %= e.g. $x %= 6, modulus by 6
k. .= e.g. $x .= '6', concats 6 to x
l. < e.g. $x < $y, evaluates to true if $x is < $y
m. > e.g. $x > $y, evaluates to true if $x is > $y
n. == e.g. $x == $y, evaluates to true if $x is equal by value to $y
o. != e.g. $x != $y, evaluates to true if $x is not equal to $y
p. === e.g. $x === $y, evaluates to true if $x is and $y is identical i.e both of same type both value and reference
q. >= e.g. $x >= $y, evaluates to true if $x is >= $y
r. <= e.g. $x <= $y, evaluates to true if $x is <= $y
s. && e.g. ($x == 2 && $y == 3) , evaluates to true if $x equals 2 and $y equals 3
t. || e.g. ($x == 2 || $y == 3) , evaluates to true if either $x equals 2 or $y equals 3
u. xor e.g. ($x == 2 xor $y == 3) , evaluates to true if either $x equals 2 or $y equals 3 but not both
v. ++ e.g. $x++, increments $x
w. –- e.g. $x--, decrements $x
</pre>

==== Defining array Structures ====
'''Ways of declaring arrays'''
 Suppose we want many variables, we could have done in the way declaring variables as above, however, that is not elegant, for suppose u want a 100 variables; declaring arrays come to the rescue. Note that index in PHP starts from 0.
<pre>
$my_guitar_heroes = array ("Hendrix", "Schenker", "Gilmour", "to_name_a_few!");
</pre>
Or
<pre>
$my_guitar_heroes [] = "Hendrix";
$my_guitar_heroes [] = "Schenker";
$my_guitar_heroes [] = "Gilmour";
$my_guitar_heroes [] = "to_name_a_few!";
</pre>
Here PHP automatically assigns the index.

Or
<pre>
$my_guitar_heroes [0] = "Hendrix";
$my_guitar_heroes [10000] = "Mainak";
</pre>
Here in I just knew the first element and the 10,001st element and that's me!

Or
a combination of the above means

Or
<pre>
// Set the elements at positions 1 through 9999 to the value, "to be decided".
$my_guitar_heroes = array_fill( 1, 9999, "to be decided" );
</pre>

'''Accessing the arrays'''
<pre>
print $my_guitar_heroes[2]; //Access the 2nd element
</pre>
Or
<pre>
// Access the last element (Note that the element positions are numbered zero to
// [number of elements] minus one.)
$my_guitar_heroes[count($my_guitar_heroes)-1];
</pre>
Or
<pre>
// Access the last element using a function call.
end($my_guitar_heroes);
</pre>

'''Iterating over the element of an array'''
<pre>
foreach ( $my_guitar_heroes as $temp) {
print "$temp ";
}
</pre>

==== Control expressions ====
To execute a statement of collection of statements over and over, we use Control expressions. The following are general syntax of the control structures

'''if statements''' 
<source lang="php">
if( $x > 0) {
print("$x is positive");
} else if( $x < 0 ) {
print("$x is negative");
} else {
print("$x is 0");
}
</source>

'''for loop''' 
<source lang="php">
for ( $x=1; $x<= 10; $x++ ) {
print "$x ";
}
</source>

'''while loop''' 
<source lang="php">
$x = 1
while ( $x <= 10 ) {
print "$x ";
}
</source>

'''do while loop''' 
<source lang="php">
$x = 1;
do {
print "$x ";
$x++;
}while($x <= 10);
</source>

==== Defining functions ====
Code which is duplicated at many places are best placed in a function. Following are the ways of describing the function.
<source lang="php">
function name_of_the_function( $arguments, $size='default_values_if_any' ) {
print "here goes in the code";
return "this value is returned, return statement is optional";
}
</source>
The arguments are passed by value. If they are to be passed by reference then an argument is prefixed by "&" as below
<source lang="php">
function name_of_the_function( &$arguments, $size='default_values_if_any' ) {
print "here goes in the code";
return "this value is returned, return statement is optional";
}
</source>
Scope of a variables defined within a function is valid within the function only.

Calling a function
<source lang="php">$x = add(5, 3);</source>

==== Debugging ====
'''Basic printing options''' 
A basic way to debug is to print the value of the variable. The following basic statments acheives that

<ul>
<li>echo "if double quotes are used then dollar variables are resolved";
<li>echo 'if single quote are used then dollar variables are not resolved';
<li>print "another way to print";
<li>nl2br("any new line characters like \n get automatically resolved to HTML line breaks");
</ul>

Apart from these the log files are very helpful and can be found in the WAMP_HOME/logs directory.

==== Handling forms ====
PHP does not change any HTML structure, thus any syntax of HTML remains the same. The part that PHP plays is making any part dynamic for e.g the action attribute of a form can be coded as action=<?php my_own_action(); ?> so that it is dynamically generated. The part where PHP kicks in is after the form is submitted, to say obtain the values of the form fields, set cookies etc. For this super global variables are used which are always available to PHP code. Some of these are
<ol>
<li>$_GET - get the data from a GET request</li>
<li>$_POST - get the data from a POST request</li>
<li>$_REQUEST - get the request</li>
<li>$_COOKIE - obtain the cookies from the browser</li>
<li>$_SESSION - obtain the session</li>
</ol>

All of these are arrays and behave accordingly.

----
[[Category:Templates]]

PHP essentials

2010-02-24T17:57:39Z

Arcturusweb: Removed Level 4 Heading for article. If importing this page into another article, include the heading for this page in THAT article.

{{review}}
----
Many web designers and casual website owners are not conversant with the
PHP language in which Joomla! is written and since Joomla! templates
usually contain PHP statements it is necessary to understand at least a
little of the language in order to be able to create or customize
templates. This chunk will describe, in simple terms, how to use each aspect of PHP in the
context of a Joomla! template. For example, a simple explanation of the PHP
if-then-else syntax using extracts from a template for illustration.

The best resource to learn PHP is probably hands on experience and Joomla can provide that to you thanks to it's native PHP code. This can be overwhelming for people who have not programmed before. Though Joomla is easy enough to [[Installation|install]] with the help of the community and a little of your time you'll have people asking you to do their websites.

One place that has a nice short list if functions and examples is http://en.wikiversity.org/wiki/25_Essential_PHP_Functions which is good to get familiar with PHP. Though for an extensive function list, explanations, and examples go to http://www.php.net.

Once you have the basics of PHP you'll need to get the basics of the Joomla PHP syntax. Start by looking at some existing {{jsite|ext|extensions}} and check out the code and also take a look at some these Tutorials about Joomla:

[http://developer.joomla.org/tutorials/184-how-to-create-a-joomla-plugin.html How to create a Joomla! Plugin]

[http://docs.joomla.org/Developing_a_Model-View-Controller_Component_-_Part_1 Developing a Model-View-Controller Component - Part 1]

[http://docs.joomla.org/Developing_a_Model-View-Controller_Component_-_Part_2_-_Adding_a_Model Developing a Model-View-Controller Component - Part 2 - Adding a Model]

[http://docs.joomla.org/Developing_a_Model-View-Controller_Component_-_Part_3_-_Using_the_Database Developing a Model-View-Controller Component - Part 3 - Using the Database]

[http://docs.joomla.org/Developing_a_Model-View-Controller_Component_-_Part_4_-_Creating_an_Administrator_Interface Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface]

That will help you get familiar with some of the functions available within Joomla's system and what they do (using the API). Take particular care to understand the MVC (model view control) setup.

If however, you are absolutely new to PHP, following may help as very brief introduction to PHP.

==== PHP Introduction ====
PHP is a scripting language and is designed primarily for producing dynamic web pages. It is in general embedded into a HTML page with tags like <?php ... ?>. When such a page is passed on to the PHP engine, the engine translates the PHP tags into HTML and which can then be rendered by a browser. Further during translation the script may require to pull data from a database and thus a database is needed. So for creating PHP pages we require in general, the PHP engine, a database typically MySQL and finally the webserver which will co-ordinate these actions and forward the final HTML to the browser. These 3 components can be installed separately, however, for convenience we have packages like WAMP for windows, MAMP for mac and LAMP for Linux. Installing the packages is discussed next.

==== PHP Installation ====
The packages can be downloaded from [http://www.wampserver.com/en/download.php WAMP]. WAMP stands for Windows Apache MySQL PHP. The instructions can be followed as given in the site and is pretty straightforward. The installation can be done is any directory (say D:/wamp). Once installed, it can be started from the program->start->WampServer. This should give a small icon in the system tray using which the server can be started/stopped/restarted. It also gives links to all important files like php.ini and other configuration files. For Mac users MAMP can be found [http://www.macupdate.com/info.php/id/16197 here]. For the purpose of this tutorial [http://www.apachefriends.org/en/xampp.html XAMPP] can also be used.

==== PHP Round trip ====
Our primary target here is to write a small PHP page and get it rendered by the Apache web server. To render a page WAMP by default looks into the www folder of the WAMP install directory referred henceforth as WAMP_HOME for convenience. Fire up your primary text editor and create a page say first.php and save it in the WAMP_HOME/www/x/y folder, where x, y are folders (which you can create for organizing your scripts). Write the following in the script

<source lang="php">
<html>
<head>
<title>Basic PHP Page</title>
</head>
<body>
<?php
echo ("My first php snippet");
?>
</body>
</html>
</source>

Save this file and point your browser to http://localhost/x/y/first.php and you should be able to see the echo message.

Primary things to note here are <pre>
1. It is strongly advised to start any PHP code by "<?php" and end with a "?>" tag.
2. To have a semicolon after each PHP statement.
3. The directory in which this script resides needs to be given in the URL.
</pre>

This completes our round trip. Now for the sake of learning either you can keep including new elements in this file or may create separate scripts and load them in the browser.

==== PHP Variable declaration and Data types ====
For any programming we need to hold data. In PHP following are the ways in which you can define variables.
<ol>
<li>$variable_name = 0; </li>
Note here we did not define what is the type of variable, whether integer or string that the variable should hold. This is referred to as dynamic scoping.
<li> the variable names should start with an alphabet and can contain alphanumeric characters and "_"
<li> Defining constants - <source lang="php"> define ("NAME_OF_THE_CONSTANT" , $value); </source> </li>
</ol>

==== Basic operators ====
The general operators are as below and explained.
<pre>
a. + e.g. 6 + 3, addition operator, answer is 9
b. – e.g. 6 - 3, subtraction operator, answer is 3
c. / e.g. 6 / 3, division operator, answer is 2
d. * e.g. 6 * 3, multiplication operator, answer is 18
e. % e.g. 6 % 3, modulus operator, answer is 0
f. . e.g. '6'.'3', concatenation operator, gives string '63'
g. += e.g. $x += 6, adds 6
h. -= e.g. $x -= 6, subtracts 6
i. /= e.g. $x /= 6, divides by 6
j. %= e.g. $x %= 6, modulus by 6
k. .= e.g. $x .= '6', concats 6 to x
l. < e.g. $x < $y, evaluates to true if $x is < $y
m. > e.g. $x > $y, evaluates to true if $x is > $y
n. == e.g. $x == $y, evaluates to true if $x is equal by value to $y
o. != e.g. $x != $y, evaluates to true if $x is not equal to $y
p. === e.g. $x === $y, evaluates to true if $x is and $y is identical i.e both of same type both value and reference
q. >= e.g. $x >= $y, evaluates to true if $x is >= $y
r. <= e.g. $x <= $y, evaluates to true if $x is <= $y
s. && e.g. ($x == 2 && $y == 3) , evaluates to true if $x equals 2 and $y equals 3
t. || e.g. ($x == 2 || $y == 3) , evaluates to true if either $x equals 2 or $y equals 3
u. xor e.g. ($x == 2 xor $y == 3) , evaluates to true if either $x equals 2 or $y equals 3 but not both
v. ++ e.g. $x++, increments $x
w. –- e.g. $x--, decrements $x
</pre>

==== Defining array Structures ====
'''Ways of declaring arrays'''
 Suppose we want many variables, we could have done in the way declaring variables as above, however, that is not elegant, for suppose u want a 100 variables; declaring arrays come to the rescue. Note that index in PHP starts from 0.
<pre>
$my_guitar_heroes = array ("Hendrix", "Schenker", "Gilmour", "to_name_a_few!");
</pre>
Or
<pre>
$my_guitar_heroes [] = "Hendrix";
$my_guitar_heroes [] = "Schenker";
$my_guitar_heroes [] = "Gilmour";
$my_guitar_heroes [] = "to_name_a_few!";
</pre>
Here PHP automatically assigns the index.

Or
<pre>
$my_guitar_heroes [0] = "Hendrix";
$my_guitar_heroes [10000] = "Mainak";
</pre>
Here in I just knew the first element and the 10,001st element and that's me!

Or
a combination of the above means

Or
<pre>
// Set the elements at positions 1 through 9999 to the value, "to be decided".
$my_guitar_heroes = array_fill( 1, 9999, "to be decided" );
</pre>

'''Accessing the arrays'''
<pre>
print $my_guitar_heroes[2]; //Access the 2nd element
</pre>
Or
<pre>
// Access the last element (Note that the element positions are numbered zero to
// [number of elements] minus one.)
$my_guitar_heroes[count($my_guitar_heroes)-1];
</pre>
Or
<pre>
// Access the last element using a function call.
end($my_guitar_heroes);
</pre>

'''Iterating over the element of an array'''
<pre>
foreach ( $my_guitar_heroes as $temp) {
print "$temp ";
}
</pre>

==== Control expressions ====
To execute a statement of collection of statements over and over, we use Control expressions. The following are general syntax of the control structures

'''if statements''' 
<source lang="php">
if( $x > 0) {
print("$x is positive");
} else if( $x < 0 ) {
print("$x is negative");
} else {
print("$x is 0");
}
</source>

'''for loop''' 
<source lang="php">
for ( $x=1; $x<= 10; $x++ ) {
print "$x ";
}
</source>

'''while loop''' 
<source lang="php">
$x = 1
while ( $x <= 10 ) {
print "$x ";
}
</source>

'''do while loop''' 
<source lang="php">
$x = 1;
do {
print "$x ";
$x++;
}while($x <= 10);
</source>

==== Defining functions ====
Code which is duplicated at many places are best placed in a function. Following are the ways of describing the function.
<source lang="php">
function name_of_the_function( $arguments, $size='default_values_if_any' ) {
print "here goes in the code";
return "this value is returned, return statement is optional";
}
</source>
The arguments are passed by value. If they are to be passed by reference then an argument is prefixed by "&" as below
<source lang="php">
function name_of_the_function( &$arguments, $size='default_values_if_any' ) {
print "here goes in the code";
return "this value is returned, return statement is optional";
}
</source>
Scope of a variables defined within a function is valid within the function only.

Calling a function
<source lang="php">$x = add(5, 3);</source>

==== Debugging ====
'''Basic printing options''' 
A basic way to debug is to print the value of the variable. The following basic statments acheives that

<ul>
<li>echo "if double quotes are used then dollar variables are resolved";
<li>echo 'if single quote are used then dollar variables are not resolved';
<li>print "another way to print";
<li>nl2br("any new line characters like \n get automatically resolved to HTML line breaks");
</ul>

Apart from these the log files are very helpful and can be found in the WAMP_HOME/logs directory.

==== Handling forms ====
PHP does not change any HTML structure, thus any syntax of HTML remains the same. The part that PHP plays is making any part dynamic for e.g the action attribute of a form can be coded as action=<?php my_own_action(); ?> so that it is dynamically generated. The part where PHP kicks in is after the form is submitted, to say obtain the values of the form fields, set cookies etc. For this super global variables are used which are always available to PHP code. Some of these are
<ol>
<li>$_GET - get the data from a GET request</li>
<li>$_POST - get the data from a POST request</li>
<li>$_REQUEST - get the request</li>
<li>$_COOKIE - obtain the cookies from the browser</li>
<li>$_SESSION - obtain the session</li>
</ol>

All of these are arrays and behave accordingly.

----
[[Category:Templates]]

Horizontal centering

2010-02-24T17:56:13Z

Arcturusweb:

Horizontal centering is achieved with CSS in one of two ways, depending on what you are centering.

For the first example, let's say you have a horizontal menu at the top of your page that you want centered in your layout. You would do it with a block of code in the linked CSS file like this:

#horz_menu {margin: auto; width: 800px; height: 25px; }

The "auto" value in the "margin" attribute centers the item, so this would create a menu area that is 800 pixels wide and 25 pixels tall and would be centered in whatever space it is placed in.

If you need to add some margin space above and below the menu and still keep it centered you would adjust the code like this:

#horz_menu { margin: 20px auto 20px auto; width: 800px; height: 25px; }

This would add 20 pixles of space on the top and bottom of the menu while keeping the left and right margin in a centered mode.

The second example is when you simply want to center text, in which case you just add the "text-align" code.

#horz_menu a { padding: .75em 0 .52em 0; font-size: 0.8em; font-weight: bold; color: #0033CC; background-color: transparent; text-align: center; }

This would cause any links within the horz_menu div tag of the html code to be centered in the horizontal menu. They would also have .75em of padding above and .52em of padding below them.

These same techniques work for the overall page layout as well. Let's say you want the shell content area of your page to be 900 pixels wide and to be centered on the page and that you want the headline to be centered within it. Your CSS code would look something like this:

#page_container {margin: auto; width: 900px; background-color: #FFFFFF; border: 1pt solid #660000; }

#page_container h1 {margin: 50px 0 20px 0 ; font-size: 1.25em; font-weight: bold; color: #0033CC; background-color: transparent; text-align: center; }

This would create a page that has a main content box centered in the browser window with a white background and a brown border.

Any text inside a h1 tag that is inside the page_container div tag in the html code of the page would also be centered inside that main content box.

Of course the example above is a simplified example for demonstration and you would have more structure involved (left column, right column, etc).

So as you can see, horizontal centering for structural items is achieved with the "margin" attribute whereas horizontal centering for text items is achieved using the "text-align" attribute.

--[[User:Daganray|daganray]] 09:54, 15 November 2009 (UTC)

More advanced Joomla! templates

2010-02-24T17:55:07Z

Arcturusweb: Added Level 4 Subheadings to All the importated template articles

==== Quirks mode and how to avoid it ====
{{:Quirks mode and how to avoid it|Quirks mode and how to avoid it}}
==== Which DocType header to use ====
{{:Which DocType header to use|Which DocType header to use}}
====Setting up page width====
{{:Setting up page width|Setting up page width}}
====About CSS page layouts====
{{:About CSS page layouts|About CSS page layouts}}
====Source Ordering====
{{:Source ordering|Source ordering}}
====Horizontal Centering====
{{:Horizontal centering|Horizontal centering}}
====PHP Essentials====
{{:PHP essentials|PHP essentials}} (eg. echo, if-then-else)
====Adding Images====
{{:Adding images|Adding images}}
====Declaring Module Positions====
{{:Declaring module positions|Declaring module positions}}
====Finding module positions on any given page====
{{:Finding module positions on any given page|Finding module positions on any given page}}
====Changing the site favicon====
{{:Changing the site favicon|Changing the site favicon}}

<noinclude>[[Category:Templates]]</noinclude>
<noinclude>[[Category:Tutorials]]</noinclude>

More advanced Joomla! templates

2010-02-24T17:51:10Z

Arcturusweb:

DocType header for templates

2010-02-24T17:50:48Z

Arcturusweb: Removed subheading - redundant

Current thinking is that XHTML 1.0 Transitional should be used for Joomla! templates.

{{:Recommended DocTypes|}}

{{:References about DocTypes|}}

<noinclude>
[[Category:Beginners]]
[[Category:Templates]]
[[Category:Topics]]
[[Category:HTML|DocType]]
[[Category:Template FAQ]]
</noinclude>

More advanced Joomla! templates

2010-02-24T17:49:37Z

Arcturusweb: Added Level 4 heading for Quirks Mode article

==== Quirks mode and how to avoid it ====
{{:Quirks mode and how to avoid it|Quirks mode and how to avoid it}}

{{:Which DocType header to use|Which DocType header to use}}

{{:Setting up page width|Setting up page width}}

{{:About CSS page layouts|About CSS page layouts}}

{{:Source ordering|Source ordering}}

{{:Horizontal centering|Horizontal centering}}

{{:PHP essentials|PHP essentials}} (eg. echo, if-then-else)

{{:Adding images|Adding images}}

{{:Declaring module positions|Declaring module positions}}

{{:Finding module positions on any given page|Finding module positions on any given page}}

{{:Changing the site favicon|Changing the site favicon}}

<noinclude>[[Category:Templates]]</noinclude>
<noinclude>[[Category:Tutorials]]</noinclude>

Finding module positions on any given page

2010-02-24T17:33:59Z

Arcturusweb:

== Finding module positions on any given page ==

To get a visual indication of all module positions used on a page you can follow this procedure:-

* navigate to the page in your web browser.
* click into the URL field in your browser.
* look for any "parameters" at the end of the URL. These are separated from the main part of the URL by a question mark. For example, in the URL <tt><nowiki>http://mydomain.com/index.php?id=17</nowiki></tt>, the "id=17" is a parameter.
* if there are no parameters, append "?tp=1" to the URL and press RETURN. For example, <tt><nowiki>http://mydomain.com/index.php?tp=1</nowiki></tt>.
* if there are already parameters in the URL, append "&tp=1" to the URL and press RETURN. For example, <tt><nowiki>http://mydomain.com/index.php?id=17&tp=1</nowiki></tt>.
* the module positions will be outlined in red.

Note that in some circumstances there may be module positions available that are not outlined in red. This can happen when a template defines those module positions as conditional on there being modules enabled in that position. If there are no modules enabled in that position then the template may adapt and the position will not be visible.
<noinclude>[[Category:Modules]][[Category:Procedures]][[Category:Templates]]</noinclude>

Adding images

2010-02-24T17:32:51Z

Arcturusweb: Added subtitle

====Adding Images====
* Upload Using Media Manager
The simplest way to add images is to upload them from your computer using the Media Manager. First, of course, you have to download the image onto your computer and be able to find it. Then, from the Control Panel (back-end administrative interface) navigate to Site -> Media Manager.

On the left is a directory tree, with the root directory "Media". This corresponds to the default "images" directory, yoursite/joomla/images. Pick a subdirectory where you want the image located, or else do nothing to upload the image to the default images directory.

At the bottom of the page is a typical Upload box. Click "Browse" to locate the image on your computer, then "Upload" to upload the file to the server.

* FTP

Of course, you can upload images to a server using any standard FTP client. You might find this handier for adding images to template directories; however, if you have FTP set up, you probably don't need an explanation of how to add an image. Also, many server administration panels such as Cpanel and Plesk have upload capabilities.

* Extensions

There are several extensions, available from the Joomla extensions section, that handle image uploads.

[[Category:FAQ]]
[[Category:Administration FAQ]]
[[Category:Getting Started FAQ]]
[[Category:Version 1.5 FAQ]]

Changing the site favicon

2010-02-24T17:29:48Z

Arcturusweb: Added subtitle to page

====Changing the Site Favicon====

# '''Create a 16x16 pixel image.''' You may use graphic software such as [[wikipedia:Photoshop|Photoshop]], [[wikipedia:Gimp|Gimp]] or [[wikipedia:Windows_Paint|Windows Paint]] or an online tool such as http://antifavicon.com/
# '''Convert to ico format''' using free online sites such as:
#* http://converticon.com/
#* http://www.favicongenerator.com/
#* http://www.htmlkit.com/services/favicon/
#* http://tools.dynamicdrive.com/favicon/
#* http://www.favicon.cc/
# The file you created in this way will have the extension .ico. '''Copy the file''' to the /joomla/templates/<your template> directory and '''name it''' favicon.ico.
# Open a browser. Do you see your new icon? If so, congratulations. If not, that doesn't necessarily mean you did anything wrong. Browsers are designed to minimize data traffic, so they don't refresh the favicon every time they show a page. Even refreshing the page (F5) wont help. So you need to refresh more thoroughly:
#* ''Mozilla / Firefox / Safari'': hold down Shift while clicking Reload, or press Ctrl-Shift-R (Cmd-Shift-R on Apple Mac);
#* ''IE'': hold Ctrl while clicking Refresh, or press Ctrl-F5;
#* ''Konqueror'': simply click the Reload button, or press F5;
#* ''Opera'' users may need to completely clear their cache in Tools→Preferences.
If this doesn't work you will need to delete the temporary internet files and the history and then open your page again.

Some templates contain code that redirects the browser to another directory or another icon file. To determine where your new favicon should be, examine http://yoursite.com/templates/your_template/index.php and look for code that contains the text <link rel="shortcut icon". There you will find the directory and the name of the icon file. Copy your icon to that place and give it the the name that link is pointing to (you might want to backup the old file). Make sure you set the security correctly such that you webserver has access to that file. Look at the example below. <source lang="html4strict"><link rel="shortcut icon" href="http://yoursite.com/templates/your_template/icon/favicon.ico" /></source>

If you don't want to just change the '''favicon.ico''' file in its respective template directory you can find the reference to the '''favicon.ico''' file in the '''html.php''' document. The path is '''"........\libraries\joomla\document\html\html.php"'''. This should prevent the icon from toggling if you use
<source lang="html4strict"><link rel="shortcut icon" href="http://yoursite.com/templates/your_template/icon/youricon.ico" /></source>
in the template html and you don't remove the favicon.ico file. (why call the icon twice?)

From the html.php
<source lang="php">
// Try to find a favicon by checking the template and root folder
$path = $directory . DS;
$dirs = array( $path, JPATH_BASE . DS );
foreach ($dirs as $dir )
{
$icon = $dir . 'favicon.ico';
if (file_exists( $icon ))
{
$path = str_replace( JPATH_BASE . DS, '', $dir );
$path = str_replace( '\\', '/', $path );
$this->addFavicon( JURI::base(true).'/'.$path . 'favicon.ico' );
break;''

</source>

<noinclude>
[[Category:Templates]]
</noinclude>

Changing the site favicon

2010-02-24T17:25:37Z

Arcturusweb: Added <noinclude> tags to bottom of page

# '''Create a 16x16 pixel image.''' You may use graphic software such as [[wikipedia:Photoshop|Photoshop]], [[wikipedia:Gimp|Gimp]] or [[wikipedia:Windows_Paint|Windows Paint]] or an online tool such as http://antifavicon.com/
# '''Convert to ico format''' using free online sites such as:
#* http://converticon.com/
#* http://www.favicongenerator.com/
#* http://www.htmlkit.com/services/favicon/
#* http://tools.dynamicdrive.com/favicon/
#* http://www.favicon.cc/
# The file you created in this way will have the extension .ico. '''Copy the file''' to the /joomla/templates/<your template> directory and '''name it''' favicon.ico.
# Open a browser. Do you see your new icon? If so, congratulations. If not, that doesn't necessarily mean you did anything wrong. Browsers are designed to minimize data traffic, so they don't refresh the favicon every time they show a page. Even refreshing the page (F5) wont help. So you need to refresh more thoroughly:
#* ''Mozilla / Firefox / Safari'': hold down Shift while clicking Reload, or press Ctrl-Shift-R (Cmd-Shift-R on Apple Mac);
#* ''IE'': hold Ctrl while clicking Refresh, or press Ctrl-F5;
#* ''Konqueror'': simply click the Reload button, or press F5;
#* ''Opera'' users may need to completely clear their cache in Tools→Preferences.
If this doesn't work you will need to delete the temporary internet files and the history and then open your page again.

Some templates contain code that redirects the browser to another directory or another icon file. To determine where your new favicon should be, examine http://yoursite.com/templates/your_template/index.php and look for code that contains the text <link rel="shortcut icon". There you will find the directory and the name of the icon file. Copy your icon to that place and give it the the name that link is pointing to (you might want to backup the old file). Make sure you set the security correctly such that you webserver has access to that file. Look at the example below. <source lang="html4strict"><link rel="shortcut icon" href="http://yoursite.com/templates/your_template/icon/favicon.ico" /></source>

If you don't want to just change the '''favicon.ico''' file in its respective template directory you can find the reference to the '''favicon.ico''' file in the '''html.php''' document. The path is '''"........\libraries\joomla\document\html\html.php"'''. This should prevent the icon from toggling if you use
<source lang="html4strict"><link rel="shortcut icon" href="http://yoursite.com/templates/your_template/icon/youricon.ico" /></source>
in the template html and you don't remove the favicon.ico file. (why call the icon twice?)

From the html.php
<source lang="php">
// Try to find a favicon by checking the template and root folder
$path = $directory . DS;
$dirs = array( $path, JPATH_BASE . DS );
foreach ($dirs as $dir )
{
$icon = $dir . 'favicon.ico';
if (file_exists( $icon ))
{
$path = str_replace( JPATH_BASE . DS, '', $dir );
$path = str_replace( '\\', '/', $path );
$this->addFavicon( JURI::base(true).'/'.$path . 'favicon.ico' );
break;''

</source>

<noinclude>
[[Category:Templates]]
</noinclude>