joomla中的jdoc:include元素解析

最新推荐文章于 2025-06-18 22:27:15 发布

转载最新推荐文章于 2025-06-18 22:27:15 发布 · 1.5k 阅读

标签

#joomla #jdocinclude

joomla 专栏收录该内容

2 篇文章

订阅专栏

本文详细解析了 Joomla 模板中的 jdoc:include 标签使用方法，介绍了该标签如何通过不同 type 属性值来包含组件、头部信息、安装步骤、消息提示及各种模块内容。同时解释了 style 属性如何定义模块渲染样式。

<jdoc:include type="component" />
<jdoc:include type="head" />
<jdoc:include type="installation" />
<jdoc:include type="message" />
<jdoc:include type="module" name="breadcrumbs" />
<jdoc:include type="module" name="menu" />
<jdoc:include type="module" name="submenu" style="rounded" id="submenu-box" />
<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" />

type 属性
jdoc:include 元素中的type属性指定要渲染的内容类型，属性值可以是component，head，installation，message，module，modules

component

页面内容主输出部分，在模板页面<body>元素中应该只出现一次。

head
填充当前页的style, script,meta的相关元素，应该在模板的<head>元素中只出现一次。

installation
仅仅在安装模板中有用，在前台和后台的模板中没有用到，某种程度上与 component类型相似，渲染安装步骤中中的一个页面主内容。

message
在模板的<body>元素中只出现一次，填充系统或者报错信息。

module
渲染由name属性指定的单一模块，模块必须是发布的并且当前用户有权访问，还可以有layout以及controller属性。

modules
渲染模板中所有指定名称的模块，模块必须是发布的并且当前用户有权访问，还可以有layout以及controller属性。

style 属性

对于module 和modules 类型，style是一个可选属性，这一属性指定了模块被渲染风格，如果没指定style，默认是none
/templates/system/html/modules.php 声明了标准的style:table,horz,xhtml,rounded,outline
模板设计者可以在以下文件自定义style
/user-template/html/modules.php.