Joomla文档中文翻译 - templateDetails.xml文件详解 - VII II X - Joomla控，Drupal粉 - 开源CMS建站新闻杂谈、文档教程、案例介绍、扩展相关、个人博客及收藏

Joomla文档中文翻译 - templateDetails.xml文件详解

Joomla文档中文翻译 - 模板相关 Tuesday, 24 November 2009 09:35

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

基本信息

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

<install version="1.5" type="template">
    <name>rhuk_milkyway</name>
    <creationDate>11/20/06</creationDate>
    <author>Andy Miller</author>
    <authorEmail>
  This e-mail address is being protected from spambots. You need JavaScript enabled to view it
 </authorEmail>
    <authorUrl>http://www.rockettheme.com</authorUrl>
    <copyright></copyright>
    <license>GNU/GPL</license>
    <version>1.0.2</version>
    <description>TPL_RHUK_MILKYWAY</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>
        <language tag="en-GB">en-GB.tpl_beez.ini</language>
    </languages>
    <administration>
        <languages folder="admin">
            <language tag="en-GB">en-GB.tpl_beez.ini</language>
        </languages>
    </administration>

模块位

关于模块位，请参考“Joomla文档中文翻译 - 什么是模块位(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文件中下面这段代码就是用来向模板管理器提供Color Variation可选参数的(上图红框中的第一个下拉列表)：

    <params>
        <param name="colorVariation" type="list" default="white" label="Color Variation" description="Color variation to use">
            <option value="blue">Blue</option>
            <option value="red">Red</option>
            <option value="green">Green</option>
            <option value="orange">Orange</option>
            <option value="black">Black</option>
            <option value="white">White</option>
        </param>
    </params>