Difference between revisions of "Creating a basic templateDetails.xml file"
From Joomla! Documentation
m |
m (added source tag, line break, fixed <) |
||
Line 2: | Line 2: | ||
Lets look at an example: | Lets look at an example: | ||
− | + | <source lang="xml"> | |
− | < | ||
<?xml version="1.0" encoding="utf-8"?> | <?xml version="1.0" encoding="utf-8"?> | ||
− | <!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://dev.joomla.org/xml/1.5/template-install.dtd"> | + | <!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" |
+ | "http://dev.joomla.org/xml/1.5/template-install.dtd"> | ||
<install version="1.5" type="template"> | <install version="1.5" type="template"> | ||
<name>mynewtemplate</name> | <name>mynewtemplate</name> | ||
Line 34: | Line 34: | ||
<position>footer</position> | <position>footer</position> | ||
</positions> | </positions> | ||
− | |||
</install> | </install> | ||
− | </ | + | </source> |
− | + | So, as you can see, we have a set of information between markup tags ( the <thing> ). Your best approach is to cut and paste this into your "templatedetails.xml" file and change the relevant bits (such as <name> <author> ). | |
− | So, as you can see, we have a set of information between markup tags ( the | ||
− | The | + | The <files> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry update it later. |
Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates. | Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates. |
Revision as of 09:45, 2 May 2008
The templatedetails.xml file is essential. Without it, your template won't be seen by Joomla!. The file holds key "metadata" about the template.
Lets look at an example:
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN"
"http://dev.joomla.org/xml/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>1/5/08</creationDate>
<author>Joe Bloggs</author>
<authorEmail>Joe@bloggs.com</authorEmail>
<authorUrl>http://www.joebloggs.com</authorUrl>
<copyright>joe bloggs 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<filename>template_thumbnail.png</filename>
<filename>images/background.png</filename>
<filename>css/css.css</filename>
</files>
<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>
</positions>
</install>
So, as you can see, we have a set of information between markup tags ( the <thing> ). Your best approach is to cut and paste this into your "templatedetails.xml" file and change the relevant bits (such as <name> <author> ).
The <files> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry update it later.
Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.