17.11.3 Liste des balises utilisables en texte

17.11.3.1 Valeurs atomiques

Syntaxe :

[V_<attr-name>]
[<tag>]

La valeur est la valeur positionnée par la méthode set().

Si la balise est de la forme V_<attr-name> et que <attr-name> est un attribut du document, alors la valeur est celle de l'attribut <attr-name> du document.

17.11.3.2 Valeurs multiples

Syntaxe :

[BLOCK <tag>]...[ENDBLOCK <tag>]

Les balises contenues dans une balise de bloc prennent les valeurs spécifiés par la méthode setBlockData().

L'évaluation d'un bloc est récursive, et les blocs résultants de l'évaluation d'un bloc sont alors évalués à leur tour.

17.11.3.3 Conditions

Syntaxe :

[IF <tag>]...[ENDIF <tag>]
[IFNOT <tag>]...[ENDIF <tag>]

Le contenu des balises conditionnelles est évalué, ou non, en fonction de la valeur du TAG positionnée par la méthode set().

La valeur positionnée par set() doit être une valeur booléenne PHP : true ou false.

17.11.3.4 Internationalisation de texte

Syntaxe :

[TEXT:<msg-id>]

La valeur est le message d'internationalisation correspondant à la clef <msg-id>.

17.11.3.5 Images

Syntaxe :

[IMG:<img-filename>]
[IMG:<img-filename>|<img-width>]

La valeur est une URL permettant d'accéder à l'image <img-filename> spécifiée.

Le chemin <img-filename> peut être le chemin d'un fichier image relatif à la racine du contexte, ou bien un nom de fichier qui sera recherché de la manière suivante :

• recherche dans le répertoire Images de l'application courante (e.g. img.png est alors cherché dans FOO/Images pour l'application courante FOO) ;
• si le fichier n'est pas trouvé et que l'application à des applications parentes, alors le fichier est recherché dans le répertoire Images des applications parentes.
• si le fichier n'est pas trouvé, alors le fichier est recherché dans le répertoire Images à la racine du contexte (e.g. Images/img.png)
• si le fichier n'est pas trouvé, alors l'image CORE/Images/noimage.png est utilisé à la place.

Si |<width> est présent, alors l'image est redimensionnée à la largeur width demandée. Les proportions sont conservés par le redimensionnement.

17.11.3.6 Zone

Syntaxe :

[ZONE <app-name>:<action-name>?<arg>=<val>&...]

La valeur est le résultat de l'exécution de l'action <action-name> de l'application <app-name> avec les arguments (<arg>=<val>&...) spécifiés.

17.11.3.7 JavaScript

Syntaxe :

[JS:REF]
[JS:CODE]
[JS:CODENLOG]

Pour [JS:REF], la valeur est un ensemble d'éléments HTML <script type="text/javascript" language="JavaScript" src="..." /> pour charger le script logmsg.js et les scripts JavaScript ajoutés via la méthode addJsRef().

Pour [JS:CODE], la valeur est une chaîne de caractère contenant les instructions JavaScript ajouté via la méthode addJsCode, et un code permettant d'afficher une alerte JavaScript des messages de log retournés par l'action. L’élément HTML <script type="text/javascript" language="JavaScript"/> n'est pas présent dans la valeur, par conséquent, il faut vous entouriez cet élément par les tables HTML <script> et </script> (e.g. <script ...>[JS:CODE]</script>).

Pour [JS:CODENLOG], la valeur retournée est identique à [JS:CODE] à l'exception du code permettant d'afficher l'alerte JavaScript des messages de log retournés par l'action qui n'est pas présent.

17.11.3.8 Règles de style CSS

Syntaxe :

[CSS:REF]
[CSS:CUSTOMREF]
[CSS:CODE]

Pour [CSS:REF], la valeur est un ensemble d'éléments HTML <link rel="stylesheet" ... /> pour charger le fichier CSS css/dcp/system.css et les fichiers CSS ajoutés via la méthode addCssRef().

Pour [CSS:CUSTOMREF], la valeur est identique à [CSS:REF] à l'exception du fichier CSS css/dcp/system.css qui n'est pas présent.

Pour [CSS:CODE], la valeur est une chaîne de caractère contenant les règles CSS ajoutés via la méthode addCssCode(). L'élément HTML <style/> n'est pas présent dans la valeur, par conséquent, il faut que vous entouriez cet élément par les tags HTML <style> et </style> (e.g. <style>[CSS:CODE]</style>).