5.1 创建自己的第一个模板 -v0.0.1版本

在这一节中我们将来实际的分析planc模板v0.0.1版本，从中了解到开发出一个可被系统识别的最小模板的条件

1，本节目标

能够自己开发出一个能够系统识别的模板

2，模板的文件夹结构

 我们已经知道了，当模板成功安装之后，joomla会在网站的根目录/templates这个目录下为你的模板创建一个目录，你所有的文件都会复制到这个目录中。如图：

我们进入到planc这个文件夹中，可以看到这个文件夹的文件结构。如图：

这个文件夹中只有两个文件，一个是index.php，一个是templateDetails.xml文件。并且这两个文件的大小都不到1kb。

在这两个文件中，index.php是空的，里面写了一些无用的内容。我们需要重点关注templateDetails.xml这个文件。

这是一个xml文件，文件名为templateDetails(中文意思是 模板的详情)。这个名称是不可修改的。文件的内容如下：

<?xml version="1.0" encoding="utf-8"?>
<extension version="3.0" type="template" method="upgrade" client="site">
	<name>planc</name>
    <version>0.0.1</version>
	<files>
<filename>index.php</filename>
	</files>
</extension>

2，约定优于设计原则

 在程序设计中，有一个原则就是约定优于设计，他的意思是说，在设计之前，就将一些内容给约定好。如果你知道约定，那么就会带来很大的方便，如果你不清楚这些约定，你会感觉很难入门。既然是约定，那么就没有原因，大家记住就行了。

3，关于模板的约定

 在Joomla中，我们（开发者）约定，每一个模板必须有一个templateDetails文件和index.php文件。并且在templateDetails按照固定的格式来说明这个模板的基本信息。如上面的xml一样。

上面的这个XML文件很简单，大家在创建自己的模板的时候，直接复制就行了。然后按照自己的需要，进行修改。

• name：就是你模板的名称。这个一般用字母。系统会在templates目录下，创建出这个目录，并且将你的文件复制过去
• version :你的模板的版本号。一般使用x.y.z的格式。你可以自己定义。如：0.0.1.主要用于后期的更新
• files：这个结点用来说明你的模板需要使用的文件或者文件夹。
• filename:你的模板中需要使用的文件的名称。比如，这个planc模板，只有一个index.php文件，因此，这里就只有一行。

4，创建自己的第一个模板

有了上面的知识，那么创建自己的第一个模板就很简单了。主要的步骤如下

• STEP 1:复制planc模板的templateDetails.xml这个文件。在这个文件中修改name属性为你的模板的名称
• STEP 2:在你的模板下面新建一个index.php文件。这个文件可以为空。
• STEP 3:将这个文件夹打包，测试安装了。

这样你的第一个模板就完成了。

5，共勉

虽然本节讲的内容很浅显，但我个人强烈的建议各位学习者，一定要亲自实践一次。在此，以一句诗句来勉励所有的朋友：

纸上得来终觉浅，绝知此事要躬行！ 

这是我的第一个版本，已经测可以正常安装。tpl_myplancv0.0.1_2019-01-04_for_j3x.zip