Creating a basic Joomla! template - Revision history

Sozzled at 21:15, 18 January 2023

2023-01-18T21:15:10Z

← Older revision		Revision as of 21:15, 18 January 2023
Line 1:		Line 1:
			{{note\|'''Note!''' The methods discussed in this article apply to old, outdated and unsupported versions of Joomla! and are to be used entirely at your own risk!\|type=serious}}
	<noinclude><languages /></noinclude>		<noinclude><languages /></noinclude>
	{{version/tutor\|1.5,2.5,3.1}}{{JSplit}}		{{version/tutor\|1.5,2.5,3.1}}{{JSplit}}

Cmb: Several capitalization and markup changes.

2022-10-31T15:33:05Z

Several capitalization and markup changes.

Show changes

MATsxm at 11:47, 5 July 2016

2016-07-05T11:47:51Z

← Older revision		Revision as of 11:47, 5 July 2016
Line 140:		Line 140:
	<jdoc:include type="modules" name="top" />		<jdoc:include type="modules" name="top" />
	<jdoc:include type="component" />		<jdoc:include type="component" />
	<jdoc:include type="modules" name="~~bottom~~" />		<jdoc:include type="modules" name="footer" />
	</body>		</body>
	</html>		</html>

Sandra97: 1 link corrected

2015-11-06T18:16:27Z

1 link corrected

← Older revision		Revision as of 18:16, 6 November 2015
Line 19:		Line 19:

	<translate><!--T:6-->		<translate><!--T:6-->
	Although it is fine to place all your [[S:MyLanguage/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.</translate>		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.</translate>

	<translate><!--T:7-->		<translate><!--T:7-->
Line 31:		Line 31:

	<translate>		<translate>

	== Creating a basic templateDetails.xml file == <!--T:8-->		== Creating a basic templateDetails.xml file == <!--T:8-->
	</translate>		</translate>

Abulafia at 21:10, 28 October 2015

2015-10-28T21:10:04Z

← Older revision		Revision as of 21:10, 28 October 2015
Line 6:		Line 6:

	<translate><!--T:2-->		<translate><!--T:2-->
	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.</translate>		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 copy and pasted with very little modification needed.</translate>

	<translate>		<translate>
Line 111:		Line 111:

	<translate><!--T:13-->		<translate><!--T:13-->
	So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to ~~cut~~ and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).</translate>		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>).</translate>

	<translate><!--T:14-->		<translate><!--T:14-->

MATsxm: Marked this version for translation

2015-10-28T13:43:10Z

Marked this version for translation

Show changes

MATsxm: Marked for translation

2015-10-28T13:42:47Z

Marked for translation

← Older revision		Revision as of 13:42, 28 October 2015
Line 1:		Line 1:
			<noinclude><languages /></noinclude>
	{{version/tutor\|1.5,2.5,3.1}}{{JSplit}}		{{version/tutor\|1.5,2.5,3.1}}{{JSplit}}
			<translate>
	== Introduction ==		== Introduction ==
			</translate>

	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.		<translate>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.</translate>

			<translate>
	== Setting up a directory structure ==		== 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''.		</translate>
			<translate>To make the most basic template, '''create a new folder''' in the ''templates'' folder. Name this folder after your template i.e. ''mynewtemplate''.</translate>

	Using your favourite text editor create the files <code>index.php</code> and <code>templateDetails.xml</code>.		<translate>Using your favourite text editor create the files <code>index.php</code> and <code>templateDetails.xml</code>.
	To keep things organized, make '''2 new folders''' called ''images'' and ''css''. Inside the ''css'' folder create a file called <code>template.css</code>.		To keep things organized, make '''2 new folders''' called ''images'' and ''css''. Inside the ''css'' folder create a file called <code>template.css</code>.</translate>

	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 <code>link</code> tag. This may also shorten the loading time of your pages, since the separate file can be cached.		<translate>Although it is fine to place all your [[S:MyLanguage/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.</translate>

	This is the most basic practical setup. Outline of folder and file structure:		<translate>This is the most basic practical setup. Outline of folder and file structure:</translate>
	* mynewtemplate/		* mynewtemplate/
	** css/		** css/
	*** template.css		*** template.css
	** images/		** images/
	** index.php		** index.php
	** templateDetails.xml		** templateDetails.xml

			<translate>
	== Creating a basic templateDetails.xml file ==		== 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.		</translate>
			<translate>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.</translate>

	The syntax of the file is different for each Joomla version.		<translate>The syntax of the file is different for each Joomla version.</translate>

	For {{JVer\|1.5}}, use the following:		<translate>For {{JVer\|1.5}}, use the following:</translate>

	<source lang="xml">		<source lang="xml">
Line 60:		Line 67:
	</source>		</source>

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

	<source lang="xml">		<source lang="xml">
Line 94:		Line 101:
	</source>		</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 cut and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).		<translate>So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to cut and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).</translate>

	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.		<translate>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.</translate>

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

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

			<translate>This leaves a final file of:</translate>

	~~This leaves a final file of:~~
	<source lang="php">		<source lang="php">
	<?php defined('_JEXEC') or die('Restricted access');?>		<?php defined('_JEXEC') or die('Restricted access');?>
Line 120:		Line 130:
	</source>		</source>

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

	{{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.		<translate>{{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.</translate>

	{{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.		<translate>{{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.</translate>

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

	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.		<translate>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.</translate>

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

			<translate>
	== Conclusion ==		== Conclusion ==
			</translate>

	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.		<translate>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.</translate>

	<noinclude>		<noinclude>
			<translate>
	[[Category:Templates]]		[[Category:Templates]]
	[[Category:Tutorials]]		[[Category:Tutorials]]
			</translate>
	</noinclude>		</noinclude>
	~~<noinclude>[[Category:Needs to be marked for translation]]</noinclude>~~

MATsxm at 16:00, 25 October 2015

2015-10-25T16:00:52Z

← Older revision		Revision as of 16:00, 25 October 2015
Line 142:		Line 142:
	[[Category:Tutorials]]		[[Category:Tutorials]]
	</noinclude>		</noinclude>
			<noinclude>[[Category:Needs to be marked for translation]]</noinclude>

Flimm: Don't hardcode template name

2015-06-29T16:08:01Z

Don't hardcode template name

← Older revision		Revision as of 16:08, 29 June 2015
Line 110:		Line 110:
	<head>		<head>
	<jdoc:include type="head" />		<jdoc:include type="head" />
	<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/~~mynewtemplate~~/css/template.css" type="text/css" />		<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
	</head>		</head>
	<body>		<body>

Dwarkesh0204: Apply Codding Standard

2015-03-18T07:15:33Z

Apply Codding Standard

← Older revision		Revision as of 07:15, 18 March 2015
Line 105:		Line 105:
	This leaves a final file of:		This leaves a final file of:
	<source lang="php">		<source lang="php">
	<?php defined( '_JEXEC' ) or die( 'Restricted access' );?>		<?php defined('_JEXEC') or die('Restricted access');?>
	<!DOCTYPE html>		<!DOCTYPE html>
	<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >		<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >