< 返回 5.1 创建自己的第一个模板 -v0.0.1版本 - C计划

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

1,本节目标


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

2,模板的文件夹结构


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

joomla_模板目录.png

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

planc_文件结构.png

这个文件夹中只有两个文件,一个是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

C计划

第3章:Joomla模板机制
第13章:让模板支持多语言
  • 内容提要
  • 留言讨论 (0)
  • 视频教程
在这一节中我们将来实际的分析planc模板v0.0.1版本,从中了解到开发出一个可被系统识别的最小模板的条件

评论 (0)

  • 最新在前
  • 最佳在前

内容待完善

该课程提供视频版,可以观看完整的视频教程