Joomla文档中文翻译 - 模板参数详解 - 怎样创建自定义模板参数类型 I

joomla_documentation_168除了Joomla的标准模板参数类型外,我们还可以在模板中使用自定义模板参数类型。关于Joomla模板标准参数类型,可以参见专题:Joomla模板标准参数类型

首先,我们来看看Joomla原生的标准模板参数类型的创建方式以加以借鉴。

标准参数类型的文件位置

我们可以在如下的路径中找到标准参数类型的代码文件:

Joomla根路径/libraries/joomla/html/parameter/element/

每一个参数类型都是通过一个与参数名称相同的php文件定义的。例如,定义category类型参数的文件位于:

Joomla根路径/libraries/joomla/html/parameter/element/category.php

这个文件中包括一个单独的类(class),名称是JElementCategory,它是JElement的一个扩展。在这里我们要再次强调,不仅定义参数的文件名需要与参数类型名称相同,而且每个文件中对应着其参数类型的类的名称也必须是“JElement+参数名称”的形式(如JElementCategory)。

开始创建自定义参数类型

首先我们需要为自定义参数类型选定一个合适的名称,在演示中,我们使用newparm这个名称。然后我们创建一个名为newparm.php的空文件,后面的步骤里,我们会在这个文件中创建一个JElement的扩展类,即JElementNewparm。

在“Joomla文档中文翻译 - 模板参数详解 - 什么是模板参数”一文中,我们提到过,“准确的说,模板参数实质上是一种扩展参数,因为它的机制原理和其他扩展(组件模块插件)的参数是相同的”。所以我们所创建的自定义参数类型实际上是可以与任何类型的扩展绑定的;在这里,我们特指“模板”这种扩展类型,所以现在我们要将之前创建的这个newparm.php文件存储在我们的模板路径中:

Joomla根路径/templates/当前模板文件夹/elements/newparm.php

待续:Joomla文档中文翻译 - 模板参数详解 - 怎样创建自定义模板参数类型 II

关于模板参数及templateDetails.xml文件,可以参考的相关文档包括:

译者:Viiiix7210

如需转载,请注明官方英文文档及本人译文的出处,谢谢。查看官方英文文档: Tutorial:Template parameters


收藏与分享

添加评论


Security code
换一张图