View source for Creating a basic Joomla! template/tr

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
==Giriş==

Bu yazının amacı, Joomla! şablonlarının oluşturulmasına giriş olarak hizmet etmektir.Temel bir şablon oluşturmak için gerekli olan gerekli dosyaları ve kodları kapsar. Kod, çok az değişiklik gerektirerek kopyalanabilir ve yapıştırılabilir.

== Bir dizin yapısı kurma ==
Temel şablonu oluşturmak için, ''şablonlar'' klasöründe '''yeni bir klasör oluşturun'''. Şablonunuzun ardından bu klasörü adlandırın, örneğin ''mynewtemplate''.

Sevdiğiniz metin düzenleyicisini kullanarak <code>index.php</code> ve <code>templateDetails.xml</code> dosyalarını oluşturun.
Düzenli tutmak için ''resimler'' ve ''css'' adlı '''2 yeni klasör''' oluşturun. ''css'' klasörünün içinde <code>template.css</code> adlı bir dosya oluşturun.

Although it is fine to place all your [[S:MyLanguage/Cascading Style Sheet (CSS)|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 <code>link</code> 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


== Creating a basic templateDetails.xml file ==
The <tt>templateDetails.xml</tt> file is essential. Without it, your template won't be seen by Joomla!. The file holds key [[Wikipedia:Metadata|metadata]] about the template. 

The syntax of the file is different for each Joomla version.

For {{JVer|1.5}}, use the following:

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
	<name>mynewtemplate</name>
	<creationDate>2008-05-01</creationDate>
	<author>John Doe</author>
	<authorEmail>john@example.com</authorEmail>
	<authorUrl>http://www.example.com</authorUrl>
	<copyright>John Doe 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>
		<folder>images</folder>
		<folder>css</folder>
	</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>
</source>

For {{JVer|2.5}} and later, use the following version. Change <code>version="2.5"</code> into the version of your Joomla! installation.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
	<name>mynewtemplate</name>
	<creationDate>2008-05-01</creationDate>
	<author>John Doe</author>
	<authorEmail>john@example.com</authorEmail>
	<authorUrl>http://www.example.com</authorUrl>
	<copyright>John Doe 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>
		<folder>images</folder>
		<folder>css</folder>
	</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>
</extension>
</source>

So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to copy and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).

The <code><files></code> 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. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== Creating a basic index.php file ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<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="footer" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

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