官方系列教材 - C计划

实战Joomla模板开发教程

本节中将介绍如何让自己定义的模块位置被系统识别,并且出现在模块设置界面的位置选项中。

1,本节目标


让我们自己定义的模块位置出现在系统的位置选项中

2,从后台说起


刚刚完成了一个最简单可以的模板,现在你一定非常希望向我们定义的模块位置发布一个模块,以便看看效果,但可能你会有些失望了。

当我们选择位置的时候,在位置列表中并没有出现我们定义的位置,这是为什么呢?如图:

3,注册模块的位置


为了让系统能够识别模板提供的模块位置,我们必须在模板的说明文件templateDetails.xml中声明本模板提供的位置。

声明模块位置的方法为在templateDetails.xml的extension结点下增加一个positions结点,然后在说明每一个position的名称。代码如下:

<?xml version="1.0" encoding="utf-8"?>
<extension version="3.0" type="template" method="upgrade" client="site">
	<name>planc</name>
    <version>0.0.7</version>
	<creationDate>2019-01-08</creationDate>
	<files>
		<filename>index.php</filename>
		<folder>css</folder>
		<folder>js</folder>
		<folder>bootstrap-3.3.7-dist</folder>
	</files>
	<positions>
		<position>logo</position>
		<position>main_menu</position>
		<position>sub_menu</position>
		<position>sidebar</position>
		<position>footer1</position>
		<position>footer2</position>
		<position>footer3</position>
		<position>footer4</position>
		<position>copyright</position>
	</positions>
</extension> 

这样,我们就完成了模块位置的注册了。 

再次刷新模块编辑界面,就可以看到我们planc定义的模块位置了。如图:

4,v0.0.7版本


关于v0.0.7版本的代码,可以在此下载[下载文件:]tpl_plancv0.0.7_2019-01-08_for_j3x.zip

5,经验分享


对于没有注册的模块位置,只需要在“位置”这个选项中直接填写上位置的名称就可以使用了,模块依然会出现在前台哦!

作者: 樱木花道

Joomla程序员,从J1.5到J4.x始终都在做Joomla相关开发定制工作,有超过10年行业经验,国内Joomla扩展开发商ZMAX团队的核心成员

作者网站:ZMAX程序人

评论 (0)

  • 最新在前
  • 最佳在前

第3章 Joomla模板机制

第13章 让模板支持多语言

第16章 结束语