2) Notions de base
Méthodes
Les méthodes sont utilisées dans les scripts
Php.
Elles permettent d'assigner des valeurs aux variables smarty par valeur
ou référence, sous forme de valeurs simples ou de tableaux.
La classe XoopsTpl étant une classe dérivée de la
classe Smarty, toutes les méthodes de Smarty peuvent être
utilisées avec
$xoopsTpl->methode_Smarty (ex. xoopsTpl->append('stories',
$story) )
Méthodes Smarty
Délimiteurs
Les constantes, variables et fonctions, utilisées dans
les templates, doivent être délimitées.
Smarty
autorisant la personnalisation des délimiteurs, les symboles <{
et }> sont ceux défini par Xoops.
Commentaires
Il
est possible d'insérer des commentaires dans les templates sous
la forme :
<{* Ceci est un commentaire*}>
Attention, ils n'apparaitront pas dans le code source de la page,
contrairement aux commentaires Html.
Fonctions
Les fonctions de Smarty sont les fonctions utilisables
dans les templates:
Elles permettent notamment :
- l'inclusion d'autres templates
- des instructions conditionnelles
- le parcours de tableaux pour en afficher les données
Ne seront détaillées que les fonctions utilisées
couramment avec Xoops (include, section, if, etc.)
Fonctions Smarty
Variables
Les variables sont utilisées dans les templates
:
- soit pour être affichées directement
- soit pour être utilisées comme arguments de fonctions ou
au sein d'instructions conditionnelles.
On distingue 3 types de variables :
- Les variables réservées Smarty
- Les variables chargées depuis des fichiers de configuration (non
développé ici)
- Les variables assignées depuis Php; nous listerons les variables
assignées par Xoops, comme <{xoops_isadmin}>
ou <{xoops_footer}>
Variables Smarty
Modificateurs de variables
Les modificateurs de variables peuvent être appliqués
aux variables, fonctions et chaines de caractêres.
Ils sont utilisés pour des modification du texte : mise en majuscules,
minuscules, troncature, suppression d'espace, etc.
Indiqués pour mémoire, n'étant en principe pas utilisés
avec Xoops, les traitements de chaines de caractêres étant réalisés
dans le Php.
Ex : <{$sujet | truncate:40:"..."}>
troncature du texte 'sujet' á 40 caractêres, suivi de ...
Retour au sommaire