Декларирование позиций модуля

From Joomla! Documentation

This page is a translated version of the page Declaring module positions and the translation is 100% complete.

Other languages:
български • ‎Deutsch • ‎English • ‎español • ‎français • ‎Nederlands • ‎русский • ‎中文(台灣)‎

Файл templateDetails.xml содержит всю необходимую шаблону информацию по установке и ядру. Для того, чтобы позиции модуля были в распоряжении для выбор [их пользователем] в менеджере модулей, эти позиции необходимо декларировать в файле templateDetails.xml шаблона.

Элементы модуля в файле templateDetails.xml

В этом файле подчиненный элемент <positions> вместе с его [собственными] подчиненными элементами <position> определяют положения, имеющиееся у данного шаблона для каждой позиции модуля. Ниже следует краткий список широко используемых названий для различных позиций модуля и как их декларировать.

<positions>
  <position>top</position>
  <position>left</position>
  <position>right</position>                
  <position>bottom</position>
  <position>banner</position>
  <position>syndicate</position>
  <position>footer</position>
  <position>user1</position>
  <position>user2</position>
  <position>user3</position>
  <position>user4</position>
  <position>debug</position>
</positions>

Хотя они широко используются, выбор как позиции модуля, так и сопровождающий показываемый для него конкретный макет, зависят от разработчика конкретного шаблона.

Добавление позиции модуля, как показано выше, применяется между тегами <positions> и </positions>. Между этими тегами в файле templateDetails.xml добавьте [на английском языке] название позиции модуля, заключенное между тегами <position> и </position>.

Вы можете добавлять и определять новые позиции модуля и называть их [на английском языке] как Вам нравится, но как минимум рекомендуется чтобы Вы поддерживали показанные выше. Это для того, чтобы поддерживать некоторый уровень последовательности при переключении шаблонов или при использовании на одном и том же сайте несколько шаблонов [одноврмененно].

Использование и применение

Какой-либо шаблон Joomlaǃ показывает набор модулей, добавленных на конкретную позицию, используя ниже следующее заявление <jdoc:include />ː

<jdoc:include type="modules" name="название позиции модуля [на английском языке]" style="xhtml" />

Для более подробной информации о коде <jdoc:include /> и о том, как использовать его, смотрите декларации jdoc.

Смотрите также