Jdoc statements/de: Difference between revisions
From Joomla! Documentation
Created page with "Dieses Element rendert ein einzelnes Modul, das durch die Attribute <tt>name</tt> und <tt>title</tt> gegeben ist: <tt>name</tt> sollte mit dem Modultyp übereinstimmen (mod_br..." |
Created page with "Module werden auf einer Seite mit einem der folgenden Code-Beispiele gerendert. Die Module werden in verschiedene Bereiche einer Vorlage unterteilt, indem die Vorlagenposition..." |
||
| Line 47: | Line 47: | ||
==== Modules ==== | ==== Modules ==== | ||
Module werden auf einer Seite mit einem der folgenden Code-Beispiele gerendert. Die Module werden in verschiedene Bereiche einer Vorlage unterteilt, indem die Vorlagenpositionen in der Datei <code>jdoc:include</code>'s <code>name="''[template position name]''"</code> attribute, festgelegt werden. Mit dem Attribut <code>jdoc:include</code>'s <code>name="'''[template position name]'''"</code>"</code> können die verschiedenen Module an ihren jeweiligen Positionen aufgerufen, gerendert und separat gestaltet werden. Zusätzliche Attribute können bereitgestellt werden, um das Layout und das Aussehen von Modulen zu steuern, falls unterstützt. | |||
Below are some examples of module statements with module positions used frequently by Joomla! theme developers. | Below are some examples of module statements with module positions used frequently by Joomla! theme developers. | ||
Revision as of 15:52, 22 April 2019
jdoc-Anweisungen sind in jedem Joomla template enthalten und geben an, wo die Ausgabe von anderen Teilen von Joomla oder deren Erweiterungen in der gesamten Webseite positioniert werden soll. Ein typisches jdoc-Statement sieht so aus: <jdoc:include type="component" />
jdoc:include
Die <jdoc:include /> Anweisung ist eine Joomla! Template Methode zur Anzeige von Inhalten, die spezifisch für die betrachtete Seite sind. Es gibt verschiedene <jdoc:include /> Anweisungen, die jeweils einen anderen Teil einer Joomla! Seite zurückgeben. Der Austausch selbst erfolgt in JDocumentHTML::_renderTemplate. Siehe auch _parseTemplate.
Das Typ-Attribut
Das Attribut type gibt die Art des zu rendernden Inhalts anstelle des Elements <jdoc:include /> an. Beispielsweise enthält das <jdoc:include ''type="head"''''''''''. /></Anweisung verwendet das type attribute head (type="head"). (Hinweis: Jdoc-Ausdrücke erfordern doppelte Anführungszeichen um Attribute herum und funktionieren nicht mit einfachen Anführungszeichen. Das Leerzeichen vor dem Schließen /> ist ebenfalls obligatorisch'.)
Komponente
<jdoc:include type="component" />
Dieses Element sollte nur einmal im <body> Element der Vorlage erscheinen, um den Hauptinhalt der Seite in Bezug auf die aktuelle Seite darzustellen.
Kopf
<jdoc:include type="head" />
Dieses Element sollte nur einmal im <head> Element der Vorlage erscheinen, um den Inhalt der Stil-, Skript- und Metaelemente der aktuellen Seite darzustellen.
Installation
<jdoc:include type="installation" />
Dieses Element wird nur innerhalb der Joomla! Installer-Vorlage für Joomla 
und darunter verwendet und ist in einer Front-end oder Backend-Vorlage nicht besonders nützlich. Es ist in etwa gleichbedeutend mit dem Typ "Komponente", der den Hauptinhalt eines Installationsschrittes wiedergibt.
Nachricht
<jdoc:include type="message" />
Dieses Element sollte nur einmal im <body> Element der Vorlage erscheinen, um System- und Fehlermeldungen, die in der Anforderung aufgetreten sind, darzustellen.
CSS-Stile für Systemnachrichten finden Sie unter templates\system\css\system.css
Module
<jdoc:include type="module" name="breadcrumbs" title="Breadcrumbs" />
<jdoc:include type="module" name="mainmenu" title="Main Menu" />
Dieses Element rendert ein einzelnes Modul, das durch die Attribute name und title gegeben ist: name sollte mit dem Modultyp übereinstimmen (mod_breadcrumbs und mod_menu in den obigen Beispielen), während title der Modulname des gewünschten Moduls sein sollte.
Das betreffende Modul muss für den aktuellen Benutzer veröffentlicht und zugänglich sein, um sichtbar zu werden. Zusätzliche Attribute können bereitgestellt werden, um das Layout und das Aussehen des Moduls zu steuern, falls unterstützt.
Modules
Module werden auf einer Seite mit einem der folgenden Code-Beispiele gerendert. Die Module werden in verschiedene Bereiche einer Vorlage unterteilt, indem die Vorlagenpositionen in der Datei können die verschiedenen Module an ihren jeweiligen Positionen aufgerufen, gerendert und separat gestaltet werden. Zusätzliche Attribute können bereitgestellt werden, um das Layout und das Aussehen von Modulen zu steuern, falls unterstützt.
jdoc:include's name="[template position name]" attribute, festgelegt werden. Mit dem Attribut jdoc:include's name="[template position name]""
Below are some examples of module statements with module positions used frequently by Joomla! theme developers.
<jdoc:include type="modules" name="debug" />
<jdoc:include type="modules" name="icon" />
<jdoc:include type="modules" name="left" style="rounded" />
<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="toolbar" />
<jdoc:include type="modules" name="top" />
<jdoc:include type="modules" name="top" style="xhtml" />
<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" />
Note: The name="user3" module position is normally (by default) used for the top menu.
The style attribute
The optional style="" attribute is available for the module and modules types of <jdoc:include /> statements. The attribute value refers to the chrome style used to wrap the output generated by the Module. If no style is provided, a value of "none" is used by default.
Template designers may add additional chrome names as described in Applying custom module chrome.