Vue d'ensemble du PatTemplate

Il y a 5 balises XML à dispotition dans PatTemplate qui forment les fondements du moteur de template.

• La balise tmpl
• La balise sub
• La balise link
• La balise var
• La balise comment

Toutes les balises PatTemplate doivent être contenues dans un “nom d’espace” qui sert à distinguer entre le XML du PatTemplate, des balises distinctives, le HTML régulier, le XHTML et d’autres balises XML. Le nom d’espace par défaut est patTemplate mais il peut, sur appel de la méthode “setNamespace”, être changé.

<?php
  $tmpl =& new patTemplate();
// change le nom d'espace en 'cms'
  $tmpl->setNamespace( 'cms' );
?>

<!-- le nom d'espace est adapté -->
   Ceci est un test du contenu contrôlé par mon système.

Les templates sont des parties de pages HTML qui peuvent être utilisés par le moteur de template. Afin de reconnaitre une certaine partie de la page comme template, PatTemplate utilise des balises XML pour assigner un nom précis et divers attributs à un template (voir les balises PatTemplate et attributs pour voir un liste de toutes les balises et attributs). Quand un template est “chargé”, le “chargeur” sépare la page en unités isolées et les traite séparément comme templates. A travers l’utilisation de l’API PatTemplate vous pouvez cacher, afficher ou répéter d’autres templates.

Un template peut ainsi contenir beaucoup d’autres templates comme souhaité.

Les templates peuvent être de différents types (définir comme type=”...” attribut):

• Standard – la distribution du template est toujours la même.
• OddEven – des sous-templates de différents types peuvent être assignés: Odd et Even (paire et impaire), lesquelles seront appelés alternativement, quand le template sera répété.
• Modulo – C’est comme un template OddEven excepté que vous pouvez avoir plus de 2 sous template. Le template OddEven est un cas spéciale simple où le modulo est égale à 2.
• Condition – De nombreux sous-templates peuvent être assignés d’une facon quelconque et il faut introduire une variable qui sera utilisée afin de les comparer avec une condition spécial des sous-templates. Cela permet l’utilisation des différents codes HTML pour chaque valeur que la condition de variable peut avoir. Il existe deux conditions spéciales qui peuvent être utilisées: default qui est comparable à la valeur par défaut dans un “switch/case” et empty qui sera indiqué lorsque la variable n’indique pas de valeur.
• SimpleCondition – Une situation qui apparait souvent est l’indication d’un signal d’erreur lorsqu’une erreur apparait. Normalement on placera le message d’erreur si il existe ou cacher le template en utilisant setAttribute() si il n’y en a aucun. En utilisant un template de type SimpleCondition vous pouvez assigner une liste de variables (utilisez le requiredvars) lesquelles doivent être placées lorsque le template sera affiché. Si l’une de ces variables n’est pas introduite, le template ne sera pas visible.

PatTemplate assigne les variables semblablement à un language de programmation. Des variables locales (à travers la méthode addvar) ainsi que des variables globales (à travers la méthode addGlobalVar) peuvent être déclarées. Les variables globale ne peuvent être que scalaire (strings, integers,...) et les variables locales peuvent aussi être des tableaux (array). Lorsqu’une variable est indiqué “array”, le template où vous l’avez inserée sera répété.

Lorsqu’une condition de template utilise l’attribut useglobals=”yes”, les variables globale seront utilisées si aucune variable locale n’a été déclarée.

Les variables doivent être écrits en lettres majuscules et ne doivent contenir que des signes alphanumeriques (0~9:A~Z) et des underscores (_) pour séparer les mots. Les variables seront toujours indiquées entre crochets, par exemple {FOO}.

Les variables seront chargées de leurs valeurs quand le template sera installé.

Il existe quelques variables systèmes prédéfinies qui sont mises à disposition lorsque l’attribut addsystemvars est installé.

• PAT_ROW_VAR – Vous pouvez utiliser ceci quand vous souhaitez énumérer un template qui se charge un à un automatiquement. Entrer simplement la variable PAT_ROW_VAR à sa place dans le template, dans laquelle l’énumération apparaîtra (celà peut également être utilsé pour le javascript mouseover)
• PAT_LOOPS –
• PAT_IS_FIRST –
• PAT_IS_LAST –
• PAT_IS_ODD –
• PAT_IS_EVEN –
• PATTEMPLATE_VERSION –
• PAT_MODULO_REP –
• PAT_MODULO -

Plus d’informations dans la balise Tmpl.

Les templates peuvent avoir plusieurs attributs. Ils peuvent être placés par setAttribute ou par l’entrée d’attributs dans des balises.

Voir les balises et attributs PatTemplate pour plus d’informations.

Le pack téléchargable de PatTemplate contient différents exemples (pour le moment en allemand) qui expliquent les fonctions fondamentales.