Modulpositionen festlegen
From Joomla! Documentation
Die Datei templateDetails.xml enthält alle Installations- und Kerninformationen zu einer Vorlage. Damit Modulpositionen im Module Manager zur Auswahl stehen, müssen die Positionen in der Datei templateDetails.xml im Template definiert werden.
Modul Element in templateDetails.xml
In der Datei definiert das Sub-Element <positions> zusammen mit seinen Sub-Elementen <position><position> die für jedes vom Template unterstützte Modulposition verfügbaren Positionen. Hier ist eine kurze Liste der gebräuchlichen Namen für die verschiedenen Modulpositionen und wie sie deklariert werden.
<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>
Obwohl diese häufig verwendet werden, obliegt es dem Template-Entwickler, sowohl einen Modulpositionsnamen als auch das zugehörige Anzeigelayout auszuwählen.
Das Hinzufügen von Modulpositionen, wie oben dargestellt, ist zwischen den Tags <positions> und </positions> implementiert. Zwischen diesen Tags in der Datei templateDetails.xml fügen Sie den Namen der Modulposition zwischen einem Satz von <position> und </position> Tags ein.
Man kann neue Modulpositionen hinzufügen und definieren und ihnen einen beliebigen Namen geben. Es wird empfohlen, dass man mindestens die im obigen Beispiel gezeigten unterstützt. Dies geschieht, damit beim Wechsel von Templates oder bei der Verwendung mehrerer Templates auf einer einzigen Webseite eine gewisse Konsistenz gewährleistet ist.
Nutzung und Implementierung
Ein Joomla! Template zeigt einen Set von Modulen, die an einer bestimmten Position mit der untenstehenden Anweisung <jdoc:include /> hinzugefügt wurden:
<jdoc:include type="modules" name="name of module position" style="xhtml" />
Weitere Informationen über<jdoc:include /> code und wie man ihn verwendet, findet man unter jdoc statements.