Modulpositionen festlegen

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 • ‎русский • ‎中文(台灣)‎

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.

Siehe auch