Balises templates

Balises surchargées

Les balises actuellements surchargées sont les balises

  • <tpl:EntryIf> (objet par défaut : entry)
  • <tpl:CategoryIf> (objet par défaut : category)
  • <tpl:SysIf> (objet par défaut)

Elles acceptent désormais l'attribut "expr" qui permet de tester une expression.

Chacune de ces balises a un objet par défaut, il est alors inutile de l'utiliser en préfixe de la variable voulue (ex pour <tpl:EntryIf> : content sera équivalent à entry.content)

Nouvelles balises

<tpl:If expr="expr">...<tpl:If>

Affiche le code inclus si l'expression entrée est vraie

{{tpl:Set var="variable" expr="expr"}}

Définit une variable et lui attribue le résultat de l'expression expr. La variable est définie dans l'objet "my", et est accessible via my.mavariable

{{tpl:Echo expr="expr"}}

Affiche le résultat de l'expression passée en paramètre.

Objets définis

my

Cet objet est par défaut vide, il est enrichi de l'ensemble des variables qui auront été définies via {{tpl:Set}}

attributs communs aux boucles

Ces attributs sont communs aux objets entry et category :

  • xx.index : index du billet courant (0 étant le premier, 1 le second, ...)
  • xx.count : nombre de billets de la boucle
  • xx.isFirst : vrai si le billet est le premier de la liste, faux sinon
  • xx.isLast : vrai si le billet est le dernierde la liste, faux sinon

entry

Objet utilisable au sein d'une boucle <tpl:Entries>, ou dans le contexte d'une page post.html

Il décrit le billet en cours.

Variables utilisables :

  • entry.date : date du billet
  • entry.content : contenu du billet
  • entry.excerpt : résumé du billet
  • entry.title : titre du billet
  • entry.id : ID du billet
  • entry.type : type du billet
  • entry.url : URL du billet
  • entry.cat_id : ID de la catégorie du billet
  • entry.cat_url : URL de la catégorie du billet
  • entry.selected : vaut 1 si le billet est sélectionné, 0 sinon
  • entry.author : nom de l'auteur du billet
  • entry.extended : vaut 1 si le billet a un extrait, 0 sinon

category

  • category.id : ID de la catégorie
  • category.url : URL de la catégorie
  • category.title : titre de la catégorie
  • category.nb_post : nombre de billets de la catégorie
  • category.desc : description de la catégorie

system

  • system.blog_lang : langue du blog
  • system.current_tpl : template en cours d'utilisation
  • system.url_type : type d'url
  • system.comments_active : 1 si les commentaires sont activés, 0 sinon
  • system.pings_active : 1 si les rétroliens sont activés, 0 sinon
  • system.wiki_comments : 1 si les commentaires sont en mode wiki, 0 sinon
  • system.search_count : nombre de résultats (page search.html seulement)

Fonctions

Fonctions "type" PHP

Certaines fonctions PHP sont importées sans changement :

  • substr(expr,start,len)
  • strlen(expr)
  • (liste à compléter selon la demande)

La concaténation de chaînes de caractères est accessible via la fonction strcat(exp1,exp2,...)

Fonction dotclear

Certaines fonctions dotclear/clearbricks sont accessibles :

  • remove_html(expr)
  • encode_html(expr)
  • cut_string(expr,taille)