Источник: официальный сайт CMS Joomla! (joomla.ohg)
Заявления jdoc имеются в любом шаблоне сайта на CMS Joomla; они предназначены для отображения определённого контента на странице. Типичное заявление jdoc выглядит следующим образом:
<jdoc:include type="component" />
Существуют различные jdoc:include-операторы, каждый из которых возвращает свой контент на страницу.
Типы атрибутов
Атрибут определяет тип содержимого. Например, оператор <jdoc:include type="head" /> использует атрибут type (type="head").
Выражения jdoc требуют двойные кавычки вокруг атрибутов, одинарные кавычки не работают. Пробел перед закрытием /> также является обязательным.
Component
<jdoc:include type="component" />
Этот элемент применяется в шаблоне только один раз внутри элемента <body> и отображает основное содержимое страницы относительно текущей просматриваемой страницы.
Head
<jdoc:include type="head" />
Этот элемент применяется в шаблоне только один раз в элементе <head>; его задача отображать стили CSS, скрипты и мета элементы, связанные с текущей страницей.
Installation
<jdoc:include type="installation" />
Этот элемент используется только внутри CMS Joomla; применяется при установке шаблона.
Message
<jdoc:include type="message" />
Этот элемент используется только один раз в <body> шаблона для отображения системных сообщений и сообщений об ошибках, которые возникли в запросе.
Module
<jdoc:include type="module" name="breadcrumbs" title="Breadcrumbs" />
<jdoc:include type="module" name="mainmenu" title="Main Menu" />
Этот элемент выводит один модуль с атрибутами name и title; name должно соответствовать типу модуля (mod_breadcrumbs и mod_menu в примерах выше), а в качестве title должно быть имя соответствующего модуля. Что бы данный модуль появился на странице, он должен быть опубликован и доступен текущему пользователю. Дополнительные атрибуты могут быть предоставлены для управления компоновкой и внешним видом модуля, если они поддерживаются.
Modules
Несколько модулей выводятся на странице с помощью одного из нижеприведённых примеров кода. Модули разделяются на разные участки шаблона, используя позиции в файле templatedetails.xml.
<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" />
Атрибут стиля style="…" для module и modules не является обязательным. Если нет стиля используется по умолчанию значение "none".