joomla中templateDetails.xml文件详解

templateDetails.xml文件向模板管理器(TemplateManager)提供了很多关于模板的重要meta数据(meta-data，元数据)，用于模板的安装及维护。通常，这些数据通过文本缩进的方式来体现出不同的区块，方便阅读和识别。

1、基本信息

在站点管理后台的模板管理中，我们可以看到一个可用的模板列表，它包含了每个模板的基本信息；所有这些信息都是通过templateDetails.xml文件提供的。下面是一个模板管理页面的截图，其中<name>，<version>等红字标明的信息名称即对应着下面xml文件代码中的相关标签。

<install version="1.5"type="template">

      <name>rhuk_milkyway</name>

      <creationDate>11/20/06</creationDate>

      <author>Alluvion</author>

      <authorEmail>alluvion@qq.com</authorEmail>

      <authorUrl>http://blog.sina.com.cn/alluvion</authorUrl>

      <copyright>2011-2011alluvion</copyright>

      <license>GNU/GPL</license>

      <version>1.0.2</version>

      <description>TPL_XX</description>

２、文件结构

模板所用到的每个文件都要在templateDetails.xml中列出，每个文件名都要包括其相对于模板根路径的完整路径信息。Joomla的模板安装器会在安装储存模板文件的时候用到这些信息。下面的文件结构声明示例取自rhuk_milkyway模板的templateDetails.xml文件。

      <files>

          <filename>index.php</filename>

          <filename>templateDetails.xml</filename>

          <filename>template_thumbnail.png</filename>

          <filename>params.ini</filename>

          <filename>images/arrow.png</filename>

          <filename>images/indent1.png</filename>

      </files>

一种比较推荐的更加完整的文件结构声明是这样的(包括images和css文件夹的路径)：

      <files>

          <filename>index.php</filename>

          <filename>component.php</filename>

          <filename>templateDetails.xml</filename>

          <filename>template_thumbnail.png</filename>

          <filename>params.ini</filename>

          <folder>images/</folder>

          <folder>css/</folder>

      </files>

３、语言

有些模板会包含语言文件，用来自定义页面中的一些静态文本。下面的示例中包含两个语言文件，其中第一个用于前台页面，第二个(包含在<administration>标签中的)用于管理后台页面。

      <languages>

          <languagetag="en-GB">en-GB.tpl_beez.ini</language>

      </languages>

      <administration>

          <languagesfolder="admin">

              <languagetag="en-GB">en-GB.tpl_beez.ini</language>

          </languages>

      </administration>

４、模块位

关于模块位，请参考“ 什么是模块位(module positions)”；下面是一个典型的模块位声明：

      <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>

          <position>debug</position>

          <position>syndicate</position>

      </positions>

５、模板参数

很多模板会向管理后台的模板管理器提供一些可供设置的参数，例如rhuk_milkyway模板允许我们设置边框颜色、背景色及模板宽度等，如下图：

templateDetails.xml文件中下面这段代码就是用来向模板管理器提供ColorVariation可选参数的(上图红框中的第一个下拉列表)：

      <params>

          <paramname="colorVariation" type="list" default="white" label="ColorVariation" description="Color variation touse">

              <optionvalue="blue">Blue</option>

              <optionvalue="red">Red</option>

              <optionvalue="green">Green</option>

              <optionvalue="orange">Orange</option>

              <optionvalue="black">Black</option>

              <optionvalue="white">White</option>

          </param>

      </params>