本节中将介绍如何让自己定义的模块位置被系统识别,并且出现在模块设置界面的位置选项中。
让我们自己定义的模块位置出现在系统的位置选项中
刚刚完成了一个最简单可以的模板,现在你一定非常希望向我们定义的模块位置发布一个模块,以便看看效果,但可能你会有些失望了。
当我们选择位置的时候,在位置列表中并没有出现我们定义的位置,这是为什么呢?如图:
为了让系统能够识别模板提供的模块位置,我们必须在模板的说明文件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定义的模块位置了。如图:
关于v0.0.7版本的代码,可以在此下载tpl_plancv0.0.7_2019-01-08_for_j3x.zip
对于没有注册的模块位置,只需要在“位置”这个选项中直接填写上位置的名称就可以使用了,模块依然会出现在前台哦!