Nach oben scrollen

Joomla jdoc


 

Jedes Joomla Template enthält jdoc Elemente. Jdoc Elemente werden im Content Management System (kurz CMS ) Joomla benötigt, um Inhalte von Joomla-Modulen auszugeben. Bei der Joomla Template-Erstellung muss man die Datei templateDetails.xml anlegen. Die templateDetails.xml enthält unter anderem die Positionen, die ein Joomla Modul mittels jdoc <Tags> einnehmen kann.

 

Erklärung der jdoc Tags in einem Joomla Template:

 

jdoc:include

Die <jdoc:include /> Anweisung gibt Elemente des Inhaltes einer Joomla-Homepage aus. Es gibt viele unterschiedliche <jdoc:include /> Anweisungen, jedes gibt ein anderes Joomla-Element aus.

 

Das type Attribut

Das type Attribut deklariert den Inhalt, welches durch <jdoc:include /> ausgegeben wird. Als Beispiel: <jdoc:include type="head" /> gibt die Header-Daten aus (z.B. Meta-Tags).
ACHTUNG: jdoc Anweisungen werden immer in doppelten (<jdoc:inlcude type="head" />) Anführungszeichen geschrieben.

 

Das component Attribut

Das component Attribut sollte nur einmal im <body></body> einer Joomla-Homepage vorhanden sein, es gibt die Inhalte (Beiträge) der Homepage aus.

 

<jdoc:include type="component" />

 

Das head Attribut

Das head Attribut sollte wie das component Attribut im <body> nur einmal im <head></head> einer Homepage vorkommen. Es wird benötigt, um Scripte und Meta-Daten einzufügen und auszugeben.

 

<jodc:include type="head" />

 

Message Attribut

Auch das Message Attribut sollte nur einmal im <body></body> Element vorkommen. Man platziert es am besten ober- oder unterhalb des component Attributs. Es wird benötigt um Anfrage- und/oder Fehler-Meldungen der Homepage auszugeben. Die Dateien für das CSS-Layout der System-Meldungen liegen in templates\system\css\system.css

 

<jdoc:include type="message" />

 

Module Attribut

Das modul Attribut gibt Inhalte eines einzelnen Modules anhand des name und titel Attributes aus.

name sollte mit dem Modul-Typ übereinstimmen (mod_search oder mod_breadcrumbs), title sollte der Name des benötigten Modules sein.

 

<jdoc:include type="module" name="search" title="Search" />                             Suchfeld für die Suche innerhalb der Homepage
<jodc:include type="module" name="breadcrumbs" title="Breadcrumbs" />            Gibt den Klickpfad einer Homepage aus 

 

Modules Attribut

Mit dem modules Attribut werden alle anderen Module mittels einer Positionsangabe in der templateDetails.xml eingebunden.
Beispiel:

 

<jdoc:include type="modules" name="left" />
<jdoc:include type="modules" name="right" />
<jdoc:include type="modules" name="top" />

 

Positionsangabe in der templateDetails.xml müssen mit dem name-Attribut übereinstimmen!

Hier noch ein paar Standard Joomla Beispiele :

<jdoc:include type="modules" name="user1" style="xhtml" />
<jdoc:include type="modules" name="user2" style="xhtml" />
<jdoc:include type="modules" name="user3" />
<jdoc:include type="modules" name="user4" />
<jdoc:include type="modules" name="debug" />
<jdoc:include type="modules" name="icon" />
<jdoc:include type="modules" name="left" style="xhtml" />
<jdoc:include type="modules" name="right" style="xhtml" />
<jdoc:include type="modules" name="status" />
<jdoc:include type="modules" name="syndicate" />
<jdoc:include type="modules" name="title" />
<jdoc:include type="modules" name="top" />
<jdoc:include type="modules" name="top" style="xhtml" />

 

Ausschnitt aus der templateDetails.xml zu den Positionen

Hier ein Ausschnitt der templateDetails.xml der Standartpositionen eines Joomla-Templates. Alle Positionen können natürlich nach Belieben geändert 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>
</positions>

 

style Attribut

Das style - Attribut kann für module und für modules verwendet werden. Wenn kein style Attribut angegeben wurde, wird als Standard none verwendet. Bei Joomla 1.5 kann es zu einem Bug kommen, der die Modul Titel nicht mehr anzeigt. Damit die Modul-Titel wieder angezeigt werden, einfach das style="xhtml" Attribut angeben.