Creating a basic index file
From Joomla! Documentation
Revision as of 21:23, 3 October 2011 by Vpierre113
The index.php file becomes the core of every page that Joomla! delivers. Essentially, you make a page (like any HTML page) but place PHP code where the content of your site should go. The template works by adding Joomla code into module positions and the component section in your template. Anything added to the template will appear on all pages unless it is added to one of these sections via the Joomla CMS (or customised code).
This page will show the bare-bones code ready for you to cut and paste into your own design.
A Joomla 1.5 template begins with the following lines:
<?php defined( '_JEXEC' ) or die( 'Restricted access' );?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
The first line stops naughty people looking at your coding and getting up to bad things.
The second line is the doctype which tells the browser (and web crawlers) what sort of page it is. This doctype is xhtml 1.0 but you can also change this whole line to:
Which will make the page html5 instead of "xhtml 1.0 transitional" which will be a bit more up to date. It'll also ensure that you have access to a few new pieces of html code not featured in xhtml 1.0. You should be aware that this will not work in internet explorer 8 or earlier without a hack so unless you know how to add the hack you should leave it as xhtml 1.0.
The third line begins our html document and describes what language the website is in. A html document is divided into two parts, head and body. The head will contain the information about the document and the body will contain the website code which controls the layout.
<head> <jdoc:include type="head" /> <link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/system/css/system.css" type="text/css" /> <link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/system/css/general.css" type="text/css" /> <link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template; ?>/css/template.css" type="text/css" /> </head>
<body> <jdoc:include type="modules" name="top" /> <jdoc:include type="component" /> <jdoc:include type="modules" name="bottom" /> </body>
Amazingly, this will suffice! Yes, its a very basic layout, but it will do the job. Everything else will be done by Joomla!. Note: you will need to ensure your menu is set to go into the "top" module position.
Above the line which says name="top" adds a module position which is called top and allows Joomla to place modules into this section of the template. The type="component" line contains all articles and main content and is very important. It goes in the centre of the template.
Note: You can add your own module lines anywhere you want in the body but you have to add a corresponding line to the templateDetails.xml file which sits alongside the index.php of your template.
Finish it off - one last bit:
View the full source code of this template.
If you want to add any images to the template you can do so like this:
<img src="<?php echo $this->baseurl; ?>/images/stories/myimage.png" alt="Custom image" class="customImage" />
Here the baseurl variable will fill in the path to your template for you.
You can add custom css like this:
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template;?>/css/styles.css" type="text/css" />
Every file which is added must have a line in the templateDetails.xml file for the template.