joomla中templateDetails.xml文件详解

发布时间：2020-12-16 05:14:30 所属栏目：百科来源：网络整理

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

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

1、基本信息

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

<name>rhuk_milkyway</name>

<author>Alluvion</author>

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

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

<copyright>2011-2011alluvion</copyright>

２、文件结构

模板所用到的每个文件都要在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>

</files>

３、语言

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

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

</languages>

<languagesfolder="admin">

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

</languages>

</administration>

４、模块位

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

<position>breadcrumb</position>

<position>right</position>

<position>footer</position>

<position>debug</position>

<position>syndicate</position>

</positions>

５、模板参数

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

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

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

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!