Difference between revisions of "Jdoc statements/fr"

Revision as of 09:41, 23 October 2014

Other languages:

Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎español • ‎français • ‎русский • ‎فارسی • ‎中文（台灣）‎

jdoc statements are included in every Joomla template and indicate where the output from other parts of Joomla or its extensions should be positioned in the overall web page. A typical jdoc statement looks like this: <jdoc:include type="component" />

jdoc:include

La déclaration <jdoc:include /> est une méthode de template Joomla! pour afficher le contenu spécifique de la page en cours de visualisation. Il existe différentes déclarations <jdoc:include />, chacune renvoyant une partie différente d'une page Joomla!. Le remplacement lui-même est fait dans JDocumentHTML::_renderTemplate. Voir également _parseTemplate.

L'attribut type

L'attribut type spécifie le type de contenu à utiliser à la place de l'élément <jdoc:include />. Par exemple, la déclaration <jdoc:include type="head" /> utilise l'attribut type head (type="head"). (Remarque: les expressions Jdoc requiert des guillemets doubles entourant les attributs, et ne fonctionneront pas des guillemets simples. L'espace avec la fermeture /> est également obligatoire.)

Composant

<jdoc:include type="component" />

Cet élément ne doit apparaître qu'une seule fois dans l'élément <body> du Template pour afficher le contenu principal de la page en cours de visualisation.

Head

<jdoc:include type="head" />

Cet élément ne doit apparaître qu'une seule fois dans l'élément <head> du Template pour afficher le contenu du style, script et éléments méta associés à la page en cours de visualisation.

Installation

<jdoc:include type="installation" />

Cet élément est utilisé uniquement par l'Installateur de Template Joomla pour Joomla et précédent et n'a pas d'utilité particulière dans un template de Front-end ou de Back-end. C'est un peu l'équivalent du type 'component' qui affiche le contenu principal d'une étape d'installation.

Message

<jdoc:include type="message" />

This element should only appear once in the <body> element of the Template to render system and error messages that occurred in the request.

CSS styles for system messages can be found in templates\system\css\system.css

Module

<jdoc:include type="module" name="breadcrumbs" title="Breadcrumbs" />
<jdoc:include type="module" name="mainmenu" title="Main Menu" />

This element renders a single module given by the name and title attributes: name should match module type (mod_breadcrumbs and mod_menu in the examples above) while title should be the module name of the desired module. 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.

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 templatedetails.xml file. Using the jdoc:include's name="[template position name]" 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.

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.

Voir également

@@ Line 26: / Line 26: @@
 </source>
-This element is only used within the Joomla! Installer template for Joomla {{JVer|2.5}} and below and is of no particular use in a Front-end or Back-end template. It's somewhat the equivalent to the 'component' type, rendering the main content of an installation step.
+Cet élément est utilisé uniquement par l'Installateur de Template Joomla pour Joomla {{JVer|2.5}} et précédent  et n'a pas d'utilité particulière dans un template de Front-end ou de Back-end. C'est un peu l'équivalent du type 'component' qui affiche le contenu principal d'une étape d'installation.
 ==== Message ====