Joomla 1.5.x: jdoc:include
Written by Administrator   
sabato, 04 ottobre 2008

Template management in Joomla 1.5 version has introduced large improvements from older version and is based now on jdoc:include statement.
As per the example here below this system results much better, powerful and flexible to manage templates in Joomla CMS.

<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" />

The type attribute specifies the element to substitute in the <jdoc:include /> statement as per the description here below.

Component: this element should only appear once in the <body> element of the Template to render the main content of the page.

Head: this element should only appear once in the <head> element of the Template to render the content of the style, script and meta elements associated with the current page.

Installation: this element is only used within the Joomla! Installer template and of no particular use in a Front-end or Back-end template. It's somewhat the equivalent to the 'component' type, rendering the main content of an installation step.

Message: this element should only appear once in the <body> element of the Template to render system and error messages that occurred in the request.

Module: this element renders a single module given by the name attribute. The module in question must be published and accessible by the current user in order to become visible. Additional attributes can be provided to control the layout and appearance of the module, if supported.

Modules: this element renders all modules assigned to the template position given by the name attribute. Modules must be published and accessible by the current user to be visible. Additional attributes can be provided to control the layout and appearance of modules, if supported.

The optional style attribute is available for the module and modules types. The attribute value refers to the "chrome" style used to wrap the output generated by a module. If no style is provided, a value of "none" is used per default. /> The values are:
table: same as style 0 of previous joomla 1.0.0 version;
horz: same as style 1 of previous joomla 1.0.0 version;
xhtml: generates a global div with a h3 title above;
rounded: generates a nested div similar to style -3 of previous joomla 1.0.0 version.

Here below a small example to include modules in "user2" position. The row 1 is for joomla 1.0.0 version while row 3 is related to 1.5 version.

<?php mosLoadModules ( ‘user2’, -2 ); ?>

<jdoc:include type=”modules” name=”user2” style=”xhtml” />

Last Updated ( sabato, 04 ottobre 2008 )