jdoc语句广泛应用与模板中,用来指示Joomla其他部分或者扩展的输出应该放在整个页面的什么位置。
一个典型的jdoc语句如下:<jdoc:include type="component" />
jdoc:include
<jdoc:include />
语句用来根据不同的页面来展示内容。有很多不同的 <jdoc:include />
语句,每个返回不同的部分。
何时替换成真正的内容:JDocumentHTML::_renderTemplate,或者_parseTemplate.
The type attribute
type属性,注意,属性必须用双引号,单引号不起作用,并且在 />闭合之前必须有空格。
Component
<jdoc:include type="component" />
只能出现一次,在<body>元素中,根据不用被浏览的页面来显示不同的内容
Head
<jdoc:include type="head" />
只出现一次,在<head>标签中,用来显示当前页面的style,script, meta等
Installation
<jdoc:include type="installation" />
只用于Joomla2.5
Message
<jdoc:include type="message" />
用来显示系统或者错误信息,样式表在templates\system\css\system.css中
Module
<jdoc:include type="module" name="breadcrumbs" title="Breadcrumbs" /> <jdoc:include type="module" name="mainmenu" title="Main Menu" />
根据name和title属性来render一个模块:name只的是模块类型,title是相应模块的名称。模块必须是发布的和当前用户有权限的,才能可见。其他的属性可以用来控制显示和模块的样式,如果支持的话。
Modules
<jdoc:include type="modules" name="debug" /> <jdoc:include type="modules" name="icon" /> <jdoc:include type="modules" name="left" style="rounded" /> <jdoc:include type="modules" name="left" style="xhtml" /> <jdoc:include type="modules" name="right" style="xhtml" /> <jdoc:include type="modules" name="status" /> <jdoc:include type="modules" name="syndicate" /> <jdoc:include type="modules" name="title" /> <jdoc:include type="modules" name="toolbar" /> <jdoc:include type="modules" name="top" /> <jdoc:include type="modules" name="top" style="xhtml" /> <jdoc:include type="modules" name="user1" style="xhtml" /> <jdoc:include type="modules" name="user2" style="xhtml" /> <jdoc:include type="modules" name="user3" /> <jdoc:include type="modules" name="user4" />
使用文件 templatedetails.xml中的
的positions 集把模块分成了不同的区域。
jdoc:include
's
name="[template position name]"属性,不同的模块可以在不同的位置,用不同的样式,。
The style attribute
这个属性可以在module
and modules中使用