Datatype : XML Block -- Bloc XML

Date de publication: le mardi 5 juin 2007 à 22h43
Dernière modification: par Pascal BOYER le jeudi 24 février 2011 à 00h45

06/05/2007 8:02

Summary / Résumé

Validates and stores multiple lines of formatted text.  
Contrôle la validité de plusieurs lignes de texte formaté puis les enregistre.

Properties / Propriétés

Description

Although there are no immediate visual clues, this datatype behaves quite differently compared to the regular "Text block" datatype. In particular, it is capable of validating and storing multiple lines of formatted text instead of just plain text. The text in an XML block must be formatted using a collection of predefined tags. The tags control the actual HTML markup of the content. eZ Publish comes with a collection of tags that cover the needs of typical everyday tasks. In addition, it is also possible to extend the system by creating custom tags for special needs.
Bien qu'il n'y ait pas de différence visuelle marquante, ce datatype se comporte tout à fait différemment de son homologue Text block. En particulier, il permet de valider puis de stocker plusieurs lignes de texte formaté et non pas simplement du texte non formaté. Le texte saisi dans un block XML doit être formaté à l'aide d'une série de balises prédéfinies. Ces balises contrôlent le marquage HTML du contenu. Bien que eZ Publish contienne, par défaut, un ensemble de balises couvrant les besoins les plus courants, il est possible d'étendre ce jeu de balises en en créant de nouvelles qui répondent à des besoins spécifiques.

Please note that the "<" sign means the beginning of an XML tag. If you need to insert a less-than sign in the normal text flow (for example, "3<5"), you will have to use the corresponding XML entity as shown below:
Retenez que le signe/symbole < représente le début d'une balise XML et que, par conséquent, si vous devez insérer dans le texte le signe inférieur à (par exemple 3<5) alors vous devrez employer, comme indiqué ci-dessous, l' entité XML correspondante:

3<5

From version 3.9, it is possible to input numerical entities and have them translated to their corresponding characters/symbols when the text is being rendered. For this to work, you need to enable the "AllowNumericEntities" configuration setting within the "[InputSettings]" block of an override for "ezxml.ini".
Depuis la version 3.9 de eZ Publish, il est possible de saisir des entités numériques qui seront traduites en leur caractères/symboles correspondants lorsque le texte sera affiché. Pour cela, vous devez activer le paramètre AllowNumericEntities de la section [InputSettings] de l'une des surcharges du fichier de configuration ezxml.ini.

By default, the datatype supports the following XML tags:
Par défaut, le datatype Bloc XML supporte les balises XML suivantes:

• Headings / Titres
• Bold text / Texte gras
• Italic text / Texte italique
• Unformatted text / Texte non formaté
• Lists / Listes
• Tables / Tableaux
• Hyperlinks / Hyperliens
• Anchors / Ancres
• Object embedding / Insertion d'objets
• Custom tags / Balises personnalisées
• Paragraphs / Paragraphes

The following screenshot shows the class attribute edit interface for this datatype.
La capture d'écran ci-dessous montre l'interface d'édition des attributs de classe dans le cas de ce datatype:

Class attribute edit interface for the "XML block" datatype
Interface d'édition des attributs de classe pour le datatype Bloc XML

Object attribute edit interface / Interface d'édition de l'attribut d'objet

The following screenshot shows the object attribute edit interface for this datatype.
La capture d'écran ci-dessous montre l'interface d'édition des attributs d'objet dans le cas de ce datatype:

Object attribute edit interface for the "XML block" datatype
Interface d'édition des attributs d'objet pour le datatype Bloc XML

Raw output / Sortie brute

The ".content" of an ezcontentobjectattribute object using this datatype returns an ezxmltext  object.
La partie .content d'un objet ezcontentobjectattribute utilisant ce datatype renvoie un objet ezxmltext .

Headings / Titres

Headings/titles can be added by making use of either the "h" or the "header" tag. The "level" parameter controls the size/level of the heading, it must be a number between 1 and 6. The optional "class" parameter allows the use of a desired CSS class. The optional "anchor_name" parameter makes it possible to add an anchor to the heading. Usage:
On ajoute des en-têtes/titres avec les balises h ou header et le paramètre level dont la valeur variant de 1 à 6 indique la taille (le niveau) de l'en-tête (ou du titre). Le paramètre optionnel class permet d'utiliser une classe CSS et le paramètre optionnel anchor_name de lier une ancre au titre. Utilisation:

<h [level=""] [class=""] [anchor_name=""] [custom_parameter="" [...] ]>Example</h>

ou

<header [level=""] [class=""] [anchor_name=""] [custom_parameter="" [...] ]>Example</header>

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [header] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leurs noms doivent être définis dans le tableau CustomAttributes[] de la section [header] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

By default, the specified levels are increased by one. In other words, a level 1 header in the XML block will become a level 2 header (H2) in the resulting HTML. The reason for this is because the H1 tag is reserved for the name / main title of the content object. The headings inside the XML block will thus become subheadings of the main title. This behavior can be changed by creating an override template for the "/content/datatype/view/ezxmltags/header.tpl" template (it can not be controlled from within an configuration file).
Par défaut, les niveaux indiqués sont incrémentés de 1, c'est à dire qu'un titre de niveau 1 dans le bloc XML devient un titre de niveau 2 dans le code HTML résultant. Ceci est dû au fait que le niveau 1 est réservé au titre/nom principal de l'objet de contenu. Les titres du bloc XML deviennent donc des sous-titres du titre principal. Cependant, ce comportement peut être modifié en créant une surcharge du template /content/datatype/view/ezxmltags/header.tpl (il n'est pas possible de contrôler ce comportement à partir d'un fichier de configuration).

Bold text / Texte gras

Bold text can be achieved by using one of the following tags: "b", "bold" or "strong". The optional "class" parameter allows the use of a desired CSS class. Usage:
Il est possible de mettre du texte en gras avec les balises b ou strong et le paramètre optionnel class permet d'utiliser une classe CSS. Utilisation:

<b [class=""] [custom_parameter="" [...] ]>Bold text.</b>

ou

<bold [class=""] [custom_parameter="" [...] ]>Bold text.</bold>

ou

<strong [class=""] [custom_parameter="" [...] ]>Bold text.</strong>

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [strong] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leurs noms doivent être définis dans le tableau CustomAttributes[] de la section [strong] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Italic text / Texte italique

Italic/emphasized text can be achieved by using one of the following tags: "i", "em" or "emphasize". The optional "class" parameter allows the use of a desired CSS class. Usage:
Il est possible de mettre du texte en italique avec les balises i, em ou emphasize et le paramètre optionnel class permet d'utiliser une classe CSS. Utilisation:

<i [class=""] [custom_parameter="" [...] ]>Emphasized text.</i>

ou

<em [class=""] [custom_parameter="" [...] ]>Emphasized text.</em>

ou

<emphasize [class=""] [custom_parameter="" [...] ]>Emphasized text.</emphasize>

The custom parameters are optional. Their names must be specified using the CustomAttributes[]  array in the [emphasize] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leurs noms doivent être définis dans le tableau CustomAttributes[] de la section [emphasize] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Unformatted text / Texte non formaté

The "literal" tag can be used to output unformatted text, for example program source code, HTML code, XML content, etc. Everything that is inside an a literal block will be rendered in the same way (character by character) as it is within the literal tags (the text will be output using the HTML PRE tags). The optional "class" parameter allows the use of a desired CSS class. Usage:
La balise literal permet de créer du texte non formaté. Par exemple, pour du code de programmation, du code HTML, du contenu XML, etc... Tout ce qui est inséré dans un bloc literal est retourné/affiché de la même manière (au caractère près) que s'il était placé à l'intérieur des balises literal (le texte résultant sera produit en utilisant les balises HTML pre). Le paramètre optionnel class permet d'utiliser une classe CSS. Utilisation:

<literal [class=""] [custom_parameter="" [...] ]>Example<\literal>

Please note that in the example above, the slash is in the wrong way within the tag that terminates the literal block. This was done in order to make the tag appear on the documentation page (since we're using literal tags to make code blocks). In other words, it should be terminated with a frontslash instead of a backslash.
Retenez que dans l'exemple ci-dessus, le slash ("\") placé à l'intérieur de la blise literal fermante n'est pas dans le bon sens. C'est un fait exprès afin que la balise apparaisse dans ce document mais dans la réalité il doit être dans l'autre sens ("/").

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [literal] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leurs noms doivent être définis dans le tableau CustomAttributes[] de la section [literal] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Lists / Listes

It is possible to create lists in the same way as in HTML by making use of the "ol", "ul" and "li" tags. The lists can be nested. The optional "class" parameter allows the use of a desired CSS class. The following examples demonstrate the usage of ordered and unordered lists.
Les balises ol, ul et li sont employées, exactement comme en HTML, pour créer des listes. Celles-ci peuvent être imbriquées et le paramètre optionnel class permet d'utiliser une classe CSS. Les exemples suivants illustrent la création de listes ordonnées et non ordonnées.

Ordered lists / Listes ordonnées

<ol [class=""] [custom_parameter="" [...] ]>
    <li [class=""] [custom_parameter="" [...] ]>Element 1</li>
    <li [class=""] [custom_parameter="" [...] ]>Element 2</li>
    <li [class=""] [custom_parameter="" [...] ]>Element 3</li>
</ol>

Unordered lists / Listes non ordonnées

<ul [class=""] [custom_parameter="" [...] ]>
    <li [class=""] [custom_parameter="" [...] ]>Element 1</li>
    <li [class=""] [custom_parameter="" [...] ]>Element 2</li>
    <li [class=""] [custom_parameter="" [...] ]>Element 3</li>
</ul>

The custom parameters are optional. In order to use them, their names must be specified using the "CustomAttributes[]" array in the [ol], [ul], [li] blocks within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leurs noms doivent être définis dans le tableau CustomAttributes[] des sections [ol], [ul] et [li] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Tables / Tableaux

Tables can be created in the same way as in HTML using "table", "tr", "th" and "td" tags. The tables can be nested.
Tout comme en HTML, les balises table, tr, th et td servent à créer des tableaux. Il est possible de créer des tableaux imbriqués.

<table [class=""] [border=""] [width=""] [custom_parameter="" [...] ]>
...
</table>

The "class", "border" and "width" parameters are optional. The "class" parameter can be used to assign a desired CSS class. The "border" parameter can be used to set a border (number of pixels). The "width" parameter can be used to control the table width (either 0-100% or number of pixels). Table content should be written according to normal HTML table syntax with "tr", "th" and "td" tags, see below.
Les paramètres class, border et width sont optionnels et le paramètre class permet d'utiliser une classe CSS. Le paramètre border sert à définir, en pixel, la taille d'une bordure. Quant au paramètre width il contrôle la largeur du tableau (soit entre 0 et 100% soit en nombre de pixels). Le contenu d'un tableau doit être écrit en respectant la syntaxe HTML des tableaux et à l'aide des balises tr, th et td comme indiqué ci-dessous.

Table rows / Lignes du tableau

Table rows can be created in the same way as in HTML:
Les lignes d'un tableau sont créées de la même manière qu'en HTML:

<tr [class=""] [custom_parameter="" [...] ]>Table row content goes here.</tr>

The "class" parameter can be used to set the desired CSS class.
Le paramètre class permet d'utiliser une classe CSS.

Table headers / En-tête du tableau

Table headers can be created in the same way as in HTML:
Les en-têtes du tableau sont créés de la même manière qu'en HTML:

<th [class=""] [width=""] [rowspan=""] [colspan=""] [custom_parameter="" [...] ]>Example.</th>

All parameters are optional. The "class" parameter can be used to set the desired CSS class. The "width" parameter can be used to set the width (either as percentage or number of pixels). The "rowspan" and "colspan" parameters are the same as in HTML.
Tous les paramètres sont optionnels et le paramètre class permet d'utiliser une classe CSS. Le paramètre width contrôle la largeur de la cellule d'en-tête (soit en pourcentage soit en nombre de pixels). Quant aux paramètres rowspan et colspan ils remplissent le même rôle qu'en HTML.

Table data/cell / Cellules/données du tableau

Table data/cells can be created in the same way as in HTML:
Les données et les cellules du tableau sont créées de la même manière qu'en HTML:

<td [class=""] [width=""] [rowspan=""] [colspan=""] [custom_parameter="" [...] ]>Example.</td>

All parameters are optional. The "class" parameter can be used to set the desired CSS class. The "width" parameter can be used to set the width (either as percentage or number of pixels). The "rowspan" and "colspan" parameters are the same as in HTML.
Tous les paramètres sont optionnels et le paramètre class permet d'utiliser une classe CSS. Le paramètre width contrôle la largeur de la cellule (soit en pourcentage soit en nombre de pixels). Quant aux paramètres rowspan et colspan ils remplissent le même rôle qu'en HTML.

Note that all custom parameters mentioned in the usage examples are optional as well. In order to use them, their names must be specified using the "CustomAttributes[]" array in the [table], [tr], [th], [td] blocks within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Retenez que tous les paramètres personnalisés mentionnés dans les exemples d’utilisation sont également optionnels. Pour les employer, leurs noms doivent être définis dans le tableau CustomAttributes[] des sections [table], [tr], [th] et [td] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Hyperlinks / Hyperliens

Hyperlinks can be inserted by making use of the "a" or the "link" tags. Usage:
Les hyperliens sont créés à l'aide des balises a ou link. Utilisation:

<a href="" [view=""] [target=""] [ class=""] [title=""] [id=""] [custom_parameter="" [...] ]>Example.</a>

ou

<link href="" [view=""] [target=""] [ class=""] [title=""] [id=""] [custom_parameter="" [...] ]>Example.</link>

The "href" parameter is required and it must be set to a valid address (either external or internal).
Le paramètre obligatoire href doit contenir une adresse web valide (qui peut être externe ou interne).

The "view" parameter will only have effect when used together with internal links (see below). This parameter makes it possible to specify the view mode that will be used when the node (or object) which the internal link points to is shown. By default, the system always uses the "full" view mode to show the contents of internal links.
Le paramètre view n'aura d'effet que s'il est utilisé conjointement à un lien interne (voir ci-dessous). Ce paramètre permet de spécifier le mode de vue qui sera utilisé pour afficher le noeud (ou l'objet) pointé par le lien interne. Par défaut, le système a toujours recours au mode de vue full pour afficher les contenus pointés par les liens internes.

The "target" parameter can be used to control how the target URL should be opened (inside the existing/active browser window/tab or within a new window/tab). The "class" parameter can be used to specify a CSS class that should be used when the link is rendered. The "title" parameter can be used to specify a short title text (will be shown when the pointer is hovering over the link). The "id" parameter is for assigning unique identifiers.
Le paramètre target permet de définir la manière dont doit s'ouvrir l'URL cible (dans la fénêtre active du navigateur ou dans une nouvelle fenêtre ou dans un nouvel onglet, etc...). Le paramètre class permet d'utiliser une classe CSS pour l'affichage du lien. Le paramètre title permet de spécifier un court texte qui sera affiché dans une petite bulle lorsque le pointeur de la souris survolera le lien. Enfin, le paramètre id sert à assigner des identifiants uniques.

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [link] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leurs noms doivent être définis dans le tableau CustomAttributes[] de la section [link] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Internal links / Liens internes

It is possible to create internal links (to other nodes and objects) by making use of the "eznode://" and the "ezobject://" notation. The internal links will be created dynamically based on the node/object ID numbers. In other words, if a node is moved, the link(s) will point to the new location(s) and thus they will not be broken.
Il est possible de créer des liens internes (vers d'autres noeuds ou objets) avec les syntaxes eznode:// ou ezobject:// qui créeront dynamiquement le lien interne en se basant sur le numéro de ID du noeud ou de l'objet. Donc, si un noeud est déplacé, le lien pointera vers le nouvel emplacement et restera donc valide.

Link to a node / Lien vers un noeud

A link to a node can be created either by specifying the target node's ID number or the node path. The following examples demonstrate how an internal link to node number 128 can be created.
Un lien pointant vers un noeud est créé en spécifiant soit le numéro de ID du noeud cible soit sont chemin. Les exemples suivants illustrent comment créer un lien interne vers le noeud 128:

<a href="eznode://128">Example.</a>

ou

<link href="eznode://128">Example.</link>

The following examples demonstrate how an internal link to a node located at "products/computers/example" can be created.
Les exemples suivants illustrent la création d'un lien interne vers un noeud dont le chemin est products/computers/example:

<a href="eznode://products/computers/example">Example.</a>

ou

<link href="eznode://products/computers/example">Example.</link>

Link to an object / Lien vers un objet

The following examples demonstrate how an internal link to object number 1024 can be created.
Les exemples suivants illustrent comment créer un lien interne vers l'objet 1024:

<a href="ezobject://1024">Example.</a>

ou

<link href="ezobject://1024">Example.</link>

When object linking is used, the destination address will be generated using the main node assignment of the target object.
Lorsque l'on crée un lien vers un objet, l'adresse de destination est générée en utilisant l'affectation du noeud principal de l'objet cible.

Alternate views / Vues alternatives

The "view" parameter can be used together with both "eznode://" and "ezobject://" links. It makes it possible to display the specified node (if object, its main node will be used) using a specific view mode instead of the default "full" view mode. The following example shows how to create an internal link that (when clicked/followed) brings up node number 1024 using the "line" view mode.
Le paramètre view peut être utilisé avec les deux syntaxes eznode:// et ezobject:// et permet d'afficher le noeud indiqué (pour un objet, c'est son noeud principal qui sera utilisé) par le biais d'un mode de vue spécifique plutôt que par le biais du mode de vue par défaut full. Les exemples suivants illustrent la création d'un lien interne qui, lorsque l'on clique dessus, affiche le noeud 1024 en utilisant le mode de vue line:

<a href="eznode://1024" view="line">Example (as line).</a>

Anchors / Ancres

The "anchor" tag makes it possible to insert HTML anchors inside the XML block. The inserted anchors will work like standard HTML anchors. Usage:
La balise anchor permet d'insérer, dans un bloc XML, des ancres HTML fonctionnant de la même manière que les ancres HTML standards. Utilisation:

<anchor name="" [custom_parameter="" [...] ] />

The "name" parameter must be set to a unique identifier for the anchor. Anchors can be reached by appending the hash character (#) followed directly by the name of the anchor that the browser should jump to. Example: http://www.example.com/hobbies#music
Le paramètre name doit contenir un identifiant unique assigné à l'ancre. Il est possible de rechercher une ancre en ajoutant, à la fin d'un URI, le symbole dièse (#) suivi du nom de l'ancre. Cela aura pour effet d'afficher, dans le navigateur, le texte à partir de la position de l'ancre. Par exemple: http://www.example.com/hobbies#music

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [anchor] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leurs noms doivent être définis dans le tableau CustomAttributes[] de la section [anchor] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Object embedding / Intégration d'objets

The "embed" tag makes it possible to insert an arbitrary content object directly in the XML block. It can for example be used to embed images. Usage:
Avec la balise embed il devient possible d'intégrer dans le bloc XML n'importe quel contenu d'objet. Cela permet d'insérer, par exemple, des images. Utilisation:

<embed href="" [class=""] [view=""] [align=""] [target=""] [size=""] [id=""] [custom_parameter="" [...] ] />

With this tag, embedded objects are inserted as "block elements". Such an element always begins on a new line when it is displayed. It exists in its own virtual box and is always followed by a carriage return (like if someone hit the "Enter" key after inserting the object). This means that, for example, inserting an image using the "embed" tag will break the current paragraph. The "embed" tag is represented by block-level tags in the resulting XHTML code.
Avec cette balise, les objets intégrés sont insérés en tant que bloc et leur affichage commence donc toujours sur une nouvelle ligne. L'élément est dans un conteneur virtuel qui lui est propre et est systématiquement suivi d'un retour chariot (comme si on appuyait sur la touche Entrée après avoir inséré l'objet). Ce qui signifie, par exemple, que l'insertion d'une image à l'aide d'une balise embed aura pour effet de casser le paragraphe courant. Cette balise est représentée par des balises de type bloc (???) dans le code XHTML résultant.

The "embed-inline" tag makes it possible to insert objects as inline elements. For example, this tag allows you to insert an image inside a text line. Usage:
La balise embed-inline permet d'intégrre des objets en tant qu'éléments en ligne. Cette balise vous permet par exemple d'intégrer une image dans une ligne de texte. Utilisation:

<embed-inline href="" [class=""] [view=""] [align=""] [target=""] [size=""] [id=""] [custom_parameter="" [...] ] />
 

This tag is represented by inline tags in the resulting XHTML code. The templates that are used for rendering "embed-inline" tags must not contain block-level XHTML tags.
Cette balise est représentée par des balises en ligne dans le code XHTML résultant. Les templates utilisés pour afficher les balises embed-inline ne doivent contenir aucune balise XHTML de type bloc.

The following table reveals the list of parameters supported by the "embed" and "embed-inline" tags.
Le tableau ci-dessous détaille la liste des paramètres supportés par les balises embed et embed-inline:

Custom tags / Balises personnalisées

In addition to the default tags described above, the "XML block" datatype makes it possible to use custom tags. A custom tag can be used both as a block or an inline element. Custom tags must be specified using the "AvailableCustomTags[]" array in the [CustomTagSettings] block within an override for the "content.ini" configuration file. When the XML is rendered, the contents of a custom tag will be replaced by a custom template. The name of the template must be specified using the "name" parameter. Example of usage:
En plus des balises présentes par défaut et décrites ci-dessus, le datatype Bloc XML permet l'usage de balises personnalisées. Ces dernières peuvent être employées aussi bien en tant qu'élément de type bloc ou de type en ligne. Les balises personnalisées doivent être définies dans le tableau AvailableCustomTags[] de la section [CustomTagSettings] de l'une des surcharges du fichier de configuration content.ini. Lors du rendu du code XML, le contenu d'une balise personnalisée est remplacé par un template personnalisé dont le nom doit être affecté au paramètre name. Exemple d'utilisation:

<custom name="template_name" [custom_parameter="value" [...] ]>
The quick brown fox jumps over the lazy dog.
</custom>

The custom tag in the example above will be replaced by a template called "template_name.tpl". This template must be located in the following directory within the current design: "/templates/content/datatype/view/ezxmltags/" (or one of the fallback designs). It is also possible to create an override template. The contents of the tag will be available in the "$content" variable within the inserted template.
Dans l'exemple ci-dessus, la balise personnalisée sera remplacée par un template appelé template_name.tpl situé dans le répertoire /templates/content/datatype/view/ezxmltags/ du design courant (ou d'un design de replis). Il est également possible de créer une surcharge de ce template. Le contenu de la balise sera disponible dans le template inséré via la variable $content.

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leurs noms doivent être définis dans le tableau CustomAttributes[] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Paragraphs / Paragraphes

Paragraphs can be added by making use of either the 'p' or the 'paragraph' tag.
Les paragraphes sont créés au moyen des balises p ou paragraph.

The optional 'class' parameter allows the use of a desired CSS class. If you do not specify the class parameter, the paragraph will be displayed in a natural way (without tags) in the administration interface. To create a non-classified paragraph, you can simply press 'Enter' key twice.
Le paramètre optionnel class permet d'utiliser une classe CSS. Si vous ne spécifiez pas ce paramètre, le paragraphe sera affiché de façon naturelle (sans balise) dans l'interface d'administration. Pour créer un paragraphe assigné d'aucune classe CSS il vous suffit d'appuyer deux fois sur la touche Entrée de votre clavier.

Usage:
Utilisation:

<p [class=""] [custom_parameter="" [...] ]>Example</p>

ou

<paragraph [class=""] [custom_parameter="" [...] ]>Example</paragraph>

By default, the system will use 'p' tag in the resulting XHTML code. This behavior can be changed by creating an override template for the '/content/datatype/view/ezxmltags/paragraph.tpl'.
Par défaut, le système utilise la balise p dans le code XHTML résultant. Ce comportement peut être modifié en créant une surcharge du template /content/datatype/view/ezxmltags/ paragraph.tpl

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [paragraph] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leurs noms doivent être définis dans le tableau CustomAttributes[] de la section [paragraph] de l'une des surcharges du fichier de configuration content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.