Ce modificateur permet de concaténer une chaîne de caractères à une variable. Exemple :

Soit la variable de template $foo ayant pour valeur 'bar' :

$rep->body->assign('foo', 'bar');

Utilisation du modificateur cat dans le template. On concatène la chaîne 'toto' à la variable $foo :

<p>{$foo|cat:'toto'}</p>

Ce qui donnera l'affichage :

<p>bartoto</p>

Ce modificateur de template compte le nombre de caractères contenus dans une variable. Exemple :

Soit la variable de template $foo ayant pour valeur ‘bar’ :

$rep->body->assign('foo', 'bar');

Utilisation de count_characters dans le template :

<p>$foo contient {$foo|count_characters} caractères</p>

Ce qui donnera l'affichage :

<p>$foo contient 3 caractères</p>

Ce modificateur de template permet de compter le nombre de paragraphes contenus dans une variable. Exemple :

Prenons la variable $foo contenant le texte suivant et qu'on assigne au template :

$foo = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit.\n\n
Vivamus ornare, enim bibendum mollis interdum, magna quam tristique lacus, sed vestibulum urna augue et nisi.';

$rep->body->assign('foo', $foo);

On affiche alors le texte ainsi que le nombre de paragraphes qu'il contient :

<p>{$foo}<br/>Contient : {$foo|count_paragraphs} paragraphes</p>

Ce qui donne :

<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Vivamus ornare, enim bibendum mollis interdum, magna quam tristique lacus, sed vestibulum urna augue et nisi.
Contient : 2 paragraphes</p>

Ce modificateur de template permet de compter le nombre de phrases contenues dans une variable. Exemple:

Prenons la variable $foo contenant le texte suivant et qu'on assigne au template :

$foo = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Vivamus ornare, enim bibendum mollis interdum, magna quam tristique lacus, sed vestibulum urna augue et nisi.';
$rep->body->assign('foo', $foo);

On affiche alors le texte ainsi que le nombre de phrases qu'il contient :

<p>{$foo}<br/>Contient : {$foo|count_sentences} phrases</p>

Ce qui donne :

<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Vivamus ornare, enim bibendum mollis interdum, magna quam tristique lacus, sed vestibulum urna augue et nisi.
Contient : 2 phrases</p>

Ce modificateur de template permet de compter le nombre de mots contenus dans une variable. Exemple :

Prenons la variable $foo contenant le texte suivant et qu'on assigne au template :

$foo = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit.';
$rep->body->assign('foo', $foo);

On affiche alors le texte ainsi que le nombre de mots qu'il contient :

<p>{$foo}<br/>Contient : {$foo|count_words} mots</p>

Ce qui donne :

<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Contient : 8 mots</p>

Ce modificateur correspond à la fonction htmlspecialchars de PHP.

ce modificateur permet d'afficher un avatar issu du site http://gravatar.com/

Pour ce faire il suffit de fournir le courriel dans le template comme suit :

{gravatar 'foo@bar.com'}

ce qui aura pour effet d'afficher votre gravatar à l'endroit voulu dans le template.

Introduction ¶

{hook 'event', $params}

{hook 'SampleBannerAnnouncement'}

Hook : convention de nommage ¶

Comment répondre aux hooks ? ¶

class hookListener extends jEventListener{
    
   function onhfbSampleBannerAnnouncement ($event) {
        $event->add( jZone::get('hook~samplebanner_accouncement') );
   } 
}

<?xml version="1.0" encoding="iso-8859-1"?>
<events xmlns="http://jelix.org/ns/events/1.0">
   <listener name="hook">
	<event name="hfbSampleBannerAnnouncement" />
   </listener>
</events>

class samplebanner_accouncementZone extends jZone {
    protected $_tplname='zone.samplebanner_accouncement';
    
    protected function _prepareTpl(){    
        $this->_tpl->assign('text',jLocale::get('hook~main.welcome'));
    }        
}

<div class="grid_16">
    <div class="box">
    <h2>Banner</h2>
    {$text}
    </div>
</div>
<div class="clear"></div>

Ce modificateur de template affiche une image

{image 'MonImage.gif', array('width'=>50)}

Le code généré :

<img width="50" src="http://localhost/extracom/cache/images/'MonImage.gif" alt=""/>

Cette fonction va mettre en cache l'image dans le répertoire www ce qui permettra de ne pas regénérer les images

Ce modificateur de template indente chaque ligne de texte contenu dans une variable.

Exemple d'utilisation ¶

$foo = "Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Vivamus ornare, enim bibendum mollis interdum." 
$rep->body->assign('foo', $foo);

{$foo|indent}

    Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Vivamus ornare, enim bibendum mollis interdum.

Paramètres ¶

{$foo|indent:"15"}

               Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
               Vivamus ornare, enim bibendum mollis interdum.

{$foo|indent:"1":"\t"}

    Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Vivamus ornare, enim bibendum mollis interdum.

Le modificateur jdatetime permet de convertir une chaîne contenant une date avec un certain format, vers une chaîne d'un autre format. Ce modificateur utilise la classe jDateTime.

Par défaut, le modificateur attend une chaîne au format base de données (jDateTime::BD_DTFORMAT) et renvoie la date au format correspondant à la langue sélectionnée (jDateTime::LANG_DTFORMAT).

  <p>la date est {$myDate|jdatetime}.</p>

Si $myDate='2006-04-12 01:05:26' et si la langue est fr, alors cela affiche :

 la date est 12/04/2006 01h05mn26s.

Pour indiquer d'autres formats, vous devez indiquer l'une des chaînes en paramètre au modificateur :

Le premier paramètre indique le format de la chaîne que le modificateur reçoit, le deuxième, le format de la chaîne en résultat.

  <p>la date est {$myDate|jdatetime:'db_date':'timestamp'}.</p>

si $myDate='2006-04-15' alors cela affiche

 la date est 1145052000.

ce modificateur permet d'afficher un lien vers le courriel d'un utilisateur, cela la forme de votre choix

pour cela plusieurs options possibles :

• affichage classique du courriel

{mailto array('address'=>'me@domain.com')}

• affichage du courriel encodé en javascript

{mailto array('address'=>'me@domain.com', 'encode'=>'javascript')}

• affichage du courriel encodé en héxadécimal

{mailto array('address'=>'me@domain.com', 'encode'=>'hex')}

• affichage du courriel suivi d'un sujet

{mailto array('address'=>'me@domain.com', 'subject'=>'Hello to you!')}

• affichage du courriel suivi d'un destinataire mis en copie

{mailto array('address'=>'me@domain.com', 'cc'=>'you@domain.com,they@domain.com')}

• utilisation d'options supplémentaires, telle une class CSS

{mailto array('address'=>'me@domain.com', 'extra'=>'class="mailto"')}

Ce modificateur format un nombre à afficher tout comme expliqué dans la doc PHP number_format

exemple :

{$number|number_format:2, ',', ' '}

ce modificateur permet de remplacer une chaine par une autre dans le template via les expressions réglulières

exemple
//$maVar = 'TOTOO';
{$maVar|regex_replace:'/O/':'ii'}

La chaine TOTOO sera remplacée par titii

Il y a cependant un bug si on désire mettre des accolades dans l'expression régulière (ticket 1257)

ce modificateur permet de remplacer une chaine par une autre dans le template via la fonction str_replace

exemple
//$maVar = 'TOTOO';
{$maVar|replace:'O':'ii'}

La chaine TOTOO sera remplacée par titii

• *Attention la fonction str_replace est obsolète en php 5.3x, il est préférable d'utiliser le modification regexp_replace**

Ce modification permet de rajouter un caractère entre chaque lettre

Par exemple Cas 1

{assign $mytext = 'Bonjour_tout_le_monde'}
{$mytext|spacify:}

Résultat : B o n j o u r _ t o u t _ l e _ m o n d e

• *Cas 2**

{assign $mytext = 'Bonjour_tout_le_monde'}
{$mytext|spacify:'.'}

Résultat : B.o.n.j.o.u.r._.t.o.u.t._.l.e._.m.o.n.d.e

Ce modification permet de formater une chaine via la fonction sprintf

{assign $mytext = 'Bonjour_tout_le_monde'}
{$mytext|sprintf:'my format %s'}

Résultat : my format Bonjour_tout_le_monde

Ce modification permet de supprimer les espaces qui sont en double dans une chaine et de les remplacer par défaut par un seul espace

exemple :

{assign $mytext = 'Bonjour_tout_le  mmonde'}
{$mytext|strip}

Résultat : Bonjour_tout_le mmonde

PS : pour mieux voir le résultat afficher la source.

{assign $mytext = 'Bonjour_tout_le  mmonde'}
{$mytext|strip:';'}

Résultat : Bonjour_tout_le;mmonde

Ce modificateur permet de couper une chaine à une longueur voulue (si besoin), et peut eventuellement la séparer dans le milieu d'un mot et ajouter la chaine $etc (comme '...')

• *Cas 1**

{$mytext|truncate}

exemple :

{assign $mytext = 'Bonjour_tout_le_monde'}
{$mytext|truncate}

résultat : Bonjour_tout_le_monde

• *Cas 2**

{$mytext|truncate:10}

exemple :

{assign $mytext = 'Bonjour_tout_le_monde'}
{$mytext|truncate:10}

résultat : Bonjour...

• *Cas 3**

{$mytext|truncate:10}

exemple :

{assign $mytext = 'Bonjour_tout_le_monde'}
{$mytext|truncate:10:'[...]'}

résultat : Bonjo[...]

• *Cas 4**

{$mytext|truncate:60:'...':true}

Ce modificateur permet de couper une chaine formatée en HTML en fermant tous les tags html ouverts, de sortes que le reste de la page n'est pas impacté

Vous devriez utiliser ce modificateur dans une zone afin que la valeur retournée soit dans la cache.

Exemple d'utilisation

{$mytext|wordwrap} 
{$mytext|truncatehtml:150:"\n<a href="...">lire l'article complet</a>"} 
{$mytext|truncatehtml:45} 

Le modificateur wiki permet de convertir une chaîne contenant une syntaxe wiki, vers le format de votre choix. Ce modificateur utilise la classe jWiki.

Par défaut, le modificateur attend une chaine au format wiki (wr3) et la renvoie au format XHTML, exemple :

  <p>{$message|wiki}</p>

Si $message vaut par exemple :

__mon texte gras__ 

le rendu sera mon texte gras

Pour indiquer d'autres formats, vous devez indiquer l'une des chaînes en paramètre au modificateur :

Le paramètre indique le format d'origine et de transformation (voulu) que le modificateur reçoit

  <p>{$message|wiki:'wr3_to_xhtml'}</p>

Ce modificateur remplace les retours à la ligne en balise html <br/> dans un texte contenu dans une variable de template.

Exemple ¶

$foo = "Lorem ipsum dolor sit amet,\nconsectetuer adipiscing elit." 
$rep->body->assign('foo', $foo);

<p>{$foo|nl2br}</p>

<p>Lorem ipsum dolor sit amet,<br/>consectetuer adipiscing elit.</p>