Creating a template for Joomla 1.5

There is not too much secret to create a template for Joomla 1.5. The concept is the same as breaking a design for any site and you just need to know some content anchors and some “must have” files to make it work.

Let’s start with the “must have files”. No matter what kind of template you are building you will need the following:

  • index.php
  • templateDetails.xml
  • template_thumbnail.png
  • a css folder with template.css (or whatever name you want to use.css) inside
  • a images folder with at least the logo.png file (must have this name)

If you have this, your template is half away to be complete.

The templateDetails.xml is tricky and it have changed from the 1.0.x version to the 1.5.x version. Anyway this file must have the following parameters:

  • xml opening tag: <?xml version=”1.0″ encoding=”utf-8″?>
  • install open with version and type described: <install version=”1.5″ type=”template”>
    • name: this will be the name displayed on joomla for your template, but it will be as well the directory of the template
    • creationDate
    • author
    • copyright
    • authorEmail
    • authorUrl
    • version: the version of the template
    • description: the description that will be shown for the administrator on joomla
    • and files: all the files that you use on your template
      • with filenames (off course has to contain  the “most have” files)

Now all you need to do is break the design and attach the content anchors on your file and this is how it works. When you go the module manager on Joomla you will see a bunch of module positioning availabe. Copy those names, you will need them. They are the current anchors that you have available to use on your template. You can definitly change what module is on which positioning on the module manager, and that can affect the use of your template.

Anyway, for any module positioning on your template, let’s say, left, you will use the following command:

<jdoc:include type=”modules” name=”modulename: left for example” />

You don’t need to write a html header, those Joomla will take care of, but you will need to tell Joomla to do that and for that you will need to use:

<jdoc:include type=”head” />

At the very first line of your index.php you will need to test if you can execute Joomla. It’s required for the template. Anyway, you still have to work out some other checks needed for Joomla to work, so this is how your header must be:

“<?php
defined( ‘_JEXEC’ ) or die( ‘Restricted access’ );
JPlugin::loadLanguage( ‘tpl_SG1′ );
?>
<!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; ?>”>
<head>
<meta http-equiv=”Content-Type” content=”text/html; <?php echo _ISO; ?>” />
<?php if ($my->id) { initEditor(); } ?>
<jdoc:include type=”head” />
<link rel=”stylesheet” href=”templates/system/css/system.css” type=”text/css” />
<link rel=”stylesheet” href=”templates/<?php echo $this->template ?>/css/template_css.css” type=”text/css” />
</head>

Now, construct your template how it should be. Add the anchors and for the content area, add the following anchor:

<jdoc:include type=”component” />

You are done. Keep these tips and tricks in mind and you will create a Joomla Template in no time.

About mcloide

Making things simpler, just check: http://www.mcloide.com View all posts by mcloide

3 responses to “Creating a template for Joomla 1.5

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: