Декларирование позиций модуля
From Joomla! Documentation
Файл 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.