jdoc:include
<jdoc:include /> тег - Joomla! Метод отображения содержимого (модуля) на странице. Существует несколько типов <jdoc:include />, каждый из которых отвечает за отображение различного контента на странице.
Атрибут типа
Атрибут типа определяет тип содержимого, которое нужно отобразить вместо <jdoc:include />
Компонент
<jdoc:include type="component" />
Этот элемент должен находиться в <body>,так как этот тег отвечает за отображение содердимого статей, новосте и пр.
Голова
<jdoc:include type="head" />
предоставляет содержимое стилей, сценариев и мета элементов, характерных для данной страницы.
Установка
<jdoc:include type="installation" />
Ничего не отображет внутри шаблоне . Это – «инструкция» для установки
Сообщение
<jdoc:include type="message" />
Используется только в <body>; отвечает за отображение системных и сообщений об ошибках.
СТИЛИ CSS для системных сообщений могут быть обнаружены в templates\system\css\system.css
Модуль
<jdoc:include type="module" name="breadcrumbs" title="Breadcrumbs" />
<jdoc:include type="module" name="menu" title="Main Menu" />
Первый тег отвечает за отображение навигационной строки, второй – за отображение главного меню; название модуля(name) должно совпадать с названием мода (mod_breadcrums и mod_menu в примерах выше) тогда как название должно быть модульным именем желаемого модуля.
Модули объявляются на странице при помощи тег, указанных выше. Каждый модуль размещается в определенной позиции, которая должна быть описана в файле templateDetails.xml с помощью тега <position>название позиции</position>. Использование jdoc:include name="[имя позиции]" “атрибут” />, вызывает модули всоответствующих позициях. Возможно использование дополнительных атрибутов, отвечающих за формат и стиль модуля.
Ниже - некоторые примеры тегов вызова модуля с названиями позиций, часто используемых вебмастерами:
<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" />
Примечание: name="user3" позиция, по-умолчанию используемая для отображения верхнего меню.
Атрибут стиля
атрибут style="" отвечает за стиль отображения модуля. Если в style=”” стоит значение “none”, то модуль выводиться по-умолчанию.
Перевод статьи с сайта
http://docs.joomla.org/Jdoc_statements by DiGeRiOn
Может кому-то будет интересна эта информация)
05.03.2009, 22:35:31