Jdoc statements/de: Difference between revisions

Latest revision as of 20:48, 5 April 2020

Jdoc-Anweisungen sind in jedem Joomla-Template enthalten und geben an, wo die Ausgabe von anderen Teilen von Joomla oder Erweiterungen in der gesamten Webseite positioniert werden soll. Ein typisches jdoc-Statement sieht so aus: <jdoc:include type="component" />

jdoc:include

Die Anweisung <jdoc:include /> ist eine 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 über 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 die Anweisung <jdoc:include type="head" /> das type-Attribut head (type="head"). (Hinweis: Jdoc-Ausdrücke erfordern doppelte Anführungszeichen um die Attribute und funktionieren nicht mit einfachen Anführungszeichen. Das Leerzeichen vor dem abschließenden /> ist ebenfalls obligatorisch.)

Komponente

<jdoc:include type="component" />

Dieses Element sollte nur einmal im <body>-Element des Templates erscheinen, um den Hauptinhalt für die aktuelle Seite darzustellen.

Head

<jdoc:include type="head" />

Dieses Element sollte nur einmal im <head>-Element des Templates erscheinen, um den Inhalt der CSS-, 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 einem Frontend oder Backend-Template nicht besonders nützlich. Es ist in etwa gleichbedeutend mit dem Typ "Komponente" und gibt den Hauptinhalt eines Installationsschrittes wieder.

Message

<jdoc:include type="message" />

Dieses Element sollte nur einmal im <body> Element der Vorlage erscheinen, um System- und Fehlermeldungen, die während der Anfrage aufgetreten sind, darzustellen.

CSS-Stile für Systemnachrichten sind hier zu finden: 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 jdoc:include's name="[template position name]" attribute, festgelegt werden. Mit dem Attribut jdoc:include's name="[template position name]"" 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.

Nachfolgend finden Sie einige Beispiele für Modulanweisungen mit Modulpositionen, die von Joomla! Template-Entwicklern häufig verwendet werden.

<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" />

Hinweis: Die Position des name="user3" Moduls wird normalerweise (standardmäßig) für das Top-Menü verwendet.

Das Style-Attribut

Das optionale Attribut style="" ist für die Typen module und module von <jdoc:include /> Anweisungen verfügbar. Der Attributwert bezieht sich auf den Stil chrome, mit dem die vom Modul generierte Ausgabe "umhüllt" wird. Wenn kein Stil angegeben wird, wird standardmäßig der Wert "none" verwendet.

Template-Designer können zusätzliche Chrome-Namen hinzufügen, wie in Applying custom module chrome beschrieben.

Siehe auch

@@ Line 1: / Line 1: @@
 <noinclude><languages /></noinclude>
-jdoc-Anweisungen sind in jedem Joomla [[S:MyLanguage/Template|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: <code><jdoc:include type="component" /></code>
+Jdoc-Anweisungen sind in jedem Joomla-[[S:MyLanguage/Template|Template]] enthalten und geben an, wo die Ausgabe von anderen Teilen von Joomla oder Erweiterungen in der gesamten Webseite positioniert werden soll.  Ein typisches jdoc-Statement sieht so aus: <code><jdoc:include type="component" /></code>
 == jdoc:include ==
-Die <code><jdoc:include /></code> Anweisung ist eine Joomla! Template Methode zur Anzeige von Inhalten, die spezifisch für die betrachtete Seite sind. Es gibt verschiedene <code><jdoc:include /></code> Anweisungen, die jeweils einen anderen Teil einer Joomla! Seite zurückgeben. Der Austausch selbst erfolgt in JDocumentHTML::_renderTemplate. Siehe auch _parseTemplate.
+Die Anweisung <code><jdoc:include /></code> ist eine Template-Methode zur Anzeige von Inhalten, die spezifisch für die betrachtete Seite sind. Es gibt verschiedene <code><jdoc:include /></code>-Anweisungen, die jeweils einen anderen Teil einer Joomla! Seite zurückgeben. Der Austausch selbst erfolgt über JDocumentHTML::_renderTemplate. Siehe auch _parseTemplate.
 === Das Typ-Attribut ===
-Das Attribut <tt>type</tt> gibt die Art des zu rendernden Inhalts anstelle des Elements <code><jdoc:include /></code> an. Beispielsweise enthält das <code><jdoc:include '''''''type="head"'''''''''''''''. /></Anweisung verwendet das <code>type</code> attribute <code>head</code> (<code>type="head"</code>). (''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'''.)
+Das Attribut <tt>type</tt> gibt die Art des zu rendernden Inhalts anstelle des Elements <code><jdoc:include /></code> an. Beispielsweise enthält die Anweisung <code><jdoc:include '''type="head"''' /></code> das <code>type</code>-Attribut <code>head</code> (<code>type="head"</code>). (''Hinweis: Jdoc-Ausdrücke erfordern doppelte Anführungszeichen um die Attribute und funktionieren nicht mit einfachen Anführungszeichen. Das Leerzeichen vor dem abschließenden /> ist ebenfalls obligatorisch''.)
 ==== Komponente ====
@@ Line 12: / Line 12: @@
 </source>
-Dieses Element sollte nur einmal im <body> Element der Vorlage erscheinen, um den Hauptinhalt der Seite in Bezug auf die aktuelle Seite darzustellen.
+Dieses Element sollte nur einmal im <body>-Element des Templates erscheinen, um den Hauptinhalt für die aktuelle Seite darzustellen.
-==== Kopf ====
+==== Head ====
 <source lang="html4strict">
 <jdoc:include type="head" />
 </source>
-Dieses Element sollte nur einmal im <head> Element der Vorlage erscheinen, um den Inhalt der Stil-, Skript- und Metaelemente der aktuellen Seite darzustellen.
+Dieses Element sollte nur einmal im <head>-Element des Templates erscheinen, um den Inhalt der CSS-, Skript- und Metaelemente der aktuellen Seite darzustellen.
 ==== Installation ====
@@ Line 26: / Line 26: @@
 </source>
-Dieses Element wird nur innerhalb der Joomla! Installer-Vorlage für Joomla {{JVer|2.5}} 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.
+Dieses Element wird nur innerhalb der Joomla! Installer-Vorlage für Joomla {{JVer|2.5}} und darunter verwendet und ist in einem Frontend oder Backend-Template nicht besonders nützlich. Es ist in etwa gleichbedeutend mit dem Typ "Komponente" und gibt den Hauptinhalt eines Installationsschrittes wieder.
 ==== Message ====
@@ Line 33: / Line 33: @@
 </source>
-This element should only appear once in the <body> element of the Template to render system and error messages that occurred in the request.
+Dieses Element sollte nur einmal im <body> Element der Vorlage erscheinen, um System- und Fehlermeldungen, die während der Anfrage aufgetreten sind, darzustellen.
-CSS styles for system messages can be found in templates\system\css\system.css
+CSS-Stile für Systemnachrichten sind hier zu finden: templates\system\css\system.css
 ==== Module ====
@@ Line 43: / Line 43: @@
 </source>
-This element renders a single module given by the <tt>name</tt> and <tt>title</tt> attributes: <tt>name</tt> should match module type (mod_breadcrumbs and mod_menu in the examples above) while <tt>title</tt> should be the module name of the desired module.
+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_breadcrumbs und mod_menu in den obigen Beispielen), während <tt>title</tt> der Modulname des gewünschten Moduls sein sollte.
-The module in question must be published and accessible by the current user in order to become visible. Additional attributes can be provided to control the layout and appearance of the module, if supported.
+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 ====
-Modules are rendered on a page using one of the following code examples. The modules are separated into different areas of a template using template positions set in the <code>templatedetails.xml</code> file. Using the <code>jdoc:include</code>'s <code>name="''[template position name]''"</code> attribute, the various modules in their respective positions can be called, rendered, and styled separately. Additional attributes can be provided to control the layout and appearance of modules, if supported.
+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.
+Nachfolgend finden Sie einige Beispiele für Modulanweisungen mit Modulpositionen, die von Joomla! Template-Entwicklern häufig verwendet werden.
 <source lang="html4strict">
@@ Line 68: / Line 68: @@
 <jdoc:include type="modules" name="user4" />
 </source>
-'''Note:''' The <code>name="user3"</code> module position is normally (by default) used for the top menu.
+'''Hinweis:''' Die Position des <code>name="user3"</code> Moduls wird normalerweise (standardmäßig) für das Top-Menü verwendet.
-=== The style attribute ===
+=== Das Style-Attribut ===
-The optional <code>style=""</code> attribute is available for the <code>module</code> and <code>modules</code> types of <code><jdoc:include /></code> statements. The attribute value refers to the [[S:MyLanguage/Module chrome|chrome]] style used to wrap the output generated by the Module. If no style is provided, a value of "<code>none</code>" is used by default.
+Das optionale Attribut <code>style=""</code> ist für die Typen <code>module</code> und <code>module</code> von <code><jdoc:include /></code> Anweisungen verfügbar. Der Attributwert bezieht sich auf den Stil [[S:MyLanguage/Module chrome|chrome]], mit dem die vom Modul generierte Ausgabe "umhüllt" wird. Wenn kein Stil angegeben wird, wird standardmäßig der Wert "<code>none</code>" verwendet.
-Template designers may add additional chrome names as described in [[S:MyLanguage/Applying custom module chrome|Applying custom module chrome]].
+Template-Designer können zusätzliche Chrome-Namen hinzufügen, wie in [[S:MyLanguage/Applying custom module chrome|Applying custom module chrome]] beschrieben.
-==See also==
+== Siehe auch ==
-* [[S:MyLanguage/Understanding Joomla! templates|Understanding Joomla! templates]]
+* [[S:MyLanguage/Understanding Joomla! templates|Joomla!-Templates verstehen]]
-* [[S:MyLanguage/Creating a basic Joomla! template|Creating a basic Joomla! template]]
+* [[S:MyLanguage/Creating a basic Joomla! template|Erstellung eines einfachen Joomla! Templates]]
-[[Category:Templates]]
+[[Category:Templates/de]]
-[[Category:Landing Pages]]
+[[Category:Landing Pages/de]]