你现在的位置:首页 > PHP网站建设知识库 > Joomla > 正文

什么是joomla模块位(module positions)?

模块位是模板中用来容纳模块的容器,它们定义了模块在模板中的位置,用以告诉joomla将模块的输出内容放置在哪些指定的地方。模板设计者们对模块位有充分的控制权,他们可以基于Joomla默认的模块位在不同的模板中创造出各种变化。
例如,名为“left”的模板位可以被放置在模板的左侧边栏容器中,但根据设计者的需求,它同样可以被设计放置到页面的其他位置;所以当一个模块被分配到“left”模板位后,它只会显示在“left”模块位所处的任何可能的位置,而并非一定在左侧边栏。
templateDetails.xml
templateDetails.xml文件包含了模板所有的安装及核心信息,包括该模板所要用到的模块位信息;模块位信息需要通过列表来声明,下面是一个范例:
<positions>
<position>top</position>
<position>left</position>
<position>right</position>
<position>bottom</position>
<position>banner</position>
<position>syndicate</position>
<position>footer</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
</positions>
上面的声明中都是一些常用模板位,但无论是模板位的名称还是位置样式都由设计者来决定;设计者可以根据需求在这个列表中任意添加在模板中需要用到的模块位。
在模板中使用模块位
Joomla模板通过使用<jdoc:include/>声明来调用和显示模块,一个典型的jdoc声明的形式如下:
<jdoc:includetype="modules" name="name of module position" style="xhtml"/>
关于jdoc声明的使用,可以参见“Joomla文档中文翻译 -什么是jdoc声明”了解更多的信息。
模板位可视化
我们可以很方便的在站点的前台页面中查看当前模板用到的模块位,只需要在当前页面的URL后面输入查询参数“?tp=1”,例如:
http://www.yourdomain.com/index.php?tp=1