View source for Declaring module positions/ru

<noinclude><languages /></noinclude>Файл [[S:MyLanguage/Creating a basic templateDetails.xml file|templateDetails.xml]] содержит всю необходимую шаблону информацию по установке и ядру. Для того, чтобы позиции модуля были в распоряжении для выбор [их пользователем] в менеджере модулей, эти позиции необходимо декларировать в файле <code>templateDetails.xml</code> шаблона.

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

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

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

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

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

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

Какой-либо шаблон Joomlaǃ показывает набор модулей, добавленных на конкретную позицию, используя ниже следующее заявление <code><jdoc:include /></code>ː
<pre>
<jdoc:include type="modules" name="название позиции модуля [на английском языке]" style="xhtml" />
</pre>

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

==Смотрите также==
*[[S:MyLanguage/Customising the way modules are displayed|Индивидуальная подстройка показа модулей]]
*[[S:MyLanguage/Counting modules in a given module position|Подсчет модулей, [назначенных] определенной позиции]]
*[[S:MyLanguage/Counting modules in multiple module positions|Подсчет модулей, [находящихся] в нескольких позициях]]
*[[S:MyLanguage/Applying custom module chrome|Применение произвольного хрома модуля]]

<noinclude>[[Category:Beginners/ru|Начинающие]][[Category:Modules/ru|Модули]][[Category:Templates/ru|Шаблоны]][[Category:Topics/ru|Темы]]</noinclude>[[Category:Tutorials/ru|Темы]][[Category:Template Development/ru|Разработка шаблона]]