Creating a basic Joomla! template

From Joomla! Documentation

Revision as of 04:52, 2 October 2008 by Tiaset03 (Talk | contribs)


The purpose of this tutorial is to serve as an introduction to creating Joomla! templates. It will cover the essential files and code needed to create a basic template. The code is presented so it can be cut and pasted with very little modification needed.

Setting up a directory structure

To make the most basic template, create a new folder in the templates folder. Name this folder after your template i.e. mynewtemplate.

Using a text editor create the files index.php and templateDetails.xml.

To keep things organized, make 2 new folders called images and css. Inside the css folder create a file called template.css.

Although it is fine to place all your CSS code directly in your index.php file to start, many web developers prefer to place their CSS code in a separate file that can be linked from multiple pages using the link tag. This may also shorten the loading time of your pages, since the separate file can be cached.

This is the most basic practical setup.

Outline of folder and file structure:

  • mynewtemplate/
    • css/
      • template.css
    • images/
    • index.php
    • templateDetails.xml

How to edit the files