diff --git a/docs/fr/appendixes/bugs.xml b/docs/fr/appendixes/bugs.xml index 7d5adc49..692fd844 100644 --- a/docs/fr/appendixes/bugs.xml +++ b/docs/fr/appendixes/bugs.xml @@ -1,11 +1,12 @@ + - BUGS - - Vérifiez le fichier de BUGS fourni avec la dernière version de Smarty ou - consultez le site Web. - + BUGS + + Vérifiez le fichier de BUGS fourni avec la dernière version de Smarty ou + consultez le site Web. + \ No newline at end of file +--> diff --git a/docs/fr/appendixes/tips.xml b/docs/fr/appendixes/tips.xml index 4a2a9fdf..d5cbcfb9 100644 --- a/docs/fr/appendixes/tips.xml +++ b/docs/fr/appendixes/tips.xml @@ -1,3 +1,7 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 @@ -7,14 +11,14 @@ Gestion des variables non-assignées - Peut-être voudrez-vous des fois afficher une valeur par + Peut-être voudrez-vous des fois afficher une valeur par défaut pour une variable qui n'a pas été assignée, comme pour afficher "&nbsp;" afin que les couleurs de fond - des tableaux fonctionnent. Beaucoup utiliseraient une - instruction {if} pour gérer cela, mais il existe un moyen - plus facile dans Smarty : l'utilisation du modificateur + des tableaux fonctionnent. Beaucoup utiliseraient une + instruction {if} pour gérer cela, mais il existe un moyen + plus facile dans Smarty : l'utilisation du modificateur de variable default. - + afficher &nbsp; quand une variable est vide @@ -35,35 +39,35 @@ - - - Gestion des variables par défaut - - Si une variable est utilisée fréquemment dans vos templates, - lui appliquer le modificateur par défaut peut être un peu fastidieux. - Vous pouvez remédier à cela en lui assignant une valeur par défaut - avec la fonction assign. - - -assigner une valeur par défaut à une variable de template + + + Gestion des variables par défaut + + Si une variable est utilisée fréquemment dans vos templates, + lui appliquer le modificateur par défaut peut être un peu fastidieux. + Vous pouvez remédier à cela en lui assignant une valeur par défaut + avec la fonction assign. + + + assigner une valeur par défaut à une variable de template {* faites cela qq part en haut de votre template *} {assign var="title" value=$title|default:"no title"} {* si $title est vide, il contiendra alors no "no title" *} {$title} - - - - Passage du titre à un template d'en-tête - - Quand la majorité de vos templates utilisent les mêmes en-tête et pied-de-page, - il est d'usage de les mettre dans leurs propres templates et de les inclure. - Mais comment faire si l'en-tête doit avoir un titre différent, selon la page - d'où on vient ? Vous pouvez passer le titre à l'en-tête quand il est inclus. - - -passer le titre au template d'en-tête + + + + Passage du titre à un template d'en-tête + + Quand la majorité de vos templates utilisent les mêmes en-tête et pied-de-page, + il est d'usage de les mettre dans leurs propres templates et de les inclure. + Mais comment faire si l'en-tête doit avoir un titre différent, selon la page + d'où on vient ? Vous pouvez passer le titre à l'en-tête quand il est inclus. + + + passer le titre au template d'en-tête mainpage.tpl @@ -96,32 +100,32 @@ footer.tpl ---------- </BODY> </HTML> - - + + Quand la page principale est conçue, le titre "Main page" est passé à header.tpl et sera donc utilisé pour le titre. Quand la page d'archive est conçue, le titre sera "Archives". Notez que dans l'exemple des archives, on utilise le fichier archives_page.conf plutôt que des variables codées en dur. Remarquez aussi que "BC News" est affichée si la variable $title n'est pas définie, grâce au modificateur de variable default. - - - - Dates - - De façon générale, essayez de toujours passer les dates à Smarty - sous forme de timestamp. Cela permet aux designers de templates d'utiliser - date_format - pour avoir un contrôle total sur le formatage des dates et de comparer - facilement les dates entre elles. - - - NOTE : à partir Smarty 1.4.0, vous pouvez passer les dates à Smarty - sous la forme de timestamps Unix ou MySQL, ou tout autre format de dates - que comprend strtotime(). - - -utilisation de date_format + + + + Dates + + De façon générale, essayez de toujours passer les dates à Smarty + sous forme de timestamp. Cela permet aux designers de templates d'utiliser + date_format + pour avoir un contrôle total sur le formatage des dates et de comparer + facilement les dates entre elles. + + + NOTE : à partir Smarty 1.4.0, vous pouvez passer les dates à Smarty + sous la forme de timestamps Unix ou MySQL, ou tout autre format de dates + que comprend strtotime(). + + + utilisation de date_format {$startDate|date_format} @@ -140,14 +144,14 @@ OUTPUT: {if $date1 < $date2} ... {/if} - - - En utilisant la fonction {html_select_date} dans un template, le programmeur - veut en général convertir le résultat d'un formulaire en un timestamp. - Voici une fonction qui devrait vous être utile. - - -conversion des éléments date d'un formulaire en timestamp + + + En utilisant la fonction {html_select_date} dans un template, le programmeur + veut en général convertir le résultat d'un formulaire en un timestamp. + Voici une fonction qui devrait vous être utile. + + + conversion des éléments date d'un formulaire en timestamp // cela suppose que vos éléments de formulaire soient nommés // startDate_Day, startDate_Month, startDate_Year @@ -165,22 +169,22 @@ function makeTimeStamp($year="",$month="",$day="") return mktime(0,0,0,$month,$day,$year); } - - - - WAP/WML - - Les templates WAP/WML nécessitent un en-tête "Content-Type" qui doit être - passé avec le template. Le moyen le plus facile de faire cela est d'écrire - une fonction utilisateur qui écrit l'en-tête. Si vous utilisez le cache, - cela ne fonctionnera pas. Nous utiliserons donc une balise d'insertion + + + + WAP/WML + + Les templates WAP/WML nécessitent un en-tête "Content-Type" qui doit être + passé avec le template. Le moyen le plus facile de faire cela est d'écrire + une fonction utilisateur qui écrit l'en-tête. Si vous utilisez le cache, + cela ne fonctionnera pas. Nous utiliserons donc une balise d'insertion (rappelez-vous que les balises d'insertion ne sont pas mises en cache !). Assurez-vous qu'aucune sortie - rien n'est transmise au navigateur avant l'appel du template, sans quoi + rien n'est transmise au navigateur avant l'appel du template, sans quoi la modification de l'en-tête échouera. - - -utilisation d'insert pour écrire un en-tête Content-Type WML + + + utilisation d'insert pour écrire un en-tête Content-Type WML // assurez-vous que Apache est configuré pour les extensions .wml ! // mettez cette fonction qq part dans votre applications @@ -218,37 +222,37 @@ Pretty easy isn't it? </p> </card> </wml> - - - - Templates composants - - Cette astuce tient plus du hack qu'autre chose mais n'en demeure pas - moins une idée plutôt chouette. Utilisez-la à vos propres risques. ;-) - - - Traditionnellemnt, la programmation avec des templates dans les applications - se déroule de la façon suivante : d'abord vous récupérez vos variables - dans l'application PHP (peut-être avec des requêtes en base de données), puis - vous instanciez votre objet Smarty, assignez les variables et affichez le - template. Disons par exemple que nous avons un téléscripteur dans - notre template. Nous récupérerions les données dans notre application, - puis les assignerions ensuite pour les afficher. Mais ne serait-ce pas - mieux de pouvoir ajouter ce téléscripteur à n'importe quelle application - en incluant directement le template sans avoir à se soucier de la récupération - des données. - - - Vous pouvez intégrer du PHP dans vos templates avec les balises - {php}{/php}. Avec cette méthode, vous pouvez inclure des templates complets, + + + + Templates composants + + Cette astuce tient plus du hack qu'autre chose mais n'en demeure pas + moins une idée plutôt chouette. Utilisez-la à vos propres risques. ;-) + + + Traditionnellemnt, la programmation avec des templates dans les applications + se déroule de la façon suivante : d'abord vous récupérez vos variables + dans l'application PHP (peut-être avec des requêtes en base de données), puis + vous instanciez votre objet Smarty, assignez les variables et affichez le + template. Disons par exemple que nous avons un téléscripteur dans + notre template. Nous récupérerions les données dans notre application, + puis les assignerions ensuite pour les afficher. Mais ne serait-ce pas + mieux de pouvoir ajouter ce téléscripteur à n'importe quelle application + en incluant directement le template sans avoir à se soucier de la récupération + des données. + + + Vous pouvez intégrer du PHP dans vos templates avec les balises + {php}{/php}. Avec cette méthode, vous pouvez inclure des templates complets, dans la mesure où ils récupèrent leurs propres données pour les assigner à leurs propres variables. Avec le traitement intégré - de cette façon, vous pouvez garder le template et le traitement ensemble. - Ainsi, on ne se soucie plus d'où vient le contenu du template, - tout vient comme un seul et unique composant. - - -template composant + de cette façon, vous pouvez garder le template et le traitement ensemble. + Ainsi, on ne se soucie plus d'où vient le contenu du template, + tout vient comme un seul et unique composant. + + + template composant {* Smarty *} @@ -270,17 +274,17 @@ Pretty easy isn't it? {/php} Stock Name: {$ticker_name} Stock Price: {$ticker_price} - - - A partir de Smarty 1.5.0, il y a même un moyen plus propre. Vous - pouvez inclure du PHP dans votre template avec la balise {include_php ...}. - De cette façon, vous pouvez garder séparée la logique applicative - de la logique de présentation. Reportez-vous à la fonction include_php pour plus - d'informations. - - -template composant avec include_php + + + A partir de Smarty 1.5.0, il y a même un moyen plus propre. Vous + pouvez inclure du PHP dans votre template avec la balise {include_php ...}. + De cette façon, vous pouvez garder séparée la logique applicative + de la logique de présentation. Reportez-vous à la fonction include_php pour plus + d'informations. + + + template composant avec include_php load_ticker.php --------------- @@ -309,20 +313,20 @@ index.tpl {include_php file="load_ticker.php"} Stock Name: {$ticker_name} Stock Price: {$ticker_price} - - - - Dissimuler les adresses email - - Vous-êtes vous déjà demandé pourquoi vos adresses emails sont sur autant - de mailing listes de spam ? Une façon pour les spammers de récupérer les - adresses est de parcourir les pages Web. Voici une façon de remédier - à ce problème : mettre votre adresse email dans du Javascript brouillé - au milieu de votre source HTML, sans que cela ne gêne l'affichage sur le - navigateur Web. Cela est fait grâce au plugin mailto. - - -exemple de dissimulation d'une adresse email + + + + Dissimuler les adresses email + + Vous-êtes vous déjà demandé pourquoi vos adresses emails sont sur autant + de mailing listes de spam ? Une façon pour les spammers de récupérer les + adresses est de parcourir les pages Web. Voici une façon de remédier + à ce problème : mettre votre adresse email dans du Javascript brouillé + au milieu de votre source HTML, sans que cela ne gêne l'affichage sur le + navigateur Web. Cela est fait grâce au plugin mailto. + + + exemple de dissimulation d'une adresse email index.tpl @@ -332,34 +336,34 @@ Send inquiries to {mailto address=$EmailAddress encode="javascript" subject="Hello"} - + - Note technique - - Cette méthode n'est pas infaillible. Un spammer peut programmer son - collecteur d'email pour passer outre cette astuce, mais c'est cependant - peu probable. - + Note technique + + Cette méthode n'est pas infaillible. Un spammer peut programmer son + collecteur d'email pour passer outre cette astuce, mais c'est cependant + peu probable. + - - - + + + diff --git a/docs/fr/appendixes/troubleshooting.xml b/docs/fr/appendixes/troubleshooting.xml index 45ce479f..4e069bde 100644 --- a/docs/fr/appendixes/troubleshooting.xml +++ b/docs/fr/appendixes/troubleshooting.xml @@ -1,53 +1,54 @@ + - Diagnostic des erreurs - - - Erreurs Smarty/PHP - - Smarty peut identifier de nombreuses erreurs comme des attributs de - balises manquants ou de noms de variables malformés. Dans ce cas-là, - vous verrez apparaître une erreur semblable à : - - -erreurs Smarty + Diagnostic des erreurs + + + Erreurs Smarty/PHP + + Smarty peut identifier de nombreuses erreurs comme des attributs de + balises manquants ou de noms de variables malformés. Dans ce cas-là, + vous verrez apparaître une erreur semblable à : + + + erreurs Smarty Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah' in /path/to/smarty/Smarty.class.php on line 1041 Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name in /path/to/smarty/Smarty.class.php on line 1041 - - - - Smarty vous indique le nom du template, le numéro de la ligne et l'erreur. - Après cela, vous pouvez connaître le numéro de ligne où il y a eu erreur dans - la définition de la classe Smarty. - - - - Il y a certaines erreurs que Smarty ne peut pas détecter, comme les - balises fermantes manquantes. Ce type d'erreurs est la plupart du temps - repéré dans la phase de compilation PHP du template compilé. - - - -erreur d'analyse PHP + + + + Smarty vous indique le nom du template, le numéro de la ligne et l'erreur. + Après cela, vous pouvez connaître le numéro de ligne où il y a eu erreur dans + la définition de la classe Smarty. + + + + Il y a certaines erreurs que Smarty ne peut pas détecter, comme les + balises fermantes manquantes. Ce type d'erreurs est la plupart du temps + repéré dans la phase de compilation PHP du template compilé. + + + + erreur d'analyse PHP Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75 - - - - Quand vous rencontrez une erreur d'analyse PHP, le numéro de la ligne - indiqué est celui du fichier PHP compilé et non du template. Vous pouvez alors - regarder le template et détecter l'erreur. Voici quelques erreurs fréquentes : - balises fermantes pour {if}{/if} ou {section}{/section} manquantes, ou - syntaxe logique incorrecte dans une instruction {if}. Si vous ne trouvez pas l'erreur, - vous devrez alors ouvrir le fichier PHP compilé et aller à la ligne correspondante pour - trouver d'où vient l'erreur. - - + + + + Quand vous rencontrez une erreur d'analyse PHP, le numéro de la ligne + indiqué est celui du fichier PHP compilé et non du template. Vous pouvez alors + regarder le template et détecter l'erreur. Voici quelques erreurs fréquentes : + balises fermantes pour {if}{/if} ou {section}{/section} manquantes, ou + syntaxe logique incorrecte dans une instruction {if}. Si vous ne trouvez pas l'erreur, + vous devrez alors ouvrir le fichier PHP compilé et aller à la ligne correspondante pour + trouver d'où vient l'erreur. + + \ No newline at end of file +--> diff --git a/docs/fr/bookinfo.xml b/docs/fr/bookinfo.xml index d256ef0e..4f4a8cc3 100755 --- a/docs/fr/bookinfo.xml +++ b/docs/fr/bookinfo.xml @@ -1,32 +1,33 @@ - - Smarty - le moteur et compilateur de templates PHP - - - MonteOhrt <monte@ispi.net> - - - AndreiZmievski <andrei@php.net> - - - - - ArnaudCogoluègnes <arnaud.cogoluegnes@free.fr> - - - GéraldCroës <gcroes@aston.fr> - - - MehdiAchour <didou@php.net> - - - &build-date; - - 2001-2004 - ispi of Lincoln, Inc. - - + + + Smarty - le moteur et compilateur de templates PHP + + + MonteOhrt <monte@ispi.net> + + + AndreiZmievski <andrei@php.net> + + + + + ArnaudCogoluègnes <arnaud.cogoluegnes@free.fr> + + + GéraldCroës <gcroes@aston.fr> + + + MehdiAchour <didou@php.net> + + + &build-date; + + 2001-2004 + ispi of Lincoln, Inc. + + - - Console de débogage + + Console de débogage + + Il existe une console de débogage dans Smarty. La console vous indique + toutes les variables incluses, assignées et chargées depuis un fichier de + configuration pour le template courant. Un template appelé "debug.tpl" + est inclus dans la distribution de Smarty. Si besoin, vous pouvez définir + $debug_tpl de façon à ce que ce dernier contienne le chemin + du template à utiliser(dans SMARTY_DIR par defaut). + Lorsque vous chargez la page, une console javascript est censée surgir + et vous donner les noms de toutes les variables inclues et assignées dans + votre page courante. Pour voir toutes les variables d'un template particulier, + voir la fonction {debug}. + Pour désactiver la console de débogage, définissez $debugging à false. + Vous pouvez également temporairement activer le débogage en indiquant + SMARTY_DEBUG dans l'url si tant est que l'option + $debugging_ctrl soit activée. + + + Note technique - Il existe une console de débogage dans Smarty. La console vous indique - toutes les variables incluses, assignées et chargées depuis un fichier de - configuration pour le template courant. Un template appelé "debug.tpl" - est inclus dans la distribution de Smarty. Si besoin, vous pouvez définir - $debug_tpl de façon à ce que ce dernier contienne le chemin - du template à utiliser(dans SMARTY_DIR par defaut). - Lorsque vous chargez la page, une console javascript est censée surgir - et vous donner les noms de toutes les variables inclues et assignées dans - votre page courante. Pour voir toutes les variables d'un template particulier, - voir la fonction {debug}. - Pour désactiver la console de débogage, définissez $debugging à false. - Vous pouvez également temporairement activer le débogage en indiquant - SMARTY_DEBUG dans l'url si tant est que l'option - $debugging_ctrl soit activée. + La console de débogage ne fonctionne pas si vous utilisez l'API fetch (), + mais seulement lorsque vous utilisez display (). C'est en effet un jeu + d'instructions javascripts à la fin du template qui déclenchent l'ouverture + de la fenêtre. Si vous n'aimez pas javascript, vous pouvez modifier + debug.tpl pour formater les données de la façon qui vous conviendra le + mieux. Les données de débogage ne sont pas mises en cache et les + informations de debug.tpl ne sont pas incluses dans la sortie de la + console de débogage. - - Note technique - - La console de débogage ne fonctionne pas si vous utilisez l'API fetch (), - mais seulement lorsque vous utilisez display (). C'est en effet un jeu - d'instructions javascripts à la fin du template qui déclenchent l'ouverture - de la fenêtre. Si vous n'aimez pas javascript, vous pouvez modifier - debug.tpl pour formater les données de la façon qui vous conviendra le - mieux. Les données de débogage ne sont pas mises en cache et les - informations de debug.tpl ne sont pas incluses dans la sortie de la - console de débogage. - - - - - Le temps de chargement des templates et des fichiers de configuration sont - indiqués en secondes. - - - - + + + + Le temps de chargement des templates et des fichiers de configuration sont + indiqués en secondes. + + + + diff --git a/docs/fr/designers/config-files.xml b/docs/fr/designers/config-files.xml index c6354aef..1c25a7b1 100644 --- a/docs/fr/designers/config-files.xml +++ b/docs/fr/designers/config-files.xml @@ -1,20 +1,20 @@ - - Fichiers de configuration - - Les fichiers de configuration sont un moyen interressant pour gérer - des variables depuis un seul et même fichier. L'exemple le plus courant - étant le schéma de couleurs du template. Normalement, pour changer le - schéma de couleur d'une application, vous devriez aller - dans chaque template et changer la couleur des éléments (ou les classes css). - Avec un fichier de configuration, il vous est possible de conserver - la couleur dans un seul endroit, puis de la mettre à jour une seule fois. - - - Exemple de fichier de configuration - + + Fichiers de configuration + + Les fichiers de configuration sont un moyen interressant pour gérer + des variables depuis un seul et même fichier. L'exemple le plus courant + étant le schéma de couleurs du template. Normalement, pour changer le + schéma de couleur d'une application, vous devriez aller + dans chaque template et changer la couleur des éléments (ou les classes css). + Avec un fichier de configuration, il vous est possible de conserver + la couleur dans un seul endroit, puis de la mettre à jour une seule fois. + + + Exemple de fichier de configuration + - - - - Les valeurs des variables de fichiers de configuration peuvent être entre - guillemets, sans que cela soit nécessaire. Si vous vouler utiliser des - valeurs sur plusieurs lignes, vous devrez les entourer de triples - guillemets ("""). Vous pouvez insérer des commentaires dans les fichiers de - configuration en utilisant une syntaxe quelquonque, non valide. - Nous recommandons l'utilisation de # (dièse) en début - de ligne. - - - Cet exemple de fichier de configuration contient deux sections. Les noms des - sections sont entourés de crochets []. Les noms de section peuvent être - des chaînes, ne contenant aucun des symboles [ et - ]. Dans notre exemple, les 4 variables du début sont - des variables dites globales, qui ne sont pas contenue dans une section. - Ces variables sont toujours chargées depuis le fichier de configuration. - Si une section est chargée, alors toutes les variables de cette section - ainsi que les variables globales sont chargées. Si une variable existe - à la fois en tant que globale et à la fois en tant que variable de - section, la variable de section est prioritaire. - Si vous appelez deux variables dans une même section de la même façon, - la dernière déclarée prime. - - - Les fichiers de configuration sont chargés dans le template grâce à la - fonction config_load. - - - Vous pouvez masquer des variables ou des sections entières en préfixant - le nom de la variable ou le nom de la section avec une virgule. - Ce procédé est utile si votre application récupère ses données depuis - plusieurs fichiers de configuration et récupère des données sensibles dont - vos templates n'ont pas besoin. Si des tiers éditent des templates, vous - êtes sûr que ces derniers n'accèderont pas à ces données de configuration - en les chargeant depuis le template. - - + + + + Les valeurs des variables de fichiers de configuration peuvent être entre + guillemets, sans que cela soit nécessaire. Si vous vouler utiliser des + valeurs sur plusieurs lignes, vous devrez les entourer de triples + guillemets ("""). Vous pouvez insérer des commentaires dans les fichiers de + configuration en utilisant une syntaxe quelquonque, non valide. + Nous recommandons l'utilisation de # (dièse) en début + de ligne. + + + Cet exemple de fichier de configuration contient deux sections. Les noms des + sections sont entourés de crochets []. Les noms de section peuvent être + des chaînes, ne contenant aucun des symboles [ et + ]. Dans notre exemple, les 4 variables du début sont + des variables dites globales, qui ne sont pas contenue dans une section. + Ces variables sont toujours chargées depuis le fichier de configuration. + Si une section est chargée, alors toutes les variables de cette section + ainsi que les variables globales sont chargées. Si une variable existe + à la fois en tant que globale et à la fois en tant que variable de + section, la variable de section est prioritaire. + Si vous appelez deux variables dans une même section de la même façon, + la dernière déclarée prime. + + + Les fichiers de configuration sont chargés dans le template grâce à la + fonction config_load. + + + Vous pouvez masquer des variables ou des sections entières en préfixant + le nom de la variable ou le nom de la section avec une virgule. + Ce procédé est utile si votre application récupère ses données depuis + plusieurs fichiers de configuration et récupère des données sensibles dont + vos templates n'ont pas besoin. Si des tiers éditent des templates, vous + êtes sûr que ces derniers n'accèderont pas à ces données de configuration + en les chargeant depuis le template. + + - - Bases syntaxiques - - Toutes les balises Smarty sont entourées de délimiteurs. Par défaut, - ces délimiteurs sont { et - }, mais ils peuvent être modifiés. - - - Pour ces exemples, nous supposons que vous utiliserez leur valeur par défaut. - Dans Smarty, le contenu qui est situé en dehors des délimiteurs - est affiché comme contenu statique, inchangé. Lorsque Smarty rencontre - des balises de template, il tente de les comprendre et en affiche la sortie - appropriée, en lieu et place. - - - &designers.language-basic-syntax.language-syntax-comments; - &designers.language-basic-syntax.language-syntax-functions; - &designers.language-basic-syntax.language-syntax-attributes; - &designers.language-basic-syntax.language-syntax-quotes; - &designers.language-basic-syntax.language-math; - &designers.language-basic-syntax.language-escaping; - + + Bases syntaxiques + + Toutes les balises Smarty sont entourées de délimiteurs. Par défaut, + ces délimiteurs sont { et + }, mais ils peuvent être modifiés. + + + Pour ces exemples, nous supposons que vous utiliserez leur valeur par défaut. + Dans Smarty, le contenu qui est situé en dehors des délimiteurs + est affiché comme contenu statique, inchangé. Lorsque Smarty rencontre + des balises de template, il tente de les comprendre et en affiche la sortie + appropriée, en lieu et place. + + + &designers.language-basic-syntax.language-syntax-comments; + &designers.language-basic-syntax.language-syntax-functions; + &designers.language-basic-syntax.language-syntax-attributes; + &designers.language-basic-syntax.language-syntax-quotes; + &designers.language-basic-syntax.language-math; + &designers.language-basic-syntax.language-escaping; + - - Désactiver l'analyse de Smarty - - Il est quelquesfois bien ou même nécessaire de faire ignorer certaines sections - à Smarty qu'il analyserait sinon. Un exemple classique est l'incorporation de code - Javascript ou CSS dans les templates. Le problème est que ces langages utilisent - les caractères { et } qui sont aussi les délimiteurs par défaut de Smarty. - - - - Le plus simple est d'éviter une telle situation en séparant votre code Javascript et CSS - dans des fichiers séparés et d'utiliser les méthodes standard HTML pour y accéder. - - - - Inclure du contenu litéral est possible en utilisant les blocs {literal} .. {/literal}. - Similairement à l'utilisation d'entités HTML, vous pouvez utiliser {ldelim} et {rdelim} pour afficher les délimiteurs. - - - - Il est souvent plus simple de modifier les délimiteurs de Smarty : $left_delimiter et - $right_delimiter. - - - Exemple de changement de délimiteur - + + Désactiver l'analyse de Smarty + + Il est quelquesfois bien ou même nécessaire de faire ignorer certaines sections + à Smarty qu'il analyserait sinon. Un exemple classique est l'incorporation de code + Javascript ou CSS dans les templates. Le problème est que ces langages utilisent + les caractères { et } qui sont aussi les délimiteurs par défaut de Smarty. + + + + Le plus simple est d'éviter une telle situation en séparant votre code Javascript et CSS + dans des fichiers séparés et d'utiliser les méthodes standard HTML pour y accéder. + + + + Inclure du contenu litéral est possible en utilisant les blocs {literal} .. {/literal}. + Similairement à l'utilisation d'entités HTML, vous pouvez utiliser {ldelim} et {rdelim} pour afficher les délimiteurs. + + + + Il est souvent plus simple de modifier les délimiteurs de Smarty : $left_delimiter et + $right_delimiter. + + + Exemple de changement de délimiteur + ]]> - - - - + + + + diff --git a/docs/fr/designers/language-basic-syntax/language-math.xml b/docs/fr/designers/language-basic-syntax/language-math.xml index 1045fc42..70616f66 100644 --- a/docs/fr/designers/language-basic-syntax/language-math.xml +++ b/docs/fr/designers/language-basic-syntax/language-math.xml @@ -1,15 +1,15 @@ - - Mathématiques - - Les mathématiques peuvent être directement appliquées aux - valeurs de variables. - - - Exemples de mathématiques - + + Mathématiques + + Les mathématiques peuvent être directement appliquées aux + valeurs de variables. + + + Exemples de mathématiques + - - + + - - Paramètres - - La plupart des fonctions attendent des paramètres qui régissent leur - comportement. Les paramètres des fonctions Smarty sont très proches des - attributs des balises HTML. Les valeurs numériques n'ont pas besoin d'être - entourées par des guillemets, par contre, ces guillemets sont recommandées lors - de l'utilisation de chaînes de caractères. Des variables peuvent aussi être - utilisées en tant que paramètres, et ne doivent pas être entourées de guillemets. - - - Certains paramètres requièrent des valeurs booléennes (true / false). - Elles peuvent être spécifiées par l'une des valeures suivantes, sans - guillemet: true, on, et yes, - ou false, off, et no. - - - Paramètres de fonction, syntaxe - + + + Paramètres + + La plupart des fonctions attendent des paramètres qui régissent leur + comportement. Les paramètres des fonctions Smarty sont très proches des + attributs des balises HTML. Les valeurs numériques n'ont pas besoin d'être + entourées par des guillemets, par contre, ces guillemets sont recommandées lors + de l'utilisation de chaînes de caractères. Des variables peuvent aussi être + utilisées en tant que paramètres, et ne doivent pas être entourées de guillemets. + + + Certains paramètres requièrent des valeurs booléennes (true / false). + Elles peuvent être spécifiées par l'une des valeures suivantes, sans + guillemet: true, on, et yes, + ou false, off, et no. + + + Paramètres de fonction, syntaxe + {include file="header.tpl"} {include file=$includeFile} @@ -30,7 +31,7 @@ <SELECT name=company> {html_options values=$vals selected=$selected output=$output} </SELECT> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml b/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml index 9c1a7f5f..10fd53e9 100644 --- a/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml +++ b/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml @@ -1,18 +1,19 @@ - - Commentaires - - Les commentaires dans Smarty sont entourés d'asterisques, de cette - façon : {* voici un commentaire *} - Les commentaires Smarty ne sont pas affichés dans la sortie finale du - template. - Ils sont utilisés pour des notes internes, dans le template, pour aider - les développeurs à en comprendre le fonctionnement. - - - Commentaires - + + + Commentaires + + Les commentaires dans Smarty sont entourés d'asterisques, de cette + façon : {* voici un commentaire *} + Les commentaires Smarty ne sont pas affichés dans la sortie finale du + template. + Ils sont utilisés pour des notes internes, dans le template, pour aider + les développeurs à en comprendre le fonctionnement. + + + Commentaires + {* Smarty *} {* Inclusion de l'en tête *} @@ -26,7 +27,7 @@ <SELECT name=company> {html_options values=$vals selected=$selected output=$output} </SELECT> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml b/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml index 2062906d..83667425 100644 --- a/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml +++ b/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml @@ -1,16 +1,17 @@ - - Fonctions - - Les balises Smarty affichent une variable - ou invoquent une fonction. Les fonctions sont appelées - lorsqu'elles sont entourées, ainsi que leurs paramètres, des délimiteurs Smarty. - Par exemple : {nomfonction par1="val" par2="val"}. - - - syntaxe des fonctions - + + + Fonctions + + Les balises Smarty affichent une variable + ou invoquent une fonction. Les fonctions sont appelées + lorsqu'elles sont entourées, ainsi que leurs paramètres, des délimiteurs Smarty. + Par exemple : {nomfonction par1="val" par2="val"}. + + + syntaxe des fonctions + {config_load file="colors.conf"} {include file="header.tpl"} @@ -22,19 +23,19 @@ {/if} {include file="footer.tpl"} - - - Les fonctions natives et les fonctions utilisateurs ont toutes deux la même - syntaxe, dans les templates. Les fonctions natives sont relatives - au traitement interne de Smarty, comme par exemple if, - section et strip. Elles ne peuvent - être modifiées. Les fonctions utilisateurs sont des fonctions additionnelles, - implémentées par l'intermédiaire de plugins. - Elles peuvent être modifiées pour correspondre à vos besoins, et vous - pouvez en créer de nouvelles. html_options et - html_select_date sont deux exemples de fonctions - utilisateurs. - + + + Les fonctions natives et les fonctions utilisateurs ont toutes deux la même + syntaxe, dans les templates. Les fonctions natives sont relatives + au traitement interne de Smarty, comme par exemple if, + section et strip. Elles ne peuvent + être modifiées. Les fonctions utilisateurs sont des fonctions additionnelles, + implémentées par l'intermédiaire de plugins. + Elles peuvent être modifiées pour correspondre à vos besoins, et vous + pouvez en créer de nouvelles. html_options et + html_select_date sont deux exemples de fonctions + utilisateurs. + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml b/docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml index 1aea9421..7549f1b7 100644 --- a/docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml +++ b/docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml @@ -1,17 +1,18 @@ - - Variables insérées dans des chaînes de caractères - - Smarty est capable d'interpréter les variables insérées à l'intérieur de - chaînes entre guillemets, du moment que leur nom est exclusivement composé - de chiffres, lettres, underscores et crochets. Si le nom de la variable - contient tout autre caractère (point, référence à un objet, etc.) - la variable doit être entourée d'apostrophes inverses (`). - - - Syntaxe d'insertion de variables dans des chaînes - + + + Variables insérées dans des chaînes de caractères + + Smarty est capable d'interpréter les variables insérées à l'intérieur de + chaînes entre guillemets, du moment que leur nom est exclusivement composé + de chiffres, lettres, underscores et crochets. Si le nom de la variable + contient tout autre caractère (point, référence à un objet, etc.) + la variable doit être entourée d'apostrophes inverses (`). + + + Syntaxe d'insertion de variables dans des chaînes + EXEMPLE DE SYNTAXE: {func var="test $foo test"} <-- comprends $foo {func var="test $foo_bar test"} <-- comprends $foo_bar @@ -24,7 +25,7 @@ EXEMPLE PRATIQUE: {include file="subdir/$tpl_name.tpl"} <-- remplace $tpl_name avec la valeur {cycle values="one,two,`$smarty.config.myval`"} <-- doit comporter les apostrophes inverses - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-builtin-functions.xml b/docs/fr/designers/language-builtin-functions.xml index 6e94fc34..ddd66e54 100644 --- a/docs/fr/designers/language-builtin-functions.xml +++ b/docs/fr/designers/language-builtin-functions.xml @@ -1,30 +1,30 @@ - - Fonctions natives - - Smarty est fourni en standard avec plusieurs fonctions natives. - Les fonctions natives sont partie intégrante du language de template. - Vous ne pouvez pas créer de fonctions utilisateurs qui portent le même nom - qu'une fonction native. Vous ne pouvez pas non plus en modifier le - comportement. - - - &designers.language-builtin-functions.language-function-capture; - &designers.language-builtin-functions.language-function-config-load; - &designers.language-builtin-functions.language-function-foreach; - &designers.language-builtin-functions.language-function-include; - &designers.language-builtin-functions.language-function-include-php; - &designers.language-builtin-functions.language-function-insert; - &designers.language-builtin-functions.language-function-if; - &designers.language-builtin-functions.language-function-ldelim; - &designers.language-builtin-functions.language-function-literal; - &designers.language-builtin-functions.language-function-php; - &designers.language-builtin-functions.language-function-section; - &designers.language-builtin-functions.language-function-strip; - - + + Fonctions natives + + Smarty est fourni en standard avec plusieurs fonctions natives. + Les fonctions natives sont partie intégrante du language de template. + Vous ne pouvez pas créer de fonctions utilisateurs qui portent le même nom + qu'une fonction native. Vous ne pouvez pas non plus en modifier le + comportement. + + + &designers.language-builtin-functions.language-function-capture; + &designers.language-builtin-functions.language-function-config-load; + &designers.language-builtin-functions.language-function-foreach; + &designers.language-builtin-functions.language-function-include; + &designers.language-builtin-functions.language-function-include-php; + &designers.language-builtin-functions.language-function-insert; + &designers.language-builtin-functions.language-function-if; + &designers.language-builtin-functions.language-function-ldelim; + &designers.language-builtin-functions.language-function-literal; + &designers.language-builtin-functions.language-function-php; + &designers.language-builtin-functions.language-function-section; + &designers.language-builtin-functions.language-function-strip; + + - - - insert - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - name - chaîne de caractères - Oui - n/a - le nom de la fonction insert (insert_name) - - - assign - chaîne de caractère - Non - n/a - Le nom de la variable qui recevra la sortie - - - script - chaîne de caractères - Non - n/a - Le nom du script PHP inclus avant que la fonction - insert ne soit appelée. - - - [var ...] - [var type] - Non - n/a - Variable à passer à la fonction insert - - - - - - Les balises insert fonctionnent à peu près comme les balises include, - à l'exception que leur sortie n'est pas placée en cache lorsque - le cache [caching] est activé. - Les balises insert seront exécutées à chaque appel du template. - + + + + insert + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + name + chaîne de caractères + Oui + n/a + le nom de la fonction insert (insert_name) + + + assign + chaîne de caractère + Non + n/a + Le nom de la variable qui recevra la sortie + + + script + chaîne de caractères + Non + n/a + Le nom du script PHP inclus avant que la fonction + insert ne soit appelée. + + + [var ...] + [var type] + Non + n/a + Variable à passer à la fonction insert + + + + - Supposons que vous avez un template avec un emplacement - pour un bandeau publicitaire en haut de page. - Ce bandeau publicitaire peut contenir toutes sortes de contenus - HTML, images, flash, etc. Nous ne pouvons pas placer du contenu - statique à cet endroit. Nous ne voulons pas non plus que ce - contenu fasse partie du cache. Arrive alors la balise insert. - Le template connais #emplacement_bandeau# et #id_site# (récupérés - depuis un fichier de configuration), et à besoin d'un appel de - fonction pour récupérer le contenu du bandeau. - - - function insert + Les balises insert fonctionnent à peu près comme les balises include, + à l'exception que leur sortie n'est pas placée en cache lorsque + le cache [caching] est activé. + Les balises insert seront exécutées à chaque appel du template. + + + Supposons que vous avez un template avec un emplacement + pour un bandeau publicitaire en haut de page. + Ce bandeau publicitaire peut contenir toutes sortes de contenus + HTML, images, flash, etc. Nous ne pouvons pas placer du contenu + statique à cet endroit. Nous ne voulons pas non plus que ce + contenu fasse partie du cache. Arrive alors la balise insert. + Le template connais #emplacement_bandeau# et #id_site# (récupérés + depuis un fichier de configuration), et à besoin d'un appel de + fonction pour récupérer le contenu du bandeau. + + + function insert {* exemple de récupération d'un bandeau publicitaire *} {insert name="getBanner" lid=#emplacement_bandeau# sid=#id_site#} - - - Dans cet exemple, nous utilisons le nom getBanner et lui passons les - paramètres #emplacement_bandeau# et #id_site#. Smarty va rechercher une - fonction appelée insert_getBanner () dans votre application PHP, et lui - passer les valeurs #banner_location_id# et #site_id# comme premier - paramètre, dans un tableau associatif. Tous les noms des fonctions insert - de votre application doivent être prefixées de "insert_" pour remédier - à d'éventuels conflits de nommage. Votre fonction insert_getBanner () - est supposée traiter les valeurs passées et retourner - un résultat. Ces résultats sont affichés dans le template en lieu et - place de la balise. Dans cet exemple, Smarty appellera cette fonction - insert_getBanner(array("lid" => "12345","sid" => "67890")); et affichera - le résultat retourné à la place de la balise insert. - - - Si vous donnez une valeur à l'attribut "assign", la sortie de la balise - insert sera assigné à une variable de template de ce nom au lieu d'être - affichée directement. NOTE: assigner la sortie à une variable n'est pas - très utile lorsque le cache est activé. - - - Si vous donnez une valeur à l'attribut "script", ce script PHP sera - inclus (une seule fois) avant l'exécution de la fonction insert. - Le cas peut survenir lorsque la fonction insert n'existe pas encore, - et que le script PHP chargé de sa définission doit être inclus. Le - chemin doit être absolu ou relatif à $trusted_dir. - Lorsque "security" est actif, le script doit être situé - dans $trusted_dir. - - - L'objet Smarty est passé comme second argument. De cette façon, vous - pouvez utiliser ou modifier des informations sur l'objet Smarty, - directement depuis votre fonction d'insertion. - - - Note technique + - Il est possible d'avoir des portions de template qui ne soient pas - gérables par le cache. Même si vous avez activé l'option - caching, les balises insert - ne feront pas partie du cache. Elles retourneront un contenu dynamique - à chaque invocation de la page. Cette méthode est très pratique pour - des éléments tels que les bandeaux publicitaires, les enquêtes, - la météo, les résultats de recherche, retours utilisateurs, etc. - - - - + Dans cet exemple, nous utilisons le nom getBanner et lui passons les + paramètres #emplacement_bandeau# et #id_site#. Smarty va rechercher une + fonction appelée insert_getBanner () dans votre application PHP, et lui + passer les valeurs #banner_location_id# et #site_id# comme premier + paramètre, dans un tableau associatif. Tous les noms des fonctions insert + de votre application doivent être prefixées de "insert_" pour remédier + à d'éventuels conflits de nommage. Votre fonction insert_getBanner () + est supposée traiter les valeurs passées et retourner + un résultat. Ces résultats sont affichés dans le template en lieu et + place de la balise. Dans cet exemple, Smarty appellera cette fonction + insert_getBanner(array("lid" => "12345","sid" => "67890")); et affichera + le résultat retourné à la place de la balise insert. + + + Si vous donnez une valeur à l'attribut "assign", la sortie de la balise + insert sera assigné à une variable de template de ce nom au lieu d'être + affichée directement. NOTE: assigner la sortie à une variable n'est pas + très utile lorsque le cache est activé. + + + Si vous donnez une valeur à l'attribut "script", ce script PHP sera + inclus (une seule fois) avant l'exécution de la fonction insert. + Le cas peut survenir lorsque la fonction insert n'existe pas encore, + et que le script PHP chargé de sa définission doit être inclus. Le + chemin doit être absolu ou relatif à $trusted_dir. + Lorsque "security" est actif, le script doit être situé + dans $trusted_dir. + + + L'objet Smarty est passé comme second argument. De cette façon, vous + pouvez utiliser ou modifier des informations sur l'objet Smarty, + directement depuis votre fonction d'insertion. + + + Note technique + + Il est possible d'avoir des portions de template qui ne soient pas + gérables par le cache. Même si vous avez activé l'option + caching, les balises insert + ne feront pas partie du cache. Elles retourneront un contenu dynamique + à chaque invocation de la page. Cette méthode est très pratique pour + des éléments tels que les bandeaux publicitaires, les enquêtes, + la météo, les résultats de recherche, retours utilisateurs, etc. + + + + diff --git a/docs/fr/designers/language-custom-functions.xml b/docs/fr/designers/language-custom-functions.xml index b7b0a2fe..42dd236d 100644 --- a/docs/fr/designers/language-custom-functions.xml +++ b/docs/fr/designers/language-custom-functions.xml @@ -7,7 +7,7 @@ Smarty est livré avec plusieurs fonctions utilisateurs que vous pouvez appeler dans vos templates. - + &designers.language-custom-functions.language-function-assign; &designers.language-custom-functions.language-function-counter; &designers.language-custom-functions.language-function-cycle; diff --git a/docs/fr/designers/language-custom-functions/language-function-assign.xml b/docs/fr/designers/language-custom-functions/language-function-assign.xml index 3f9b8e26..712dea59 100644 --- a/docs/fr/designers/language-custom-functions/language-function-assign.xml +++ b/docs/fr/designers/language-custom-functions/language-function-assign.xml @@ -1,46 +1,47 @@ - - assign - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - var - chaîne de caractère - Oui - n/a - Le nom de la variable assignée - - - value - chaîne de caractère - Oui - n/a - La valeur assignée - - - - - - Assign est utilisé pour déclarer ou modifier des variables de template. - - -assign + + + assign + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + var + chaîne de caractère + Oui + n/a + Le nom de la variable assignée + + + value + chaîne de caractère + Oui + n/a + La valeur assignée + + + + + + Assign est utilisé pour déclarer ou modifier des variables de template. + + + assign {assign var="name" value="Bob"} @@ -49,7 +50,7 @@ La valeur de $name est {$name}. SORTIE: La valeur de $name est Bob. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-counter.xml b/docs/fr/designers/language-custom-functions/language-function-counter.xml index 4d739b43..ffd28c24 100644 --- a/docs/fr/designers/language-custom-functions/language-function-counter.xml +++ b/docs/fr/designers/language-custom-functions/language-function-counter.xml @@ -1,85 +1,86 @@ - - counter - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - name - chaîne de caractère - Non - default - Le nom du compteur - - - start - numérique - Non - 1 - La valeur initiale du compteur - - - skip - numérique - Non - 1 - L'intervale du compteur - - - direction - chaîne de caractères - Non - up - la direction du compteur (up/down) [compte / décompte] - - - print - booléen - Non - true - S'il faut afficher cette valeur ou non - - - assign - chaîne de caractères - Non - n/a - La variable dans laquelle la valeur du compteur - sera assignée. - - - - - - counter affiche un compteur. counter retient la valeur - du compte à chaque itération. Vous pouvez adapter le nombre, l'intervale - et la direction du compteur, ainsi que décider d'afficher ou non - les valeurs. Vous pouvez lancer plusieurs compteurs simultanément en - leur donnant des noms uniques. Si vous ne donnez pas de nom à un - compteur, 'default' sera utilisé. - - - Si vous donnez une valeur à l'attribut "assign", alors la sortie de la - fonction counter sera assignée à la variable de template donnée plutôt - que d'être directement affichée. - - -counter + + + counter + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + name + chaîne de caractère + Non + default + Le nom du compteur + + + start + numérique + Non + 1 + La valeur initiale du compteur + + + skip + numérique + Non + 1 + L'intervale du compteur + + + direction + chaîne de caractères + Non + up + la direction du compteur (up/down) [compte / décompte] + + + print + booléen + Non + true + S'il faut afficher cette valeur ou non + + + assign + chaîne de caractères + Non + n/a + La variable dans laquelle la valeur du compteur + sera assignée. + + + + + + counter affiche un compteur. counter retient la valeur + du compte à chaque itération. Vous pouvez adapter le nombre, l'intervale + et la direction du compteur, ainsi que décider d'afficher ou non + les valeurs. Vous pouvez lancer plusieurs compteurs simultanément en + leur donnant des noms uniques. Si vous ne donnez pas de nom à un + compteur, 'default' sera utilisé. + + + Si vous donnez une valeur à l'attribut "assign", alors la sortie de la + fonction counter sera assignée à la variable de template donnée plutôt + que d'être directement affichée. + + + counter {* initialisation du compteur *} {counter start=0 skip=2 print=false} @@ -95,7 +96,7 @@ SORTIE: 4<br> 6<br> 8<br> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-cycle.xml b/docs/fr/designers/language-custom-functions/language-function-cycle.xml index ae5ea867..89ae9895 100644 --- a/docs/fr/designers/language-custom-functions/language-function-cycle.xml +++ b/docs/fr/designers/language-custom-functions/language-function-cycle.xml @@ -1,96 +1,97 @@ - - cycle - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - name - chaîne de caractères - Non - default - Le nom du cycle - - - values - divers - Oui - N/A - Les valeurs sur lesquelles boucler, soit une liste - séparée par des virgules, (voir l'attribut delimiter), - soit un tableau de valeurs. - - - print - booléen - Non - true - S'il faut afficher ou non cette valeur - - - advance - booléen - Non - true - Oui ou non aller à la prochaîne valeur - - - delimiter - chaîne de caractères - Non - , - Le délimiteur à utiliser dans la liste. - - - assign - chaîne de caractères - Non - n/a - La variable de template dans laquelle la sortie - sera assignée - - - - - - cycle est utilisé pour boucler sur un ensemble de valeurs. Très pratique - pour alterner entre deux ou plusieurs couleurs dans un tableau, - ou plus généralement pour boucler sur les valeurs d'un tableau. - - - Vous pouvez définir plusieurs "cycle" dans votre template, en leur - donnant des noms uniques (attribut name). - - - Vous pouvez empêcher la valeur courante de s'afficher en définissant - l'attribut print à false. Ce procédé peut être utile pour discrètement - passer outre une valeur de la liste. - - - L'attribut advance est utilisé pour répéter une valeur. Lorsque - définit à false, le prochain appel de cycle ramènera la même valeur. - - - Si vous définissez l'attribut spécial "assign", la sortie de la fonction - cycle y sera assignée plutôt que d'être directement affichée. - - -cycle + + + cycle + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + name + chaîne de caractères + Non + default + Le nom du cycle + + + values + divers + Oui + N/A + Les valeurs sur lesquelles boucler, soit une liste + séparée par des virgules, (voir l'attribut delimiter), + soit un tableau de valeurs. + + + print + booléen + Non + true + S'il faut afficher ou non cette valeur + + + advance + booléen + Non + true + Oui ou non aller à la prochaîne valeur + + + delimiter + chaîne de caractères + Non + , + Le délimiteur à utiliser dans la liste. + + + assign + chaîne de caractères + Non + n/a + La variable de template dans laquelle la sortie + sera assignée + + + + + + cycle est utilisé pour boucler sur un ensemble de valeurs. Très pratique + pour alterner entre deux ou plusieurs couleurs dans un tableau, + ou plus généralement pour boucler sur les valeurs d'un tableau. + + + Vous pouvez définir plusieurs "cycle" dans votre template, en leur + donnant des noms uniques (attribut name). + + + Vous pouvez empêcher la valeur courante de s'afficher en définissant + l'attribut print à false. Ce procédé peut être utile pour discrètement + passer outre une valeur de la liste. + + + L'attribut advance est utilisé pour répéter une valeur. Lorsque + définit à false, le prochain appel de cycle ramènera la même valeur. + + + Si vous définissez l'attribut spécial "assign", la sortie de la fonction + cycle y sera assignée plutôt que d'être directement affichée. + + + cycle {section name=rows loop=$data} <tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"> @@ -110,7 +111,7 @@ SORTIE: <td>3</td> </tr> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-debug.xml b/docs/fr/designers/language-custom-functions/language-function-debug.xml index 4faa709e..6e26b4a0 100644 --- a/docs/fr/designers/language-custom-functions/language-function-debug.xml +++ b/docs/fr/designers/language-custom-functions/language-function-debug.xml @@ -1,43 +1,44 @@ - - debug - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - output - chaîne de caractères - Non - html - Type de sortie, html ou javascript - - - - - - {debug} amène la console de débogage sur la page. Fonctionne - quelle que soit la valeur du paramètre debug de Smarty. - Comme ce dernier est appelé lors de l'exécution, il n'est capable - d'afficher que les variables assignées au template, et non - les templates en cours d'utilisation. Toutefois, vous voyez toutes - les variables disponibles pour le template courant. - + + + debug + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + output + chaîne de caractères + Non + html + Type de sortie, html ou javascript + + + + + + {debug} amène la console de débogage sur la page. Fonctionne + quelle que soit la valeur du paramètre debug de Smarty. + Comme ce dernier est appelé lors de l'exécution, il n'est capable + d'afficher que les variables assignées au template, et non + les templates en cours d'utilisation. Toutefois, vous voyez toutes + les variables disponibles pour le template courant. + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-eval.xml b/docs/fr/designers/language-custom-functions/language-function-eval.xml index 07bf3a32..f2362867 100644 --- a/docs/fr/designers/language-custom-functions/language-function-eval.xml +++ b/docs/fr/designers/language-custom-functions/language-function-eval.xml @@ -1,71 +1,72 @@ - - eval - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - var - mixed - Oui - n/a - variable (ou chaîne de caractères) à évaluer - - - assign - chaîne de caractères - Non - n/a - Le nom de la variable PHP dans laquelle la sortie - sera assignée - - - - - - eval évalue une variable comme si cette dernière était un template. - Peut être utile pour embarquer des balises de templates ou des variables - de template dans des variables ou des balises/variables dans des - variables de fichiers de configuration. - - - Si vous définissez l'attribut "assign", la sortie sera assignée à la - variable de template désignée plutôt que d'être affichée dans le - template. - - - Note technique - - Les variables évaluées sont traitées de la même façon que les templates. - Elles suivent les mêmes règles de traitement et de sécurité, comme si - elles étaient réellement des templates. - - - - Note technique - - Les variables évaluées sont compilées à chaque invocation, et la version - compilée n'est pas sauvegardée ! Toutefois, si le cache est activé, - la sortie sera placée en cache avec le reste du template. - - - -eval + + + eval + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + var + mixed + Oui + n/a + variable (ou chaîne de caractères) à évaluer + + + assign + chaîne de caractères + Non + n/a + Le nom de la variable PHP dans laquelle la sortie + sera assignée + + + + + + eval évalue une variable comme si cette dernière était un template. + Peut être utile pour embarquer des balises de templates ou des variables + de template dans des variables ou des balises/variables dans des + variables de fichiers de configuration. + + + Si vous définissez l'attribut "assign", la sortie sera assignée à la + variable de template désignée plutôt que d'être affichée dans le + template. + + + Note technique + + Les variables évaluées sont traitées de la même façon que les templates. + Elles suivent les mêmes règles de traitement et de sécurité, comme si + elles étaient réellement des templates. + + + + Note technique + + Les variables évaluées sont compilées à chaque invocation, et la version + compilée n'est pas sauvegardée ! Toutefois, si le cache est activé, + la sortie sera placée en cache avec le reste du template. + + + + eval setup.conf ---------- @@ -96,7 +97,7 @@ Vous devez sp Vous devez spécifier un <b>département</b>. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-fetch.xml b/docs/fr/designers/language-custom-functions/language-function-fetch.xml index efc92bc9..93b46b8e 100644 --- a/docs/fr/designers/language-custom-functions/language-function-fetch.xml +++ b/docs/fr/designers/language-custom-functions/language-function-fetch.xml @@ -1,73 +1,74 @@ - - fetch - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - file - chaîne de caractères - Oui - n/a - le fichier, site http ou ftp à récupérer - - - assign - chaîne de caractères - Non - n/a - le nom de la variable PHP dans laquelle la sortie - sera assignée plutôt que d'être directement affichée. - - - - - - - fetch est utilisé pour récupérer des fichiers depuis le système de - fichier local, depuis un serveur http ou ftp, et en afficher le contenu. - Si le nom du fichier commence par "http://", la page internet sera - récupérée, puis affichée. Si le nom du fichier commence par "ftp://", - le fichier sera récupéré depuis le serveur ftp, et affiché. - Pour les fichiers du système local, le chemin doit être absolu ou - relatif au chemin d'exécution du script PHP. - - - Vous pouvez spécifier l'attribut optionnel assign - qui défini une variable de template dans laquelle la sortie - sera stockée plutôt qude d'être affichée (nouveau dans Smarty 1.5.0). - - - Note technique - Ne supporte pas les redirections http. Assurez vous d'inclure les - slash de fin sur votre page web si nécessaire. - - - - Note technique - - Si la sécurité est activée, vous ne pourez récupérer les - fichiers du système local que s'ils sont situés dans l'un des - répertoires sécurisé ($secure_dir). - - - -fetch + + + fetch + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + file + chaîne de caractères + Oui + n/a + le fichier, site http ou ftp à récupérer + + + assign + chaîne de caractères + Non + n/a + le nom de la variable PHP dans laquelle la sortie + sera assignée plutôt que d'être directement affichée. + + + + + + + fetch est utilisé pour récupérer des fichiers depuis le système de + fichier local, depuis un serveur http ou ftp, et en afficher le contenu. + Si le nom du fichier commence par "http://", la page internet sera + récupérée, puis affichée. Si le nom du fichier commence par "ftp://", + le fichier sera récupéré depuis le serveur ftp, et affiché. + Pour les fichiers du système local, le chemin doit être absolu ou + relatif au chemin d'exécution du script PHP. + + + Vous pouvez spécifier l'attribut optionnel assign + qui défini une variable de template dans laquelle la sortie + sera stockée plutôt qude d'être affichée (nouveau dans Smarty 1.5.0). + + + Note technique + Ne supporte pas les redirections http. Assurez vous d'inclure les + slash de fin sur votre page web si nécessaire. + + + + Note technique + + Si la sécurité est activée, vous ne pourez récupérer les + fichiers du système local que s'ils sont situés dans l'un des + répertoires sécurisé ($secure_dir). + + + + fetch {* Inclus du javascript dans votre template *} {fetch file="/export/httpd/www.domain.com/docs/navbar.js"} @@ -83,7 +84,7 @@ {if $weather ne ""} <b>{$weather}</b> {/if} - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml b/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml index 0284f924..f5073157 100644 --- a/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml +++ b/docs/fr/designers/language-custom-functions/language-function-html-checkboxes.xml @@ -1,88 +1,89 @@ - - html_checkboxes - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - name - chaîne de caractères - Non - checkbox - Nom de la liste de cases à cocher - - - values - array - Oui, à moins que vous n'utilisiez l'attribut - option - n/a - Un tableau de valeurs pour les cases à - cocher - - - output - array - Oui, à moins que vous n'utilisiez l'attribut - option - n/a - Un tableau de sortie pour les cases à cocher - - - checked - chaîne de caractères - Non - empty - Les éléments cochés de la liste - - - options - associative array - Oui, à moins que vous n'utilisiez values et - output - n/a - Un tableau associatif de valeurs et - sorties - - - separator - chaîne de caractères - Non - empty - chaîne de caractère pour séparer chaque case - à cocher - - - - - - html_checkboxes est une fonction utilisateur qui crée un groupe de - cases à cocher avec les données fournies. Elle prend en compte la liste - des éléments sélectionnés par défaut. Les attributs requis sont - values et output, à moins que vous n'utilisiez options à la place. - La sortie générée est compatible XHTML. - - - Tous les paramètres qui ne sont pas listés ci-dessus sont affichés - en tant que paires nom/valeur dans chaque balise <input> crée. - - -html_checkboxes + + + html_checkboxes + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + name + chaîne de caractères + Non + checkbox + Nom de la liste de cases à cocher + + + values + array + Oui, à moins que vous n'utilisiez l'attribut + option + n/a + Un tableau de valeurs pour les cases à + cocher + + + output + array + Oui, à moins que vous n'utilisiez l'attribut + option + n/a + Un tableau de sortie pour les cases à cocher + + + checked + chaîne de caractères + Non + empty + Les éléments cochés de la liste + + + options + associative array + Oui, à moins que vous n'utilisiez values et + output + n/a + Un tableau associatif de valeurs et + sorties + + + separator + chaîne de caractères + Non + empty + chaîne de caractère pour séparer chaque case + à cocher + + + + + + html_checkboxes est une fonction utilisateur qui crée un groupe de + cases à cocher avec les données fournies. Elle prend en compte la liste + des éléments sélectionnés par défaut. Les attributs requis sont + values et output, à moins que vous n'utilisiez options à la place. + La sortie générée est compatible XHTML. + + + Tous les paramètres qui ne sont pas listés ci-dessus sont affichés + en tant que paires nom/valeur dans chaque balise <input> crée. + + + html_checkboxes index.php: @@ -122,7 +123,7 @@ SORTIE: (pour les deux exemples) <input type="checkbox" name="id[]" value="1001" checked="checked"><br /> <input type="checkbox" name="id[]" value="1002">Jane Johnson<br /> <input type="checkbox" name="id[]" value="1003">Charlie Brown<br /> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-html-image.xml b/docs/fr/designers/language-custom-functions/language-function-html-image.xml index be963ebe..c996defe 100644 --- a/docs/fr/designers/language-custom-functions/language-function-html-image.xml +++ b/docs/fr/designers/language-custom-functions/language-function-html-image.xml @@ -1,98 +1,99 @@ - - html_image - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - file - chaîne de caractères - Oui - n/a - nom/chemin des images - - - border - chaîne de caractères - Non - 0 - Bordure de l'image - - - height - chaîne de caractères - Non - Hauteur de l'image actuelle - Hauteur de l'image à afficher - - - width - chaîne de caractères - Non - Longueur de l'image actuelle - Longueur de l'image à afficher - - - basedir - chaîne de caractères - non - racine du serveur web - répertoire depuis lequel baser le calcul des - chemins relatifs - - - link - chaîne de caractères - non - n/a - lien sur lequel l'image pointe - - - - - - html_image est une fonction utilisateur qui génère la balise - HTML pour une image. La hauteur et la longueur de l'image sont calculés - automatiquement depuis le fichier image si aucune n'est spécifiée. - - - basedir est le répertoire de base depuis lequel seront calculés les - chemins relatifs. Si non spécifié, la racine du serveur web est utilisé - (variable d'environnement DOCUMENT_ROOT). Si la sécurité est activée, - l'image doit se situer dans un répertoire sécurisé. - - - link est la valeur href à laquelle lier l'image. Si link est défini, - une balise <a href="VALEURLINK"><a> est placée autour de - l'image. - - - Note technique - - html_image requiert un accès au disque dur pour lire l'image et - calculer ses dimensions. Si vous n'utilisez pas un cache, il - est généralement préférable d'éviter d'utiliser html_image - et de laisser les balises images statiques pour de meilleures - performances. - - - -html_image + + + html_image + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + file + chaîne de caractères + Oui + n/a + nom/chemin des images + + + border + chaîne de caractères + Non + 0 + Bordure de l'image + + + height + chaîne de caractères + Non + Hauteur de l'image actuelle + Hauteur de l'image à afficher + + + width + chaîne de caractères + Non + Longueur de l'image actuelle + Longueur de l'image à afficher + + + basedir + chaîne de caractères + non + racine du serveur web + répertoire depuis lequel baser le calcul des + chemins relatifs + + + link + chaîne de caractères + non + n/a + lien sur lequel l'image pointe + + + + + + html_image est une fonction utilisateur qui génère la balise + HTML pour une image. La hauteur et la longueur de l'image sont calculés + automatiquement depuis le fichier image si aucune n'est spécifiée. + + + basedir est le répertoire de base depuis lequel seront calculés les + chemins relatifs. Si non spécifié, la racine du serveur web est utilisé + (variable d'environnement DOCUMENT_ROOT). Si la sécurité est activée, + l'image doit se situer dans un répertoire sécurisé. + + + link est la valeur href à laquelle lier l'image. Si link est défini, + une balise <a href="VALEURLINK"><a> est placée autour de + l'image. + + + Note technique + + html_image requiert un accès au disque dur pour lire l'image et + calculer ses dimensions. Si vous n'utilisez pas un cache, il + est généralement préférable d'éviter d'utiliser html_image + et de laisser les balises images statiques pour de meilleures + performances. + + + + html_image index.php: @@ -111,7 +112,7 @@ SORTIE: (possible) <img src="pumpkin.jpg" border="0" width="44" height="68"> <img src="/path/under/docroot/pumpkin.jpg" border="0" width="44" height="68"> <img src="../path/relative/to/currdir/pumpkin.jpg" border="0" width="44" height="68"> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-html-options.xml b/docs/fr/designers/language-custom-functions/language-function-html-options.xml index a99bf411..b009f978 100644 --- a/docs/fr/designers/language-custom-functions/language-function-html-options.xml +++ b/docs/fr/designers/language-custom-functions/language-function-html-options.xml @@ -1,90 +1,91 @@ - - html_options - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - values - array - Oui, à moins que vous n'utilisiez - l'attribut options - n/a - un tableau de valeurs pour les listes - déroulantes - - - output - array - Oui, à moins que vous n'utilisiez - l'attribut options - n/a - Un tableau de libellés pour la liste - déroulante - - - selected - chaîne de caractères/tableau - Non - empty - Les éléments sélectionnés - - - options - Tableau associatif - Oui, à moins que vous n'utilisiez option - et values - n/a - Un tableau associatif valeur / libellé - - - name - chaîne de caractères - Non - empty - Nom du goupe d'options - - - - - - html_options est une fonction utilisateur qui crée un groupe d'options - avec les données fournies. Elle prend en charge les éléments - sélectionnés par défaut. Les attributs requis sont values et output, - à moins que vous n'utilisiez options à la place. - - - Si la valeur donnée est un tableau, elle sera traitée comme un - OPTGROUP html, et affichée. La récursivité est supportée avec - OPTGROUP. La sortie est compatible XHTML. - - - Si l'attribut optionnel name est donné, les - balises <select name="groupname"></select> entoureront la - liste d'options. - - - Tous les paramètres qui ne sont pas dans la liste ci-dessus sont - affichés en tant que paires nom / valeur. Ils sont ignorés si - le paramètre optionnel name n'est pas donné. - - -html_options + + + html_options + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + values + array + Oui, à moins que vous n'utilisiez + l'attribut options + n/a + un tableau de valeurs pour les listes + déroulantes + + + output + array + Oui, à moins que vous n'utilisiez + l'attribut options + n/a + Un tableau de libellés pour la liste + déroulante + + + selected + chaîne de caractères/tableau + Non + empty + Les éléments sélectionnés + + + options + Tableau associatif + Oui, à moins que vous n'utilisiez option + et values + n/a + Un tableau associatif valeur / libellé + + + name + chaîne de caractères + Non + empty + Nom du goupe d'options + + + + + + html_options est une fonction utilisateur qui crée un groupe d'options + avec les données fournies. Elle prend en charge les éléments + sélectionnés par défaut. Les attributs requis sont values et output, + à moins que vous n'utilisiez options à la place. + + + Si la valeur donnée est un tableau, elle sera traitée comme un + OPTGROUP html, et affichée. La récursivité est supportée avec + OPTGROUP. La sortie est compatible XHTML. + + + Si l'attribut optionnel name est donné, les + balises <select name="groupname"></select> entoureront la + liste d'options. + + + Tous les paramètres qui ne sont pas dans la liste ci-dessus sont + affichés en tant que paires nom / valeur. Ils sont ignorés si + le paramètre optionnel name n'est pas donné. + + + html_options index.php: @@ -130,7 +131,7 @@ SORTIE: (valable pour les deux exemples) <option value="1002">Jane Johnson</option> <option value="1003">Charlie Brown</option> </select> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-html-radios.xml b/docs/fr/designers/language-custom-functions/language-function-html-radios.xml index 4ef98896..907b9bc6 100644 --- a/docs/fr/designers/language-custom-functions/language-function-html-radios.xml +++ b/docs/fr/designers/language-custom-functions/language-function-html-radios.xml @@ -1,88 +1,89 @@ - - html_radios - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - name - chaîne de caractères - Non - radio - nom de la liste boutons radio - - - values - tableau - Oui, à moins que vous n'utilisiez l'attribut - options - n/a - Le tableau des valeurs des boutons radio - - - output - tableau - Oui, à moins que vous n'utilisiez l'attribut - options - n/a - Un tableau de libellés pour les boutons radio - - - checked - chaîne de caractères - Non - empty - Les boutons radios sélectionnés - - - options - tableau associatif - Oui, à moins que vous n'utilisiez values - et outputs - n/a - un tableau associatif valeurs / libellés - - - separator - chaîne de caractères - Non - empty - chaîne de séparation à placer entre les - boutons radio - - - - - - html_radio est une fonction utilisateur qui crée des boutons radio - html à partir des données fournies. Elle prend en charge les éléments - sélectionnés par défaut. Les attributs requis sont values et output, - à moins que vous n'utilisiez options à la place. La sortie générée est - compatible XHTML. - - - Tous les paramètres qui ne sont pas dans la liste ci dessus sont - affichés en tant que paires nom / valeur dans chaque balise <input> - créée. - - - -html_radios + + + html_radios + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + name + chaîne de caractères + Non + radio + nom de la liste boutons radio + + + values + tableau + Oui, à moins que vous n'utilisiez l'attribut + options + n/a + Le tableau des valeurs des boutons radio + + + output + tableau + Oui, à moins que vous n'utilisiez l'attribut + options + n/a + Un tableau de libellés pour les boutons radio + + + checked + chaîne de caractères + Non + empty + Les boutons radios sélectionnés + + + options + tableau associatif + Oui, à moins que vous n'utilisiez values + et outputs + n/a + un tableau associatif valeurs / libellés + + + separator + chaîne de caractères + Non + empty + chaîne de séparation à placer entre les + boutons radio + + + + + + html_radio est une fonction utilisateur qui crée des boutons radio + html à partir des données fournies. Elle prend en charge les éléments + sélectionnés par défaut. Les attributs requis sont values et output, + à moins que vous n'utilisiez options à la place. La sortie générée est + compatible XHTML. + + + Tous les paramètres qui ne sont pas dans la liste ci dessus sont + affichés en tant que paires nom / valeur dans chaque balise <input> + créée. + + + + html_radios index.php: @@ -124,7 +125,7 @@ SORTIE: (both examples) <input type="radio" name="id[]" value="1001" checked="checked"><br /> <input type="radio" name="id[]" value="1002">Jane Johnson<br /> <input type="radio" name="id[]" value="1003">Charlie Brown<br /> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml b/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml index 1d0ace53..7a77b66b 100644 --- a/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml +++ b/docs/fr/designers/language-custom-functions/language-function-html-select-date.xml @@ -1,215 +1,216 @@ - - html_select_date - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - prefix - chaîne de caractères - Non - Date_ - Avec quoi préfixer le nom de variable - - - time - timestamp/YYYY-MM-DD - Non - la date courante au format unix YYYY-MM-DD - format - la date / heure à utiliser - - - start_year - chaîne de caractères - Non - current year - La première année dans la liste déroulante, soit - le numéro de l'année, soit un nombre relatif à l'année - courante (+/- N). - - - end_year - chaîne de caractères - Non - même chose que start_year - La dernière année dans la liste déroulante, soit - le numéro de l'année, soit un nombre relatif à l'année - courante (+/- N). - - - display_days - boolean - Non - true - Si l'on souhaite afficher les jours ou pas. - - - display_months - boolean - Non - true - Si l'on souhaite afficher les mois ou pas. - - - display_years - boolean - Non - true - Si l'on souhaite afficher les années ou pas. - - - month_format - chaîne de caractères - Non - %B - le format du mois (strftime) - - - day_format - chaîne de caractères - Non - %02d - Le format du jour (sprintf) - - - day_value_format - chaîne de caractères - Non - %d - le format de la valeur du jour (sprintf) - - - year_as_text - boolean - Non - false - S'il faut afficher l'année au format texte - - - reverse_years - boolean - Non - false - Affiche les années dans l'ordre inverse - - - field_array - chaîne de caractères - Non - null - - Si un nom est donné, la liste déroulante sera affichée - de telle façon que les résultats seront retournés à PHP - sous la forme nom[Day] (jour), nom[Year] (année), - nom[Month] (Mois). - - - - day_size - chaîne de caractères - Non - null - Ajoute un attribut size à la liste - déroulante des jours. - - - month_size - chaîne de caractères - Non - null - Ajoute un attribut size à la liste - déroulante des mois. - - - year_size - chaîne de caractères - Non - null - Ajoute un attribut size à la liste - déroulante des années. - - - all_extra - chaîne de caractères - Non - null - Ajoute des attributs supplémentaires à - toutes les balises select/input. - - - day_extra - chaîne de caractères - Non - null - Ajoute des attributs supplémentaires aux balises - select/input du jour. - - - month_extra - chaîne de caractères - Non - null - Ajoute des attributs supplémentaires aux balises - select/input du mois. - - - year_extra - chaîne de caractères - Non - null - Ajoute des attributs supplémentaires aux balises - select/input de l'année. - - - field_order - chaîne de caractères - Non - MDY - L'ordre dans lequel afficher les - listes déroulantes. - - - field_separator - chaîne de caractères - Non - \n - la chaîne de caractères affichée entre les - différents champs. - - - month_value_format - chaîne de caractères - Non - %m - Le format strftime de la valeur des mois, par défaut %m - pour les numéros. - - - - - - html_select_date est une fonction utilisateur qui crée des listes - déroulantes pour saisir la date. Elle peut afficher n'importe quel - jour, mois et année. - - -html_select_date + + + html_select_date + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + prefix + chaîne de caractères + Non + Date_ + Avec quoi préfixer le nom de variable + + + time + timestamp/YYYY-MM-DD + Non + la date courante au format unix YYYY-MM-DD + format + la date / heure à utiliser + + + start_year + chaîne de caractères + Non + current year + La première année dans la liste déroulante, soit + le numéro de l'année, soit un nombre relatif à l'année + courante (+/- N). + + + end_year + chaîne de caractères + Non + même chose que start_year + La dernière année dans la liste déroulante, soit + le numéro de l'année, soit un nombre relatif à l'année + courante (+/- N). + + + display_days + boolean + Non + true + Si l'on souhaite afficher les jours ou pas. + + + display_months + boolean + Non + true + Si l'on souhaite afficher les mois ou pas. + + + display_years + boolean + Non + true + Si l'on souhaite afficher les années ou pas. + + + month_format + chaîne de caractères + Non + %B + le format du mois (strftime) + + + day_format + chaîne de caractères + Non + %02d + Le format du jour (sprintf) + + + day_value_format + chaîne de caractères + Non + %d + le format de la valeur du jour (sprintf) + + + year_as_text + boolean + Non + false + S'il faut afficher l'année au format texte + + + reverse_years + boolean + Non + false + Affiche les années dans l'ordre inverse + + + field_array + chaîne de caractères + Non + null + + Si un nom est donné, la liste déroulante sera affichée + de telle façon que les résultats seront retournés à PHP + sous la forme nom[Day] (jour), nom[Year] (année), + nom[Month] (Mois). + + + + day_size + chaîne de caractères + Non + null + Ajoute un attribut size à la liste + déroulante des jours. + + + month_size + chaîne de caractères + Non + null + Ajoute un attribut size à la liste + déroulante des mois. + + + year_size + chaîne de caractères + Non + null + Ajoute un attribut size à la liste + déroulante des années. + + + all_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires à + toutes les balises select/input. + + + day_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select/input du jour. + + + month_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select/input du mois. + + + year_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select/input de l'année. + + + field_order + chaîne de caractères + Non + MDY + L'ordre dans lequel afficher les + listes déroulantes. + + + field_separator + chaîne de caractères + Non + \n + la chaîne de caractères affichée entre les + différents champs. + + + month_value_format + chaîne de caractères + Non + %m + Le format strftime de la valeur des mois, par défaut %m + pour les numéros. + + + + + + html_select_date est une fonction utilisateur qui crée des listes + déroulantes pour saisir la date. Elle peut afficher n'importe quel + jour, mois et année. + + + html_select_date {html_select_date} @@ -266,11 +267,11 @@ SORTIE: <select name="Date_Year"> <option value="2001" selected>2001</option> </select> - - - - -html_select_date + + + + + html_select_date {* le démarage et la fin de l'année peuvent être relatif à l'année courante *} @@ -301,7 +302,7 @@ SORTIE: (current year is 2000) <option value="2000" selected>2000</option> <option value="2001">2001</option> </select> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-html-select-time.xml b/docs/fr/designers/language-custom-functions/language-function-html-select-time.xml index 4c4004c8..8225ac90 100644 --- a/docs/fr/designers/language-custom-functions/language-function-html-select-time.xml +++ b/docs/fr/designers/language-custom-functions/language-function-html-select-time.xml @@ -1,147 +1,148 @@ - - html_select_time - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - prefix - chaîne de caractères - Non - Time_ - Par quoi préfixer la variable. - - - time - timestamp - Non - current time - Quel jour / heure utiliser. - - - display_hours - boolean - Non - true - S'il faut afficher l'heure. - - - display_minutes - boolean - Non - true - S'il faut afficher les minutes. - - - display_seconds - boolean - Non - true - S'il faut afficher les secondes. - - - display_meridian - boolean - Non - true - S'il faut afficher le méridian (am/pm) - - - use_24_hours - boolean - Non - true - S'il faut utiliser l'horloge 24 heure. - - - minute_interval - integer - Non - 1 - Intervalle des minutes dans la liste - déroulante - - - second_interval - integer - Non - 1 - Intervalle des secondes dans la liste - déroulante - - - field_array - chaîne de caractères - Non - n/a - Nom du tableau dans lequel les valeures - seront stockées. - - - all_extra - chaîne de caractères - Non - null - Ajoute des attributs supplémentaires aux balises - select / input. - - - hour_extra - chaîne de caractères - Non - null - Ajoute des attributs supplémentaires aux balises - select / input de l'heure. - - - minute_extra - chaîne de caractères - Non - null - Ajoute des attributs supplémentaires aux balises - select / input des minutes. - - - second_extra - chaîne de caractères - Non - null - Ajoute des attributs supplémentaires aux balises - select / input des secondes. - - - meridian_extra - chaîne de caractères - Non - null - Ajoute des attributs supplémentaires aux balises - select / input du méridian. - - - - - - html_select_time est une fonction utilisateur qui crée des listes - déroulantes pour saisir une heure. Elle prends en charge l'heure, - les minutes, les secondes et le méridian. - - -html_select_time + + + html_select_time + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + prefix + chaîne de caractères + Non + Time_ + Par quoi préfixer la variable. + + + time + timestamp + Non + current time + Quel jour / heure utiliser. + + + display_hours + boolean + Non + true + S'il faut afficher l'heure. + + + display_minutes + boolean + Non + true + S'il faut afficher les minutes. + + + display_seconds + boolean + Non + true + S'il faut afficher les secondes. + + + display_meridian + boolean + Non + true + S'il faut afficher le méridian (am/pm) + + + use_24_hours + boolean + Non + true + S'il faut utiliser l'horloge 24 heure. + + + minute_interval + integer + Non + 1 + Intervalle des minutes dans la liste + déroulante + + + second_interval + integer + Non + 1 + Intervalle des secondes dans la liste + déroulante + + + field_array + chaîne de caractères + Non + n/a + Nom du tableau dans lequel les valeures + seront stockées. + + + all_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input. + + + hour_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input de l'heure. + + + minute_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input des minutes. + + + second_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input des secondes. + + + meridian_extra + chaîne de caractères + Non + null + Ajoute des attributs supplémentaires aux balises + select / input du méridian. + + + + + + html_select_time est une fonction utilisateur qui crée des listes + déroulantes pour saisir une heure. Elle prends en charge l'heure, + les minutes, les secondes et le méridian. + + + html_select_time {html_select_time use_24_hours=true} @@ -302,7 +303,7 @@ SORTIE: <option value="am" selected>AM</option> <option value="pm">PM</option> </select> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-html-table.xml b/docs/fr/designers/language-custom-functions/language-function-html-table.xml index eb066305..5ce36bbc 100644 --- a/docs/fr/designers/language-custom-functions/language-function-html-table.xml +++ b/docs/fr/designers/language-custom-functions/language-function-html-table.xml @@ -1,85 +1,86 @@ - - html_table - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - loop - array - Oui - n/a - Tableau de données à parcourir - - - cols - integer - Non - 3 - Nombre de colonnes du tableau - - - table_attr - chaîne de caractères - Non - border="1" - attributs pour la balise table - - - tr_attr - chaîne de caractères - Non - empty - attributs pour les balises tr (les tableaux sont - parcourus) - - - td_attr - chaîne de caractères - Non - empty - attributs pour les balises td (les tableaux sont - parcourus) - - - trailpad - chaîne de caractères - Non - &nbsp; - valeur avec laquelle remplir les cellules - restantes de la dernière ligne (si il y en a) - - - - - - html_table est une fonction utilisateur - qui transforme un tableau de données dans un tabeau HTML. L'attribut - cols détermine le nombre de colonne du tableau. - Les attributs table_attr, tr_attr - et td_attr déterminent les attributs donnés aux - balises table, tr et td. Si tr_attr ou - td_attr sont des tableaux, ils seront parcourus. - trailpad est la valeur avec laquelle remplir - les cellules restantes de la dernière ligne, s'il y en a une. - - -html_table + + + html_table + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + loop + array + Oui + n/a + Tableau de données à parcourir + + + cols + integer + Non + 3 + Nombre de colonnes du tableau + + + table_attr + chaîne de caractères + Non + border="1" + attributs pour la balise table + + + tr_attr + chaîne de caractères + Non + empty + attributs pour les balises tr (les tableaux sont + parcourus) + + + td_attr + chaîne de caractères + Non + empty + attributs pour les balises td (les tableaux sont + parcourus) + + + trailpad + chaîne de caractères + Non + &nbsp; + valeur avec laquelle remplir les cellules + restantes de la dernière ligne (si il y en a) + + + + + + html_table est une fonction utilisateur + qui transforme un tableau de données dans un tabeau HTML. L'attribut + cols détermine le nombre de colonne du tableau. + Les attributs table_attr, tr_attr + et td_attr déterminent les attributs donnés aux + balises table, tr et td. Si tr_attr ou + td_attr sont des tableaux, ils seront parcourus. + trailpad est la valeur avec laquelle remplir + les cellules restantes de la dernière ligne, s'il y en a une. + + + html_table index.php: @@ -112,7 +113,7 @@ SORTIE: <tr bgcolor="#dddddd"><td>5</td><td>6</td><td>7</td><td>8</td></tr> <tr bgcolor="#eeeeee"><td>9</td><td>&nbsp;</td><td>&nbsp;</td><td>&nbsp;</td></tr> </table> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-mailto.xml b/docs/fr/designers/language-custom-functions/language-function-mailto.xml index 4646e899..2729a066 100644 --- a/docs/fr/designers/language-custom-functions/language-function-mailto.xml +++ b/docs/fr/designers/language-custom-functions/language-function-mailto.xml @@ -1,111 +1,112 @@ - - mailto - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - address - chaîne de caractères - Oui - n/a - l'adresse email - - - text - chaîne de caractères - Non - n/a - le texte à afficher, par défaut l'adresse email - - - encode - chaîne de caractères - Non - none - Comment encoder l'adresse email. - none, hex et javascript sont des valeurs correctes. - - - cc - chaîne de caractères - Non - n/a - Les adresses email en copie (Cc). - Séparez les entrées par une virgule. - - - bcc - chaîne de caractères - Non - n/a - Les adresses email en copie cachées (Bcc). - Séparez les entrées par une virgule. - - - subject - chaîne de caractères - Non - n/a - Sujet de l'email. - - - newsgroups - chaîne de caractères - Non - n/a - newsgroup ou poster le message. - Séparez les entrées par une virgule. - - - followupto - chaîne de caractères - Non - n/a - Adresses ou transmettre le message. - Séparez les entrées par une virgule. - - - - extra - chaîne de caractères - Non - n/a - Toute information que vous souhaitez passer au lien, - comme par exemple une classe css. - - - - - - mailto crée un lien mailto automatiquement encodé (optionnel). - L'encodage rend la tâche de récupération des e-mails sur votre - site plus difficiles aux "web spiders". - - - Note technique - - javascript n'est certainement pas la forme d'encodage la plus robuste. - Vous pouvez également utiliser un encodage hexadécimal. - - - -mailto + + + mailto + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + address + chaîne de caractères + Oui + n/a + l'adresse email + + + text + chaîne de caractères + Non + n/a + le texte à afficher, par défaut l'adresse email + + + encode + chaîne de caractères + Non + none + Comment encoder l'adresse email. + none, hex et javascript sont des valeurs correctes. + + + cc + chaîne de caractères + Non + n/a + Les adresses email en copie (Cc). + Séparez les entrées par une virgule. + + + bcc + chaîne de caractères + Non + n/a + Les adresses email en copie cachées (Bcc). + Séparez les entrées par une virgule. + + + subject + chaîne de caractères + Non + n/a + Sujet de l'email. + + + newsgroups + chaîne de caractères + Non + n/a + newsgroup ou poster le message. + Séparez les entrées par une virgule. + + + followupto + chaîne de caractères + Non + n/a + Adresses ou transmettre le message. + Séparez les entrées par une virgule. + + + + extra + chaîne de caractères + Non + n/a + Toute information que vous souhaitez passer au lien, + comme par exemple une classe css. + + + + + + mailto crée un lien mailto automatiquement encodé (optionnel). + L'encodage rend la tâche de récupération des e-mails sur votre + site plus difficiles aux "web spiders". + + + Note technique + + javascript n'est certainement pas la forme d'encodage la plus robuste. + Vous pouvez également utiliser un encodage hexadécimal. + + + + mailto {mailto address="me@domain.com"} {mailto address="moi@domaine.com" text="send me some mail"} @@ -128,7 +129,7 @@ SORTIE: <a href="mailto:moi@domaine.com?subject=Hello%20to%20you%21" >moi@domaine.com</a> <a href="mailto:moi@domaine.com?cc=you@domain.com%2Cthey@domain.com" >moi@domaine.com</a> <a href="mailto:moi@domaine.com" class="email">moi@domaine.com</a> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-math.xml b/docs/fr/designers/language-custom-functions/language-function-math.xml index d7ce5fd1..84562ac8 100644 --- a/docs/fr/designers/language-custom-functions/language-function-math.xml +++ b/docs/fr/designers/language-custom-functions/language-function-math.xml @@ -1,93 +1,94 @@ - - math - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - equation - chaîne de caractères - Oui - n/a - L'opération à éxécuter - - - format - chaîne de caractères - Non - n/a - Le format du résultat (sprintf) - - - var - numeric - Oui - n/a - Les variables de l'opération - - - assign - chaîne de caractères - Non - n/a - Variable de template dans laquelle la sortie - sera assignée - - - [var ...] - numeric - Oui - n/a - Valeurs des variables de l'opération - - - - - - math autorise les designers de templates à effectuer des opérations - dans le template. Toute valeur numérique peut être utilisée dans une - opération, et le résultat sera affiché à la place des balises - "equation". Les variables utilisées dans l'opération sont passées en - tant que paramètre, et peuvent être des variables de templates ou des - valeurs statiques. +, -, /, *, abs, ceil, cos, - exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, - srans et tan sont tous des opérateurs valides. Voir la - documentation PHP pour plus d'informations sur ces fonctions - mathématiques. - - - Si vous spécifiez l'attribut assign, la sortie sera assignée à la variable - donnée plutôt que d'être directement affichée. - - - Note technique - - math est une fonction coûteuse en terme de performances, du fait - qu'elle utilise la fonction PHP eval (). Effectuer les calculs - dans votre code PHP est beaucoup plus efficient, donc, chaque fois - que possible, effectuez vos calculs directement dans PHP et assignez - le résultat au template. Evitez coût que coût les appels - répétitifs à la fonction math, comme on pourait le faire une - une boucle section. - - - -math + + + math + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + equation + chaîne de caractères + Oui + n/a + L'opération à éxécuter + + + format + chaîne de caractères + Non + n/a + Le format du résultat (sprintf) + + + var + numeric + Oui + n/a + Les variables de l'opération + + + assign + chaîne de caractères + Non + n/a + Variable de template dans laquelle la sortie + sera assignée + + + [var ...] + numeric + Oui + n/a + Valeurs des variables de l'opération + + + + + + math autorise les designers de templates à effectuer des opérations + dans le template. Toute valeur numérique peut être utilisée dans une + opération, et le résultat sera affiché à la place des balises + "equation". Les variables utilisées dans l'opération sont passées en + tant que paramètre, et peuvent être des variables de templates ou des + valeurs statiques. +, -, /, *, abs, ceil, cos, + exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, + srans et tan sont tous des opérateurs valides. Voir la + documentation PHP pour plus d'informations sur ces fonctions + mathématiques. + + + Si vous spécifiez l'attribut assign, la sortie sera assignée à la variable + donnée plutôt que d'être directement affichée. + + + Note technique + + math est une fonction coûteuse en terme de performances, du fait + qu'elle utilise la fonction PHP eval (). Effectuer les calculs + dans votre code PHP est beaucoup plus efficient, donc, chaque fois + que possible, effectuez vos calculs directement dans PHP et assignez + le résultat au template. Evitez coût que coût les appels + répétitifs à la fonction math, comme on pourait le faire une + une boucle section. + + + + math {* $height=4, $width=5 *} @@ -126,7 +127,7 @@ SORTIE: SORTIE: 9.44 - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-popup-init.xml b/docs/fr/designers/language-custom-functions/language-function-popup-init.xml index 056ec4f4..b2c909c3 100644 --- a/docs/fr/designers/language-custom-functions/language-function-popup-init.xml +++ b/docs/fr/designers/language-custom-functions/language-function-popup-init.xml @@ -1,29 +1,30 @@ - - popup_init - - popup est une intégration de overLib, une librairie capable de réaliser - des fenêtres surgissantes. (nous parlerons de "popup"). - Ce type de fenêtre est utilisé pour apporter des informations - contextuelles, comme des infobulles d'aides ou astuces. - popup_init doit être appelé une fois, en début de page si vous comptez - utiliser la fonction popup. - overLib à été écrit par Erik Bosrup. Le site d'overlib est situé à - l'adresse http://www.bosrup.com/web/overlib/. - - - Comme dans Smarty 2.1.2, overLib n'est PAS fournie dans la distribution. - Téléchargez overLib, déposez overlib.js dans votre arborescence web et - indiquez le chemin relatif à ce fichier dans l'attribut src de - popup_init. - - -popup_init + + + popup_init + + popup est une intégration de overLib, une librairie capable de réaliser + des fenêtres surgissantes. (nous parlerons de "popup"). + Ce type de fenêtre est utilisé pour apporter des informations + contextuelles, comme des infobulles d'aides ou astuces. + popup_init doit être appelé une fois, en début de page si vous comptez + utiliser la fonction popup. + overLib à été écrit par Erik Bosrup. Le site d'overlib est situé à + l'adresse http://www.bosrup.com/web/overlib/. + + + Comme dans Smarty 2.1.2, overLib n'est PAS fournie dans la distribution. + Téléchargez overLib, déposez overlib.js dans votre arborescence web et + indiquez le chemin relatif à ce fichier dans l'attribut src de + popup_init. + + + popup_init {* popup_init doit être appelé une fois en début de page. *} {popup_init src="/javascripts/overlib.js"} - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-popup.xml b/docs/fr/designers/language-custom-functions/language-function-popup.xml index d9c8f580..678b9e74 100644 --- a/docs/fr/designers/language-custom-functions/language-function-popup.xml +++ b/docs/fr/designers/language-custom-functions/language-function-popup.xml @@ -1,410 +1,411 @@ - - popup - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - text - chaîne de caractères - Oui - n/a - le texte/code html à afficher dans la popup - - - trigger - chaîne de caractères - Non - onMouseOver - L'évènement utilisé pour rendre la popup active, - onMouseOver ou onClick. - - - sticky - boolean - Non - false - Rends la popup active jusqu'a ce qu'elle soit - explicitement fermée. - - - caption - chaîne de caractères - Non - n/a - Défini le libellé du titre - - - fgcolor - chaîne de caractères - Non - n/a - couleur interne de la popup - - - bgcolor - chaîne de caractères - Non - n/a - couleur de la bordure de la popup - - - textcolor - chaîne de caractères - Non - n/a - couleur du texte à l'intérieur de la - popup - - - capcolor - chaîne de caractères - Non - n/a - couleur du libellé de la popup - - - closecolor - chaîne de caractères - Non - n/a - couleur du texte de fermeture - - - textfont - chaîne de caractères - Non - n/a - la police à utiliser dans le texte principal - - - captionfont - chaîne de caractères - Non - n/a - la police à utiliser dans le libellé - - - closefont - chaîne de caractères - Non - n/a - la police pour le texte de fermeture - - - textsize - chaîne de caractères - Non - n/a - taille de la police texte prinicpal - - - captionsize - chaîne de caractères - Non - n/a - taille de la police du libellé - - - closesize - chaîne de caractères - Non - n/a - taille de la police du bouton "fermer" - - - width - integer - Non - n/a - Longeur de la popup - - - height - integer - Non - n/a - Hauteur de la popup - - - left - boolean - Non - false - la popup va à gauche de la souris - - - right - boolean - Non - false - la popup va à droite de la souris - - - center - boolean - Non - false - la popup est centrée par rapport à la - position de la souris - - - above - boolean - Non - false - la popup est au dessus de la souris. NOTE: - possible uniquement si la hauteur est définie - - - below - boolean - Non - false - la popup apparait en dessous de la souris - - - border - integer - Non - n/a - rends la bordure de la popup plus épaisse ou plus - fine - - - offsetx - integer - Non - n/a - A quelle distance du curseur la popup apparaitra - , horizontalement. - - - offsety - integer - Non - n/a - A quelle distance du curseur la popup apparaitra - , verticalement. - - - fgbackground - url to image - Non - n/a - Une image à utiliser à la place de la couleur de - fonds dans la popup - - - bgbackground - url to image - Non - n/a - Image à utiliser à la place de la bordure de la - popup. NOTE: vous veillerez à définir bgcolor à "" ou la - couleur apparaitra de même. NOTE: Lorsque vous avez un - lien de fermeture, Netscape effectuera un nouveau rendu - des cellules du tableau, affichant mal les éléments - - - closetext - chaîne de caractères - Non - n/a - définit le texte de fermeture par autre chose - que "Close" - - - noclose - boolean - Non - n/a - N'affiche pas le bouton "Close" pour les fenêtres - "collantes". - - - - status - chaîne de caractères - Non - n/a - défini le texte de la barre de statut - du navigateur - - - autostatus - boolean - Non - n/a - Défini le texte de la barre de statut au contenu - de la popup. NOTE: Ecrase l'attribut status. - - - autostatuscap - chaîne de caractères - Non - n/a - Défini le texte de la barre de statut au libellé - de la popup. NOTE: Ecrase l'attribut status. - - - inarray - integer - Non - n/a - indique à overLib de lire le texte à cet index dans le - tableau ol_text, situé dans overlib.js. Ce paramètre peut être - utilisé à la place de text. - - - caparray - integer - Non - n/a - indique à overlib de lire le libellé depuis le - tableau ol_caps - - - capicon - url - Non - n/a - affiche l'image spécifiée avant le libellé de la - popup - - - snapx - integer - Non - n/a - Aligne la popup sur une grille horizontale - - - snapy - integer - Non - n/a - Aligne la popup sur une grille verticale - - - fixx - integer - Non - n/a - vérrouille la popup à une position horizontale. - Note: remplace les autres paramètres de position - horizontale - - - fixy - integer - Non - n/a - vérouille la popup à une position verticale - Note: remplace les autres paramètres de position - verticale - - - background - url - Non - n/a - défini l'image à utiliser plutôt que le tableau - de fond - - - padx - integer,integer - Non - n/a - écarte l'image de fond du reste des éléments - avec un espace horizontal, pour le positionnement du texte. - Note: c'est un attribut à deux paramètres. - - - pady - integer,integer - Non - n/a - écarte l'image de fond du reste des éléments - avec un espace vertical, pour le positionnement du texte. - Note: c'est un attribut à deux paramètres. - - - fullhtml - boolean - Non - n/a - vous autorise à placer du code html en tant que - contenu de la popup. Le code html est attendu dans - l'attribut text. - - - frame - chaîne de caractères - Non - n/a - contrôle la popup dans un cadre différent. - Voir la documentation d'overlib pour plus de détails - sur cette fonction. - - - timeout - chaîne de caractères - Non - n/a - Appelle la fonction javascript spécifiée et prends - sa valeur de retour comme texte devant être affiché - dans la popup. - - - delay - integer - Non - n/a - la popup se comporte comme une infobulle. - Elle disparaitra au bout d'un certain délai, en - millisecondes. - - - hauto - boolean - Non - n/a - Détermine automatiquement si la popup doit être - à gauche ou à droite de la souris - - - vauto - boolean - Non - n/a - Détermine automatiquement si la popup doit être - au-dessus ou au-dessous de la souris - - - - - - popup est utilisé pour créer une fenêtre popup javascript. - - -popup + + + popup + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + text + chaîne de caractères + Oui + n/a + le texte/code html à afficher dans la popup + + + trigger + chaîne de caractères + Non + onMouseOver + L'évènement utilisé pour rendre la popup active, + onMouseOver ou onClick. + + + sticky + boolean + Non + false + Rends la popup active jusqu'a ce qu'elle soit + explicitement fermée. + + + caption + chaîne de caractères + Non + n/a + Défini le libellé du titre + + + fgcolor + chaîne de caractères + Non + n/a + couleur interne de la popup + + + bgcolor + chaîne de caractères + Non + n/a + couleur de la bordure de la popup + + + textcolor + chaîne de caractères + Non + n/a + couleur du texte à l'intérieur de la + popup + + + capcolor + chaîne de caractères + Non + n/a + couleur du libellé de la popup + + + closecolor + chaîne de caractères + Non + n/a + couleur du texte de fermeture + + + textfont + chaîne de caractères + Non + n/a + la police à utiliser dans le texte principal + + + captionfont + chaîne de caractères + Non + n/a + la police à utiliser dans le libellé + + + closefont + chaîne de caractères + Non + n/a + la police pour le texte de fermeture + + + textsize + chaîne de caractères + Non + n/a + taille de la police texte prinicpal + + + captionsize + chaîne de caractères + Non + n/a + taille de la police du libellé + + + closesize + chaîne de caractères + Non + n/a + taille de la police du bouton "fermer" + + + width + integer + Non + n/a + Longeur de la popup + + + height + integer + Non + n/a + Hauteur de la popup + + + left + boolean + Non + false + la popup va à gauche de la souris + + + right + boolean + Non + false + la popup va à droite de la souris + + + center + boolean + Non + false + la popup est centrée par rapport à la + position de la souris + + + above + boolean + Non + false + la popup est au dessus de la souris. NOTE: + possible uniquement si la hauteur est définie + + + below + boolean + Non + false + la popup apparait en dessous de la souris + + + border + integer + Non + n/a + rends la bordure de la popup plus épaisse ou plus + fine + + + offsetx + integer + Non + n/a + A quelle distance du curseur la popup apparaitra + , horizontalement. + + + offsety + integer + Non + n/a + A quelle distance du curseur la popup apparaitra + , verticalement. + + + fgbackground + url to image + Non + n/a + Une image à utiliser à la place de la couleur de + fonds dans la popup + + + bgbackground + url to image + Non + n/a + Image à utiliser à la place de la bordure de la + popup. NOTE: vous veillerez à définir bgcolor à "" ou la + couleur apparaitra de même. NOTE: Lorsque vous avez un + lien de fermeture, Netscape effectuera un nouveau rendu + des cellules du tableau, affichant mal les éléments + + + closetext + chaîne de caractères + Non + n/a + définit le texte de fermeture par autre chose + que "Close" + + + noclose + boolean + Non + n/a + N'affiche pas le bouton "Close" pour les fenêtres + "collantes". + + + + status + chaîne de caractères + Non + n/a + défini le texte de la barre de statut + du navigateur + + + autostatus + boolean + Non + n/a + Défini le texte de la barre de statut au contenu + de la popup. NOTE: Ecrase l'attribut status. + + + autostatuscap + chaîne de caractères + Non + n/a + Défini le texte de la barre de statut au libellé + de la popup. NOTE: Ecrase l'attribut status. + + + inarray + integer + Non + n/a + indique à overLib de lire le texte à cet index dans le + tableau ol_text, situé dans overlib.js. Ce paramètre peut être + utilisé à la place de text. + + + caparray + integer + Non + n/a + indique à overlib de lire le libellé depuis le + tableau ol_caps + + + capicon + url + Non + n/a + affiche l'image spécifiée avant le libellé de la + popup + + + snapx + integer + Non + n/a + Aligne la popup sur une grille horizontale + + + snapy + integer + Non + n/a + Aligne la popup sur une grille verticale + + + fixx + integer + Non + n/a + vérrouille la popup à une position horizontale. + Note: remplace les autres paramètres de position + horizontale + + + fixy + integer + Non + n/a + vérouille la popup à une position verticale + Note: remplace les autres paramètres de position + verticale + + + background + url + Non + n/a + défini l'image à utiliser plutôt que le tableau + de fond + + + padx + integer,integer + Non + n/a + écarte l'image de fond du reste des éléments + avec un espace horizontal, pour le positionnement du texte. + Note: c'est un attribut à deux paramètres. + + + pady + integer,integer + Non + n/a + écarte l'image de fond du reste des éléments + avec un espace vertical, pour le positionnement du texte. + Note: c'est un attribut à deux paramètres. + + + fullhtml + boolean + Non + n/a + vous autorise à placer du code html en tant que + contenu de la popup. Le code html est attendu dans + l'attribut text. + + + frame + chaîne de caractères + Non + n/a + contrôle la popup dans un cadre différent. + Voir la documentation d'overlib pour plus de détails + sur cette fonction. + + + timeout + chaîne de caractères + Non + n/a + Appelle la fonction javascript spécifiée et prends + sa valeur de retour comme texte devant être affiché + dans la popup. + + + delay + integer + Non + n/a + la popup se comporte comme une infobulle. + Elle disparaitra au bout d'un certain délai, en + millisecondes. + + + hauto + boolean + Non + n/a + Détermine automatiquement si la popup doit être + à gauche ou à droite de la souris + + + vauto + boolean + Non + n/a + Détermine automatiquement si la popup doit être + au-dessus ou au-dessous de la souris + + + + + + popup est utilisé pour créer une fenêtre popup javascript. + + + popup {* popup_init doit être appelé en haut de votre page *} {popup_init src="/javascripts/overlib.js"} @@ -419,7 +420,7 @@ text="<UL><LI>links<LI>pages<LI>images</UL>" snapx SORTIE: (allez sur le site officiel de Smarty pour des exemples.) - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-custom-functions/language-function-textformat.xml b/docs/fr/designers/language-custom-functions/language-function-textformat.xml index 8bb35f98..12538b53 100644 --- a/docs/fr/designers/language-custom-functions/language-function-textformat.xml +++ b/docs/fr/designers/language-custom-functions/language-function-textformat.xml @@ -1,103 +1,104 @@ - - textformat - - - - - - - - - - Nom attribut - Type - Requis - Defaut - Description - - - - - style - chaîne de caractères - Non - n/a - style prédéfini - - - indent - number - Non - 0 - Taille de l'indentation pour chaque - ligne - - - indent_first - number - Non - 0 - Taille de l'indentation de la - première ligne - - - indent_char - chaîne de caractères - Non - (single space) - Le caractère (ou la chaîne) à utiliser pour - indenter - - - wrap - number - Non - 80 - A combien de caractères doit on ajuster chaque - ligne - - - wrap_char - chaîne de caractères - Non - \n - Le caractère (ou chaîne de caractères) avec lequel - terminer les lignes - - - wrap_cut - boolean - Non - false - Si true, wrap réduira les lignes au caractère exact - au lieu d'ajuster à la fin d'un mot - - - assign - chaîne de caractères - Non - n/a - Le nom de la variable PHP dans laquelle la - sortie sera assignée - - - - - - textformat est une fonction de bloc utilisée pour formater du texte. - Elle nettoie la chaîne de ses espaces et caractères spéciaux, puis - formate les paragraphes en ajustant ces derniers à une certaine limite, - puis en indentant les lignes. - - - Vous pouvez soit utiliser un style prédéfini, soit définir explicitement - chaque attribut. Actuellement, seul le style prédéfini "email" est - disponible. - - -textformat + + + textformat + + + + + + + + + + Nom attribut + Type + Requis + Defaut + Description + + + + + style + chaîne de caractères + Non + n/a + style prédéfini + + + indent + number + Non + 0 + Taille de l'indentation pour chaque + ligne + + + indent_first + number + Non + 0 + Taille de l'indentation de la + première ligne + + + indent_char + chaîne de caractères + Non + (single space) + Le caractère (ou la chaîne) à utiliser pour + indenter + + + wrap + number + Non + 80 + A combien de caractères doit on ajuster chaque + ligne + + + wrap_char + chaîne de caractères + Non + \n + Le caractère (ou chaîne de caractères) avec lequel + terminer les lignes + + + wrap_cut + boolean + Non + false + Si true, wrap réduira les lignes au caractère exact + au lieu d'ajuster à la fin d'un mot + + + assign + chaîne de caractères + Non + n/a + Le nom de la variable PHP dans laquelle la + sortie sera assignée + + + + + + textformat est une fonction de bloc utilisée pour formater du texte. + Elle nettoie la chaîne de ses espaces et caractères spéciaux, puis + formate les paragraphes en ajustant ces derniers à une certaine limite, + puis en indentant les lignes. + + + Vous pouvez soit utiliser un style prédéfini, soit définir explicitement + chaque attribut. Actuellement, seul le style prédéfini "email" est + disponible. + + + textformat {textformat wrap=40} @@ -236,7 +237,7 @@ bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers.xml b/docs/fr/designers/language-modifiers.xml index 9036c3a5..2369d214 100644 --- a/docs/fr/designers/language-modifiers.xml +++ b/docs/fr/designers/language-modifiers.xml @@ -60,7 +60,7 @@ Sujet: {$sujet|truncate:40:"..."} &designers.language-modifiers.language-modifier-truncate; &designers.language-modifiers.language-modifier-upper; &designers.language-modifiers.language-modifier-wordwrap; - + - - capitalize - - Met la première lettre de chaque mot d'une variable en majuscule. - - - capitalize - + + + capitalize + + Met la première lettre de chaque mot d'une variable en majuscule. + + + capitalize + index.php: $smarty = new Smarty; @@ -23,7 +24,7 @@ SORTIE: La police commence une campagne de sensibilisation contre la violence routière. La Police Commence Une Campagne De Sensibilisation Contre La Violence Routière. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-cat.xml b/docs/fr/designers/language-modifiers/language-modifier-cat.xml index 36e31a12..04659e44 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-cat.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-cat.xml @@ -1,39 +1,40 @@ - - cat - - - - - - - - - - Position du paramètre - Type - Requis - cat - Description - - - - - 1 - chaîne de caractères - Non - empty - Valeur à concaténer à la variable donnée. - - - - - - Cette valeur est concaténée à la variable donnée. - - -cat + + + cat + + + + + + + + + + Position du paramètre + Type + Requis + cat + Description + + + + + 1 + chaîne de caractères + Non + empty + Valeur à concaténer à la variable donnée. + + + + + + Cette valeur est concaténée à la variable donnée. + + + cat index.php: @@ -48,7 +49,7 @@ index.tpl: SORTIE: Les devins ont prévus que le monde existera toujours demain. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-count-characters.xml b/docs/fr/designers/language-modifiers/language-modifier-count-characters.xml index 98a7deee..e67529b4 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-count-characters.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-count-characters.xml @@ -1,12 +1,13 @@ - - count_characters - - Compte le nombre de caractères dans une variable. - - -count_characters + + + count_characters + + Compte le nombre de caractères dans une variable. + + + count_characters index.php: @@ -24,7 +25,7 @@ SORTIE: Vagues de froid liées à la température. 39 - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-count-paragraphs.xml b/docs/fr/designers/language-modifiers/language-modifier-count-paragraphs.xml index e86e4b59..d25739ec 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-count-paragraphs.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-count-paragraphs.xml @@ -1,12 +1,13 @@ - - count_paragraphs - - Compte le nombre de paragraphes dans une variable. - - -count_paragraphs + + + count_paragraphs + + Compte le nombre de paragraphes dans une variable. + + + count_paragraphs index.php: @@ -23,7 +24,7 @@ SORTIE: La guerre apporte la paix, au prix de la vie des innocents. 1 - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-count-sentences.xml b/docs/fr/designers/language-modifiers/language-modifier-count-sentences.xml index e9d02e69..c54861e0 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-count-sentences.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-count-sentences.xml @@ -1,12 +1,13 @@ - - count_sentences - - Compte le nombre de phrases dans une variable. - - -count_sentences + + + count_sentences + + Compte le nombre de phrases dans une variable. + + + count_sentences index.php: @@ -27,7 +28,7 @@ Deux navires rentrent en collision à coups de haches. 2 - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-count-words.xml b/docs/fr/designers/language-modifiers/language-modifier-count-words.xml index ab697450..5a3bfaed 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-count-words.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-count-words.xml @@ -1,12 +1,13 @@ - - count_words - - Compte le nombre de mots dans une variable. - - -count_words + + + count_words + + Compte le nombre de mots dans une variable. + + + count_words index.php: @@ -23,7 +24,7 @@ SORTIE: Un anneau pour les gouverner tous. 6 - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-date-format.xml b/docs/fr/designers/language-modifiers/language-modifier-date-format.xml index 9f6a7fb4..e523fe9b 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-date-format.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-date-format.xml @@ -1,52 +1,53 @@ - - date_format - - - - - - - - - - Position du paramètre - Type - Requis - Defaut - Description - - - - - 1 - chaîne de caractères - Non - %b %e, %Y - Format de sortie de la date. - - - 2 - chaîne de caractères - Non - n/a - Date par défaut si aucune n'est spécifiée en entrée. - - - - - - Formate une date / heure au format strftime donné. Les dates peuvent - être passées à smarty en tant que timestamp unix, timestamp mysql ou - comme chaîne quelconque contenant mois jour année (interprétable par - strtotime). Les concepteurs de templates peuvent utiliser date_format - pour contrôler parfaitement le format de sortie de la date. - Si la date passée à date_format est vide, et qu'un second paramètre - est donné, ce dernier sera utilisé comme étant la date à formater. - - -date_format + + + date_format + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractères + Non + %b %e, %Y + Format de sortie de la date. + + + 2 + chaîne de caractères + Non + n/a + Date par défaut si aucune n'est spécifiée en entrée. + + + + + + Formate une date / heure au format strftime donné. Les dates peuvent + être passées à smarty en tant que timestamp unix, timestamp mysql ou + comme chaîne quelconque contenant mois jour année (interprétable par + strtotime). Les concepteurs de templates peuvent utiliser date_format + pour contrôler parfaitement le format de sortie de la date. + Si la date passée à date_format est vide, et qu'un second paramètre + est donné, ce dernier sera utilisé comme étant la date à formater. + + + date_format index.php: @@ -72,9 +73,9 @@ Tuesday, February 6, 2001 Feb 5, 2001 Monday, February 5, 2001 14:33:00 - - -date_format indicateurs de convertion + + + date_format indicateurs de convertion %a - Abréviation du jour de la semaine, selon les paramètres locaux. @@ -162,8 +163,8 @@ PHP strftime(). Il est probable que vous disposiez de plus ou moins d'options disponibles selon le système sur lequel PHP a été compilé (strftime ()). Reportez vous à l'aide de votre système pour une liste complète des paramètres disponibles. - - + + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-default.xml b/docs/fr/designers/language-modifiers/language-modifier-default.xml index ce871144..26773841 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-default.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-default.xml @@ -1,42 +1,43 @@ - - default - - - - - - - - - - Position du paramètre - Type - Requis - Defaut - Description - - - - - 1 - chaîne de caractères - Non - empty - La valeur par défaut de la sortie si la variable - d'entrée est vide. - - - - - - Utilisé pour définir une valeur par défaut à une variable. - Si la variable est vide ou indéfinie, la valeur donnée est affichée - en lieu et place. Default attends un seul argument. - - -default + + + default + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractères + Non + empty + La valeur par défaut de la sortie si la variable + d'entrée est vide. + + + + + + Utilisé pour définir une valeur par défaut à une variable. + Si la variable est vide ou indéfinie, la valeur donnée est affichée + en lieu et place. Default attends un seul argument. + + + default index.php: @@ -53,7 +54,7 @@ SORTIE: Les portes de la moria restent fermées. pas de titre - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-escape.xml b/docs/fr/designers/language-modifiers/language-modifier-escape.xml index 77d1d44d..dcd9a6ce 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-escape.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-escape.xml @@ -1,46 +1,47 @@ - - escape - - - - - - - - - - - Position du paramètre - Type - Requis - Valeurs possibles - Defaut - Description - - - - - 1 - chaîne de caractère - Non - html, htmlall, url, quotes, hex, hexentity, - javascript - html - Format d'échappement à utiliser. - - - - - - "Echappe" les caractères spéciaux html, d'url, pour - les quotes d'une chaîne, les valeurs - hexadécimales, les entités hexadécimales ou javascript. - Par défaut, ce paramètre est html. - - -escape + + + escape + + + + + + + + + + + Position du paramètre + Type + Requis + Valeurs possibles + Defaut + Description + + + + + 1 + chaîne de caractère + Non + html, htmlall, url, quotes, hex, hexentity, + javascript + html + Format d'échappement à utiliser. + + + + + + "Echappe" les caractères spéciaux html, d'url, pour + les quotes d'une chaîne, les valeurs + hexadécimales, les entités hexadécimales ou javascript. + Par défaut, ce paramètre est html. + + + escape index.php: @@ -67,7 +68,7 @@ SORTIE: %27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27 \'Stiff Opposition Expected to Casketless Funeral Plan\' <a href="mailto:%62%6f%62%40%6d%65%2e%6e%65%74">&#x62;&#x6f;&#x62;&#x40;&#x6d;&#x65;&#x2e;&#x6e;&#x65;&#x74;</a> - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-indent.xml b/docs/fr/designers/language-modifiers/language-modifier-indent.xml index 894c7b95..00086618 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-indent.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-indent.xml @@ -1,50 +1,51 @@ - - indent - - - - - - - - - - Position du paramètre - Type - Requis - Defaut - Description - - - - - 1 - entier - Non - 4 - De combien de caractères l'indentation doit être effectuée. - - - 2 - chaîne de caractère - Non - (espace) - Caractère à utiliser pour l'indentation. - - - - - - Indente chacune des lignes d'une chaîne. Comme paramètre optionnel, - vous pouvez spécifier le nombre de caractères à utiliser pour l'indentation (4 par défaut). - Comme second paramètre optionnel, vous - pouvez spécifier le caractère à utiliser pour l'indentation (utilisez - "\t" pour les tabulations). - - -indent + + + indent + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + entier + Non + 4 + De combien de caractères l'indentation doit être effectuée. + + + 2 + chaîne de caractère + Non + (espace) + Caractère à utiliser pour l'indentation. + + + + + + Indente chacune des lignes d'une chaîne. Comme paramètre optionnel, + vous pouvez spécifier le nombre de caractères à utiliser pour l'indentation (4 par défaut). + Comme second paramètre optionnel, vous + pouvez spécifier le caractère à utiliser pour l'indentation (utilisez + "\t" pour les tabulations). + + + indent index.php: @@ -72,7 +73,7 @@ Il fera noir cette nuit. Il fera noir cette nuit. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-lower.xml b/docs/fr/designers/language-modifiers/language-modifier-lower.xml index 111e3509..80e1e5b3 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-lower.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-lower.xml @@ -1,12 +1,13 @@ - - lower - - Met une variable en minuscules. - - -lower + + + lower + + Met une variable en minuscules. + + + lower index.php: @@ -23,7 +24,7 @@ SORTIE: Deux Suspects Se Sont Sauvés. deux suspects se sont sauvés. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml b/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml index 2d43bfaa..2b0d8844 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml @@ -1,13 +1,14 @@ - - nl2br - - Transforme toutes les fins de lignes en balises <br />. - Equivalent à la fonction PHP nl2br(). - - -nl2br + + + nl2br + + Transforme toutes les fins de lignes en balises <br />. + Equivalent à la fonction PHP nl2br(). + + + nl2br index.php: @@ -22,7 +23,7 @@ index.tpl: SORTIE: Pluie ou soleil attendu<br />aujourd'hui, nuit noire - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-regex-replace.xml b/docs/fr/designers/language-modifiers/language-modifier-regex-replace.xml index 7ddd2fdc..ba14a1b7 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-regex-replace.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-regex-replace.xml @@ -1,47 +1,48 @@ - - regex_replace - - - - - - - - - - Position du paramètre - Type - Requis - Defaut - Description - - - - - 1 - chaîne de caractère - Oui - n/a - Expression régulière à remplacer. - - - 2 - chaîne de caractère - Oui - n/a - La chaîne de remplacement. - - - - - - Un rechercher / remplacer avec une expression régulière. Utilise la même - syntaxe que la fonction PHP preg_replace. - - -regex_replace + + + regex_replace + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractère + Oui + n/a + Expression régulière à remplacer. + + + 2 + chaîne de caractère + Oui + n/a + La chaîne de remplacement. + + + + + + Un rechercher / remplacer avec une expression régulière. Utilise la même + syntaxe que la fonction PHP preg_replace. + + + regex_replace index.php: @@ -61,7 +62,7 @@ SORTIE: L'infertilité est un maux grandissant , disent les experts. L'infertilité est un maux grandissant, disent les experts. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-replace.xml b/docs/fr/designers/language-modifiers/language-modifier-replace.xml index 930d29e4..463df800 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-replace.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-replace.xml @@ -1,46 +1,47 @@ - - replace - - - - - - - - - - Position du paramètre - Type - Requis - Defaut - Description - - - - - 1 - chaîne de caractères - Oui - n/a - chaîne à remplacer. - - - 2 - chaîne de caractères - Oui - n/a - chaîne de remplacement. - - - - - - Un simple remplacement de chaîne de caractères. - - -replace + + + replace + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractères + Oui + n/a + chaîne à remplacer. + + + 2 + chaîne de caractères + Oui + n/a + chaîne de remplacement. + + + + + + Un simple remplacement de chaîne de caractères. + + + replace index.php: @@ -59,7 +60,7 @@ SORTIE: Child's Stool Great for Use in Garden. Child's Stool Great for Use in Vineyard. Child's Stool Great for Use in Garden. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-spacify.xml b/docs/fr/designers/language-modifiers/language-modifier-spacify.xml index a269a6f4..92bfad4f 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-spacify.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-spacify.xml @@ -1,41 +1,42 @@ - - spacify - - - - - - - - - - Position du paramètre - Type - Requis - Defaut - Description - - - - - 1 - chaîne de caractère - Non - espace - Ce qui est inséré entre chaque caractère de la variable. - - - - - - spacify est un moyen pour insérer un espace entre tous les caractères - d'une variable. Optionnellement, vous pouvez lui passer un caractère - (ou une chaîne) différent de espace à insérer. - - -spacify + + + spacify + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractère + Non + espace + Ce qui est inséré entre chaque caractère de la variable. + + + + + + spacify est un moyen pour insérer un espace entre tous les caractères + d'une variable. Optionnellement, vous pouvez lui passer un caractère + (ou une chaîne) différent de espace à insérer. + + + spacify index.php: @@ -55,7 +56,7 @@ SORTIE: Quelquechose s'est mal passé et à provoqué cet accident, disent les experts. Q u e l q u e c h o s e s ' e s t m a l p a s s é e t à p r o v o q u é c e t a c c i d e n t , d i s e n t l e s e x p e r t s . Q^^u^^e^^l^^q^^u^^e^^c^^h^^o^^s^^e^^ ^^s^^'^^e^^s^^t^^ ^^m^^a^^l^^ ^^p^^a^^s^^s^^é^^ ^^e^^t^^ ^^à^^ ^^p^^r^^o^^v^^o^^q^^u^^é^^ ^^c^^e^^t^^ ^^a^^c^^c^^i^^d^^e^^n^^t^^,^^ ^^d^^i^^s^^e^^n^^t^^ ^^l^^e^^s^^ ^^e^^x^^p^^e^^r^^t^^s^^. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-string-format.xml b/docs/fr/designers/language-modifiers/language-modifier-string-format.xml index 2e090440..62259777 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-string-format.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-string-format.xml @@ -1,40 +1,41 @@ - - string_format - - - - - - - - - - Position du paramètre - Type - Requis - Defaut - Description - - - - - 1 - chaîne de caractères - Oui - n/a - Le format à utiliser (sprintf) - - - - - - Un moyen pour formater les chaînes de caractères, comme par exemple les - nombres décimaux. Utilise la syntaxe de sprintf pour formater les éléments. - - -string_format + + + string_format + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + chaîne de caractères + Oui + n/a + Le format à utiliser (sprintf) + + + + + + Un moyen pour formater les chaînes de caractères, comme par exemple les + nombres décimaux. Utilise la syntaxe de sprintf pour formater les éléments. + + + string_format index.php: @@ -53,7 +54,7 @@ SORTIE: 23.5787446 23.58 24 - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-strip-tags.xml b/docs/fr/designers/language-modifiers/language-modifier-strip-tags.xml index 68b84f0a..a3f6dccb 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-strip-tags.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-strip-tags.xml @@ -1,13 +1,14 @@ - - strip_tags - - Supprime toutes les balises, et plus généralement tout ce qui se trouve - entre < et >. - - -strip_tags + + + strip_tags + + Supprime toutes les balises, et plus généralement tout ce qui se trouve + entre < et >. + + + strip_tags index.php: @@ -27,7 +28,7 @@ Une femme aveugle obtient un nouveau <font face=\"helvetica\"> rein</font> d'un père qu'elle n'a pas vu depuis<b> des années</b>. Une femme aveugle obtient un nouveau rein d'un père qu'elle n'a pas vu depuis des années. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-strip.xml b/docs/fr/designers/language-modifiers/language-modifier-strip.xml index 5cce237e..04b48afc 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-strip.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-strip.xml @@ -1,21 +1,22 @@ - - strip - - Remplace les espaces multiples, les nouvelles lignes et les tabulations - par un espace simple, ou une chaîne donnée. - - - Note - - Si vous voulez réaliser cette action sur un bloc complet du template, - utilisez la fonction strip. - - - -strip + + + strip + + Remplace les espaces multiples, les nouvelles lignes et les tabulations + par un espace simple, ou une chaîne donnée. + + + Note + + Si vous voulez réaliser cette action sur un bloc complet du template, + utilisez la fonction strip. + + + + strip index.php: @@ -37,7 +38,7 @@ Une r Une réunion autour d'un feu de cheminée est toujours agréable. Une&nbsp;réunion&nbsp;autour&nbsp;d'un&nbsp;feu&nbsp;de&nbsp;cheminée&nbsp;est&nbsp;toujours &nbsp;agréable. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-truncate.xml b/docs/fr/designers/language-modifiers/language-modifier-truncate.xml index ae7058b3..de10d68b 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-truncate.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-truncate.xml @@ -1,63 +1,64 @@ - - truncate - - - - - - - - - - Position du paramètre - Type - Requis - Defaut - Description - - - - - 1 - entier - Non - 80 - Le nombre de caractères maximums au-delà duquel - on effectue le troncage - - - 2 - chaîne de caractère - Non - ... - Le texte à rajouter lorsque l'on effectue un - troncage. - - - 3 - booléen - Non - false - Détermine si le troncage est effectué sur - le dernier mot (false), ou au caractère exact (true). - - - - - - - Tronque une variable à une certaine longueur, par défaut 80. - Un second paramètre optionnel permet de spécifier une chaîne à afficher - à la fin de la variable une fois tronquée. Les caractères de fin sont - inclus dans la longueur de la chaîne à tronquer. Par défaut, - truncate tentera de couper la chaîne à la fin d'un mot. Si vous voulez - tronquer la chaîne au caractère exact, donnez la valeur true au - dernier paramètre optionnel. - - -truncate + + + truncate + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + entier + Non + 80 + Le nombre de caractères maximums au-delà duquel + on effectue le troncage + + + 2 + chaîne de caractère + Non + ... + Le texte à rajouter lorsque l'on effectue un + troncage. + + + 3 + booléen + Non + false + Détermine si le troncage est effectué sur + le dernier mot (false), ou au caractère exact (true). + + + + + + + Tronque une variable à une certaine longueur, par défaut 80. + Un second paramètre optionnel permet de spécifier une chaîne à afficher + à la fin de la variable une fois tronquée. Les caractères de fin sont + inclus dans la longueur de la chaîne à tronquer. Par défaut, + truncate tentera de couper la chaîne à la fin d'un mot. Si vous voulez + tronquer la chaîne au caractère exact, donnez la valeur true au + dernier paramètre optionnel. + + + truncate index.php: @@ -84,7 +85,7 @@ Deux soeurs r Deux soeurs réunies après 18 a Deux soeurs réunies après 1... - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-upper.xml b/docs/fr/designers/language-modifiers/language-modifier-upper.xml index 5b3374d2..83807f3f 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-upper.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-upper.xml @@ -1,12 +1,13 @@ - - upper - - Met une variable en majuscules. - - -upper + + + upper + + Met une variable en majuscules. + + + upper index.php: @@ -24,7 +25,7 @@ SORTIE: Si l'attaque n'est pas mise en place rapidement, cela risque de durer longtemps. SI L'ATTAQUE N'EST PAS MISE EN PLACE RAPIDEMENT, CELA RISQUE DE DURER LONGTEMPS. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-modifiers/language-modifier-wordwrap.xml b/docs/fr/designers/language-modifiers/language-modifier-wordwrap.xml index f35afd95..32289efc 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-wordwrap.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-wordwrap.xml @@ -1,59 +1,60 @@ - - wordwrap - - - - - - - - - - Position du paramètre - Type - Requis - Defaut - Description - - - - - 1 - entier - Non - 80 - La nombre de colonnes sur lequel ajuster l'affichage. - - - 2 - chaîne de caractères - Non - \n - chaîne de caractères utilisée pour l'ajustement. - - - 3 - booléen - Non - false - Détermine si l'ajustement se fait en fin de mot - (false) ou au caractère exact (true). - - - - - - Ajuste une chaîne de caractères à une taille de colonne, par défaut 80. - Un second paramètre optionnel vous permet de spécifier la chaîne à utiliser - pour l'ajustement à la nouvelle ligne (retour chariot \n par défaut). - Par défaut, wordwrap tente un ajustement à la fin d'un mot. Si vous voulez - autoriser le découpage des mots pour un ajustement au caractère près, - passez true au troisième paramètre optionnel. - - -wordwrap + + + wordwrap + + + + + + + + + + Position du paramètre + Type + Requis + Defaut + Description + + + + + 1 + entier + Non + 80 + La nombre de colonnes sur lequel ajuster l'affichage. + + + 2 + chaîne de caractères + Non + \n + chaîne de caractères utilisée pour l'ajustement. + + + 3 + booléen + Non + false + Détermine si l'ajustement se fait en fin de mot + (false) ou au caractère exact (true). + + + + + + Ajuste une chaîne de caractères à une taille de colonne, par défaut 80. + Un second paramètre optionnel vous permet de spécifier la chaîne à utiliser + pour l'ajustement à la nouvelle ligne (retour chariot \n par défaut). + Par défaut, wordwrap tente un ajustement à la fin d'un mot. Si vous voulez + autoriser le découpage des mots pour un ajustement au caractère près, + passez true au troisième paramètre optionnel. + + + wordwrap index.php: @@ -98,7 +99,7 @@ Une femme aveugle obtient un n ouveau rein d'un père qu'elle n'a pas vu depuis des années. - + \ No newline at end of file +--> diff --git a/docs/fr/designers/language-variables.xml b/docs/fr/designers/language-variables.xml index 862501ad..d987deeb 100644 --- a/docs/fr/designers/language-variables.xml +++ b/docs/fr/designers/language-variables.xml @@ -23,7 +23,7 @@ ]]> - + &designers.language-variables.language-assigned-variables; &designers.language-variables.language-config-variables; &designers.language-variables.language-variables-smarty; diff --git a/docs/fr/designers/language-variables/language-assigned-variables.xml b/docs/fr/designers/language-variables/language-assigned-variables.xml index 509955fd..5bbabba7 100644 --- a/docs/fr/designers/language-variables/language-assigned-variables.xml +++ b/docs/fr/designers/language-variables/language-assigned-variables.xml @@ -1,45 +1,48 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + Variables assignées depuis PHP - Pour utiliser une variables assignées depuis PHP, il - faut la préfixer par le symbole dollar $. + Pour utiliser une variables assignées depuis PHP, il + faut la préfixer par le symbole dollar $. Les variables asignées depuis un template grâce à la fonction - assign sont - manipulées de la même façon. - - - Variables assignées - + assign sont + manipulées de la même façon. + + + Variables assignées + La dernière connexion remonte au {$dateConnexionPrecedente}. ]]> - - - Cela va afficher: - - + + + Cela va afficher: + + La dernière connexion remonte au 11 janvier 2001. ]]> - - - - - Tableaux associatifs - - Vous pouvez également utiliser des variables sous forme de tableaux - associatifs assignées depuis PHP en en spécifiant la clef, - après le symbole '.' (point). - - - Accéder aux variables de tableaux associatifs - + + + + + Tableaux associatifs + + Vous pouvez également utiliser des variables sous forme de tableaux + associatifs assignées depuis PHP en en spécifiant la clef, + après le symbole '.' (point). + + + Accéder aux variables de tableaux associatifs + assign('Contacts', $smarty->display('index.tpl'); ?> ]]> - - - où index.tpl est : - - + + + où index.tpl est : + + {$Contacts.email}
@@ -64,30 +67,30 @@ $smarty->display('index.tpl'); {$Contacts.phone.home}
{$Contacts.phone.cell}
]]> - - - Cela va afficher : - - + + + Cela va afficher : + + zaphod@slartibartfast.com
555-444-3333
555-111-1234
]]> - - - - - - Tableaux indexés - - Vous pouvez utiliser des tableaux indexés de la même façon - que vous le faites en PHP. - - - Accès aux tableaux grâce à l'index - + + + + + + Tableaux indexés + + Vous pouvez utiliser des tableaux indexés de la même façon + que vous le faites en PHP. + + + Accès aux tableaux grâce à l'index + index.php: $smarty = new Smarty; @@ -112,16 +115,16 @@ SORTIE: zaphod@slartibartfast.com<br> 555-444-3333<br> 555-111-1234<br> - - - - Objets - - Les attributs des objets assignés depuis PHP peuvent être utilisées en - en spécifiant le nom après le symbole '->'. - - -accéder aux attributs des objets + + + + Objets + + Les attributs des objets assignés depuis PHP peuvent être utilisées en + en spécifiant le nom après le symbole '->'. + + + accéder aux attributs des objets nom: {$person->name}<br> email: {$person->email}<br> @@ -130,26 +133,26 @@ SORTIE: nom: Zaphod Beeblebrox<br> email: zaphod@slartibartfast.com<br> - - - - + + + + diff --git a/docs/fr/designers/language-variables/language-config-variables.xml b/docs/fr/designers/language-variables/language-config-variables.xml index 677c860a..f9aa01ee 100644 --- a/docs/fr/designers/language-variables/language-config-variables.xml +++ b/docs/fr/designers/language-variables/language-config-variables.xml @@ -1,16 +1,17 @@ - - Variables chargées depuis des fichiers de configuration - - Les variables récupérées depuis un fichier de configuration sont utilisées - entourées du symbole dièse (#), ou via la variable spéciale smarty - $smarty.config. - - - -variables de fichiers de configuration + + + Variables chargées depuis des fichiers de configuration + + Les variables récupérées depuis un fichier de configuration sont utilisées + entourées du symbole dièse (#), ou via la variable spéciale smarty + $smarty.config. + + + + variables de fichiers de configuration foo.conf: @@ -67,30 +68,30 @@ SORTIE: (same for both examples) </table> </body> </html> - - - Les variables de fichier de configuration ne peuvent être utilisés tant - qu'elles n'ont pas été chargées. Cette procédure est expliquée - plus loin dans le document, voir config_load. - - - \ No newline at end of file + + + Les variables de fichier de configuration ne peuvent être utilisés tant + qu'elles n'ont pas été chargées. Cette procédure est expliquée + plus loin dans le document, voir config_load. + + + diff --git a/docs/fr/designers/language-variables/language-variables-smarty.xml b/docs/fr/designers/language-variables/language-variables-smarty.xml index 51cd6156..078abe31 100644 --- a/docs/fr/designers/language-variables/language-variables-smarty.xml +++ b/docs/fr/designers/language-variables/language-variables-smarty.xml @@ -1,22 +1,25 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - Variable réservée {$smarty} - - La variable réservée {$smarty} peut être utilisée pour accéder à plusieurs - variables spéciales du template. En voici la liste complète. - - - - Variables de requête - - Les variables de requête comme GET, POST, COOKIES, SERVER, ENVIRONNEMENT - et SESSION peuvent être utilisées comme dans l'exemple suivant: - - - - Afficher des variables de requête - + + + Variable réservée {$smarty} + + La variable réservée {$smarty} peut être utilisée pour accéder à plusieurs + variables spéciales du template. En voici la liste complète. + + + + Variables de requête + + Les variables de requête comme GET, POST, COOKIES, SERVER, ENVIRONNEMENT + et SESSION peuvent être utilisées comme dans l'exemple suivant: + + + + Afficher des variables de requête + {* Affiche la valeur de page dans l'url (GET) http://www.domain.com/index.php?page=foo *} {$smarty.get.page} @@ -37,94 +40,94 @@ {* affiche la variable "utilisateur" du regroupement de get/post/cookies/server/env *} {$smarty.request.utilisateur} - - - - - {$smarty.now} - - Le timestamp courant peut être récupéré grâce à {$smarty.now}. - Le nombre obtenu correspond au nombre de secondes écoulées depuis - Epoch (1 Janvier 1970) et peut être passé directement au modificateur - de variable date à des fins d'affichage. - - - -utilisation de {$smarty.now} + + + + + {$smarty.now} + + Le timestamp courant peut être récupéré grâce à {$smarty.now}. + Le nombre obtenu correspond au nombre de secondes écoulées depuis + Epoch (1 Janvier 1970) et peut être passé directement au modificateur + de variable date à des fins d'affichage. + + + + utilisation de {$smarty.now} {* utilise le modificateur de variable date_format pour afficher la date et heure *} {$smarty.now|date_format:"%d-%m-%Y %H:%M:%S"} - - - - {$smarty.const} - - Vous pouvez directement accéder aux constantes PHP. - - - -Utiliser {$smarty.const} + + + + {$smarty.const} + + Vous pouvez directement accéder aux constantes PHP. + + + + Utiliser {$smarty.const} {$smarty.const._MA_CONSTANTE_} - - - - - {$smarty.capture} - - La capture réalisée via {capture}..{/capture} peut être récupérée - par l'intermédiaire de la variable {$smarty}. Voir la section - sur capture pour un - exemple à ce sujet. - - - - - {$smarty.config} - - La variable {$smarty} peut être utilisée pour désigner une variable - d'un fichier de configuration. {$smarty.config.foo} est un synonyme de - {#foo#}. Voir la section config_load - pour un exemple à ce sujet. - - - - - {$smarty.section}, {$smarty.foreach} - - La variable {$smarty} peut être utilisée pour accéder aux propriétés - des boucles 'section' et 'foreach'. Voir la documentation de - section et - foreach. - - - - - {$smarty.template} - - Cette variable contient le nom du template en cours de traitement. - - - - - \ No newline at end of file + + + + + {$smarty.capture} + + La capture réalisée via {capture}..{/capture} peut être récupérée + par l'intermédiaire de la variable {$smarty}. Voir la section + sur capture pour un + exemple à ce sujet. + + + + + {$smarty.config} + + La variable {$smarty} peut être utilisée pour désigner une variable + d'un fichier de configuration. {$smarty.config.foo} est un synonyme de + {#foo#}. Voir la section config_load + pour un exemple à ce sujet. + + + + + {$smarty.section}, {$smarty.foreach} + + La variable {$smarty} peut être utilisée pour accéder aux propriétés + des boucles 'section' et 'foreach'. Voir la documentation de + section et + foreach. + + + + + {$smarty.template} + + Cette variable contient le nom du template en cours de traitement. + + + + + diff --git a/docs/fr/getting-started.xml b/docs/fr/getting-started.xml index c7ef642a..704d0c09 100644 --- a/docs/fr/getting-started.xml +++ b/docs/fr/getting-started.xml @@ -1,11 +1,12 @@ + Pour commencer - + - Qu'est-ce que Smarty ? - + Qu'est-ce que Smarty ? + Smarty est un moteur de template pour PHP. Plus précisément, il facilite la séparation entre la logique applicative et la présentation. Cela s'explique plus facilement dans une situation où le @@ -29,8 +30,8 @@ de l'application sans restructurer les templates, et le designer de templates peut changer les templates sans briser la logique applicative. - - + + Et maintenant un mot rapide sur ce que Smarty NE fait PAS. Smarty n'a pas pour prétention de supprimer complétement les traitements au sein des templates. @@ -39,393 +40,393 @@ Un conseil : laissez la logique applicative en dehors des templates et la logique de présentation en dehors de l'application. A l'avenir, cela permet une meilleure gestion des évènements. - - + + L'un des aspects unique de Smarty est la compilation des templates. Cela signifie que Smarty lit les templates et crée des scripts PHP à partir de ces derniers. Une fois créés, ils sont exécutés. Il n'y a donc pas d'analyse coûteuse de template à chaque requête, et les templates peuvent bénéficier des solutions de cache PHP - comme Zend Accelerator (&url.zend;) ou - PHP Accelerator + comme Zend Accelerator (&url.zend;) ou + PHP Accelerator (&url.php-accelerator;). - - - Quelques caractéristiques de Smarty : - - - Il est très rapide. - Il est efficace, le parser PHP s'occupe - du sale travail. - Pas d'analyse de template coûteuse, une seule compilation. - - Il sait ne recompiler que les fichiers de templates - qui ont été modifiés. - Vous pouvez créer des + + + Quelques caractéristiques de Smarty : + + + Il est très rapide. + Il est efficace, le parser PHP s'occupe + du sale travail. + Pas d'analyse de template coûteuse, une seule compilation. + + Il sait ne recompiler que les fichiers de templates + qui ont été modifiés. + Vous pouvez créer des fonctions utilisateurs et des modificateurs de variables personnalisés, le langage de - template est donc extrémement extensible. - Syntaxe des templates configurable, vous + template est donc extrémement extensible. + Syntaxe des templates configurable, vous pouvez utiliser {}, {{}}, <!--{}-->, etc comme délimiteurs. - - Les instructions if/elseif/else/endif + + Les instructions if/elseif/else/endif sont passées au parser PHP, la syntaxe de l'expression {if...} peut être aussi simple ou aussi complexe que vous - le désirez. - Imbrication illimitée de sections, - de 'if', etc. autorisée. - Il est possible d'inclure du code PHP + le désirez. + Imbrication illimitée de sections, + de 'if', etc. autorisée. + Il est possible d'inclure du code PHP directement dans vos templates, bien que cela ne soit pas obligatoire - (ni conseillé), vu que le moteur est extensible. - Support de cache intégré. - Sources de templates arbitraires. - Fonctions de gestion de cache personnalisables. - Architecture de plugins - + (ni conseillé), vu que le moteur est extensible. + Support de cache intégré. + Sources de templates arbitraires. + Fonctions de gestion de cache personnalisables. + Architecture de plugins + Installation - + Ce dont vous avez besoin - Smarty nécessite un serveur Web utilisant PHP 4.0.6 ou supérieur. + Smarty nécessite un serveur Web utilisant PHP 4.0.6 ou supérieur. - + - Installation de base - + Installation de base + Copiez les fichiers bibliothèques de Smarty du répertoire /libs/ de la distribution à un emplacement accessible à PHP. Ce sont des fichiers PHP que vous NE DEVEZ PAS modifier. Ils sont partagés par toutes les applications et ne seront mis à jour que lorsque vous installerez une nouvelle version de Smarty. + + + fichiers de la bibliothèque SMARTY + + Smarty.class.php + Smarty_Compiler.class.php + Config_File.class.php + debug.tpl + /plugins/*.php (tous !) + + + + Smarty utilise une constante PHP appelée SMARTY_DIR qui + représente le chemin complet de la bibliothèque Smarty. En fait, + si votre application trouve le fichier + Smarty.class.php, vous n'aurez pas + besoin de définir la variable SMARTY_DIR, Smarty s'en chargera pour vous. + En revanche, si Smarty.class.php + n'est pas dans votre répertoire d'inclusion ou que vous ne + donnez pas un chemin absolu à votre application, vous + devez définir SMARTY_DIR explicitement. SMARTY_DIR + doit avoir être terminé par un slash. + + + + Voici comment créer une instance de Smarty dans vos scripts PHP : + + + + créer une instance de Smarty + + require('Smarty.class.php'); + $smarty = new Smarty; + + + + Essayez de lancer le script ci-dessus. Si vous obtenez une erreur indiquant + que le fichier Smarty.class.php n'est pas trouvé, + tentez l'une des choses suivantes : + + + + fournir un chemin absolu vers la bibliothèque Smarty + + require('/usr/local/lib/php/Smarty/Smarty.class.php'); + $smarty = new Smarty; + + + + Ajouter le répertoire de la bibliothèque au chemin de php_include + + // Editez le fichier php.ini, ajoutez le répertoire de la + // bibliothèque Smarty au include_path et redémarrez le serveur Web. + // Cela devrait ensuite fonctionner : + require('Smarty.class.php'); + $smarty = new Smarty; + + + + Définir explicitement la constante SMARTY_DIR + + define('SMARTY_DIR','/usr/local/lib/php/Smarty/'); + require(SMARTY_DIR.'Smarty.class.php'); + $smarty = new Smarty; + + + + Maintenant que les fichiers de la librairie sont en place, + il est temps de définir les répertoires de Smarty, pour votre application. + Smarty a besoin de quatre répertoires qui sont (par défaut) + templates, + templates_c, configs et + cache. Chacun d'entre eux peut être défini + via les attributs $template_dir, + $compile_dir, $config_dir et + $cache_dir respectivement. Il est vivement + conseillé que vous régliez ces répertoires séparément pour chaque + application qui utilise Smarty. + + + Assurez-vous de bien connaître chemin de la racine + de votre arborescence Web. Dans notre exemple, la racine + est "/web/www.mydomain.com/docs". Seul Smarty + accède aux répertoires en question, et jamais le serveur Web. + Pour des raisons de sécurité, il est donc conseillé de + sortir ces répertoires dans un répertoire + en dehors de l'arborescence + Web. + + + Dans notre exemple d'installation, nous allons régler l'environnement + de Smarty pour une application de livre d'or. Nous avons ici choisi + une application principalement pour mettre en évidence une + convention de nommage des répertoires. Vous pouvez utiliser le même + environnement pour n'importe quelle autre application, il suffit de + remplacer "livredor" avec le nom de votre application. Nous allons + mettre nos répertoires Smarty dans + "/web/www.mydomain.com/smarty/livredor/". + + + Vous allez avoir besoin d'au moins un fichier à la racine de + l'arborescence Web, + il s'agit du script auquel l'internaute a accès. Nous allons l'appeler + "index.php" et le placer dans un sous-répertoire + appelé "/livredor/". Il est pratique de configurer le serveur Web de + sorte que "index.php" soit identifié comme fichier + par défaut de ce répertoire. Aicnsi, si l'on tape + "http://www.mydomain.com/livredor/", le script index.php soit + exécuté sans que "index.php" ne soit spécifié dans l'URL. Avec Apache + vous pouvez régler cela en ajoutant "index.php" à la ligne où se + trouve DirectoryIndex (séparez chaque entrée par un espace). + + + Jetons un coup d'oeil à la structure de fichier obtenue : + + + + exemple de structure de fichiers + + /usr/local/lib/php/Smarty/Smarty.class.php + /usr/local/lib/php/Smarty/Smarty_Compiler.class.php + /usr/local/lib/php/Smarty/Config_File.class.php + /usr/local/lib/php/Smarty/debug.tpl + /usr/local/lib/php/Smarty/plugins/*.php + + /web/www.mydomain.com/smarty/livredor/templates/ + /web/www.mydomain.com/smarty/livredor/templates_c/ + /web/www.mydomain.com/smarty/livredor/configs/ + /web/www.mydomain.com/smarty/livredor/cache/ + + /web/www.mydomain.com/docs/livredor/index.php + + + + Smarty a besoin d'accéder en écriture aux répertoires + $compile_dir et $cache_dir, + assurez-vous donc que le serveur Web dispose de ces droits d'accès. + Il s'agit généralement de l'utilisateur "nobody" et du group + "nobody". Pour les utilisateurs de OS X, l'utilisateur par défaut + est "web" et le group "web". Si vous utilisez Apache, vous pouvez + parcourir le fichier httpd.conf (en général dans + "/usr/local/apache/conf/") pour déterminer quel est l'utilisateur + et le groupe auquel il appartient. + + + + + régler les permissions d'accès + + + chown nobody:nobody /web/www.mydomain.com/smarty/templates_c/ + chmod 770 /web/www.mydomain.com/smarty/templates_c/ + + chown nobody:nobody /web/www.mydomain.com/smarty/cache/ + chmod 770 /web/www.mydomain.com/smarty/cache/ + + + + Note technique + + La commande chmod 770 est relativement bien sécurisée, elle donne + à l'utilisateur "nobody" et au groupe "nobody" les accès en + lecture/écriture aux répertoires. Si vous voulez donner le droit d'accès + en lecture à tout le monde (principalement pour pouvoir accéder + vous-même à ces fichiers), vous pouvez lui préférer chmod 775. - - fichiers de la bibliothèque SMARTY - -Smarty.class.php -Smarty_Compiler.class.php -Config_File.class.php -debug.tpl -/plugins/*.php (tous !) - - - - Smarty utilise une constante PHP appelée SMARTY_DIR qui - représente le chemin complet de la bibliothèque Smarty. En fait, - si votre application trouve le fichier - Smarty.class.php, vous n'aurez pas - besoin de définir la variable SMARTY_DIR, Smarty s'en chargera pour vous. - En revanche, si Smarty.class.php - n'est pas dans votre répertoire d'inclusion ou que vous ne - donnez pas un chemin absolu à votre application, vous - devez définir SMARTY_DIR explicitement. SMARTY_DIR - doit avoir être terminé par un slash. - + - Voici comment créer une instance de Smarty dans vos scripts PHP : + Nous devons créer le fichier index.tpl que Smarty va charger. + Il va se trouver dans $template_dir. - - - créer une instance de Smarty - -require('Smarty.class.php'); -$smarty = new Smarty; - - + + + Edition de /web/www.mydomain.com/smarty/templates/index.tpl + + + {* Smarty *} + + Hello, {$name}! + + + + + Note technique + + {* Smarty *} est un commentaire de template. Il n'est pas + obligatoire mais il est bon de commencer tous vos templates + avec ce commentaire. Cela rend le fichier facilement + reconnaissable en plus de son extension. Les éditeurs + de texte peuvent par exemple reconnaître le fichier et + adapter la coloration syntaxique. + + + - Essayez de lancer le script ci-dessus. Si vous obtenez une erreur indiquant - que le fichier Smarty.class.php n'est pas trouvé, - tentez l'une des choses suivantes : + Maintenant passons à l'édition du fichier index.php. Nous allons + créer une instance de Smarty, assigner une valeur à une variable + de template et afficher le résultat avec index.tpl. Dans notre + exemple d'environnement, "/usr/local/lib/php/Smarty" est dans notre + include_path. Assurez-vous de faire la même chose ou d'utiliser + des chemins absolus. - - - fournir un chemin absolu vers la bibliothèque Smarty - -require('/usr/local/lib/php/Smarty/Smarty.class.php'); -$smarty = new Smarty; - - - - Ajouter le répertoire de la bibliothèque au chemin de php_include - -// Editez le fichier php.ini, ajoutez le répertoire de la -// bibliothèque Smarty au include_path et redémarrez le serveur Web. -// Cela devrait ensuite fonctionner : -require('Smarty.class.php'); -$smarty = new Smarty; - - - - Définir explicitement la constante SMARTY_DIR - -define('SMARTY_DIR','/usr/local/lib/php/Smarty/'); -require(SMARTY_DIR.'Smarty.class.php'); -$smarty = new Smarty; - - + + + édition de /web/www.mydomain.com/docs/livredor/index.php + + // charge la bibliothèque Smarty + require('Smarty.class.php'); + + $smarty = new Smarty; + + $smarty->template_dir = '/web/www.mydomain.com/smarty/livredor/templates/'; + $smarty->compile_dir = '/web/www.mydomain.com/smarty/livredor/templates_c/'; + $smarty->config_dir = '/web/www.mydomain.com/smarty/livredor/configs/'; + $smarty->cache_dir = '/web/www.mydomain.com/smarty/livredor/cache/'; + + $smarty->assign('name','Ned'); + + $smarty->display('index.tpl'); + + + + Note techique + + Dans notre exemple, nous avons configuré les chemins absolus + pour chacun des répertoires Smarty. Si + '/web/www.mydomain.com/smarty/livredor/' est dans votre + include_path PHP alors ces réglages ne sont pas nécessaires. + Quoi qu'il en soit il est plus efficace et (par expérience) + moins générateur d'erreurs de les définir avec des chemins + absolus. Cela nous garantit que Smarty récupèrera les bons fichiers. + + + - Maintenant que les fichiers de la librairie sont en place, - il est temps de définir les répertoires de Smarty, pour votre application. - Smarty a besoin de quatre répertoires qui sont (par défaut) - templates, - templates_c, configs et - cache. Chacun d'entre eux peut être défini - via les attributs $template_dir, - $compile_dir, $config_dir et - $cache_dir respectivement. Il est vivement - conseillé que vous régliez ces répertoires séparément pour chaque - application qui utilise Smarty. + Et maintenant appelez le fichier index.php avec navigateur + Web. Vous devriez voir "Hello, Ned!". - Assurez-vous de bien connaître chemin de la racine - de votre arborescence Web. Dans notre exemple, la racine - est "/web/www.mydomain.com/docs". Seul Smarty - accède aux répertoires en question, et jamais le serveur Web. - Pour des raisons de sécurité, il est donc conseillé de - sortir ces répertoires dans un répertoire - en dehors de l'arborescence - Web. + Vous venez de terminer l'installation de base de Smarty ! - - Dans notre exemple d'installation, nous allons régler l'environnement - de Smarty pour une application de livre d'or. Nous avons ici choisi - une application principalement pour mettre en évidence une - convention de nommage des répertoires. Vous pouvez utiliser le même - environnement pour n'importe quelle autre application, il suffit de - remplacer "livredor" avec le nom de votre application. Nous allons - mettre nos répertoires Smarty dans - "/web/www.mydomain.com/smarty/livredor/". - - - Vous allez avoir besoin d'au moins un fichier à la racine de - l'arborescence Web, - il s'agit du script auquel l'internaute a accès. Nous allons l'appeler - "index.php" et le placer dans un sous-répertoire - appelé "/livredor/". Il est pratique de configurer le serveur Web de - sorte que "index.php" soit identifié comme fichier - par défaut de ce répertoire. Aicnsi, si l'on tape - "http://www.mydomain.com/livredor/", le script index.php soit - exécuté sans que "index.php" ne soit spécifié dans l'URL. Avec Apache - vous pouvez régler cela en ajoutant "index.php" à la ligne où se - trouve DirectoryIndex (séparez chaque entrée par un espace). - - - Jetons un coup d'oeil à la structure de fichier obtenue : - - - - exemple de structure de fichiers - -/usr/local/lib/php/Smarty/Smarty.class.php -/usr/local/lib/php/Smarty/Smarty_Compiler.class.php -/usr/local/lib/php/Smarty/Config_File.class.php -/usr/local/lib/php/Smarty/debug.tpl -/usr/local/lib/php/Smarty/plugins/*.php - -/web/www.mydomain.com/smarty/livredor/templates/ -/web/www.mydomain.com/smarty/livredor/templates_c/ -/web/www.mydomain.com/smarty/livredor/configs/ -/web/www.mydomain.com/smarty/livredor/cache/ - -/web/www.mydomain.com/docs/livredor/index.php - - - - Smarty a besoin d'accéder en écriture aux répertoires - $compile_dir et $cache_dir, - assurez-vous donc que le serveur Web dispose de ces droits d'accès. - Il s'agit généralement de l'utilisateur "nobody" et du group - "nobody". Pour les utilisateurs de OS X, l'utilisateur par défaut - est "web" et le group "web". Si vous utilisez Apache, vous pouvez - parcourir le fichier httpd.conf (en général dans - "/usr/local/apache/conf/") pour déterminer quel est l'utilisateur - et le groupe auquel il appartient. - - - - - régler les permissions d'accès - - -chown nobody:nobody /web/www.mydomain.com/smarty/templates_c/ -chmod 770 /web/www.mydomain.com/smarty/templates_c/ - -chown nobody:nobody /web/www.mydomain.com/smarty/cache/ -chmod 770 /web/www.mydomain.com/smarty/cache/ - - - - Note technique - - La commande chmod 770 est relativement bien sécurisée, elle donne - à l'utilisateur "nobody" et au groupe "nobody" les accès en - lecture/écriture aux répertoires. Si vous voulez donner le droit d'accès - en lecture à tout le monde (principalement pour pouvoir accéder - vous-même à ces fichiers), vous pouvez lui préférer chmod 775. - - - - - Nous devons créer le fichier index.tpl que Smarty va charger. - Il va se trouver dans $template_dir. - - - - Edition de /web/www.mydomain.com/smarty/templates/index.tpl - - -{* Smarty *} - -Hello, {$name}! - - - - - Note technique - - {* Smarty *} est un commentaire de template. Il n'est pas - obligatoire mais il est bon de commencer tous vos templates - avec ce commentaire. Cela rend le fichier facilement - reconnaissable en plus de son extension. Les éditeurs - de texte peuvent par exemple reconnaître le fichier et - adapter la coloration syntaxique. - - - - - Maintenant passons à l'édition du fichier index.php. Nous allons - créer une instance de Smarty, assigner une valeur à une variable - de template et afficher le résultat avec index.tpl. Dans notre - exemple d'environnement, "/usr/local/lib/php/Smarty" est dans notre - include_path. Assurez-vous de faire la même chose ou d'utiliser - des chemins absolus. - - - - édition de /web/www.mydomain.com/docs/livredor/index.php - -// charge la bibliothèque Smarty -require('Smarty.class.php'); - -$smarty = new Smarty; - -$smarty->template_dir = '/web/www.mydomain.com/smarty/livredor/templates/'; -$smarty->compile_dir = '/web/www.mydomain.com/smarty/livredor/templates_c/'; -$smarty->config_dir = '/web/www.mydomain.com/smarty/livredor/configs/'; -$smarty->cache_dir = '/web/www.mydomain.com/smarty/livredor/cache/'; - -$smarty->assign('name','Ned'); - -$smarty->display('index.tpl'); - - - - Note techique - - Dans notre exemple, nous avons configuré les chemins absolus - pour chacun des répertoires Smarty. Si - '/web/www.mydomain.com/smarty/livredor/' est dans votre - include_path PHP alors ces réglages ne sont pas nécessaires. - Quoi qu'il en soit il est plus efficace et (par expérience) - moins générateur d'erreurs de les définir avec des chemins - absolus. Cela nous garantit que Smarty récupèrera les bons fichiers. - - - - - Et maintenant appelez le fichier index.php avec navigateur - Web. Vous devriez voir "Hello, Ned!". - - - Vous venez de terminer l'installation de base de Smarty ! - - - + + Configuration avancée - + - Ceci est la suite de l'installation de base, veuillez - lire cette dernière avant de poursuivre. + Ceci est la suite de l'installation de base, veuillez + lire cette dernière avant de poursuivre. - Une manière un peu plus commode de configurer Smarty est de faire votre - propre classe fille et de l'initialiser selon votre environnement. - De la sorte, nous n'aurons plus besoin de configurer à chaques fois les - chemins de notre environnement. Créons un nouveau répertoire - "/php/includes/livredor/" et un nouveau fichier appelé "setup.php". - Dans notre exemple d'environnement, "/php/includes" est notre - include_path PHP. Assurez-vous de faire la même chose ou alors d'utiliser - des chemins absolus. + Une manière un peu plus commode de configurer Smarty est de faire votre + propre classe fille et de l'initialiser selon votre environnement. + De la sorte, nous n'aurons plus besoin de configurer à chaques fois les + chemins de notre environnement. Créons un nouveau répertoire + "/php/includes/livredor/" et un nouveau fichier appelé "setup.php". + Dans notre exemple d'environnement, "/php/includes" est notre + include_path PHP. Assurez-vous de faire la même chose ou alors d'utiliser + des chemins absolus. - + édition de /php/includes/livredor/setup.php - -// charge la librairie Smarty -require('Smarty.class.php'); - -// le fichier setup.php est un bon -// endroit pour charger les fichiers -// de librairies de l'application et vous pouvez -// faire cela juste ici. Par exemple : -// require('livredor/livredor.lib.php'); - -class Smarty_livredor extends Smarty { - - function Smarty_livredor() { - - // Constructeur de la classe. Appelé automatiquement - // à l'instanciation de la classe. - - $this->Smarty(); - - $this->template_dir = '/web/www.mydomain.com/smarty/livredor/templates/'; - $this->compile_dir = '/web/www.mydomain.com/smarty/livredor/templates_c/'; - $this->config_dir = '/web/www.mydomain.com/smarty/livredor/configs/'; - $this->cache_dir = '/web/www.mydomain.com/smarty/livredor/cache/'; - - $this->caching = true; - $this->assign('app_name','Guest Book'); - } - -} + + // charge la librairie Smarty + require('Smarty.class.php'); + + // le fichier setup.php est un bon + // endroit pour charger les fichiers + // de librairies de l'application et vous pouvez + // faire cela juste ici. Par exemple : + // require('livredor/livredor.lib.php'); + + class Smarty_livredor extends Smarty { + + function Smarty_livredor() { + + // Constructeur de la classe. Appelé automatiquement + // à l'instanciation de la classe. + + $this->Smarty(); + + $this->template_dir = '/web/www.mydomain.com/smarty/livredor/templates/'; + $this->compile_dir = '/web/www.mydomain.com/smarty/livredor/templates_c/'; + $this->config_dir = '/web/www.mydomain.com/smarty/livredor/configs/'; + $this->cache_dir = '/web/www.mydomain.com/smarty/livredor/cache/'; + + $this->caching = true; + $this->assign('app_name','Guest Book'); + } + + } - - - Modifions maintenant le fichier index.php pour qu'il utilise "setup.php" - - + + + Modifions maintenant le fichier index.php pour qu'il utilise "setup.php" + + édition de /web/www.mydomain.com/docs/livredor/index.php - -require('livredor/setup.php'); - -$smarty = new Smarty_livredor; - -$smarty->assign('name','Ned'); - -$smarty->display('index.tpl'); + + require('livredor/setup.php'); + + $smarty = new Smarty_livredor; + + $smarty->assign('name','Ned'); + + $smarty->display('index.tpl'); - - - Vous savez maintenant qu'il est facile de créer une instance de Smarty, - correctement configurée, en utilisant Smarty_livredor qui initialise - automatiquement tout ce qu'il faut pour votre application. - - + + + Vous savez maintenant qu'il est facile de créer une instance de Smarty, + correctement configurée, en utilisant Smarty_livredor qui initialise + automatiquement tout ce qu'il faut pour votre application. + + - + diff --git a/docs/fr/preface.xml b/docs/fr/preface.xml index 9921032f..7f5f901b 100644 --- a/docs/fr/preface.xml +++ b/docs/fr/preface.xml @@ -1,8 +1,9 @@ + - Préface - + Préface + "Comment rendre mes scripts PHP indépendants de la présentation ?". Voici sans doute la question la plus posée sur la mailing list PHP. Alors que PHP est étiqueté "langage de script @@ -11,8 +12,8 @@ le contenu est important. De plus, dans de nombreuses entreprises les rôles du designer et du programmeur sont distincts. La solution template coule donc de source. - - + + Dans notre entreprise par exemple, le développement d'une application se fait de la manière suivante : une fois le cahier des charges écrit, le designer réalise une maquette, et donne ses interfaces @@ -27,8 +28,8 @@ comme des fichiers de configuration, des blocs dynamiques et d'autres solutions pour répondre à des problématiques d'interface, mais ne veulent pas nécessairement avoir à faire à toutes les subtilités de la programmation PHP. - - + + Un rapide tour d'horizon des solutions type template aujourd'hui et l'on s'aperçoit que la plupart d'entre elles n'offrent que des moyens rudimentaires pour substituer des variables dans des templates, ainsi que des @@ -41,8 +42,8 @@ designers soient capables de travailler avec leurs propres fichiers de configuration pour y récupérer des variables, exploitables dans leurs templates. Et la liste est longue. - - + + Fin 1999, nous avons commencé à écrire une spécification pour un moteur de template. Une fois la spécification terminée, nous avons commencé à travailler sur un moteur de template écrit @@ -66,8 +67,8 @@ tout le travail nécessaire en amont, dans le script PHP, pour configurer et exécuter les templates, et les blocs dynamiques. Comment rendre tout ceci plus simple ? - - + + Puis vint la vision de ce que devait devenir Smarty. Nous savons combien le code PHP peut être rapide sans le coût d'analyse des templates. Nous savons aussi combien fastidieux @@ -75,8 +76,8 @@ cela peut être remplacé par une syntaxe spécifique, beaucoup plus simple. Et si nous combinions les deux forces ? Ainsi, Smarty était né... - - + + - - Fonctionnalités avancées -&programmers.advanced-features.advanced-features-objects; -&programmers.advanced-features.advanced-features-prefilters; - -&programmers.advanced-features.advanced-features-postfilters; - -&programmers.advanced-features.advanced-features-outputfilters; - -&programmers.advanced-features.section-template-cache-handler-func; - -&programmers.advanced-features.template-resources; + + + Fonctionnalités avancées + &programmers.advanced-features.advanced-features-objects; + &programmers.advanced-features.advanced-features-prefilters; + + &programmers.advanced-features.advanced-features-postfilters; + + &programmers.advanced-features.advanced-features-outputfilters; + + &programmers.advanced-features.section-template-cache-handler-func; + + &programmers.advanced-features.template-resources; - - Objets - - Smarty donne l'accès aux objets PHP a travers les templates. Il y - a 2 moyens d'y avoir accès. Le premier consiste a allouer les objets - au template puis de les utiliser avec une syntaxe similaire a celles - des fonctions personnalisées. Le deuxième moyen consiste a allouer - des objets aux templates et de les utiliser comme n'importe quelle - variable. La première méthode a une syntaxe beaucoup plus sympathique. - Elle est aussi plus sécurisée, puisqu'un objet alloué ne peut avoir accès - qu'a certaines méthodes et propriétés. Néanmoins, un objet alloué - ne peut pas avoir de lien sur lui-même ou être mis dans un tableau - d'objet, etc. Vous devez choisir la méthode qui correspond a vos - besoins, mais tGchez d'utiliser la première méthode autant que possible - afin de réduire la syntaxe des templates au minimum. - - - Si l'option de sécurité est activée, aucune méthode ou fonctions privées - n'est accessible (commentant par "_"). S'il existe une méthode et une - propriété du même nom, c'est la méthode qui sera utilisée. - - - Vous pouvez restreindre l'accès aux méthodes et aux propriétés en - les listant dans un tableau en tant que troisième paramètre - d'allocation. - - - Par défaut, les paramètres passés aux objets depuis le templates le sont de la + + + Objets + + Smarty donne l'accès aux objets PHP a travers les templates. Il y + a 2 moyens d'y avoir accès. Le premier consiste a allouer les objets + au template puis de les utiliser avec une syntaxe similaire a celles + des fonctions personnalisées. Le deuxième moyen consiste a allouer + des objets aux templates et de les utiliser comme n'importe quelle + variable. La première méthode a une syntaxe beaucoup plus sympathique. + Elle est aussi plus sécurisée, puisqu'un objet alloué ne peut avoir accès + qu'a certaines méthodes et propriétés. Néanmoins, un objet alloué + ne peut pas avoir de lien sur lui-même ou être mis dans un tableau + d'objet, etc. Vous devez choisir la méthode qui correspond a vos + besoins, mais tGchez d'utiliser la première méthode autant que possible + afin de réduire la syntaxe des templates au minimum. + + + Si l'option de sécurité est activée, aucune méthode ou fonctions privées + n'est accessible (commentant par "_"). S'il existe une méthode et une + propriété du même nom, c'est la méthode qui sera utilisée. + + + Vous pouvez restreindre l'accès aux méthodes et aux propriétés en + les listant dans un tableau en tant que troisième paramètre + d'allocation. + + + Par défaut, les paramètres passés aux objets depuis le templates le sont de la même faton que les fonctions utilisateurs les récupèrent. Le premier paramètre correspond a un tableau associatif, le second a l'objet Smarty. Si vous souhaitez que les paramètres soient passées un a un, comme dans un appel traditionnel, définissez registration, quatrième paramètre optionnel, a false. - - - utilisation d'un objet alloué ou assigné - + + + utilisation d'un objet alloué ou assigné + <?php // la classe @@ -71,7 +72,7 @@ the output was {$output) {* access our assigned object *} {$myobj->meth1("foo",$bar)} - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml b/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml index 840454a4..d35b1573 100644 --- a/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml +++ b/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml @@ -1,27 +1,40 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - Filtres de sortie - - Quand le template est appelé via les fonctions display() ou fetch(), - sa sortie est envoyée a travers un ou plusieurs filtres de sorties. - Ils diffèrent des filtres de post-compilation dans le sens ou ils agissent - sur la sortie des templates, une fois exécutés, et non sur les sources - des templates. - - - Les filtres de sortie peuvent être soit - déclarés soit + + + Filtres de sortie + + Quand le template est appelé via les fonctions display() ou fetch(), + sa sortie est envoyée a travers un ou plusieurs filtres de sorties. + Ils diffèrent des filtres de post-compilation dans le sens ou ils agissent + sur la sortie des templates, une fois exécutés, et non sur les sources + des templates. + + + Les filtres de sortie peuvent être soit + déclarés soit chargés depuis les répertoires des plugins en utilisant la fonction load_filter() - ou en réglant la variable - $autoload_filters. - Smarty passera la sortie du template en premier argument et attendra - de la fonction qu'elle retourne le résultat de l'exécution. - - - utilisation d'un filtre de sortie - + ou en réglant la variable + $autoload_filters. + Smarty passera la sortie du template en premier argument et attendra + de la fonction qu'elle retourne le résultat de l'exécution. + + + utilisation d'un filtre de sortie + <?php // mettez ceci dans votre application function protect_email($tpl_output, &$smarty) @@ -39,25 +52,25 @@ $smarty->display("index.tpl"); // dorénavant toute occurence d'un adresse email dans le résultat du template // aura un protection simple contre les robots spammers ?> - - - \ No newline at end of file + + + diff --git a/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml b/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml index a6dd82ab..0cd6ac73 100644 --- a/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml +++ b/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml @@ -1,20 +1,27 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - Filtres de post-compilation - - Les filtres de post-compilation sont des fonctions PHP que vos templates - exécutent après avoir été compilés. Les filtres de post-compilation peuvent - être soit déclarés soit chargés - depuis les répertoires des plugins en utilisant la fonction - load_filter() ou en réglant - la variable $autoload_filters. - Smarty passera le template compilé en tant que premier paramètre et attendra - de la fonction qu'elle retourne le résultat de l'exécution. - - - utilisation d'un filtre de post-compilation de templates - + + + Filtres de post-compilation + + Les filtres de post-compilation sont des fonctions PHP que vos templates + exécutent après avoir été compilés. Les filtres de post-compilation peuvent + être soit déclarés soit chargés + depuis les répertoires des plugins en utilisant la fonction + load_filter() ou en réglant + la variable $autoload_filters. + Smarty passera le template compilé en tant que premier paramètre et attendra + de la fonction qu'elle retourne le résultat de l'exécution. + + + utilisation d'un filtre de post-compilation de templates + <?php // mettez cela dans votre application function add_header_comment($tpl_source, &$smarty) @@ -30,25 +37,25 @@ $smarty->display("index.tpl"); {* template Smarty compilé index.tpl *} <!-- Created by Smarty! --> {* reste du contenu du template... *} - - - \ No newline at end of file + + + diff --git a/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml b/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml index 3a5b17f1..09a5d6ee 100644 --- a/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml +++ b/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml @@ -1,24 +1,37 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - Filtres de pré-compilation - - Les filtres de pré-compilation sont des fonctions PHP que vos templates - exécutent avant qu'ils ne soient compilés. Cela peut être utile - pour pré-traiter vos templates afin d'enlever les commentaires - inutiles, garder un oeil sur ce que les gens mettent dans leurs templates, etc. - Les filtre de pré-compilations peuvent être soit - déclarés soit chargés - a partir des répertoires de plugins en utilisant la fonction - load_filter() ou en réglant + + + Filtres de pré-compilation + + Les filtres de pré-compilation sont des fonctions PHP que vos templates + exécutent avant qu'ils ne soient compilés. Cela peut être utile + pour pré-traiter vos templates afin d'enlever les commentaires + inutiles, garder un oeil sur ce que les gens mettent dans leurs templates, etc. + Les filtre de pré-compilations peuvent être soit + déclarés soit chargés + a partir des répertoires de plugins en utilisant la fonction + load_filter() ou en réglant la variable - $autoload_filters. + $autoload_filters. Smarty passera a la fonction le code source en tant que premier argument, et attendra en retour le code modifié. Utilisation un filtre de pré-compilation de template - + <?php // mettre ceci dans votre application function remove_dw_comments($tpl_source, &$smarty) @@ -34,24 +47,24 @@ $smarty->display("index.tpl"); {* template Smarty index.tpl *} <!--# cette ligne va être supprimée par le filtre de pré-compilation --> - - \ No newline at end of file + + diff --git a/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml b/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml index e2915d19..274baae1 100644 --- a/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml +++ b/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml @@ -1,17 +1,38 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - Fonction de gestion du cache - - Une alternative au mécanisme de cache par défaut (basé sur des fichiers - de cache) consiste a spécifier une fonction de gestion de cache utilisateur - qui sera utilisée pour lire, écrire et effacer les fichiers de cache. - - - Il suffit de créer dans votre application une fonction que Smarty - utilisera pour la gestion du cache et d'assigner le nom de cette - fonction a la variable de classe - $cache_handler_func. + + + Fonction de gestion du cache + + Une alternative au mécanisme de cache par défaut (basé sur des fichiers + de cache) consiste a spécifier une fonction de gestion de cache utilisateur + qui sera utilisée pour lire, écrire et effacer les fichiers de cache. + + + Il suffit de créer dans votre application une fonction que Smarty + utilisera pour la gestion du cache et d'assigner le nom de cette + fonction a la variable de classe + $cache_handler_func. Smarty utilisera alors cette fonction pour gérer les données du cache. Le premier argument est l'action, qui sera 'read', 'write' ou 'clear'. Le second paramètre est l'objet Smarty. Le troisième est le contenu @@ -22,10 +43,10 @@ Le quatrième paramètre est le nom du fichier de template (utile pour lire/écrire), le cinquième paramètre est l'identifiant de cache (optionnel) et le sixième est l'identifiant de compilation. - - - exemple d'utilisation de MySQL pour la source du cache - + + + exemple d'utilisation de MySQL pour la source du cache + <?php /* @@ -128,25 +149,25 @@ function mysql_cache_handler($action, &$smarty_obj, &$cache_content, $tp } ?> - - - \ No newline at end of file + + + diff --git a/docs/fr/programmers/advanced-features/template-resources.xml b/docs/fr/programmers/advanced-features/template-resources.xml index f60d699a..8b5bc0d6 100644 --- a/docs/fr/programmers/advanced-features/template-resources.xml +++ b/docs/fr/programmers/advanced-features/template-resources.xml @@ -1,25 +1,26 @@ - - Ressources - - Les templates peuvent provenir d'une grande variété de ressources. Quand vous - affichez ou récupérez un template, ou quand vous incluez un template - dans un autre template, vous fournissez un type de ressource, suivi - par le chemin approprié et le nom du template. - - - Templates depuis $template_dir - - Les templates du répertoire $template_dir n'ont pas - besoin d'une ressource template, bien que vous puissiez utiliser - la ressource "file" pour être cohérent. Vous n'avez qu'a fournir - le chemin vers le template que vous voulez utiliser, relatif - au répertoire racine $template_dir. - - - Utilisation de templates depuis $template_dir - + + + Ressources + + Les templates peuvent provenir d'une grande variété de ressources. Quand vous + affichez ou récupérez un template, ou quand vous incluez un template + dans un autre template, vous fournissez un type de ressource, suivi + par le chemin approprié et le nom du template. + + + Templates depuis $template_dir + + Les templates du répertoire $template_dir n'ont pas + besoin d'une ressource template, bien que vous puissiez utiliser + la ressource "file" pour être cohérent. Vous n'avez qu'a fournir + le chemin vers le template que vous voulez utiliser, relatif + au répertoire racine $template_dir. + + + Utilisation de templates depuis $template_dir + // le script PHP $smarty->display("index.tpl"); $smarty->display("admin/menu.tpl"); @@ -28,70 +29,70 @@ $smarty->display("file:admin/menu.tpl"); // le m {* le template Smarty *} {include file="index.tpl"} {include file="file:index.tpl"} {* le même que celui ci-dessus *} - - - - Templates a partir de n'importe quel répertoire - - Les templates en-dehors du répertoire $template_dir nécessitent - le type de ressource template, suivi du chemin absolu et du nom du - template. - - - utilisation d'un template depuis n'importe quel répertoire - + + + + Templates a partir de n'importe quel répertoire + + Les templates en-dehors du répertoire $template_dir nécessitent + le type de ressource template, suivi du chemin absolu et du nom du + template. + + + utilisation d'un template depuis n'importe quel répertoire + // le script PHP $smarty->display("file:/export/templates/index.tpl"); $smarty->display("file:/path/to/my/templates/menu.tpl"); {* le template Smarty *} {include file="file:/usr/local/share/templates/navigation.tpl"} - - - - Chemin de fichiers Windows - - Si vous utilisez Windows, les chemins de fichiers sont la plupart - du temps sur un disque identifié par une lettre (c:) au début du chemin. - Assurez-vous de bien mettre "file:" dans le chemin pour éviter des - conflits d'espace de nommage et obtenir les résultats escomptés. - - - utilisation de templates avec des chemins de fichiers Windows - + + + + Chemin de fichiers Windows + + Si vous utilisez Windows, les chemins de fichiers sont la plupart + du temps sur un disque identifié par une lettre (c:) au début du chemin. + Assurez-vous de bien mettre "file:" dans le chemin pour éviter des + conflits d'espace de nommage et obtenir les résultats escomptés. + + + utilisation de templates avec des chemins de fichiers Windows + // le script PHP $smarty->display("file:C:/export/templates/index.tpl"); $smarty->display("file:F:/path/to/my/templates/menu.tpl"); {* le template Smarty *} {include file="file:D:/usr/local/share/templates/navigation.tpl"} - - - - - - Templates depuis d'autres sources - - Vous pouvez récupérer les templates a partir n'importe quelle - source a laquelle vous avez accès avec PHP : base de données, - sockets, LDAP et ainsi de suite. Il suffit d'écrire les fonctions - de ressource plugins et de les enregistrer auprès de Smarty. - - - Reportez-vous a la section ressource plugins - pour plus d'informations sur les fonctions que vous Otes censé fournir. - - - - Notez que vous ne pouvez pas écraser la ressource file native, - toutefois, vous pouvez fournir une ressource qui récupère un template depuis - le système de fichier par un autre moyen en l'enregistrant sous un autre - nom de ressource. - - - - utilisation de ressources utilisateurs - + + + + + + Templates depuis d'autres sources + + Vous pouvez récupérer les templates a partir n'importe quelle + source a laquelle vous avez accès avec PHP : base de données, + sockets, LDAP et ainsi de suite. Il suffit d'écrire les fonctions + de ressource plugins et de les enregistrer auprès de Smarty. + + + Reportez-vous a la section ressource plugins + pour plus d'informations sur les fonctions que vous Otes censé fournir. + + + + Notez que vous ne pouvez pas écraser la ressource file native, + toutefois, vous pouvez fournir une ressource qui récupère un template depuis + le système de fichier par un autre moyen en l'enregistrant sous un autre + nom de ressource. + + + + utilisation de ressources utilisateurs + // le script PHP // mettez ces fonctions quelque part dans votre application @@ -148,20 +149,20 @@ $smarty->display("db:index.tpl"); {* utilise la ressource depuis le template Smarty *} {include file="db:/extras/navigation.tpl"} - - - - - Fonction de gestion de template par défaut - - Vous pouvez spécifier une fonction qui sera utilisée pour - récupérer le contenu d'un template dans le cas oú le template - ne peut pas être récupéré depuis sa ressource. Une utilisation possible est - la création de templates a la volée. - - - utilisation de la fonction de gestion de template par défaut - + + + + + Fonction de gestion de template par défaut + + Vous pouvez spécifier une fonction qui sera utilisée pour + récupérer le contenu d'un template dans le cas oú le template + ne peut pas être récupéré depuis sa ressource. Une utilisation possible est + la création de templates a la volée. + + + utilisation de la fonction de gestion de template par défaut + <?php // mettez cette fonction quelque part dans votre application @@ -184,8 +185,8 @@ function make_template ($resource_type, $resource_name, &$template_source, & // régle la fonction par défaut $smarty->default_template_handler_func = 'make_template'; ?> - - + + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions.xml b/docs/fr/programmers/api-functions.xml index 522f06aa..f1e35411 100644 --- a/docs/fr/programmers/api-functions.xml +++ b/docs/fr/programmers/api-functions.xml @@ -1,46 +1,47 @@ - - Méthodes -&programmers.api-functions.api-append; -&programmers.api-functions.api-append-by-ref; -&programmers.api-functions.api-assign; -&programmers.api-functions.api-assign-by-ref; -&programmers.api-functions.api-clear-all-assign; -&programmers.api-functions.api-clear-all-cache; -&programmers.api-functions.api-clear-assign; -&programmers.api-functions.api-clear-cache; -&programmers.api-functions.api-clear-compiled-tpl; -&programmers.api-functions.api-clear-config; -&programmers.api-functions.api-config-load; -&programmers.api-functions.api-display; -&programmers.api-functions.api-fetch; -&programmers.api-functions.api-get-config-vars; -&programmers.api-functions.api-get-registered-object; -&programmers.api-functions.api-get-template-vars; -&programmers.api-functions.api-is-cached; -&programmers.api-functions.api-load-filter; -&programmers.api-functions.api-register-block; -&programmers.api-functions.api-register-compiler-function; -&programmers.api-functions.api-register-function; -&programmers.api-functions.api-register-modifier; -&programmers.api-functions.api-register-object; -&programmers.api-functions.api-register-outputfilter; -&programmers.api-functions.api-register-postfilter; -&programmers.api-functions.api-register-prefilter; -&programmers.api-functions.api-register-resource; -&programmers.api-functions.api-trigger-error; - -&programmers.api-functions.api-template-exists; -&programmers.api-functions.api-unregister-block; -&programmers.api-functions.api-unregister-compiler-function; -&programmers.api-functions.api-unregister-function; -&programmers.api-functions.api-unregister-modifier; -&programmers.api-functions.api-unregister-object; -&programmers.api-functions.api-unregister-outputfilter; -&programmers.api-functions.api-unregister-postfilter; -&programmers.api-functions.api-unregister-prefilter; -&programmers.api-functions.api-unregister-resource; + + + Méthodes + &programmers.api-functions.api-append; + &programmers.api-functions.api-append-by-ref; + &programmers.api-functions.api-assign; + &programmers.api-functions.api-assign-by-ref; + &programmers.api-functions.api-clear-all-assign; + &programmers.api-functions.api-clear-all-cache; + &programmers.api-functions.api-clear-assign; + &programmers.api-functions.api-clear-cache; + &programmers.api-functions.api-clear-compiled-tpl; + &programmers.api-functions.api-clear-config; + &programmers.api-functions.api-config-load; + &programmers.api-functions.api-display; + &programmers.api-functions.api-fetch; + &programmers.api-functions.api-get-config-vars; + &programmers.api-functions.api-get-registered-object; + &programmers.api-functions.api-get-template-vars; + &programmers.api-functions.api-is-cached; + &programmers.api-functions.api-load-filter; + &programmers.api-functions.api-register-block; + &programmers.api-functions.api-register-compiler-function; + &programmers.api-functions.api-register-function; + &programmers.api-functions.api-register-modifier; + &programmers.api-functions.api-register-object; + &programmers.api-functions.api-register-outputfilter; + &programmers.api-functions.api-register-postfilter; + &programmers.api-functions.api-register-prefilter; + &programmers.api-functions.api-register-resource; + &programmers.api-functions.api-trigger-error; + + &programmers.api-functions.api-template-exists; + &programmers.api-functions.api-unregister-block; + &programmers.api-functions.api-unregister-compiler-function; + &programmers.api-functions.api-unregister-function; + &programmers.api-functions.api-unregister-modifier; + &programmers.api-functions.api-unregister-object; + &programmers.api-functions.api-unregister-outputfilter; + &programmers.api-functions.api-unregister-postfilter; + &programmers.api-functions.api-unregister-prefilter; + &programmers.api-functions.api-unregister-resource; - - append_by_ref - - - void append_by_ref - string varname - mixed var - - - void append_by_ref - string varname - mixed var - boolean merge - - - - Utilisée pour ajouter des valeurs a un template par référence plut(t que - par copie. Si vous ajoutez une variable par référence puis changez sa - valeur, le changement est aussi répercuté sur la valeur assignée. - Pour les objets, append_by_ref ne fait pas de copie en mémoire de l'objet - assigné. Voir la documentation PHP pour plus d'informations sur les - références de variable. - Si vous passez le troisième paramètre a vrai, la valeur sera fusionnée - avec le tableau courant plut(t que d'être ajoutée. - - - Note technique - - Le paramètre de fusion respecte les clés des tableaux, ainsi si vous - fusionnez deux tableaux indexés numériquement, ils pourront s'écraser - l'un l'autre ou donner des clés qui ne se suivent pas. Cela diffère - donc de la fonction PHP array_merge() qui supprime les clés numériques - et les renumérote. - - - - append_by_ref - + + + append_by_ref + + + void append_by_ref + string varname + mixed var + + + void append_by_ref + string varname + mixed var + boolean merge + + + + Utilisée pour ajouter des valeurs a un template par référence plut(t que + par copie. Si vous ajoutez une variable par référence puis changez sa + valeur, le changement est aussi répercuté sur la valeur assignée. + Pour les objets, append_by_ref ne fait pas de copie en mémoire de l'objet + assigné. Voir la documentation PHP pour plus d'informations sur les + références de variable. + Si vous passez le troisième paramètre a vrai, la valeur sera fusionnée + avec le tableau courant plut(t que d'être ajoutée. + + + Note technique + + Le paramètre de fusion respecte les clés des tableaux, ainsi si vous + fusionnez deux tableaux indexés numériquement, ils pourront s'écraser + l'un l'autre ou donner des clés qui ne se suivent pas. Cela diffère + donc de la fonction PHP array_merge() qui supprime les clés numériques + et les renumérote. + + + + append_by_ref + // ajoute des paires nom/valeur $smarty->append_by_ref("Name",$myname); $smarty->append_by_ref("Address",$address); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-append.xml b/docs/fr/programmers/api-functions/api-append.xml index a5722f33..fe6f4977 100644 --- a/docs/fr/programmers/api-functions/api-append.xml +++ b/docs/fr/programmers/api-functions/api-append.xml @@ -1,52 +1,53 @@ - - append - - - void append - mixed var - - - void append - string varname - mixed var - - - void append - string varname - mixed var - boolean merge - - - - Utilisée pour ajouter un élément a un tableau assigné. Si vous utilisez - cette fonction avec une chaîne de caractères, elle est convertie en - tableau auquel on ajoute ensuite l'élément. Vous pouvez explicitement passer - des paires nom/valeur. Si vous passez le troisième paramètre - (optionel) a vrai, la valeur sera fusionnée avec le tableau plut(t que - d'être ajoutée. - - - Note technique - - Le paramètre de fusion respecte les clés des tableaux, ainsi si vous - fusionnez deux tableaux indexés numériquement, ils pourront s'écraser - l'un l'autre ou donner des clés qui ne se suivent pas. Cela diffère - donc de la fonction PHP array_merge() qui supprime les clés numériques - et les renumérote. - - - - append - + + + append + + + void append + mixed var + + + void append + string varname + mixed var + + + void append + string varname + mixed var + boolean merge + + + + Utilisée pour ajouter un élément a un tableau assigné. Si vous utilisez + cette fonction avec une chaîne de caractères, elle est convertie en + tableau auquel on ajoute ensuite l'élément. Vous pouvez explicitement passer + des paires nom/valeur. Si vous passez le troisième paramètre + (optionel) a vrai, la valeur sera fusionnée avec le tableau plut(t que + d'être ajoutée. + + + Note technique + + Le paramètre de fusion respecte les clés des tableaux, ainsi si vous + fusionnez deux tableaux indexés numériquement, ils pourront s'écraser + l'un l'autre ou donner des clés qui ne se suivent pas. Cela diffère + donc de la fonction PHP array_merge() qui supprime les clés numériques + et les renumérote. + + + + append + // passe des paires nom/valeur $smarty->append("Name","Fred"); $smarty->append("Address",$address); // passe un tableau associatif $smarty->append(array("city" => "Lincoln","state" => "Nebraska")); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-assign-by-ref.xml b/docs/fr/programmers/api-functions/api-assign-by-ref.xml index 5a677018..a0318b69 100644 --- a/docs/fr/programmers/api-functions/api-assign-by-ref.xml +++ b/docs/fr/programmers/api-functions/api-assign-by-ref.xml @@ -1,36 +1,37 @@ - - assign_by_ref - - - void assign_by_ref - string varname - mixed var - - - - Utilisée pour assigner des valeurs aux templates par référence plut(t - que par copie. Référez-vous au manuel PHP pour une explication plus précise - sur les références des variables. - - - Note technique - - Si vous assignez une variable par référence puis changez sa - valeur, le changement est aussi répercuté sur la valeur assignée. - Pour les objets, assign_by_ref ne fait pas de copie en mémoire de l'objet - assigné. Référez-vous au manuel PHP pour une explication plus précise sur - les références de variable. - - - - assign_by_ref - + + + assign_by_ref + + + void assign_by_ref + string varname + mixed var + + + + Utilisée pour assigner des valeurs aux templates par référence plut(t + que par copie. Référez-vous au manuel PHP pour une explication plus précise + sur les références des variables. + + + Note technique + + Si vous assignez une variable par référence puis changez sa + valeur, le changement est aussi répercuté sur la valeur assignée. + Pour les objets, assign_by_ref ne fait pas de copie en mémoire de l'objet + assigné. Référez-vous au manuel PHP pour une explication plus précise sur + les références de variable. + + + + assign_by_ref + // passe des paires noms/valeurs $smarty->assign_by_ref("Name",$myname); $smarty->assign_by_ref("Address",$address); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-assign.xml b/docs/fr/programmers/api-functions/api-assign.xml index a0df7a6d..51befd39 100644 --- a/docs/fr/programmers/api-functions/api-assign.xml +++ b/docs/fr/programmers/api-functions/api-assign.xml @@ -1,33 +1,34 @@ - - assign - - - void assign - mixed var - - - void assign - string varname - mixed var - - - - Utilisée pour assigner des valeurs aux templates. Vous pouvez - explicitement passer des paires nom/valeur, ou des tableaux - associatifs contenant des paires nom/valeur. - - - assign - + + + assign + + + void assign + mixed var + + + void assign + string varname + mixed var + + + + Utilisée pour assigner des valeurs aux templates. Vous pouvez + explicitement passer des paires nom/valeur, ou des tableaux + associatifs contenant des paires nom/valeur. + + + assign + // passe des paires nom/valeur $smarty->assign("Name","Fred"); $smarty->assign("Address",$address); // passe un tableau associatif $smarty->assign(array("city" => "Lincoln","state" => "Nebraska")); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-clear-all-assign.xml b/docs/fr/programmers/api-functions/api-clear-all-assign.xml index 7077babb..bd032f9c 100644 --- a/docs/fr/programmers/api-functions/api-clear-all-assign.xml +++ b/docs/fr/programmers/api-functions/api-clear-all-assign.xml @@ -1,22 +1,23 @@ - - clear_all_assign - - - void clear_all_assign - - - - - Utilisée pour effacer les valeurs de toutes les variables assignées. - - -clear_all_assign + + + clear_all_assign + + + void clear_all_assign + + + + + Utilisée pour effacer les valeurs de toutes les variables assignées. + + + clear_all_assign // efface toutes les variables assignées $smarty->clear_all_assign(); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-clear-all-cache.xml b/docs/fr/programmers/api-functions/api-clear-all-cache.xml index 68d4fbd8..646a4766 100644 --- a/docs/fr/programmers/api-functions/api-clear-all-cache.xml +++ b/docs/fr/programmers/api-functions/api-clear-all-cache.xml @@ -1,24 +1,25 @@ - - clear_all_cache - - - void clear_all_cache - int expire time - - - - Utilisée pour effacer les fichiers de cache des templates. Vous pouvez passer un - paramètre optionnel afin d'indiquer l'Gge minimun que doivent avoir - les fichiers de cache pour qu'ils soient effacés. - - -clear_all_cache + + + clear_all_cache + + + void clear_all_cache + int expire time + + + + Utilisée pour effacer les fichiers de cache des templates. Vous pouvez passer un + paramètre optionnel afin d'indiquer l'Gge minimun que doivent avoir + les fichiers de cache pour qu'ils soient effacés. + + + clear_all_cache // efface le cache $smarty->clear_all_cache(); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-clear-assign.xml b/docs/fr/programmers/api-functions/api-clear-assign.xml index 40459933..4a938ddd 100644 --- a/docs/fr/programmers/api-functions/api-clear-assign.xml +++ b/docs/fr/programmers/api-functions/api-clear-assign.xml @@ -1,26 +1,27 @@ - - clear_assign - - - void clear_assign - string var - - - - Efface la valeur d'une variable assignée. Il peut s'agir - d'une simple valeur ou d'un tableau de valeur. - - -clear_assign + + + clear_assign + + + void clear_assign + string var + + + + Efface la valeur d'une variable assignée. Il peut s'agir + d'une simple valeur ou d'un tableau de valeur. + + + clear_assign // efface une variable $smarty->clear_assign("Name"); // efface plusieurs variables $smarty->clear_assign(array("Name","Address","Zip")); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-clear-cache.xml b/docs/fr/programmers/api-functions/api-clear-cache.xml index 54df24ba..b6f084ef 100644 --- a/docs/fr/programmers/api-functions/api-clear-cache.xml +++ b/docs/fr/programmers/api-functions/api-clear-cache.xml @@ -1,54 +1,61 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - clear_cache - - voidclear_cache - stringtemplate - stringcache id - stringcompile id - intexpire time - - - Utilisée pour nettoyer le(s) fichier(s) de cache d'un template en particulier. - Si vous avez plusieurs fichiers de cache pour ce template vous - pouvez en spécifier un en particulier en passant son identifiant - en deuxième paramètre. Vous pouvez aussi passer un identifiant - de compilation en troisième paramètre. Vous pouvez grouper des - templates ensemble afin qu'ils puissent être supprimés en groupe. - Référez-vous a la section sur le - cache - pour plus d'informations. Vous pouvez passer un quatrième paramètre - pour indiquer un Gge minimum en secondes que le fichier en cache doit - avoir avant d'être effacé. - - -clear_cache + + + clear_cache + + voidclear_cache + stringtemplate + stringcache id + stringcompile id + intexpire time + + + Utilisée pour nettoyer le(s) fichier(s) de cache d'un template en particulier. + Si vous avez plusieurs fichiers de cache pour ce template vous + pouvez en spécifier un en particulier en passant son identifiant + en deuxième paramètre. Vous pouvez aussi passer un identifiant + de compilation en troisième paramètre. Vous pouvez grouper des + templates ensemble afin qu'ils puissent être supprimés en groupe. + Référez-vous a la section sur le + cache + pour plus d'informations. Vous pouvez passer un quatrième paramètre + pour indiquer un Gge minimum en secondes que le fichier en cache doit + avoir avant d'être effacé. + + + clear_cache // efface le fichier de cache de ce template $smarty->clear_cache("index.tpl"); // efface un fichier de cache grGce a son identifiant de cache $smarty->clear_cache("index.tpl","CACHEID"); - - - \ No newline at end of file + + + diff --git a/docs/fr/programmers/api-functions/api-clear-compiled-tpl.xml b/docs/fr/programmers/api-functions/api-clear-compiled-tpl.xml index 92574b85..cd1d8536 100644 --- a/docs/fr/programmers/api-functions/api-clear-compiled-tpl.xml +++ b/docs/fr/programmers/api-functions/api-clear-compiled-tpl.xml @@ -1,27 +1,28 @@ - - clear_compiled_tpl - - - void clear_compiled_tpl - string tpl_file - - - - Utilisée pour effacer la version compilée du template spécifié ou - de tous les templates si aucun n'est spécifié. Cette fonction - est destinée a un usage avancé et n'est pas habituellement utilisée. - - -clear_compiled_tpl + + + clear_compiled_tpl + + + void clear_compiled_tpl + string tpl_file + + + + Utilisée pour effacer la version compilée du template spécifié ou + de tous les templates si aucun n'est spécifié. Cette fonction + est destinée a un usage avancé et n'est pas habituellement utilisée. + + + clear_compiled_tpl // efface la version compilée du template spécifié $smarty->clear_compiled_tpl("index.tpl"); // efface tout le contenu du répertoire des templates compilés $smarty->clear_compiled_tpl(); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-clear-config.xml b/docs/fr/programmers/api-functions/api-clear-config.xml index 0fc56c2d..44d7bf56 100644 --- a/docs/fr/programmers/api-functions/api-clear-config.xml +++ b/docs/fr/programmers/api-functions/api-clear-config.xml @@ -1,25 +1,26 @@ - - clear_config - - voidclear_config - stringvar - - - Utilisée pour effacer toutes les variables de configuration s'étant - vues assigner une valeur. Si une variable est spécifiée, seule cette - variable est effacée. - - -clear_config + + + clear_config + + voidclear_config + stringvar + + + Utilisée pour effacer toutes les variables de configuration s'étant + vues assigner une valeur. Si une variable est spécifiée, seule cette + variable est effacée. + + + clear_config // efface toutes les variables de configuration assignées $smarty->clear_config(); // efface une seule variable $smarty->clear_config('foobar'); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-config-load.xml b/docs/fr/programmers/api-functions/api-config-load.xml index ee14517c..2fdfffd0 100644 --- a/docs/fr/programmers/api-functions/api-config-load.xml +++ b/docs/fr/programmers/api-functions/api-config-load.xml @@ -1,39 +1,40 @@ - - config_load - - voidconfig_load - stringfile - stringsection - - - Utilisée pour charger des données d'un fichier de config et les - assigner a un template. Cette fonction fonctionne exactement comme - la fonction de template config_load. - - - Note technique - - Comme pour Smarty 2.4.0, les variables de templates assignées - sont conservées entre chaque appel a fetch et display. - Les variables de configuration chargées avec config_load sont - globales. Les fichiers de config sont aussi compilés pour une - exécution plus rapide et respecte les réglages de force_compile et de compile_check. - - - -config_load + + + config_load + + voidconfig_load + stringfile + stringsection + + + Utilisée pour charger des données d'un fichier de config et les + assigner a un template. Cette fonction fonctionne exactement comme + la fonction de template config_load. + + + Note technique + + Comme pour Smarty 2.4.0, les variables de templates assignées + sont conservées entre chaque appel a fetch et display. + Les variables de configuration chargées avec config_load sont + globales. Les fichiers de config sont aussi compilés pour une + exécution plus rapide et respecte les réglages de force_compile et de compile_check. + + + + config_load // charge les variables de configuration et les assigne $smarty->config_load('my.conf'); // charge une section $smarty->config_load('my.conf','foobar'); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-display.xml b/docs/fr/programmers/api-functions/api-display.xml index ae5f8b1b..b78887b3 100644 --- a/docs/fr/programmers/api-functions/api-display.xml +++ b/docs/fr/programmers/api-functions/api-display.xml @@ -1,34 +1,35 @@ - - display - - voiddisplay - stringtemplate - stringcache_id - stringcompile_id - - - Utilisée pour afficher un template. Il faut fournir un type et un - chemin de ressource template - valides. Vous pouvez passer en second paramètre un identifiant - de fichier de cache. Reportez-vous a la section - cache pour plus de renseignements. - - - Le troisième paramètre optionnel est un identifiant de compilation. - Cela s'avère utile quand vous voulez compiler différentes versions - d'un même template, pour par exemple avoir des templates - compilés séparés pour différents langages. Une autre utilité de ce - paramètre est le cas oú vous utilisez plus d'un $template_dir mais un seul - $compile_dir, car certains templates avec le même nom s'écraseraient - entre eux. Vous pouvez aussi régler la variable $compile_id une seule - fois au lieu de la passer a chaque appel. - - -affichage + + + display + + voiddisplay + stringtemplate + stringcache_id + stringcompile_id + + + Utilisée pour afficher un template. Il faut fournir un type et un + chemin de ressource template + valides. Vous pouvez passer en second paramètre un identifiant + de fichier de cache. Reportez-vous a la section + cache pour plus de renseignements. + + + Le troisième paramètre optionnel est un identifiant de compilation. + Cela s'avère utile quand vous voulez compiler différentes versions + d'un même template, pour par exemple avoir des templates + compilés séparés pour différents langages. Une autre utilité de ce + paramètre est le cas oú vous utilisez plus d'un $template_dir mais un seul + $compile_dir, car certains templates avec le même nom s'écraseraient + entre eux. Vous pouvez aussi régler la variable $compile_id une seule + fois au lieu de la passer a chaque appel. + + + affichage include("Smarty.class.php"); $smarty = new Smarty; @@ -55,16 +56,16 @@ if(!$smarty->is_cached("index.tpl")) // display the output $smarty->display("index.tpl"); - - - Utilisez la syntaxe des ressources templates - pour afficher des fichiers en-dehors du répertoire - $template_dir - - - -exemples de fonction d'affichage de ressources templates + + + Utilisez la syntaxe des ressources templates + pour afficher des fichiers en-dehors du répertoire + $template_dir + + + + exemples de fonction d'affichage de ressources templates // chemin absolu $smarty->display("/usr/local/include/templates/header.tpl"); @@ -77,26 +78,26 @@ $smarty->display("file:C:/www/pub/templates/header.tpl"); // inclue a partir de la ressource template "db" $smarty->display("db:header.tpl"); - - - - \ No newline at end of file + + + + diff --git a/docs/fr/programmers/api-functions/api-fetch.xml b/docs/fr/programmers/api-functions/api-fetch.xml index c4b4e262..5cff2be8 100644 --- a/docs/fr/programmers/api-functions/api-fetch.xml +++ b/docs/fr/programmers/api-functions/api-fetch.xml @@ -1,34 +1,77 @@ + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 - - fetch - - stringfetch - stringtemplate - stringcache_id - stringcompile_id - - - Utilisée pour renvoyer le résultat du template plut(t que de l'afficher. - Il faut passer un type et un chemin de ressource template - valides. Vous pouvez passer un identifiant de cache en deuxième - paramètre. Reportez-vous a la section cache - pour plus de renseignements. - - - Un troisième paramètre optionnel est un identifiant de compilation. - Cela s'avère utile quand vous voulez compiler différentes versions - d'un même template, pour par exemple avoir des templates - compilés séparés pour différents langages. Une autre utilité de ce - paramètre est le cas oú vous utilisez plus d'un $template_dir - mais un seul $compile_dir, car certains templates avec le même nom - s'écraseraient entre eux. Vous pouvez aussi régler la variable $compile_id une seule - fois plut(t que de la passer a chaque appel. - + + + fetch + + stringfetch + stringtemplate + stringcache_id + stringcompile_id + + + Utilisée pour renvoyer le résultat du template plut(t que de l'afficher. + Il faut passer un type et un chemin de ressource template + valides. Vous pouvez passer un identifiant de cache en deuxième + paramètre. Reportez-vous a la section cache + pour plus de renseignements. + + + Un troisième paramètre optionnel est un identifiant de compilation. + Cela s'avère utile quand vous voulez compiler différentes versions + d'un même template, pour par exemple avoir des templates + compilés séparés pour différents langages. Une autre utilité de ce + paramètre est le cas oú vous utilisez plus d'un $template_dir + mais un seul $compile_dir, car certains templates avec le même nom + s'écraseraient entre eux. Vous pouvez aussi régler la variable $compile_id une seule + fois plut(t que de la passer a chaque appel. + -fetch + fetch include("Smarty.class.php"); $smarty = new Smarty; @@ -81,4 +124,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-get-config-vars.xml b/docs/fr/programmers/api-functions/api-get-config-vars.xml index 650f78d3..c13a03b8 100644 --- a/docs/fr/programmers/api-functions/api-get-config-vars.xml +++ b/docs/fr/programmers/api-functions/api-get-config-vars.xml @@ -1,18 +1,19 @@ - - get_config_vars - - arrayget_config_vars - stringvarname - - - Retourne la valeur de la variable de configuration passée en paramètre. - Si aucun paramètre n'est donné, un tableau de toutes les variables de - configuration chargées est renvoyé. - - -get_config_vars + + + get_config_vars + + arrayget_config_vars + stringvarname + + + Retourne la valeur de la variable de configuration passée en paramètre. + Si aucun paramètre n'est donné, un tableau de toutes les variables de + configuration chargées est renvoyé. + + + get_config_vars // récupère la variable de configuration chargée 'foo' $foo = $smarty->get_config_vars('foo'); @@ -22,7 +23,7 @@ $config_vars = $smarty->get_config_vars(); // les affiche a l'écran print_r($config_vars); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-get-registered-object.xml b/docs/fr/programmers/api-functions/api-get-registered-object.xml index 77f91de3..4598ea62 100644 --- a/docs/fr/programmers/api-functions/api-get-registered-object.xml +++ b/docs/fr/programmers/api-functions/api-get-registered-object.xml @@ -1,20 +1,21 @@ - - get_registered_object - - - array get_registered_object - string object_name - - - - Retourne la référence d'un objet enregistré. Utile quand vous - voulez accéder directement a un objet enregistré avec une - fonction utilisateur. - - -get_registered_object + + + get_registered_object + + + array get_registered_object + string object_name + + + + Retourne la référence d'un objet enregistré. Utile quand vous + voulez accéder directement a un objet enregistré avec une + fonction utilisateur. + + + get_registered_object function smarty_block_foo($params, &$smarty) { if (isset[$params['object']]) { @@ -23,7 +24,7 @@ function smarty_block_foo($params, &$smarty) { // $obj_ref est maintenant une référence vers l'objet } } - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-get-template-vars.xml b/docs/fr/programmers/api-functions/api-get-template-vars.xml index 68e26360..469c73f0 100644 --- a/docs/fr/programmers/api-functions/api-get-template-vars.xml +++ b/docs/fr/programmers/api-functions/api-get-template-vars.xml @@ -1,18 +1,19 @@ - - get_template_vars - - arrayget_template_vars - stringvarname - - - Retourne la valeur assignée passée en paramètre. Si aucun paramètre - n'est donné, un tableau de toutes les variables assignées est - renvoyé. - - -get_template_vars + + + get_template_vars + + arrayget_template_vars + stringvarname + + + Retourne la valeur assignée passée en paramètre. Si aucun paramètre + n'est donné, un tableau de toutes les variables assignées est + renvoyé. + + + get_template_vars // récupère la variable 'foo' assignée au template // get assigned template var 'foo' @@ -23,7 +24,7 @@ $tpl_vars = $smarty->get_template_vars(); // les affiche a l'écran print_r($tpl_vars); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-is-cached.xml b/docs/fr/programmers/api-functions/api-is-cached.xml index 90bec755..c8d06a6f 100644 --- a/docs/fr/programmers/api-functions/api-is-cached.xml +++ b/docs/fr/programmers/api-functions/api-is-cached.xml @@ -1,21 +1,22 @@ - - is_cached - - - void is_cached - string template - [string cache_id] - - - - Retourne vrai s'il y a un fichier de cache valide pour ce template. - Cela fonctionne seulement si caching est a vrai. - - -is_cached + + + is_cached + + + void is_cached + string template + [string cache_id] + + + + Retourne vrai s'il y a un fichier de cache valide pour ce template. + Cela fonctionne seulement si caching est a vrai. + + + is_cached $smarty->caching = true; @@ -25,14 +26,14 @@ if(!$smarty->is_cached("index.tpl")) { } $smarty->display("index.tpl"); - - - Vous pouvez aussi passer en second paramètre un identifiant - de cache au cas oú vous voudriez plusieurs fichiers de cache - pour ce template. - - -is_cached with multiple-cache template + + + Vous pouvez aussi passer en second paramètre un identifiant + de cache au cas oú vous voudriez plusieurs fichiers de cache + pour ce template. + + + is_cached with multiple-cache template $smarty->caching = true; @@ -42,7 +43,7 @@ if(!$smarty->is_cached("index.tpl","FrontPage")) { } $smarty->display("index.tpl","FrontPage"); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-load-filter.xml b/docs/fr/programmers/api-functions/api-load-filter.xml index ec326c05..30a2477c 100644 --- a/docs/fr/programmers/api-functions/api-load-filter.xml +++ b/docs/fr/programmers/api-functions/api-load-filter.xml @@ -1,28 +1,29 @@ - - load_filter - - - void load_filter - string type - string name - - - - Cette fonction peut être utilisée pour charger un plugin - de filtrage. Le premier argument spécifie le type du filtre - et peut prendre l'une des valeurs suivantes : 'pre', 'post' - ou 'output'. Le second argument spécifie le nom du plugin - de filtrage, par exemple 'trim'. - - -Chargement de plugins de filtrage + + + load_filter + + + void load_filter + string type + string name + + + + Cette fonction peut être utilisée pour charger un plugin + de filtrage. Le premier argument spécifie le type du filtre + et peut prendre l'une des valeurs suivantes : 'pre', 'post' + ou 'output'. Le second argument spécifie le nom du plugin + de filtrage, par exemple 'trim'. + + + Chargement de plugins de filtrage $smarty->load_filter('pre', 'trim'); // charge le filtre 'trim' de type 'pre' $smarty->load_filter('pre', 'datefooter'); // charge un autre filtre de type 'pre' appelé 'datefooter' $smarty->load_filter('output', 'compress'); // charge le filtre 'compress' de type 'output' - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-register-block.xml b/docs/fr/programmers/api-functions/api-register-block.xml index a34acb35..6b627959 100644 --- a/docs/fr/programmers/api-functions/api-register-block.xml +++ b/docs/fr/programmers/api-functions/api-register-block.xml @@ -1,21 +1,22 @@ - - register_block - - - void register_block - string name - string impl - - - - Utilisée pour déclarrer dynamiquement des plugins de fonction - de blocs. Il faut passer en paramètre le nom de la fonction - de blocs, suivi du nom de la fonction PHP qui l'implémente. - - -register_block + + + register_block + + + void register_block + string name + string impl + + + + Utilisée pour déclarrer dynamiquement des plugins de fonction + de blocs. Il faut passer en paramètre le nom de la fonction + de blocs, suivi du nom de la fonction PHP qui l'implémente. + + + register_block /* PHP */ $smarty->register_block("translate", "do_translation"); @@ -32,7 +33,7 @@ function do_translation ($params, $content, &$smarty) { {translate lang="br"} Hello, world! {/translate} - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-register-compiler-function.xml b/docs/fr/programmers/api-functions/api-register-compiler-function.xml index 0d433d28..9f582fc7 100644 --- a/docs/fr/programmers/api-functions/api-register-compiler-function.xml +++ b/docs/fr/programmers/api-functions/api-register-compiler-function.xml @@ -1,20 +1,21 @@ - - register_compiler_function - - - void register_compiler_function - string name - string impl - - - - Utilisée pour déclarer dynamiquement un plugin de fonction - de compilation. Il faut passer en paramètres le nom de la fonction - de compilation, suivi par la fonction PHP qui - l'implémente. - + + + register_compiler_function + + + void register_compiler_function + string name + string impl + + + + Utilisée pour déclarer dynamiquement un plugin de fonction + de compilation. Il faut passer en paramètres le nom de la fonction + de compilation, suivi par la fonction PHP qui + l'implémente. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-register-function.xml b/docs/fr/programmers/api-functions/api-register-function.xml index 739c24cd..7560f35c 100644 --- a/docs/fr/programmers/api-functions/api-register-function.xml +++ b/docs/fr/programmers/api-functions/api-register-function.xml @@ -1,21 +1,22 @@ - - register_function - - - void register_function - string name - string impl - - - - Utilisée pour déclarer dynamiquement des plugins de fonction - de templates. Il faut passer en paramètres le nom de la fonction - de templates, suivi par le nom de la fonction PHP qui l'implémente. - - -register_function + + + register_function + + + void register_function + string name + string impl + + + + Utilisée pour déclarer dynamiquement des plugins de fonction + de templates. Il faut passer en paramètres le nom de la fonction + de templates, suivi par le nom de la fonction PHP qui l'implémente. + + + register_function $smarty->register_function("date_now", "print_current_date"); @@ -29,7 +30,7 @@ function print_current_date ($params) { // vous pouvez maintenant utiliser ceci dans Smarty pour afficher // la date actuelle : {date_now} ou {date_now format="%Y/%m/%d"} // pour la formater - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-register-modifier.xml b/docs/fr/programmers/api-functions/api-register-modifier.xml index 3176eb58..953f4a0d 100644 --- a/docs/fr/programmers/api-functions/api-register-modifier.xml +++ b/docs/fr/programmers/api-functions/api-register-modifier.xml @@ -1,28 +1,29 @@ - - register_modifier - - - void register_modifier - string name - string impl - - - - Utilisée pour déclarer dynamiquement un plugin de modificateur. - Il faut passer en paramètre le nom du modificateur de variables, - suivi de la fonction PHP qui l'implémente. - - -register_modifier + + + register_modifier + + + void register_modifier + string name + string impl + + + + Utilisée pour déclarer dynamiquement un plugin de modificateur. + Il faut passer en paramètre le nom du modificateur de variables, + suivi de la fonction PHP qui l'implémente. + + + register_modifier // associons la fonction PHP stripslashes a un modificateur Smarty. $smarty->register_modifier("sslash","stripslashes"); // vous pouvez maintenant utiliser {$var|sslash} pour supprimer les slash des variables - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-register-object.xml b/docs/fr/programmers/api-functions/api-register-object.xml index bdf56675..5e2a017f 100644 --- a/docs/fr/programmers/api-functions/api-register-object.xml +++ b/docs/fr/programmers/api-functions/api-register-object.xml @@ -1,40 +1,43 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - register_object - - - void register_object - string object_name - object $object - array allowed methods/properties - boolean format - - - - Utilisée pour enregistrer un objet a utiliser dans un template. - Reportez-vous a la section - objet de - ce manuel pour des exemples. - - - \ No newline at end of file + + + register_object + + + void register_object + string object_name + object $object + array allowed methods/properties + boolean format + + + + Utilisée pour enregistrer un objet a utiliser dans un template. + Reportez-vous a la section + objet de + ce manuel pour des exemples. + + + diff --git a/docs/fr/programmers/api-functions/api-register-outputfilter.xml b/docs/fr/programmers/api-functions/api-register-outputfilter.xml index ac1c5db1..f1c8b80d 100644 --- a/docs/fr/programmers/api-functions/api-register-outputfilter.xml +++ b/docs/fr/programmers/api-functions/api-register-outputfilter.xml @@ -1,19 +1,20 @@ - - register_outputfilter - - - void register_outputfilter - string function_name - - - - Utilisée pour déclarer dynamiquement des filtres de sortie, pour - agir sur la sortie d'un template avant qu'elle ne soit affichée. - Reportez-vous a la section - filtres de sortie pour plus d'information sur le sujet. - + + + register_outputfilter + + + void register_outputfilter + string function_name + + + + Utilisée pour déclarer dynamiquement des filtres de sortie, pour + agir sur la sortie d'un template avant qu'elle ne soit affichée. + Reportez-vous a la section + filtres de sortie pour plus d'information sur le sujet. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-register-postfilter.xml b/docs/fr/programmers/api-functions/api-register-postfilter.xml index 82c0ddb0..6454a957 100644 --- a/docs/fr/programmers/api-functions/api-register-postfilter.xml +++ b/docs/fr/programmers/api-functions/api-register-postfilter.xml @@ -1,39 +1,44 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - register_postfilter - - - void register_postfilter - string function_name - - - - Utilisée pour déclarer dynamiquement des filtres de post-compilation pour y faire - passer des templates une fois qu'ils ont été compilés. Reportez-vous - a la section - filtres de post-compilation de templates - pour avoir plus de renseignements sur la faton de paramétrer les fonctions - de post-compilation. - - - \ No newline at end of file + + + register_postfilter + + + void register_postfilter + string function_name + + + + Utilisée pour déclarer dynamiquement des filtres de post-compilation pour y faire + passer des templates une fois qu'ils ont été compilés. Reportez-vous + a la section + filtres de post-compilation de templates + pour avoir plus de renseignements sur la faton de paramétrer les fonctions + de post-compilation. + + + diff --git a/docs/fr/programmers/api-functions/api-register-prefilter.xml b/docs/fr/programmers/api-functions/api-register-prefilter.xml index d05cefa9..032f84b9 100644 --- a/docs/fr/programmers/api-functions/api-register-prefilter.xml +++ b/docs/fr/programmers/api-functions/api-register-prefilter.xml @@ -1,39 +1,44 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - register_prefilter - - - void register_prefilter - string function_name - - - - Utilisée pour déclarer dynamiquement des filtres de pré-compilation pour y faire - passer des templates avant qu'ils ne soient compilés. Reportez-vous - a la section - filtres de pré-compilation de templates - pour avoir plus de renseignements sur la faton de paramétrer les fonctions - de pré-compilation. - - - \ No newline at end of file + + + register_prefilter + + + void register_prefilter + string function_name + + + + Utilisée pour déclarer dynamiquement des filtres de pré-compilation pour y faire + passer des templates avant qu'ils ne soient compilés. Reportez-vous + a la section + filtres de pré-compilation de templates + pour avoir plus de renseignements sur la faton de paramétrer les fonctions + de pré-compilation. + + + diff --git a/docs/fr/programmers/api-functions/api-register-resource.xml b/docs/fr/programmers/api-functions/api-register-resource.xml index 93690aa1..e3ccbf34 100644 --- a/docs/fr/programmers/api-functions/api-register-resource.xml +++ b/docs/fr/programmers/api-functions/api-register-resource.xml @@ -1,30 +1,31 @@ - - register_resource - - - void register_resource - string name - array resource_funcs - - - - Utilisée pour déclarer dynamiquement une ressource plugin - dans Smarty. Il faut passer en paramètre le nom de la ressource - et le tableau des fonctions PHP qui l'implémentent. Reportez-vous - a la section ressources templates - pour avoir plus d'informations sur la faton de paramétrer une fonction - récupérant des templates. - - -register_resource + + + register_resource + + + void register_resource + string name + array resource_funcs + + + + Utilisée pour déclarer dynamiquement une ressource plugin + dans Smarty. Il faut passer en paramètre le nom de la ressource + et le tableau des fonctions PHP qui l'implémentent. Reportez-vous + a la section ressources templates + pour avoir plus d'informations sur la faton de paramétrer une fonction + récupérant des templates. + + + register_resource $smarty->register_resource("db", array("db_get_template", "db_get_timestamp", "db_get_secure", "db_get_trusted")); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-template-exists.xml b/docs/fr/programmers/api-functions/api-template-exists.xml index 121685e2..eab9ed5a 100644 --- a/docs/fr/programmers/api-functions/api-template-exists.xml +++ b/docs/fr/programmers/api-functions/api-template-exists.xml @@ -1,18 +1,19 @@ - - template_exists - - - bool template_exists - string template - - - - Cette fonction vérifie si le template spécifié existe. Elle accepte - soit un chemin vers le template, soit une ressource de type - chaene de caractères précisant le nom du template. - + + + template_exists + + + bool template_exists + string template + + + + Cette fonction vérifie si le template spécifié existe. Elle accepte + soit un chemin vers le template, soit une ressource de type + chaene de caractères précisant le nom du template. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-trigger-error.xml b/docs/fr/programmers/api-functions/api-trigger-error.xml index d12612aa..80a600a4 100644 --- a/docs/fr/programmers/api-functions/api-trigger-error.xml +++ b/docs/fr/programmers/api-functions/api-trigger-error.xml @@ -1,21 +1,22 @@ - - trigger_error - - - void trigger_error - string error_msg - [int level] - - - - Cette fonction peut-être utilisée pour afficher un message d'erreur - en utilisant Smarty. Le paramètre level - peut prendre l'une des valeures utilisées par la fonction PHP - trigger_error, i.e. E_USER_NOTICE, E_USER_WARNING, etc. Par défaut - il s'agit de E_USER_WARNING. - + + + trigger_error + + + void trigger_error + string error_msg + [int level] + + + + Cette fonction peut-être utilisée pour afficher un message d'erreur + en utilisant Smarty. Le paramètre level + peut prendre l'une des valeures utilisées par la fonction PHP + trigger_error, i.e. E_USER_NOTICE, E_USER_WARNING, etc. Par défaut + il s'agit de E_USER_WARNING. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-unregister-block.xml b/docs/fr/programmers/api-functions/api-unregister-block.xml index dc687b94..58886b57 100644 --- a/docs/fr/programmers/api-functions/api-unregister-block.xml +++ b/docs/fr/programmers/api-functions/api-unregister-block.xml @@ -1,17 +1,18 @@ - - unregister_block - - - void unregister_block - string name - - - - Utilisée pour désallouer dynamiquement un plugin de fonction - de blocs. Passez en paramètre le nom du bloc. - + + + unregister_block + + + void unregister_block + string name + + + + Utilisée pour désallouer dynamiquement un plugin de fonction + de blocs. Passez en paramètre le nom du bloc. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-unregister-compiler-function.xml b/docs/fr/programmers/api-functions/api-unregister-compiler-function.xml index 08808c6d..7dcd835e 100644 --- a/docs/fr/programmers/api-functions/api-unregister-compiler-function.xml +++ b/docs/fr/programmers/api-functions/api-unregister-compiler-function.xml @@ -1,17 +1,18 @@ - - unregister_compiler_function - - - void unregister_compiler_function - string name - - - - Utilisée pour désallouer dynamiquement un fonction de compilation. - Passez en paramètre le nom de la fonction de compilation. - + + + unregister_compiler_function + + + void unregister_compiler_function + string name + + + + Utilisée pour désallouer dynamiquement un fonction de compilation. + Passez en paramètre le nom de la fonction de compilation. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-unregister-function.xml b/docs/fr/programmers/api-functions/api-unregister-function.xml index b42fedf1..1608cd46 100644 --- a/docs/fr/programmers/api-functions/api-unregister-function.xml +++ b/docs/fr/programmers/api-functions/api-unregister-function.xml @@ -1,25 +1,26 @@ - - unregister_function - - - void unregister_function - string name - - - - Utilisée pour désallouer dynamiquement un plugin de fonction - de templates. Passez en paramètres le nom de la fonction de templates. - - -unregister_function + + + unregister_function + + + void unregister_function + string name + + + + Utilisée pour désallouer dynamiquement un plugin de fonction + de templates. Passez en paramètres le nom de la fonction de templates. + + + unregister_function // nous ne voulons pas que les designers de templates aient accès // au système de fichiers. $smarty->unregister_function("fetch"); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-unregister-modifier.xml b/docs/fr/programmers/api-functions/api-unregister-modifier.xml index 9d87c716..5b1b4ae0 100644 --- a/docs/fr/programmers/api-functions/api-unregister-modifier.xml +++ b/docs/fr/programmers/api-functions/api-unregister-modifier.xml @@ -1,25 +1,26 @@ - - unregister_modifier - - - void unregister_modifier - string name - - - - Utilisée pour désallouer dynamiquement un plugin modificateur de variable. - Passez en paramètre le nom du modificateur de templates. - - -unregister_modifier + + + unregister_modifier + + + void unregister_modifier + string name + + + + Utilisée pour désallouer dynamiquement un plugin modificateur de variable. + Passez en paramètre le nom du modificateur de templates. + + + unregister_modifier // nous ne voulons pas que les designers de templates // suppriment les balises des élements $smarty->unregister_modifier("strip_tags"); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-unregister-object.xml b/docs/fr/programmers/api-functions/api-unregister-object.xml index 14aa002c..361c0b0d 100644 --- a/docs/fr/programmers/api-functions/api-unregister-object.xml +++ b/docs/fr/programmers/api-functions/api-unregister-object.xml @@ -1,16 +1,17 @@ - - unregister_object - - - void unregister_object - string object_name - - - - Utilisée pour désallouer un objet. - + + + unregister_object + + + void unregister_object + string object_name + + + + Utilisée pour désallouer un objet. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-unregister-outputfilter.xml b/docs/fr/programmers/api-functions/api-unregister-outputfilter.xml index be319ec8..5170628a 100644 --- a/docs/fr/programmers/api-functions/api-unregister-outputfilter.xml +++ b/docs/fr/programmers/api-functions/api-unregister-outputfilter.xml @@ -1,16 +1,17 @@ - - unregister_outputfilter - - - void unregister_outputfilter - string function_name - - - - Utilisée pour désallouer dynamiquement un filtre de sortie. - + + + unregister_outputfilter + + + void unregister_outputfilter + string function_name + + + + Utilisée pour désallouer dynamiquement un filtre de sortie. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-unregister-postfilter.xml b/docs/fr/programmers/api-functions/api-unregister-postfilter.xml index 894ceba1..247cf4bf 100644 --- a/docs/fr/programmers/api-functions/api-unregister-postfilter.xml +++ b/docs/fr/programmers/api-functions/api-unregister-postfilter.xml @@ -1,16 +1,17 @@ - - unregister_postfilter - - - void unregister_postfilter - string function_name - - - - Utilisée pour désallouer dynamiquement un filtre de post-compilation. - + + + unregister_postfilter + + + void unregister_postfilter + string function_name + + + + Utilisée pour désallouer dynamiquement un filtre de post-compilation. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-unregister-prefilter.xml b/docs/fr/programmers/api-functions/api-unregister-prefilter.xml index 2f62dedb..35f417b4 100644 --- a/docs/fr/programmers/api-functions/api-unregister-prefilter.xml +++ b/docs/fr/programmers/api-functions/api-unregister-prefilter.xml @@ -1,16 +1,17 @@ - - unregister_prefilter - - - void unregister_prefilter - string function_name - - - - Utilisée pour désallouer dynamiquement un filtre de pré-compilation. - + + + unregister_prefilter + + + void unregister_prefilter + string function_name + + + + Utilisée pour désallouer dynamiquement un filtre de pré-compilation. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-functions/api-unregister-resource.xml b/docs/fr/programmers/api-functions/api-unregister-resource.xml index c90c278e..7376d33c 100644 --- a/docs/fr/programmers/api-functions/api-unregister-resource.xml +++ b/docs/fr/programmers/api-functions/api-unregister-resource.xml @@ -1,22 +1,23 @@ - - unregister_resource - - - void unregister_resource - string name - - - - Utilisée pour désallouer dynamiquement un plugin ressource. - Passez en paramètre le nom de la ressource. - - -unregister_resource + + + unregister_resource + + + void unregister_resource + string name + + + + Utilisée pour désallouer dynamiquement un plugin ressource. + Passez en paramètre le nom de la ressource. + + + unregister_resource $smarty->unregister_resource("db"); - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables.xml b/docs/fr/programmers/api-variables.xml index 12a6af6f..3198f873 100644 --- a/docs/fr/programmers/api-variables.xml +++ b/docs/fr/programmers/api-variables.xml @@ -1,42 +1,43 @@ - - Variables - -&programmers.api-variables.variable-template-dir; -&programmers.api-variables.variable-compile-dir; -&programmers.api-variables.variable-config-dir; -&programmers.api-variables.variable-plugins-dir; -&programmers.api-variables.variable-debugging; -&programmers.api-variables.variable-debug-tpl; -&programmers.api-variables.variable-debugging-ctrl; -&programmers.api-variables.variable-global-assign; -&programmers.api-variables.variable-undefined; -&programmers.api-variables.variable-autoload-filters; -&programmers.api-variables.variable-compile-check; -&programmers.api-variables.variable-force-compile; -&programmers.api-variables.variable-caching; -&programmers.api-variables.variable-cache-dir; -&programmers.api-variables.variable-cache-lifetime; -&programmers.api-variables.variable-cache-handler-func; -&programmers.api-variables.variable-cache-modified-check; -&programmers.api-variables.variable-config-overwrite; -&programmers.api-variables.variable-config-booleanize; -&programmers.api-variables.variable-config-read-hidden; -&programmers.api-variables.variable-config-fix-newlines; -&programmers.api-variables.variable-default-template-handler-func; -&programmers.api-variables.variable-php-handling; -&programmers.api-variables.variable-security; -&programmers.api-variables.variable-secure-dir; -&programmers.api-variables.variable-security-settings; -&programmers.api-variables.variable-trusted-dir; -&programmers.api-variables.variable-left-delimiter; -&programmers.api-variables.variable-right-delimiter; -&programmers.api-variables.variable-compiler-class; -&programmers.api-variables.variable-request-vars-order; -&programmers.api-variables.variable-compile-id; -&programmers.api-variables.variable-use-sub-dirs; -&programmers.api-variables.variable-default-modifiers; + + + Variables + + &programmers.api-variables.variable-template-dir; + &programmers.api-variables.variable-compile-dir; + &programmers.api-variables.variable-config-dir; + &programmers.api-variables.variable-plugins-dir; + &programmers.api-variables.variable-debugging; + &programmers.api-variables.variable-debug-tpl; + &programmers.api-variables.variable-debugging-ctrl; + &programmers.api-variables.variable-global-assign; + &programmers.api-variables.variable-undefined; + &programmers.api-variables.variable-autoload-filters; + &programmers.api-variables.variable-compile-check; + &programmers.api-variables.variable-force-compile; + &programmers.api-variables.variable-caching; + &programmers.api-variables.variable-cache-dir; + &programmers.api-variables.variable-cache-lifetime; + &programmers.api-variables.variable-cache-handler-func; + &programmers.api-variables.variable-cache-modified-check; + &programmers.api-variables.variable-config-overwrite; + &programmers.api-variables.variable-config-booleanize; + &programmers.api-variables.variable-config-read-hidden; + &programmers.api-variables.variable-config-fix-newlines; + &programmers.api-variables.variable-default-template-handler-func; + &programmers.api-variables.variable-php-handling; + &programmers.api-variables.variable-security; + &programmers.api-variables.variable-secure-dir; + &programmers.api-variables.variable-security-settings; + &programmers.api-variables.variable-trusted-dir; + &programmers.api-variables.variable-left-delimiter; + &programmers.api-variables.variable-right-delimiter; + &programmers.api-variables.variable-compiler-class; + &programmers.api-variables.variable-request-vars-order; + &programmers.api-variables.variable-compile-id; + &programmers.api-variables.variable-use-sub-dirs; + &programmers.api-variables.variable-default-modifiers; - - $autoload_filters - - Si vous désirez charger des filtres a chaque invocation - de templates, vous pouvez le spécifier en utilisant cette - variable. Les types de filtres et les valeurs sont des - tableaux comportant le nom des filtres. - - + + + $autoload_filters + + Si vous désirez charger des filtres a chaque invocation + de templates, vous pouvez le spécifier en utilisant cette + variable. Les types de filtres et les valeurs sont des + tableaux comportant le nom des filtres. + + $smarty->autoload_filters = array('pre' => array('trim', 'stamp'), 'output' => array('convert')); - - + + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-cache-dir.xml b/docs/fr/programmers/api-variables/variable-cache-dir.xml index 101981bd..753a9992 100644 --- a/docs/fr/programmers/api-variables/variable-cache-dir.xml +++ b/docs/fr/programmers/api-variables/variable-cache-dir.xml @@ -1,27 +1,28 @@ - - $cache_dir - - Il s'agit du nom du répertoire oú les caches des templates - sont stockés. Par défaut il s'agit de "./cache", ce qui signifie - que Smarty va chercher ce répertoire - dans le même répertoire que le script PHP en cours d'exécution. - - - Note technique - - Ce réglage doit être soit un chemin absolu, soit un chemin - relatif. include_path n'a aucune influence lors de l'écriture des fichiers. - - - - Note technique - - Il n'est pas conseillé de mettre ce répertoire - dans l'arborescence Web. - - + + + $cache_dir + + Il s'agit du nom du répertoire oú les caches des templates + sont stockés. Par défaut il s'agit de "./cache", ce qui signifie + que Smarty va chercher ce répertoire + dans le même répertoire que le script PHP en cours d'exécution. + + + Note technique + + Ce réglage doit être soit un chemin absolu, soit un chemin + relatif. include_path n'a aucune influence lors de l'écriture des fichiers. + + + + Note technique + + Il n'est pas conseillé de mettre ce répertoire + dans l'arborescence Web. + + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-cache-handler-func.xml b/docs/fr/programmers/api-variables/variable-cache-handler-func.xml index 9ae60ced..e8f3c301 100644 --- a/docs/fr/programmers/api-variables/variable-cache-handler-func.xml +++ b/docs/fr/programmers/api-variables/variable-cache-handler-func.xml @@ -1,13 +1,14 @@ - - $cache_handler_func - - Vous pouvez utiliser votre propre fonction de gestion du cache plut(t que - d'utiliser celle livrée avec Smarty. - Référez-vous a la section sur la fonction de gestion de cache - personnalisée pour plus de détails. - + + + $cache_handler_func + + Vous pouvez utiliser votre propre fonction de gestion du cache plut(t que + d'utiliser celle livrée avec Smarty. + Référez-vous a la section sur la fonction de gestion de cache + personnalisée pour plus de détails. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-cache-lifetime.xml b/docs/fr/programmers/api-variables/variable-cache-lifetime.xml index ad1ea65d..20512c2b 100644 --- a/docs/fr/programmers/api-variables/variable-cache-lifetime.xml +++ b/docs/fr/programmers/api-variables/variable-cache-lifetime.xml @@ -1,55 +1,66 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - $cache_lifetime - - Il s'agit de la durée en secondes pendant laquelle un cache de template - est valide. Une fois cette durée dépassée, le cache est regénéré. - $caching doit être a "true" pour que $cache_lifetime ait une - quelconque utilité. Avec une valeur de -1, le cache n'expire jamais. - Avec une valeur de 0, le cache est toujours regénéré (utile - a des fins de tests seulement. Une meilleure faton de désactiver - le cache est de mettre $caching a "false"). - - - Si $force_compile est - activé, les fichiers du cache seront regénérés a chaque fois, - désactivant ainsi le cache. Vous pouvez effacer tous les fichiers du cache - avec la function - clear_all_cache() - ou de faton individuelle (ou groupée) - avec la fonction clear_cache(). - - - Note technique - - Si vous souhaitez donner a certains templates leur propre durée de vie - en cache, vous pouvez le faire en réglant - $caching a 2, - puis $cache_lifetime a une unique valeur juste avant d'appeler - display ou fetch(). - - - - \ No newline at end of file + + + $cache_lifetime + + Il s'agit de la durée en secondes pendant laquelle un cache de template + est valide. Une fois cette durée dépassée, le cache est regénéré. + $caching doit être a "true" pour que $cache_lifetime ait une + quelconque utilité. Avec une valeur de -1, le cache n'expire jamais. + Avec une valeur de 0, le cache est toujours regénéré (utile + a des fins de tests seulement. Une meilleure faton de désactiver + le cache est de mettre $caching a "false"). + + + Si $force_compile est + activé, les fichiers du cache seront regénérés a chaque fois, + désactivant ainsi le cache. Vous pouvez effacer tous les fichiers du cache + avec la function + clear_all_cache() + ou de faton individuelle (ou groupée) + avec la fonction clear_cache(). + + + Note technique + + Si vous souhaitez donner a certains templates leur propre durée de vie + en cache, vous pouvez le faire en réglant + $caching a 2, + puis $cache_lifetime a une unique valeur juste avant d'appeler + display ou fetch(). + + + + diff --git a/docs/fr/programmers/api-variables/variable-cache-modified-check.xml b/docs/fr/programmers/api-variables/variable-cache-modified-check.xml index 6d19bdc2..9dc7f34e 100644 --- a/docs/fr/programmers/api-variables/variable-cache-modified-check.xml +++ b/docs/fr/programmers/api-variables/variable-cache-modified-check.xml @@ -1,15 +1,16 @@ - - $cache_modified_check - - Si cette variable est a vrai, Smarty respectera l'en-tête - If-Modified-Since envoyé par le client. Si la date de derniére - modification du fichier de cache n'a pas changé depuis la derniére - visite, alors un en-tête "304 Not Modified" sera envoyé a la place - du contenu. Cela ne fonctionne qu'avec du contenu mis en cache hors de la - balise insert. - + + + $cache_modified_check + + Si cette variable est a vrai, Smarty respectera l'en-tête + If-Modified-Since envoyé par le client. Si la date de derniére + modification du fichier de cache n'a pas changé depuis la derniére + visite, alors un en-tête "304 Not Modified" sera envoyé a la place + du contenu. Cela ne fonctionne qu'avec du contenu mis en cache hors de la + balise insert. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-caching.xml b/docs/fr/programmers/api-variables/variable-caching.xml index 5c669cc6..233ea449 100644 --- a/docs/fr/programmers/api-variables/variable-caching.xml +++ b/docs/fr/programmers/api-variables/variable-caching.xml @@ -1,28 +1,29 @@ - - $caching - - Ce paramétre demande a Smarty de mettre ou non en cache la sortie des - templates. - Par défaut ce réglage est a 0 (désactivé). Si vos templates - générent du contenu redondant, il est conseillé d'activer le - cache. Cela permettra un gain de performance conséquent. - Vous pouvez aussi avoir de nombreux fichiers de cache pour un même template. - Une valeur de 1 ou 2 active le cache. 1 indique a Smarty d'utiliser - la variable $cache_lifetime pour déterminer si le fichier de cache a expiré. - Une valeur de 2 indique a Smarty d'utiliser la valeur - $cache_lifetime spécifiée a la génération du cache. Ainsi vous pouvez régler - la durée de vie d'un fichier de cache avant de récupérer le template pour avoir - un certain contr(le quand ce fichier en particulier expire. Voir - aussi is_cached. - - - Si $compile_check est actif, le contenu du cache sera regénéré - si un des templates ou un des fichiers de configuration qui fait partie - de ce fichier de cache a été modifié. Si $force_compile est actif, le contenu - du cache est toujours regénéré. - + + + $caching + + Ce paramétre demande a Smarty de mettre ou non en cache la sortie des + templates. + Par défaut ce réglage est a 0 (désactivé). Si vos templates + générent du contenu redondant, il est conseillé d'activer le + cache. Cela permettra un gain de performance conséquent. + Vous pouvez aussi avoir de nombreux fichiers de cache pour un même template. + Une valeur de 1 ou 2 active le cache. 1 indique a Smarty d'utiliser + la variable $cache_lifetime pour déterminer si le fichier de cache a expiré. + Une valeur de 2 indique a Smarty d'utiliser la valeur + $cache_lifetime spécifiée a la génération du cache. Ainsi vous pouvez régler + la durée de vie d'un fichier de cache avant de récupérer le template pour avoir + un certain contr(le quand ce fichier en particulier expire. Voir + aussi is_cached. + + + Si $compile_check est actif, le contenu du cache sera regénéré + si un des templates ou un des fichiers de configuration qui fait partie + de ce fichier de cache a été modifié. Si $force_compile est actif, le contenu + du cache est toujours regénéré. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-compile-check.xml b/docs/fr/programmers/api-variables/variable-compile-check.xml index 472fdeac..aa10ae5e 100644 --- a/docs/fr/programmers/api-variables/variable-compile-check.xml +++ b/docs/fr/programmers/api-variables/variable-compile-check.xml @@ -1,28 +1,29 @@ - - $compile_check - - A chaque invocation de l'application PHP, Smarty fait - un test pour voir si le template courant a été modifié - (date de derniére modification différente) depuis sa - derniére compilation. S'il a changé, le template est recompilé. - Si le template n'a pas encore été compilé, il le sera - quelle que soit la valeur ce réglage. - Par défaut cette valeur est a vrai. Quand - une application est mise en production (les templates - ne changent plus), cette vérification n'est pas nécessaire. - Assurez-vous de mettre $compile_check a "false" pour des performances - maximales. Notez que si vous mettez ce paramétre a "false" et qu'un - template est modifié, vous ne verrez *pas* le changement - car le template ne sera *pas* recompilé. Si le processus de cache - est activé et que $compile_check l'est aussi, alors les fichiers - du cache seront regénérés si un template concerné ou un fichier de - configuration concerné est modifié. Voir aussi $force_compile ou clear_compiled_tpl. - - + + + $compile_check + + A chaque invocation de l'application PHP, Smarty fait + un test pour voir si le template courant a été modifié + (date de derniére modification différente) depuis sa + derniére compilation. S'il a changé, le template est recompilé. + Si le template n'a pas encore été compilé, il le sera + quelle que soit la valeur ce réglage. + Par défaut cette valeur est a vrai. Quand + une application est mise en production (les templates + ne changent plus), cette vérification n'est pas nécessaire. + Assurez-vous de mettre $compile_check a "false" pour des performances + maximales. Notez que si vous mettez ce paramétre a "false" et qu'un + template est modifié, vous ne verrez *pas* le changement + car le template ne sera *pas* recompilé. Si le processus de cache + est activé et que $compile_check l'est aussi, alors les fichiers + du cache seront regénérés si un template concerné ou un fichier de + configuration concerné est modifié. Voir aussi $force_compile ou clear_compiled_tpl. + + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-compile-dir.xml b/docs/fr/programmers/api-variables/variable-compile-dir.xml index d89b7c35..51afba36 100644 --- a/docs/fr/programmers/api-variables/variable-compile-dir.xml +++ b/docs/fr/programmers/api-variables/variable-compile-dir.xml @@ -1,27 +1,28 @@ - - $compile_dir - - C'est le nom du répertoire oú se trouvent les templates - compilés. Par défaut, il s'agit de "./templates_c", - ce qui signifie que Smarty va chercher ce répertoire - dans le même répertoire que le script PHP en cours d'exécution. - - - Note technique - - Ce réglage doit être soit un chemin absolu, soit un chemin - relatif. include_path n'est pas utilisé pour écrire des fichiers. - - - - Note technique - - Il n'est pas conseillé de mettre ce répertoire - sous la racine de l'arborescence Web. - - + + + $compile_dir + + C'est le nom du répertoire oú se trouvent les templates + compilés. Par défaut, il s'agit de "./templates_c", + ce qui signifie que Smarty va chercher ce répertoire + dans le même répertoire que le script PHP en cours d'exécution. + + + Note technique + + Ce réglage doit être soit un chemin absolu, soit un chemin + relatif. include_path n'est pas utilisé pour écrire des fichiers. + + + + Note technique + + Il n'est pas conseillé de mettre ce répertoire + sous la racine de l'arborescence Web. + + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-compile-id.xml b/docs/fr/programmers/api-variables/variable-compile-id.xml index 5cba539a..f08b5677 100644 --- a/docs/fr/programmers/api-variables/variable-compile-id.xml +++ b/docs/fr/programmers/api-variables/variable-compile-id.xml @@ -1,12 +1,13 @@ - - $compile_id - - Identifiant persistant du compilateur. On peut passer le même compile_id - a chaque appel de fonction mais une alternative consiste a régler ce - compile_id, qui sera utilisé implicitement. - + + + $compile_id + + Identifiant persistant du compilateur. On peut passer le même compile_id + a chaque appel de fonction mais une alternative consiste a régler ce + compile_id, qui sera utilisé implicitement. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-compiler-class.xml b/docs/fr/programmers/api-variables/variable-compiler-class.xml index 76ae5ae8..f00fe5bb 100644 --- a/docs/fr/programmers/api-variables/variable-compiler-class.xml +++ b/docs/fr/programmers/api-variables/variable-compiler-class.xml @@ -1,12 +1,13 @@ - - $compiler_class - - Spécifie le nom de la classe du compilateur qui va être utilisée pour - compiler les templates. Le compilateur par défaut est - 'Smarty_Compiler'. Réservé aux utilisateurs avancés. - + + + $compiler_class + + Spécifie le nom de la classe du compilateur qui va être utilisée pour + compiler les templates. Le compilateur par défaut est + 'Smarty_Compiler'. Réservé aux utilisateurs avancés. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-config-booleanize.xml b/docs/fr/programmers/api-variables/variable-config-booleanize.xml index b687c151..2c755676 100644 --- a/docs/fr/programmers/api-variables/variable-config-booleanize.xml +++ b/docs/fr/programmers/api-variables/variable-config-booleanize.xml @@ -1,15 +1,16 @@ - - $config_booleanize - - Si cette variable est a vrai, les valeurs on/true/yes et off/false/no - dans les fichiers de configuration sont automitiquement converties - en booléen. De cette faton vous pouvez utiliser ces valeurs dans le - template de la faton suivante : {if #foobar#} ... {/if}. Si foobar - est a on, true ou yes, l'instruction {if} sera exécutée. vrai - par défaut. - + + + $config_booleanize + + Si cette variable est a vrai, les valeurs on/true/yes et off/false/no + dans les fichiers de configuration sont automitiquement converties + en booléen. De cette faton vous pouvez utiliser ces valeurs dans le + template de la faton suivante : {if #foobar#} ... {/if}. Si foobar + est a on, true ou yes, l'instruction {if} sera exécutée. vrai + par défaut. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-config-dir.xml b/docs/fr/programmers/api-variables/variable-config-dir.xml index fb72056b..9f90d42f 100644 --- a/docs/fr/programmers/api-variables/variable-config-dir.xml +++ b/docs/fr/programmers/api-variables/variable-config-dir.xml @@ -1,21 +1,22 @@ - - $config_dir - - Il s'agit du répertoire utilisé pour stocker les - fichiers de configuration utilisés dans les templates. - La valeur par défaut est "./configs", ce qui signifie - que Smarty va chercher ce répertoire - dans le même répertoire que le script PHP qui s'exécute. - - - Note technique - - Il n'est pas conseillé de mettre ce répertoire - sous la racine de l'arborescence Web. - - + + + $config_dir + + Il s'agit du répertoire utilisé pour stocker les + fichiers de configuration utilisés dans les templates. + La valeur par défaut est "./configs", ce qui signifie + que Smarty va chercher ce répertoire + dans le même répertoire que le script PHP qui s'exécute. + + + Note technique + + Il n'est pas conseillé de mettre ce répertoire + sous la racine de l'arborescence Web. + + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-config-fix-newlines.xml b/docs/fr/programmers/api-variables/variable-config-fix-newlines.xml index 3f9ca4c6..02d3697f 100644 --- a/docs/fr/programmers/api-variables/variable-config-fix-newlines.xml +++ b/docs/fr/programmers/api-variables/variable-config-fix-newlines.xml @@ -1,11 +1,12 @@ - - $config_fix_newlines - - Si cette variable est mise a vrai, les caractéres de nouvelles lignes mac et dos - (\r et \r\n) sont convertis en \n quand ils sont analysés. vrai par défaut. - + + + $config_fix_newlines + + Si cette variable est mise a vrai, les caractéres de nouvelles lignes mac et dos + (\r et \r\n) sont convertis en \n quand ils sont analysés. vrai par défaut. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-config-overwrite.xml b/docs/fr/programmers/api-variables/variable-config-overwrite.xml index c48c0f6b..b4c613b9 100644 --- a/docs/fr/programmers/api-variables/variable-config-overwrite.xml +++ b/docs/fr/programmers/api-variables/variable-config-overwrite.xml @@ -1,14 +1,15 @@ - - $config_overwrite - - Si cette variable est a vrai, les variables lues dans les fichiers - de configuration peuvent s'écraser entre elles. Sinon les variables - seront mises dans un tableau. Très utile si vous voulez stocker - des tableaux de données dans des fichiers de configuration, listez - simplement chaque élément plusieurs fois. Mise a faux par défaut. - + + + $config_overwrite + + Si cette variable est a vrai, les variables lues dans les fichiers + de configuration peuvent s'écraser entre elles. Sinon les variables + seront mises dans un tableau. Très utile si vous voulez stocker + des tableaux de données dans des fichiers de configuration, listez + simplement chaque élément plusieurs fois. Mise a faux par défaut. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-config-read-hidden.xml b/docs/fr/programmers/api-variables/variable-config-read-hidden.xml index 5cd52d7b..5f243b1e 100644 --- a/docs/fr/programmers/api-variables/variable-config-read-hidden.xml +++ b/docs/fr/programmers/api-variables/variable-config-read-hidden.xml @@ -1,16 +1,17 @@ - - $config_read_hidden - - Si cette variable est a vrai, les sections cachés (dont les noms - commencent par un point) dans les fichiers de configuration peuvent - être lues depuis les templates. On laisse habituellement cela a faux, de - cette faton vous pouvez stocker des données sensibles dans les fichiers - de configuration, comme par exemple des paramétres de base de données, - sans vous soucier de la faton dont les templates les chargent. - Mise a faux par défaut. - + + + $config_read_hidden + + Si cette variable est a vrai, les sections cachés (dont les noms + commencent par un point) dans les fichiers de configuration peuvent + être lues depuis les templates. On laisse habituellement cela a faux, de + cette faton vous pouvez stocker des données sensibles dans les fichiers + de configuration, comme par exemple des paramétres de base de données, + sans vous soucier de la faton dont les templates les chargent. + Mise a faux par défaut. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-debug-tpl.xml b/docs/fr/programmers/api-variables/variable-debug-tpl.xml index b4a80a8f..d25cbb93 100644 --- a/docs/fr/programmers/api-variables/variable-debug-tpl.xml +++ b/docs/fr/programmers/api-variables/variable-debug-tpl.xml @@ -1,12 +1,13 @@ - - $debug_tpl - - C'est le nom du fichier template utilisé pour la - console de débuggage. Par défaut debug.tpl, il se situe dans SMARTY_DIR - + + + $debug_tpl + + C'est le nom du fichier template utilisé pour la + console de débuggage. Par défaut debug.tpl, il se situe dans SMARTY_DIR + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-debugging-ctrl.xml b/docs/fr/programmers/api-variables/variable-debugging-ctrl.xml index e605cdd7..188be12c 100644 --- a/docs/fr/programmers/api-variables/variable-debugging-ctrl.xml +++ b/docs/fr/programmers/api-variables/variable-debugging-ctrl.xml @@ -1,14 +1,15 @@ - - $debugging_ctrl - - Cela permet d'avoir différents moyens pour activer - le débogage. URL signifie que si SMARTY_DEBUG se - trouve dans QUERY_STRING, le débuggage - est activé a l'invocation du script. Si $debugging - est a vrai, cette valeur est sans effet. - + + + $debugging_ctrl + + Cela permet d'avoir différents moyens pour activer + le débogage. URL signifie que si SMARTY_DEBUG se + trouve dans QUERY_STRING, le débuggage + est activé a l'invocation du script. Si $debugging + est a vrai, cette valeur est sans effet. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-debugging.xml b/docs/fr/programmers/api-variables/variable-debugging.xml index 595df152..fb76cccb 100644 --- a/docs/fr/programmers/api-variables/variable-debugging.xml +++ b/docs/fr/programmers/api-variables/variable-debugging.xml @@ -1,32 +1,33 @@ - - $debugging - - Cela active la - console de débogage. - La console est une fenêtre javascript qui vous informe des templates - inclus et des variables assignées dans la page courante. - - - \ No newline at end of file + + + $debugging + + Cela active la + console de débogage. + La console est une fenêtre javascript qui vous informe des templates + inclus et des variables assignées dans la page courante. + + + diff --git a/docs/fr/programmers/api-variables/variable-default-modifiers.xml b/docs/fr/programmers/api-variables/variable-default-modifiers.xml index 499b0ab3..9586674a 100644 --- a/docs/fr/programmers/api-variables/variable-default-modifiers.xml +++ b/docs/fr/programmers/api-variables/variable-default-modifiers.xml @@ -1,15 +1,16 @@ - - $default_modifiers - - Il s'agit d'un tableau de modificateurs utilisé pour assigner - une valeur par défaut a chaque variable dans un template. - Par exemple, pour par défaut échapper les caractéres HTML de chaque variable, - utilisez array('escape:"htmlall"'); Pour rendre une variable indépendante - des modificateurs par défaut, passez-lui en paramétre le modificateur - "nodefaults" : {$var|nodefaults}. - + + + $default_modifiers + + Il s'agit d'un tableau de modificateurs utilisé pour assigner + une valeur par défaut a chaque variable dans un template. + Par exemple, pour par défaut échapper les caractéres HTML de chaque variable, + utilisez array('escape:"htmlall"'); Pour rendre une variable indépendante + des modificateurs par défaut, passez-lui en paramétre le modificateur + "nodefaults" : {$var|nodefaults}. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-default-resource-type.xml b/docs/fr/programmers/api-variables/variable-default-resource-type.xml index e0ea1043..67bdfd3e 100644 --- a/docs/fr/programmers/api-variables/variable-default-resource-type.xml +++ b/docs/fr/programmers/api-variables/variable-default-resource-type.xml @@ -8,25 +8,25 @@ par défaut est 'file', signifiant que $smarty->display('index.tpl'); et $smarty->display('file:index.tpl'); sont la même chose. Voyez le chapitre ressource pour plus de détails. - - - + + + diff --git a/docs/fr/programmers/api-variables/variable-default-template-handler-func.xml b/docs/fr/programmers/api-variables/variable-default-template-handler-func.xml index 6f7f8593..252b06f5 100644 --- a/docs/fr/programmers/api-variables/variable-default-template-handler-func.xml +++ b/docs/fr/programmers/api-variables/variable-default-template-handler-func.xml @@ -1,11 +1,12 @@ - - $default_template_handler_func - - Cette fonction est appelée quand un template ne peut pas être - obtenu avec sa ressource. - + + + $default_template_handler_func + + Cette fonction est appelée quand un template ne peut pas être + obtenu avec sa ressource. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-error-reporting.xml b/docs/fr/programmers/api-variables/variable-error-reporting.xml index 8318c2e7..a9ba5b4a 100644 --- a/docs/fr/programmers/api-variables/variable-error-reporting.xml +++ b/docs/fr/programmers/api-variables/variable-error-reporting.xml @@ -2,7 +2,7 @@ -$error_reporting + $error_reporting Lorsque cette valeur est configurée à une valeur non nulle, sa valeur est utilisée comme le error_reporting-level de PHP diff --git a/docs/fr/programmers/api-variables/variable-force-compile.xml b/docs/fr/programmers/api-variables/variable-force-compile.xml index 21d24960..ffaa7b79 100644 --- a/docs/fr/programmers/api-variables/variable-force-compile.xml +++ b/docs/fr/programmers/api-variables/variable-force-compile.xml @@ -1,15 +1,16 @@ - - $force_compile - - Cela oblige Smarty a (re)compiler les templates a chaque - invocation. Ce réglage supplante $compile_check. Par défaut, il - est désactivé. Ceci est commode pour le développement et le - débogage mais ne devrait jamais être utilisé dans un environnment - de production. Si le systéme de cache est actif, les - fichiers du cache seront regénérés a chaque appel. - + + + $force_compile + + Cela oblige Smarty a (re)compiler les templates a chaque + invocation. Ce réglage supplante $compile_check. Par défaut, il + est désactivé. Ceci est commode pour le développement et le + débogage mais ne devrait jamais être utilisé dans un environnment + de production. Si le systéme de cache est actif, les + fichiers du cache seront regénérés a chaque appel. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-global-assign.xml b/docs/fr/programmers/api-variables/variable-global-assign.xml index 194bd501..4b290edf 100644 --- a/docs/fr/programmers/api-variables/variable-global-assign.xml +++ b/docs/fr/programmers/api-variables/variable-global-assign.xml @@ -1,47 +1,48 @@ - - $global_assign - - C'est une liste de variable qui sont toujours - implicitement assignées au moteur de templates. - Ceci est commode pour rendre des variables globales - ou des variables du serveur accessibles a tous les templates - plut(t que de devoir les assigner a la main. Chaque élément - de $global_assign doit être soit le nom de la variable - globale, soit une paire clef/valeur, oú clef est le - nom du tableau global et valeur le tableau de variable - assignées depuis ce tableau global. - $SCRIPT_NAME est globalement assigné par défaut depuis - $HTTP_SERVER_VARS. - - - Note technique - - On peut accéder aux variables du serveur avec la variable - $smarty, par exemple {$smarty.server.SCRIPT_NAME}. - Se reporter a la section sur la variable - $smarty. - - - - \ No newline at end of file + + + $global_assign + + C'est une liste de variable qui sont toujours + implicitement assignées au moteur de templates. + Ceci est commode pour rendre des variables globales + ou des variables du serveur accessibles a tous les templates + plut(t que de devoir les assigner a la main. Chaque élément + de $global_assign doit être soit le nom de la variable + globale, soit une paire clef/valeur, oú clef est le + nom du tableau global et valeur le tableau de variable + assignées depuis ce tableau global. + $SCRIPT_NAME est globalement assigné par défaut depuis + $HTTP_SERVER_VARS. + + + Note technique + + On peut accéder aux variables du serveur avec la variable + $smarty, par exemple {$smarty.server.SCRIPT_NAME}. + Se reporter a la section sur la variable + $smarty. + + + + diff --git a/docs/fr/programmers/api-variables/variable-left-delimiter.xml b/docs/fr/programmers/api-variables/variable-left-delimiter.xml index 13ac4274..bdf5b770 100644 --- a/docs/fr/programmers/api-variables/variable-left-delimiter.xml +++ b/docs/fr/programmers/api-variables/variable-left-delimiter.xml @@ -1,11 +1,12 @@ - - $left_delimiter - - Il s'agit du délimiteur gauche utilisé par le moteur de templates. La - valeur par défaut est "{". - + + + $left_delimiter + + Il s'agit du délimiteur gauche utilisé par le moteur de templates. La + valeur par défaut est "{". + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-php-handling.xml b/docs/fr/programmers/api-variables/variable-php-handling.xml index ab1b6c87..586304db 100644 --- a/docs/fr/programmers/api-variables/variable-php-handling.xml +++ b/docs/fr/programmers/api-variables/variable-php-handling.xml @@ -1,49 +1,54 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - $php_handling - - Indique a Smarty comment interpréter le code PHP - intégré dans les templates. Il y a quatre valeurs possibles, par - défaut SMARTY_PHP_PASSTHRU. Notez que cela n'affecte PAS le code - PHP entouré des balises - {php}{/php} - dans le template. - - - SMARTY_PHP_PASSTHRU - Smarty écrit les balises - telles quelles. - SMARTY_PHP_QUOTE - Smarty transforme les balises - en entités HTML. - SMARTY_PHP_REMOVE - Smarty supprime les balises - des templates. - SMARTY_PHP_ALLOW - Smarty exécute les balises - comme du code PHP. - - - NOTE : Intégrer du code PHP dans les templates est vivement - déconseillé. Préférez les - fonctions utilisateurs - ou les modificateurs de variables. - - - \ No newline at end of file + + + $php_handling + + Indique a Smarty comment interpréter le code PHP + intégré dans les templates. Il y a quatre valeurs possibles, par + défaut SMARTY_PHP_PASSTHRU. Notez que cela n'affecte PAS le code + PHP entouré des balises + {php}{/php} + dans le template. + + + SMARTY_PHP_PASSTHRU - Smarty écrit les balises + telles quelles. + SMARTY_PHP_QUOTE - Smarty transforme les balises + en entités HTML. + SMARTY_PHP_REMOVE - Smarty supprime les balises + des templates. + SMARTY_PHP_ALLOW - Smarty exécute les balises + comme du code PHP. + + + NOTE : Intégrer du code PHP dans les templates est vivement + déconseillé. Préférez les + fonctions utilisateurs + ou les modificateurs de variables. + + + diff --git a/docs/fr/programmers/api-variables/variable-plugins-dir.xml b/docs/fr/programmers/api-variables/variable-plugins-dir.xml index 5f0bea40..ede0cd3a 100644 --- a/docs/fr/programmers/api-variables/variable-plugins-dir.xml +++ b/docs/fr/programmers/api-variables/variable-plugins-dir.xml @@ -1,23 +1,24 @@ - - $plugins_dir - - Ce sont les répertoire dans lesquels Smarty ira chercher les plugins - dont il a besoin. La valeur par défaut est "plugins" sous le - répertoire SMARTY_DIR. Si vous donnez un chemin relatif, Smarty - regardera d'abord relativement au SMARTY_DIR, puis relativement au rtc (répertoire - de travail courant), puis relativement a chaque entrée de votre répertoire - d'inclusion PHP. - - - Note technique - - Pour des raisons de performances, ne réglez pas votre plugins_dir - pour qu'il utilise votre include_path PHP. Utilisez un - chemin absolu ou un chemin relatif a SMARTY_DIR ou au rtc. - - + + + $plugins_dir + + Ce sont les répertoire dans lesquels Smarty ira chercher les plugins + dont il a besoin. La valeur par défaut est "plugins" sous le + répertoire SMARTY_DIR. Si vous donnez un chemin relatif, Smarty + regardera d'abord relativement au SMARTY_DIR, puis relativement au rtc (répertoire + de travail courant), puis relativement a chaque entrée de votre répertoire + d'inclusion PHP. + + + Note technique + + Pour des raisons de performances, ne réglez pas votre plugins_dir + pour qu'il utilise votre include_path PHP. Utilisez un + chemin absolu ou un chemin relatif a SMARTY_DIR ou au rtc. + + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-request-use-auto-globals.xml b/docs/fr/programmers/api-variables/variable-request-use-auto-globals.xml index 793bd5f3..dc36d004 100644 --- a/docs/fr/programmers/api-variables/variable-request-use-auto-globals.xml +++ b/docs/fr/programmers/api-variables/variable-request-use-auto-globals.xml @@ -1,3 +1,45 @@ + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 @@ -10,9 +52,9 @@ qui utilisent {$smarty.request.*}, {$smarty.get.*} etc. . Attention: Si vous configurez $request_use_auto_globals à true, variable.request.vars.order - n'a plus d'effets et la valeur de la directive de configuration - gpc_order de PHP est utilisée. - + n'a plus d'effets et la valeur de la directive de configuration + gpc_order de PHP est utilisée. + - - $request_vars_order - - L'ordre dans lequel les variables de requêtes sont enregistrées, - identique a variables_order dans php.ini. - + + + $request_vars_order + + L'ordre dans lequel les variables de requêtes sont enregistrées, + identique a variables_order dans php.ini. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-right-delimiter.xml b/docs/fr/programmers/api-variables/variable-right-delimiter.xml index 32539a59..3a17aefb 100644 --- a/docs/fr/programmers/api-variables/variable-right-delimiter.xml +++ b/docs/fr/programmers/api-variables/variable-right-delimiter.xml @@ -1,11 +1,12 @@ - - $right_delimiter - - Il s'agit du délimiteur droit utilisé par le moteur de templates. - La valeur par défaut est "}". - + + + $right_delimiter + + Il s'agit du délimiteur droit utilisé par le moteur de templates. + La valeur par défaut est "}". + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-secure-dir.xml b/docs/fr/programmers/api-variables/variable-secure-dir.xml index f918a5f4..e700f6be 100644 --- a/docs/fr/programmers/api-variables/variable-secure-dir.xml +++ b/docs/fr/programmers/api-variables/variable-secure-dir.xml @@ -1,12 +1,13 @@ - - $secure_dir - - Il s'agit d'un tableau contenant tous les répertoires locaux qui sont - considérés comme sécurisés. {include} et {fetch} l'utilisent quand - la sécurité est activée. - + + + $secure_dir + + Il s'agit d'un tableau contenant tous les répertoires locaux qui sont + considérés comme sécurisés. {include} et {fetch} l'utilisent quand + la sécurité est activée. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-security-settings.xml b/docs/fr/programmers/api-variables/variable-security-settings.xml index ba8da3f9..8ecb6556 100644 --- a/docs/fr/programmers/api-variables/variable-security-settings.xml +++ b/docs/fr/programmers/api-variables/variable-security-settings.xml @@ -1,24 +1,25 @@ - - $security_settings - - Ces réglages servent à écraser ou spécifier les paramétres de sécurité - quand celle-ci est activée. Les réglages possibles sont les suivants : - - - PHP_HANDLING - true/false. Si vrai, le - réglage $php_handling n'est pas vérifié. - IF_FUNCS - Le tableau des noms de fonctions - PHP autorisées dans les intructions IF. - INCLUDE_ANY - true/false. Si vrai, - les templates peuvent être inclus de n'importe oú, quelque soit - le contenu de $secure_dir. - PHP_TAGS - true/false. Si vrai, - les balises {php}{/php} sont autorisées dans les templates. - MODIFIER_FUNCS - Le tableau des noms de fonctions - autorisées a être utilisées comme modificateurs de variables. - + + + $security_settings + + Ces réglages servent à écraser ou spécifier les paramétres de sécurité + quand celle-ci est activée. Les réglages possibles sont les suivants : + + + PHP_HANDLING - true/false. Si vrai, le + réglage $php_handling n'est pas vérifié. + IF_FUNCS - Le tableau des noms de fonctions + PHP autorisées dans les intructions IF. + INCLUDE_ANY - true/false. Si vrai, + les templates peuvent être inclus de n'importe oú, quelque soit + le contenu de $secure_dir. + PHP_TAGS - true/false. Si vrai, + les balises {php}{/php} sont autorisées dans les templates. + MODIFIER_FUNCS - Le tableau des noms de fonctions + autorisées a être utilisées comme modificateurs de variables. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-security.xml b/docs/fr/programmers/api-variables/variable-security.xml index aea1fefb..e6619f47 100644 --- a/docs/fr/programmers/api-variables/variable-security.xml +++ b/docs/fr/programmers/api-variables/variable-security.xml @@ -1,31 +1,32 @@ - - $security - - Cette variable est a faux par défaut. $security est de rigueur - quand vous n'Otes pas complétement svr des personnes qui éditent les templates - (par ftp par exemple) et que vous voulez réduire le risque que - la sécurité du systéme soit compromise par le language de template. - Activer cette option de sécurité applique les régles suivantes - au langage de template, a moins que $security_settings ne spécifie - le contraire : - - - Si $php_handling est réglée a SMARTY_PHP_ALLOW, - cela est implicitement changé a SMARTY_PHP_PASSTHRU. - Les fonctions PHP ne sont pas autorisées dans les - instructions IF, a part celles déclarées dans - $security_settings. - Les templates ne peuvent être inclus que depuis - des répertoires listés dans le tableau $security_dir. - Les fichiers locaux ne peuvent être récupérés que depuis - les répertoires listés dans le tableau $security_dir en - utilisant {fetch}. - Les balises {php}{/php} ne sont pas autorisées. - Les fonctions PHP ne sont pas autorisées en tant - modificateurs, a part celles spécifiées dans $security_settings. - + + + $security + + Cette variable est a faux par défaut. $security est de rigueur + quand vous n'Otes pas complétement svr des personnes qui éditent les templates + (par ftp par exemple) et que vous voulez réduire le risque que + la sécurité du systéme soit compromise par le language de template. + Activer cette option de sécurité applique les régles suivantes + au langage de template, a moins que $security_settings ne spécifie + le contraire : + + + Si $php_handling est réglée a SMARTY_PHP_ALLOW, + cela est implicitement changé a SMARTY_PHP_PASSTHRU. + Les fonctions PHP ne sont pas autorisées dans les + instructions IF, a part celles déclarées dans + $security_settings. + Les templates ne peuvent être inclus que depuis + des répertoires listés dans le tableau $security_dir. + Les fichiers locaux ne peuvent être récupérés que depuis + les répertoires listés dans le tableau $security_dir en + utilisant {fetch}. + Les balises {php}{/php} ne sont pas autorisées. + Les fonctions PHP ne sont pas autorisées en tant + modificateurs, a part celles spécifiées dans $security_settings. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-template-dir.xml b/docs/fr/programmers/api-variables/variable-template-dir.xml index 8185fecf..ff7f64a4 100644 --- a/docs/fr/programmers/api-variables/variable-template-dir.xml +++ b/docs/fr/programmers/api-variables/variable-template-dir.xml @@ -1,23 +1,24 @@ - - $template_dir - - C'est le nom par défaut du répertoire des templates. - Si vous ne spécifiez aucun chemin lors de l'utilisation de templates, Smarty - les cherchera a cet emplacement. - Par défaut, il s'agit de "./templates", ce qui signifie - qu'il va chercher le répertoire templates - dans le répertoire oú se trouve le script PHP en cours d'exécution. - - - - Note technique - - Il n'est pas conseillé de mettre ce répertoire - dans l'arborescence Web. - - + + + $template_dir + + C'est le nom par défaut du répertoire des templates. + Si vous ne spécifiez aucun chemin lors de l'utilisation de templates, Smarty + les cherchera a cet emplacement. + Par défaut, il s'agit de "./templates", ce qui signifie + qu'il va chercher le répertoire templates + dans le répertoire oú se trouve le script PHP en cours d'exécution. + + + + Note technique + + Il n'est pas conseillé de mettre ce répertoire + dans l'arborescence Web. + + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-trusted-dir.xml b/docs/fr/programmers/api-variables/variable-trusted-dir.xml index 68ee3544..f673d28b 100644 --- a/docs/fr/programmers/api-variables/variable-trusted-dir.xml +++ b/docs/fr/programmers/api-variables/variable-trusted-dir.xml @@ -1,32 +1,33 @@ - - $trusted_dir - - $trusted_dir n'est utilisée lorsque $security est activée. C'est un - tableau de tous les répertoires qui peuvent être considérés comme svrs. - Les répertoires svrs sont ceux qui contiennent des scripts PHP qui - sont exécutés directement depuis les templates avec - {include_php}. - - - \ No newline at end of file + + + $trusted_dir + + $trusted_dir n'est utilisée lorsque $security est activée. C'est un + tableau de tous les répertoires qui peuvent être considérés comme svrs. + Les répertoires svrs sont ceux qui contiennent des scripts PHP qui + sont exécutés directement depuis les templates avec + {include_php}. + + + diff --git a/docs/fr/programmers/api-variables/variable-undefined.xml b/docs/fr/programmers/api-variables/variable-undefined.xml index dafc23d9..adfe9f27 100644 --- a/docs/fr/programmers/api-variables/variable-undefined.xml +++ b/docs/fr/programmers/api-variables/variable-undefined.xml @@ -1,13 +1,14 @@ - - $undefined - - Cela régle la valeur de $undefined, null par défaut. - N'est actuellement utilisé que pour initialiser - des variables non-définies dans $global_assign a des - valeurs par défaut. - + + + $undefined + + Cela régle la valeur de $undefined, null par défaut. + N'est actuellement utilisé que pour initialiser + des variables non-définies dans $global_assign a des + valeurs par défaut. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/api-variables/variable-use-sub-dirs.xml b/docs/fr/programmers/api-variables/variable-use-sub-dirs.xml index ef75404c..df90d633 100644 --- a/docs/fr/programmers/api-variables/variable-use-sub-dirs.xml +++ b/docs/fr/programmers/api-variables/variable-use-sub-dirs.xml @@ -1,12 +1,13 @@ - - $use_sub_dirs - - Régler cela a faux si votre environnement PHP n'autorise pas Smarty a créer - des sous-répertoires. Les sous-répertoires sont efficaces, utilisez-les quand - vous le pouvez. - + + + $use_sub_dirs + + Régler cela a faux si votre environnement PHP n'autorise pas Smarty a créer + des sous-répertoires. Les sous-répertoires sont efficaces, utilisez-les quand + vous le pouvez. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/caching.xml b/docs/fr/programmers/caching.xml index 9143579c..7f6d1c2b 100644 --- a/docs/fr/programmers/caching.xml +++ b/docs/fr/programmers/caching.xml @@ -1,32 +1,33 @@ - - Cache - - Le cache est utilisée pour accélérer l'appel de display() ou de fetch() en sauvegardant leur résultat - dans un fichier. Si un fichier de cache est disponible lors d'un appel, - il sera affiché sans qu'il ne soit nécessaire de regénérer le résultat. - Le systéme de cache - peut accélérer les traitements de faton impressionnante, en particulier les - templates dont la compilation est trés longue. Comme le résultat de - display() ou de fetch() est dans le cache, un fichier de cache peut - être composé de plusieurs fichiers de templates, plusieurs fichiers - de configuration, etc. - - - Comme les templates sont dynamiques, il est important de faire attention - a la faton dont les fichiers de cache sont générés, et pour combien de temps. - Si par exemple vous affichez la page d'accueil de votre site Web dont le - contenu ne change pas souvent, il peut être intéressant de mettre cette page - dans le cache pour une heure ou plus. A l'inverse, si vous affichez une page - de météo mises a jour toutes les minutes, mettre cette page en cache - n'a aucun sens. - -&programmers.caching.caching-setting-up; -&programmers.caching.caching-multiple-caches; -&programmers.caching.caching-groups; + + + Cache + + Le cache est utilisée pour accélérer l'appel de display() ou de fetch() en sauvegardant leur résultat + dans un fichier. Si un fichier de cache est disponible lors d'un appel, + il sera affiché sans qu'il ne soit nécessaire de regénérer le résultat. + Le systéme de cache + peut accélérer les traitements de faton impressionnante, en particulier les + templates dont la compilation est trés longue. Comme le résultat de + display() ou de fetch() est dans le cache, un fichier de cache peut + être composé de plusieurs fichiers de templates, plusieurs fichiers + de configuration, etc. + + + Comme les templates sont dynamiques, il est important de faire attention + a la faton dont les fichiers de cache sont générés, et pour combien de temps. + Si par exemple vous affichez la page d'accueil de votre site Web dont le + contenu ne change pas souvent, il peut être intéressant de mettre cette page + dans le cache pour une heure ou plus. A l'inverse, si vous affichez une page + de météo mises a jour toutes les minutes, mettre cette page en cache + n'a aucun sens. + + &programmers.caching.caching-setting-up; + &programmers.caching.caching-multiple-caches; + &programmers.caching.caching-groups; - - Contrôler la mise en cache des sorties des Plugins - - Depuis Smarty-2.6.0, la mise en cache des plugins peut être déclarée lors - de leur inscription. Les troisièmes paramètres de register_block, - register_compiler_function et register_function sont appelés - $cacheable et valent true par défaut, ce qui est - aussi le comportement par défaut des versions de Smarty précédent la 2.6.0 + + Contrôler la mise en cache des sorties des Plugins + + Depuis Smarty-2.6.0, la mise en cache des plugins peut être déclarée lors + de leur inscription. Les troisièmes paramètres de register_block, + register_compiler_function et register_function sont appelés + $cacheable et valent true par défaut, ce qui est + aussi le comportement par défaut des versions de Smarty précédent la 2.6.0 + + + + Lors de l'inscription d'un plugin avec $cacheable=false, le plugin est + appelé à chaque fois que la page est affichée, même si la page vient du + cache. La fonction plugin se comporte presque comme la fonction + insert. - - - Lors de l'inscription d'un plugin avec $cacheable=false, le plugin est - appelé à chaque fois que la page est affichée, même si la page vient du - cache. La fonction plugin se comporte presque comme la fonction - insert. - - + Contrairement à {insert} les attributs pour le plugin ne sont pas mis en cache par défaut. Cela peut être le cas en utilisant le quatrième paramètre $cache_attrs. $cache_attrs - est un tableau de noms d'attributs qui doivent être mis en cache, pour que + est un tableau de noms d'attributs qui doivent être mis en cache, pour que la fonction plugin reçoive les valeurs telles qu'elles étaient définies lorsque la page a été mise en cache, à chaque récupération à partir du cache. - + Eviter la mise en cache du résultat d'un plugin @@ -66,12 +66,12 @@ Time Remaining: {remain endtime=$obj->endtime} Le nombre de secondes avant que la date de fin de $obj ne soit atteinte change à chaque affichage de la page, même si la page est mise en cache. Comme l'attribut - endtime est mis en cache, il n'y a que l'objet qui ait besoin d'être extrait de la + endtime est mis en cache, il n'y a que l'objet qui ait besoin d'être extrait de la base de données lors de la mise en cache de la page, mais pas lors des affichages ultérieurs de la page. - + Eviter la mise en cache d'une portion du template @@ -110,29 +110,29 @@ Now is: {"0"|date_format:"%D %H:%M:%S"} Lors du rechargement de la page, vous remarquerez que les deux dates sont différentes. L'une est "dynamique" et l'autre est "statique". Vous pouvez faire ce que vous voulez - entre {dynamic}...{/dynamic} et être sûrs que cela ne sera pas mis en cache comme le + entre {dynamic}...{/dynamic} et être sûrs que cela ne sera pas mis en cache comme le reste de la page. - + diff --git a/docs/fr/programmers/caching/caching-groups.xml b/docs/fr/programmers/caching/caching-groups.xml index 68e3cf6e..95a3dae4 100644 --- a/docs/fr/programmers/caching/caching-groups.xml +++ b/docs/fr/programmers/caching/caching-groups.xml @@ -1,16 +1,17 @@ - - groupes de fichiers de cache - - Vous pouvez faire des groupements plus élaborés en paramétrant les - groupes d'identifiant de cache. Il suffit de séparer chaque sous-groupes - avec une barre verticale "|" dans la valeur de l'identifiant de cache. - Vous pouvez faire autant de sous-groupes que vous le désirez. - - - groupes d'identifiants de cache - + + + groupes de fichiers de cache + + Vous pouvez faire des groupements plus élaborés en paramétrant les + groupes d'identifiant de cache. Il suffit de séparer chaque sous-groupes + avec une barre verticale "|" dans la valeur de l'identifiant de cache. + Vous pouvez faire autant de sous-groupes que vous le désirez. + + + groupes d'identifiants de cache + require('Smarty.class.php'); $smarty = new Smarty; @@ -25,10 +26,10 @@ $smarty->clear_cache(null,"sports|basketball"); $smarty->clear_cache(null,"sports"); $smarty->display('index.tpl',"sports|basketball"); - - - Note technique - + + + Note technique + Le systéme de cache n'utilise PAS le chemin vers le template en quoi que ce soit pour l'identifiant de cache. Si par exemple vous faites display('themes/blue/index.tpl'), vous ne pouvez pas effacer tous @@ -36,8 +37,8 @@ $smarty->display('index.tpl',"sports|basketball"); faire cela, vous devez les grouper avec un même identifiant de cache, display('themes/blue/index.tpl','themes|blue'). Vous pouvez ensuite effacer les fichiers de cache pour blue et theme avec clear_cache(null,'theme|blue'). - - + + \ No newline at end of file +--> diff --git a/docs/fr/programmers/caching/caching-multiple-caches.xml b/docs/fr/programmers/caching/caching-multiple-caches.xml index 19e7f5b1..a3201fc5 100644 --- a/docs/fr/programmers/caching/caching-multiple-caches.xml +++ b/docs/fr/programmers/caching/caching-multiple-caches.xml @@ -1,18 +1,21 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - Caches multiples pour une seule page - - Vous pouvez avoir plusieurs fichiers de caches pour un même appel - aux fonctions display() ou fetch(). Imaginons qu'un appel a display('index.tpl') - puisse avoir plusieurs résultats, en fonction de certaines conditions, et que - vous vouliez des fichiers de cache séparés pour chacun d'eux. Vous - pouvez faire cela en passant un identifiant de cache (cache_id) en - deuxiéme paramétre a l'appel de fonction. - - - Passage d'un cache_id a display() - + + + Caches multiples pour une seule page + + Vous pouvez avoir plusieurs fichiers de caches pour un même appel + aux fonctions display() ou fetch(). Imaginons qu'un appel a display('index.tpl') + puisse avoir plusieurs résultats, en fonction de certaines conditions, et que + vous vouliez des fichiers de cache séparés pour chacun d'eux. Vous + pouvez faire cela en passant un identifiant de cache (cache_id) en + deuxiéme paramétre a l'appel de fonction. + + + Passage d'un cache_id a display() + require('Smarty.class.php'); $smarty = new Smarty; @@ -21,39 +24,39 @@ $smarty->caching = true; $my_cache_id = $_GET['article_id']; $smarty->display('index.tpl',$my_cache_id); - - - Nous passons ci-dessus la variable $my_cache_id a display() comme - identifiant de cache. Pour chaque valeur distincte de $my_cache_id, - un fichier de cache distinct va être créé. Dans cet exemple, - "article_id" a été passé dans l'URL et est utilisé en tant qu'identifiant - de cache. - - - Note technique - - Soyez prudent en passant des valeurs depuis un client (navigateur Web) - vers Smarty (ou vers n'importe quelle application PHP). Bien que l'exemple - ci-dessus consistant a utiliser article_id depuis l'URL puisse paraetre - commode, le résultat peut s'avérer mauvais. L'identifiant - de cache est utilisé pour créer un répertoire sur le systéme de fichiers, - donc si l'utilisateur décide de donner une trés grande valeur a article_id - ou d'écrire un script qui envoie des article_id de faton aléatoire, - cela pourra causer des problémes coté serveur. Assurez-vous de bien - tester toute donnée passée en paramétre avant de l'utiliser. Dans cet - exemple, peut-être savez-vous que article_id a une longueur de 10 + + + Nous passons ci-dessus la variable $my_cache_id a display() comme + identifiant de cache. Pour chaque valeur distincte de $my_cache_id, + un fichier de cache distinct va être créé. Dans cet exemple, + "article_id" a été passé dans l'URL et est utilisé en tant qu'identifiant + de cache. + + + Note technique + + Soyez prudent en passant des valeurs depuis un client (navigateur Web) + vers Smarty (ou vers n'importe quelle application PHP). Bien que l'exemple + ci-dessus consistant a utiliser article_id depuis l'URL puisse paraetre + commode, le résultat peut s'avérer mauvais. L'identifiant + de cache est utilisé pour créer un répertoire sur le systéme de fichiers, + donc si l'utilisateur décide de donner une trés grande valeur a article_id + ou d'écrire un script qui envoie des article_id de faton aléatoire, + cela pourra causer des problémes coté serveur. Assurez-vous de bien + tester toute donnée passée en paramétre avant de l'utiliser. Dans cet + exemple, peut-être savez-vous que article_id a une longueur de 10 caractéres, est exclusivement composé de caractéres alph-numériques et doit avoir une valeur contenue dans la base de données. Vérifiez-le bien ! - - - - Assurez-vous de bien passer le même identifiant aux fonctions - is_cached() et - clear_cache(). - - - passer un cache_id a is_cached() - + + + + Assurez-vous de bien passer le même identifiant aux fonctions + is_cached() et + clear_cache(). + + + passer un cache_id a is_cached() + require('Smarty.class.php'); $smarty = new Smarty; @@ -68,15 +71,15 @@ if(!$smarty->is_cached('index.tpl',$my_cache_id)) { } $smarty->display('index.tpl',$my_cache_id); - - + + Vous pouvez effacer tous les fichiers de cache pour un identifiant de cache particulier en passant null en tant que premier paramétre a clear_cache(). - - - effacement de tous les fichiers de cache pour un identifiant de cache particulier - + + + effacement de tous les fichiers de cache pour un identifiant de cache particulier + require('Smarty.class.php'); $smarty = new Smarty; @@ -86,29 +89,29 @@ $smarty->caching = true; $smarty->clear_cache(null,"sports"); $smarty->display('index.tpl',"sports"); - - + + De cette maniére vous pouvez "grouper" vos fichiers de cache en leur donnant le même identifiant. - - - \ No newline at end of file + + + diff --git a/docs/fr/programmers/caching/caching-setting-up.xml b/docs/fr/programmers/caching/caching-setting-up.xml index 2794afa3..292c8a7e 100644 --- a/docs/fr/programmers/caching/caching-setting-up.xml +++ b/docs/fr/programmers/caching/caching-setting-up.xml @@ -1,52 +1,59 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - - Paramétrer le cache - - La premiére chose a faire est d'activer le cache. Cela est fait en - mettant $caching = true - (ou 1). - - - activation du cache - + + + Paramétrer le cache + + La premiére chose a faire est d'activer le cache. Cela est fait en + mettant $caching = true + (ou 1). + + + activation du cache + require('Smarty.class.php'); $smarty = new Smarty; $smarty->caching = true; $smarty->display('index.tpl'); - - - Avec le cache activé, la fonction display('index.tpl') va afficher - le template mais sauvegardera par la même occasion une copie du résultat - dans un fichier (de cache) du répertoire - $cache_dir. Au prochain appel de - display('index.tpl'), le fichier de cache sera préféré a la réutilisation - du template. - - - Note technique - - Les fichiers situés dans $cache_dir sont nommés de la même faton que les templates. - Bien qu'ils aient une extension ".php", ils ne sont pas vraiment exécutable. - N'éditez surtout pas ces fichiers ! - - - - Tout fichier de cache a une durée de vie limitée déterminée par $cache_lifetime. La valeur par - défaut est 3600 secondes, i.e. 1 heure. Une fois que cette durée est - dépassée, le cache est regénéré. Il est possible de donner + + + Avec le cache activé, la fonction display('index.tpl') va afficher + le template mais sauvegardera par la même occasion une copie du résultat + dans un fichier (de cache) du répertoire + $cache_dir. Au prochain appel de + display('index.tpl'), le fichier de cache sera préféré a la réutilisation + du template. + + + Note technique + + Les fichiers situés dans $cache_dir sont nommés de la même faton que les templates. + Bien qu'ils aient une extension ".php", ils ne sont pas vraiment exécutable. + N'éditez surtout pas ces fichiers ! + + + + Tout fichier de cache a une durée de vie limitée déterminée par $cache_lifetime. La valeur par + défaut est 3600 secondes, i.e. 1 heure. Une fois que cette durée est + dépassée, le cache est regénéré. Il est possible de donner une durée d'expiration propre a chaque fichier de cache en réglant $caching = 2. Se reporter a la documentation de $cache_lifetime pour plus de - détails. - - - réglage individuel de cache_lifetime - + linkend="variable.cache.lifetime">$cache_lifetime pour plus de + détails. + + + réglage individuel de cache_lifetime + require('Smarty.class.php'); $smarty = new Smarty; @@ -66,19 +73,19 @@ $smarty->display('home.tpl'); // dans 1 heure. $smarty->cache_lifetime = 30; // 30 secondes $smarty->display('home.tpl'); - + - Si $compile_check est actif, - chaque fichier de template et de configuration qui a un rapport - avec le fichier de cache sera vérifié pour détecter une éventuelle - modification. Si l'un de ces fichiers a été modifié depuis que le fichier de cache a été - généré, le cache est immédiatement regénéré. Ce processus est covteux, donc, - pour des raisons de performances, mettez ce paramétre a false pour une application - en production. + Si $compile_check est actif, + chaque fichier de template et de configuration qui a un rapport + avec le fichier de cache sera vérifié pour détecter une éventuelle + modification. Si l'un de ces fichiers a été modifié depuis que le fichier de cache a été + généré, le cache est immédiatement regénéré. Ce processus est covteux, donc, + pour des raisons de performances, mettez ce paramétre a false pour une application + en production. - - activation de $compile_check - + + activation de $compile_check + require('Smarty.class.php'); $smarty = new Smarty; @@ -86,8 +93,8 @@ $smarty->caching = true; $smarty->compile_check = true; $smarty->display('index.tpl'); - - + + Si $force_compile est actif, les fichiers de cache sont toujours regénérés. Ceci revient finalement a désactiver le cache. $force_compile est utilisé a des fins de débogage, @@ -95,15 +102,15 @@ $smarty->display('index.tpl'); $caching = false (ou 0). - La fonction is_cached() permet - de tester si un template a ou non un fichier de cache valide. - Si vous disposez d'un template en cache qui requiert une requête - a une base de données, vous pouvez utiliser cette méthode plut(t - que $compile_check. + La fonction is_cached() permet + de tester si un template a ou non un fichier de cache valide. + Si vous disposez d'un template en cache qui requiert une requête + a une base de données, vous pouvez utiliser cette méthode plut(t + que $compile_check. - - utilisation de is_cached() - + + utilisation de is_cached() + require('Smarty.class.php'); $smarty = new Smarty; @@ -116,8 +123,8 @@ if(!$smarty->is_cached('index.tpl')) { } $smarty->display('index.tpl'); - - + + Vous pouvez rendre dynamiques seulement certaines parties d'une page avec la fonction de templates insert. @@ -126,17 +133,17 @@ $smarty->display('index.tpl'); banniére, vous pouvez garder cet élément dynamique dans le contenu qui est en cache. Reportez-vous a la documentation insert pour plus de détails - et des exemples. + et des exemples. - Vous pouvez effacer tous les fichiers du cache avec la fonction clear_all_cache(), ou de faton - individuelle (ou par groupe) avec la fonction clear_cache(). + Vous pouvez effacer tous les fichiers du cache avec la fonction clear_all_cache(), ou de faton + individuelle (ou par groupe) avec la fonction clear_cache(). nettoyage du cache - + require('Smarty.class.php'); $smarty = new Smarty; @@ -150,24 +157,24 @@ $smarty->clear_cache('index.tpl'); $smarty->display('index.tpl'); - - \ No newline at end of file + + diff --git a/docs/fr/programmers/plugins.xml b/docs/fr/programmers/plugins.xml index 923b7b08..a95e5634 100644 --- a/docs/fr/programmers/plugins.xml +++ b/docs/fr/programmers/plugins.xml @@ -1,52 +1,53 @@ - - Etendre Smarty avec des plugins - + + + Etendre Smarty avec des plugins + La version 2.0 a introduit l'architecture de plugin qui est utilisée pour pratiquement toute les fonctionnalités - personnalisables de Smarty. Ceci comprend : + personnalisables de Smarty. Ceci comprend : - les fonctions - les modificateurs - les fonctions de blocs - les fonctions de compilation - les filtres de pré-compilation - les filtres de post-compilation - les filtres de sorties - les ressources - les insertions + les fonctions + les modificateurs + les fonctions de blocs + les fonctions de compilation + les filtres de pré-compilation + les filtres de post-compilation + les filtres de sorties + les ressources + les insertions A part pour les ressources, la compatibilité avec les anciennes fatons d'enregistrer les fonctions de gestion avec l'API register_ est conservée. Si vous n'avez pas utilisé cette API et que vous avez - a la place directement modifié les variables de classes + a la place directement modifié les variables de classes $custom_funcs, $custom_mods et d'autres, vous devez alors modifier vos scripts pour utiliser l'API ou convertir vos fonctionnalités personnalisées en plugins. - - -&programmers.plugins.plugins-howto; - -&programmers.plugins.plugins-naming-conventions; - -&programmers.plugins.plugins-writing; - -&programmers.plugins.plugins-functions; - -&programmers.plugins.plugins-modifiers; - -&programmers.plugins.plugins-block-functions; - -&programmers.plugins.plugins-compiler-functions; - -&programmers.plugins.plugins-prefilters-postfilters; - -&programmers.plugins.plugins-outputfilters; - -&programmers.plugins.plugins-resources; - -&programmers.plugins.plugins-inserts; + + + &programmers.plugins.plugins-howto; + + &programmers.plugins.plugins-naming-conventions; + + &programmers.plugins.plugins-writing; + + &programmers.plugins.plugins-functions; + + &programmers.plugins.plugins-modifiers; + + &programmers.plugins.plugins-block-functions; + + &programmers.plugins.plugins-compiler-functions; + + &programmers.plugins.plugins-prefilters-postfilters; + + &programmers.plugins.plugins-outputfilters; + + &programmers.plugins.plugins-resources; + + &programmers.plugins.plugins-inserts; - Fonctions de blocs - - - void smarty_block_name - array $params - mixed $content - object &$smarty - - - - Les fonctions de blocs sont des fonctions de la forme {func} .. {/func}. - En d'autres mots, elles englobent des blocs de template et opérent sur les - contenus de ces blocs. Les fonctions de blocs ont la priorité sur les - fonctions utilisateurs de même nom, ce qui signifie que vous ne - pouvez avoir une fonction utilisateur {func} et une fonction de bloc - {func} .. {/func}. - - - L'implémentation de votre fonction est appelée deux fois par Smarty : - une fois pour la balise ouvrante et une autre fois pour la balise - fermante. - - - Seule la balise ouvrante d'une fonction de bloc peut avoir des attributs. - Tous les attributs passés par le template aux fonctions de templates sont - contenues dans le tableau associatif $params. - Vous pouvez accéder a ces valeurs soit directement, par exemple - $params['start'], soit en utilisant - extract($params) pour les importer dans la table - des symboles. Votre fonction a aussi accés aux attributs de la balise - ouvrante quand c'est la balise fermante qui est exécutée. - - - La valeur de la variable $content est différente - selon si votre fonction est appelée pour la balise ouvrante ou la - balise fermante. Si c'est pour la balise ouvrante, elle sera a - null et si c'est la balise fermante elle sera - égale au contenu du bloc de template. Notez que le bloc de template - aura déjà été exécuté par Smarty, vous recevrez donc la sortie du - template et non sa source. - - - Si vous imbriqué des fonctions de bloc, il est possible de connaetre - la fonction de bloc parente grGce a la variable $smarty->_tag_stack. - Faites un var_dump() dessus et la structure devrait apparaetre. - - - Regardez aussi : - register_block(), - unregister_block(). - - - fonction de bloc - + +Fonctions de blocs + + + void smarty_block_name + array $params + mixed $content + object &$smarty + + + + Les fonctions de blocs sont des fonctions de la forme {func} .. {/func}. + En d'autres mots, elles englobent des blocs de template et opérent sur les + contenus de ces blocs. Les fonctions de blocs ont la priorité sur les + fonctions utilisateurs de même nom, ce qui signifie que vous ne + pouvez avoir une fonction utilisateur {func} et une fonction de bloc + {func} .. {/func}. + + + L'implémentation de votre fonction est appelée deux fois par Smarty : + une fois pour la balise ouvrante et une autre fois pour la balise + fermante. + + + Seule la balise ouvrante d'une fonction de bloc peut avoir des attributs. + Tous les attributs passés par le template aux fonctions de templates sont + contenues dans le tableau associatif $params. + Vous pouvez accéder a ces valeurs soit directement, par exemple + $params['start'], soit en utilisant + extract($params) pour les importer dans la table + des symboles. Votre fonction a aussi accés aux attributs de la balise + ouvrante quand c'est la balise fermante qui est exécutée. + + + La valeur de la variable $content est différente + selon si votre fonction est appelée pour la balise ouvrante ou la + balise fermante. Si c'est pour la balise ouvrante, elle sera a + null et si c'est la balise fermante elle sera + égale au contenu du bloc de template. Notez que le bloc de template + aura déjà été exécuté par Smarty, vous recevrez donc la sortie du + template et non sa source. + + + Si vous imbriqué des fonctions de bloc, il est possible de connaetre + la fonction de bloc parente grGce a la variable $smarty->_tag_stack. + Faites un var_dump() dessus et la structure devrait apparaetre. + + + Regardez aussi : + register_block(), + unregister_block(). + + + fonction de bloc + <?php /* * Smarty plugin @@ -72,25 +75,25 @@ function smarty_block_translate($params, $content, &$smarty) echo $translation; } } - - - \ No newline at end of file + + + diff --git a/docs/fr/programmers/plugins/plugins-compiler-functions.xml b/docs/fr/programmers/plugins/plugins-compiler-functions.xml index 03a94318..4ba0ace5 100644 --- a/docs/fr/programmers/plugins/plugins-compiler-functions.xml +++ b/docs/fr/programmers/plugins/plugins-compiler-functions.xml @@ -1,34 +1,37 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - Fonctions de compilation - - Les fonctions de compilation sont appelées durant la compilation du template. - Elles sont utiles pour injecter du code PHP ou du contenu "statique variant - avec le temps" (bandeau de pub par ex.). Si une fonction de compilation et - une fonction personnalisée ont le même - nom, la fonction de compilation a priorité. - - - - mixed smarty_compiler_name - string $tag_arg - object &$smarty - - - - Les fonctions de compilation ont deux paramétres : une chaene contenant - la balise - en gros, tout, depuis le nom de la fonction jusqu'au délimiteur de fin - et - l'objet Smarty. Elles sont censées retourner le code PHP qui doit être - injecté dans le template compilé. - - - Regardez aussi - register_compiler_function(), - unregister_compiler_function(). - - - fonction de compilation simple - + +Fonctions de compilation + + Les fonctions de compilation sont appelées durant la compilation du template. + Elles sont utiles pour injecter du code PHP ou du contenu "statique variant + avec le temps" (bandeau de pub par ex.). Si une fonction de compilation et + une fonction personnalisée ont le même + nom, la fonction de compilation a priorité. + + + + mixed smarty_compiler_name + string $tag_arg + object &$smarty + + + + Les fonctions de compilation ont deux paramétres : une chaene contenant + la balise - en gros, tout, depuis le nom de la fonction jusqu'au délimiteur de fin - et + l'objet Smarty. Elles sont censées retourner le code PHP qui doit être + injecté dans le template compilé. + + + Regardez aussi + register_compiler_function(), + unregister_compiler_function(). + + + fonction de compilation simple + <?php /* * Smarty plugin @@ -45,38 +48,38 @@ function smarty_compiler_tplheader($tag_arg, &$smarty) return "\necho '" . $smarty->_current_file . " compiled at " . date('Y-m-d H:M'). "';"; } ?> - - Cette fonction peut-être appelé depuis le template comme suivant : - - + + Cette fonction peut-être appelé depuis le template comme suivant : + + {* cette fonction n'est executée que lors de la compilation *} {tplheader} - - Le code PHP résultant dans les templates compilés ressemblerait a ta : - - + + Le code PHP résultant dans les templates compilés ressemblerait a ta : + + <php echo 'index.tpl compiled at 2002-02-20 20:02'; ?> - - - \ No newline at end of file + + + diff --git a/docs/fr/programmers/plugins/plugins-functions.xml b/docs/fr/programmers/plugins/plugins-functions.xml index 8187661f..213e0ed2 100644 --- a/docs/fr/programmers/plugins/plugins-functions.xml +++ b/docs/fr/programmers/plugins/plugins-functions.xml @@ -1,41 +1,44 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - Les fonctions de templates - - - void smarty_function_name - array $params - object &$smarty - - - - Tous les attributs passés aux fonctions de template a partir du template - sont contenus dans le tableau associatif $params. - Vous pouvez accéder a ces valeurs soit directement, par exemple - $params['start'], soit en utilisant - extract($params) pour les importer dans la table - des symboles. - - - Le retour de la fonction sera substituée a la balise de fonction - du template (fonction fetch par exemple). Sinon, - la fonction peut simplement accomplir une autre tGche sans sortie - (la fonction assign par exemple) - - - Si la fonction a besoin d'assigner des variables aux templates ou d'utiliser - d'autres fonctionnalités fournies par Smarty, elle peut recevoir un - objet $smarty pour cela. - - - Référez-vous aussi a : - register_function(), - unregister_function(). - - - - fonction de plugin avec sortie - + +Les fonctions de templates + + + void smarty_function_name + array $params + object &$smarty + + + + Tous les attributs passés aux fonctions de template a partir du template + sont contenus dans le tableau associatif $params. + Vous pouvez accéder a ces valeurs soit directement, par exemple + $params['start'], soit en utilisant + extract($params) pour les importer dans la table + des symboles. + + + Le retour de la fonction sera substituée a la balise de fonction + du template (fonction fetch par exemple). Sinon, + la fonction peut simplement accomplir une autre tGche sans sortie + (la fonction assign par exemple) + + + Si la fonction a besoin d'assigner des variables aux templates ou d'utiliser + d'autres fonctionnalités fournies par Smarty, elle peut recevoir un + objet $smarty pour cela. + + + Référez-vous aussi a : + register_function(), + unregister_function(). + + + + fonction de plugin avec sortie + <?php /* * Smarty plugin @@ -59,18 +62,18 @@ function smarty_function_eightball($params, &$smarty) return $answers[$result]; } ?> - - - - peut être utilisée dans le template de la faton suivante : - - + + + + peut être utilisée dans le template de la faton suivante : + + Question: Will we ever have time travel? Answer: {eightball}. - - - fonction de plugin sans sortie - + + + fonction de plugin sans sortie + <?php /* * Smarty plugin @@ -98,26 +101,26 @@ function smarty_function_assign($params, &$smarty) $smarty->assign($var, $value); } ?> - - - - \ No newline at end of file + + + + diff --git a/docs/fr/programmers/plugins/plugins-howto.xml b/docs/fr/programmers/plugins/plugins-howto.xml index 5bb54593..75d807ab 100644 --- a/docs/fr/programmers/plugins/plugins-howto.xml +++ b/docs/fr/programmers/plugins/plugins-howto.xml @@ -1,27 +1,28 @@ - - Comment fonctionnent les plugins - - Les plugins sont toujours chargés a la demande. Seuls les modificateurs - de variables, les ressources, etc invoqués dans les scripts de templates - seront chargés. De plus, chaque plugin n'est chargé qu'une fois, et ce - même si vous avez plusieurs instances de Smarty qui tournent dans - la même requête. - - - Les filtres de post/pré-compilation et les filtres de sortie sont des cas - un peu spéciaux. - Comme ils ne sont pas mentionnés dans les templates, ils doivent être déclarés - ou chargés explicitement via les fonctions de l'API avant que le template - ne soit exécuté. L'ordre dans lequel les filtres multiples d'un même type - sont exécutés dépend de l'ordre dans lequel ils sont enregistrés ou chargés. - - - Il n'existe qu'un seul répertoire de plugin (pour des raisons de performances). - Pour installer un plugin, copiez-le simplement dans le répertoire et Smarty - l'utilisera automatiquement. - + + + Comment fonctionnent les plugins + + Les plugins sont toujours chargés a la demande. Seuls les modificateurs + de variables, les ressources, etc invoqués dans les scripts de templates + seront chargés. De plus, chaque plugin n'est chargé qu'une fois, et ce + même si vous avez plusieurs instances de Smarty qui tournent dans + la même requête. + + + Les filtres de post/pré-compilation et les filtres de sortie sont des cas + un peu spéciaux. + Comme ils ne sont pas mentionnés dans les templates, ils doivent être déclarés + ou chargés explicitement via les fonctions de l'API avant que le template + ne soit exécuté. L'ordre dans lequel les filtres multiples d'un même type + sont exécutés dépend de l'ordre dans lequel ils sont enregistrés ou chargés. + + + Il n'existe qu'un seul répertoire de plugin (pour des raisons de performances). + Pour installer un plugin, copiez-le simplement dans le répertoire et Smarty + l'utilisera automatiquement. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/plugins/plugins-inserts.xml b/docs/fr/programmers/plugins/plugins-inserts.xml index e536a559..f0440d19 100644 --- a/docs/fr/programmers/plugins/plugins-inserts.xml +++ b/docs/fr/programmers/plugins/plugins-inserts.xml @@ -1,33 +1,76 @@ + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 - Insertions - - Les plugins d'insertion sont utilisés pour implémenter les fonctions - qui sont appelées par les balises - insert - dans les templates. - - - - string smarty_insert_name - array $params - object &$smarty - - - - Le premier paramétre passé a la fonction est une tableau associatif - d'attributs. Vous pouvez accéder a ces valeurs soit directement, par exemple - $params['start'], soit en utilisant - extract($params) pour les importer dans la table - des symboles. - - - La fonction d'insertion est supposée retourner le résultat qui sera - substitué a la balise insert dans le template. - - - plugin d'insertion - + +Insertions + + Les plugins d'insertion sont utilisés pour implémenter les fonctions + qui sont appelées par les balises + insert + dans les templates. + + + + string smarty_insert_name + array $params + object &$smarty + + + + Le premier paramétre passé a la fonction est une tableau associatif + d'attributs. Vous pouvez accéder a ces valeurs soit directement, par exemple + $params['start'], soit en utilisant + extract($params) pour les importer dans la table + des symboles. + + + La fonction d'insertion est supposée retourner le résultat qui sera + substitué a la balise insert dans le template. + + + plugin d'insertion + <?php /* * Smarty plugin @@ -50,7 +93,7 @@ function smarty_insert_time($params, &$smarty) return $datetime; } ?> - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/plugins/plugins-modifiers.xml b/docs/fr/programmers/plugins/plugins-modifiers.xml index 6ca59ba0..4afe333c 100644 --- a/docs/fr/programmers/plugins/plugins-modifiers.xml +++ b/docs/fr/programmers/plugins/plugins-modifiers.xml @@ -1,39 +1,42 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - Modificateurs - - Les modificateurs sont des petites fonctions appliquées a une variable - de template avant qu'elle ne soit affichée ou utilisée dans un autre contexte. - Les modificateurs peuvent être chaenés entre eux. - - - - mixed smarty_modifier_name - mixed $value - [mixed $param1, ...] - - - - Le premier paramétre passé au modificateur est la valeur - sur laquelle le modificateur est supposé opérer. Les autres paramétres - peuvent être optionnels, dépendant de quel genre d'opération doit être - effectué. - - - Le modificateur doit retourner le résultat de son exécution. - - - Regardez aussi - register_modifier(), - unregister_modifier(). - - - plugin modificateur simple - - Ce plugin est un alias d'une fonction PHP. Il n'a aucun paramétre - supplémentaires. - - + +Modificateurs + + Les modificateurs sont des petites fonctions appliquées a une variable + de template avant qu'elle ne soit affichée ou utilisée dans un autre contexte. + Les modificateurs peuvent être chaenés entre eux. + + + + mixed smarty_modifier_name + mixed $value + [mixed $param1, ...] + + + + Le premier paramétre passé au modificateur est la valeur + sur laquelle le modificateur est supposé opérer. Les autres paramétres + peuvent être optionnels, dépendant de quel genre d'opération doit être + effectué. + + + Le modificateur doit retourner le résultat de son exécution. + + + Regardez aussi + register_modifier(), + unregister_modifier(). + + + plugin modificateur simple + + Ce plugin est un alias d'une fonction PHP. Il n'a aucun paramétre + supplémentaires. + + <?php /* * Smarty plugin @@ -49,11 +52,11 @@ function smarty_modifier_capitalize($string) return ucwords($string); } ?> - - - - un plugin modificateur un peu plus complexe - + + + + un plugin modificateur un peu plus complexe + <?php /* * Smarty plugin @@ -84,25 +87,25 @@ function smarty_modifier_truncate($string, $length = 80, $etc = '...', return $string; } ?> - - - \ No newline at end of file + + + diff --git a/docs/fr/programmers/plugins/plugins-naming-conventions.xml b/docs/fr/programmers/plugins/plugins-naming-conventions.xml index e1375abf..f40feb68 100644 --- a/docs/fr/programmers/plugins/plugins-naming-conventions.xml +++ b/docs/fr/programmers/plugins/plugins-naming-conventions.xml @@ -1,62 +1,63 @@ - - Conventions de nommage - - Les fichiers et les fonctions de plugins doivent suivre une convention - de nommage trés spécifique pour être localisés par Smarty. - - - Les fichiers de plugins doivent être nommés de la faton suivante : -
- - - type.nom.php - - -
- - - Oú type est l'une des valeurs suivantes : - - function - modifier - block - compiler - prefilter - postfilter - outputfilter - resource - insert - - - - Et nom doit être un identifiant valide (lettres, nombres - et underscore seulement). - - - Quelques exemples : function.html_select_date.php, - resource.db.php, - modifier.spacify.php. - - - Les fonctions de plugins dans les fichiers de plugins doivent être - nommées de la faton suivante : -
- - smarty_type_nom - -
- - - Les significations de type et de nom sont les mêmes - que précédemment. - - - Smarty donnera des messages d'erreur approprié si le fichier de plugin - n'est pas trouvé, ou si le fichier ou la fonction de plugin ne sont - pas nommés correctement. - + + + Conventions de nommage + + Les fichiers et les fonctions de plugins doivent suivre une convention + de nommage trés spécifique pour être localisés par Smarty. + + + Les fichiers de plugins doivent être nommés de la faton suivante : +
+ + + type.nom.php + + +
+ + + Oú type est l'une des valeurs suivantes : + + function + modifier + block + compiler + prefilter + postfilter + outputfilter + resource + insert + + + + Et nom doit être un identifiant valide (lettres, nombres + et underscore seulement). + + + Quelques exemples : function.html_select_date.php, + resource.db.php, + modifier.spacify.php. + + + Les fonctions de plugins dans les fichiers de plugins doivent être + nommées de la faton suivante : +
+ + smarty_type_nom + +
+ + + Les significations de type et de nom sont les mêmes + que précédemment. + + + Smarty donnera des messages d'erreur approprié si le fichier de plugin + n'est pas trouvé, ou si le fichier ou la fonction de plugin ne sont + pas nommés correctement. + \ No newline at end of file +--> diff --git a/docs/fr/programmers/plugins/plugins-outputfilters.xml b/docs/fr/programmers/plugins/plugins-outputfilters.xml index d4f903ba..a4a7d4f2 100644 --- a/docs/fr/programmers/plugins/plugins-outputfilters.xml +++ b/docs/fr/programmers/plugins/plugins-outputfilters.xml @@ -1,27 +1,70 @@ + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 + +Warning: str_repeat(): Second argument has to be greater than or equal to 0. in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 63 - Filtres de sortie - - Les plugins de filtres de sortie opérent sur la sortie du template, - aprés que le template a été chargé et exécuté, mais avant que - la sortie ne soit affichée. - - - - string smarty_outputfilter_name - string $template_output - object &$smarty - - - - Le premier paramétre passé a la fonction du filtre de sortie est la - sortie du template qui doit être modifiée et le second paramétre - est l'instance de Smarty appelant le plugin. Le plugin est supposé - faire un traitement et en retourner le résultat. - - - plugin de filtre de sortie - + +Filtres de sortie + + Les plugins de filtres de sortie opérent sur la sortie du template, + aprés que le template a été chargé et exécuté, mais avant que + la sortie ne soit affichée. + + + + string smarty_outputfilter_name + string $template_output + object &$smarty + + + + Le premier paramétre passé a la fonction du filtre de sortie est la + sortie du template qui doit être modifiée et le second paramétre + est l'instance de Smarty appelant le plugin. Le plugin est supposé + faire un traitement et en retourner le résultat. + + + plugin de filtre de sortie + /* * Smarty plugin * ------------------------------------------------------------- @@ -38,7 +81,7 @@ '$1%40$2', $output); } - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/plugins/plugins-prefilters-postfilters.xml b/docs/fr/programmers/plugins/plugins-prefilters-postfilters.xml index ef1b2702..8450ef1a 100644 --- a/docs/fr/programmers/plugins/plugins-prefilters-postfilters.xml +++ b/docs/fr/programmers/plugins/plugins-prefilters-postfilters.xml @@ -1,45 +1,46 @@ - - filtres de pré-compilation/filtres de post-compilation - - Les filtres de pré-compilation et les filtres de post-compilation ont des concepts trés - proches. Ils différent dans leur exécution, plus précisément dans le - moment oú ils sont exécutés. - - - - string smarty_prefilter_name - string $source - object &$smarty - - - - Les filtres de pré-compilation sont utilisés pour transformer la source d'un template - juste avant la compilation. Le premier paramétre passé a la fonction - de filtre de pré-compilation est la source du template, éventuellement modifiée par - d'autres filtre de pré-compilations. Le plugin est supposé retourner la source modifiée. - Notez que cette source n'est sauvegardée nulle part, elle est seulement - utilisé pour la compilation. - - - - string smarty_postfilter_name - string $compiled - object &$smarty - - - - Les filtres de post-compilation sont utilisés pour modifier la sortie du template - (le code PHP) juste aprés que la compilation a été faite mais juste - avant que le template ne soit sauvegardé sur le systéme de fichiers. - Le premier paramétre passé a la fonction de filtre de post-compilation est le code - du template compilé, éventuellement déja modifié par d'autres filtre de post-compilations. - Le plugin est censé retourner la version modifié du code. - - - plugin de filtre de post-compilation - + + + filtres de pré-compilation/filtres de post-compilation + + Les filtres de pré-compilation et les filtres de post-compilation ont des concepts trés + proches. Ils différent dans leur exécution, plus précisément dans le + moment oú ils sont exécutés. + + + + string smarty_prefilter_name + string $source + object &$smarty + + + + Les filtres de pré-compilation sont utilisés pour transformer la source d'un template + juste avant la compilation. Le premier paramétre passé a la fonction + de filtre de pré-compilation est la source du template, éventuellement modifiée par + d'autres filtre de pré-compilations. Le plugin est supposé retourner la source modifiée. + Notez que cette source n'est sauvegardée nulle part, elle est seulement + utilisé pour la compilation. + + + + string smarty_postfilter_name + string $compiled + object &$smarty + + + + Les filtres de post-compilation sont utilisés pour modifier la sortie du template + (le code PHP) juste aprés que la compilation a été faite mais juste + avant que le template ne soit sauvegardé sur le systéme de fichiers. + Le premier paramétre passé a la fonction de filtre de post-compilation est le code + du template compilé, éventuellement déja modifié par d'autres filtre de post-compilations. + Le plugin est censé retourner la version modifié du code. + + + plugin de filtre de post-compilation + <?php /* * Smarty plugin @@ -55,11 +56,11 @@ return preg_replace('!<(\w+)[^>]+>!e', 'strtolower("$1")', $source); } ?> - - - - plugin de filtre de post-compilation - + + + + plugin de filtre de post-compilation + <?php /* * Smarty plugin @@ -77,7 +78,7 @@ return $compiled; } ?> - + \ No newline at end of file +--> diff --git a/docs/fr/programmers/plugins/plugins-resources.xml b/docs/fr/programmers/plugins/plugins-resources.xml index 0f9569b0..ca2e1d69 100644 --- a/docs/fr/programmers/plugins/plugins-resources.xml +++ b/docs/fr/programmers/plugins/plugins-resources.xml @@ -1,83 +1,86 @@ + +Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56 - Ressources - - Les plugins ressources sont un moyen générique de fournir des sources - de templates ou des composants de scripts PHP a Smarty. Quelques exemples - de ressources : bases de données, LDAP, mémoire partagée, sockets, et ainsi - de suite. - - - Il y au total 4 fonctions qui ont besoin d'être enregistrées pour - chaque type de ressource. Chaque fonction retoit le nom de la ressource demandée - comme premier paramétre et l'objet Smarty comme dernier paramétre. - Les autres paramétres dépendent de la fonction. - - - - bool smarty_resource_name_source - string $rsrc_name - string &$source - object &$smarty - - - bool smarty_resource_name_timestamp - string $rsrc_name - int &$timestamp - object &$smarty - - - bool smarty_resource_name_secure - string $rsrc_name - object &$smarty - - - bool smarty_resource_name_trusted - string $rsrc_name - object &$smarty - - + +Ressources + + Les plugins ressources sont un moyen générique de fournir des sources + de templates ou des composants de scripts PHP a Smarty. Quelques exemples + de ressources : bases de données, LDAP, mémoire partagée, sockets, et ainsi + de suite. + + + Il y au total 4 fonctions qui ont besoin d'être enregistrées pour + chaque type de ressource. Chaque fonction retoit le nom de la ressource demandée + comme premier paramétre et l'objet Smarty comme dernier paramétre. + Les autres paramétres dépendent de la fonction. + + + + bool smarty_resource_name_source + string $rsrc_name + string &$source + object &$smarty + + + bool smarty_resource_name_timestamp + string $rsrc_name + int &$timestamp + object &$smarty + + + bool smarty_resource_name_secure + string $rsrc_name + object &$smarty + + + bool smarty_resource_name_trusted + string $rsrc_name + object &$smarty + + - - La premiére fonction est supposée récupérer la ressource. Son second - paramétre est une variable passée par référence oú le résultat doit être - stocké. La fonction est supposée retourner true si - elle réussi a récupérer la ressource et false sinon. - + + La premiére fonction est supposée récupérer la ressource. Son second + paramétre est une variable passée par référence oú le résultat doit être + stocké. La fonction est supposée retourner true si + elle réussi a récupérer la ressource et false sinon. + - - La seconde fonction est supposée récupérer la date de derniére modification - de la ressource demandée (comme un timestamp UNIX). Le second paramétre - est une variable passée par référence dans laquelle la date doit - être stockée. La fonction est supposée renvoyer true si elle - a réussi a récupérer la date et false sinon. - + + La seconde fonction est supposée récupérer la date de derniére modification + de la ressource demandée (comme un timestamp UNIX). Le second paramétre + est une variable passée par référence dans laquelle la date doit + être stockée. La fonction est supposée renvoyer true si elle + a réussi a récupérer la date et false sinon. + - - La troisiéme fonction est supposée retourner true - ou false selon si la ressource demandée est svre - ou non. La fonction est utilisée seulement pour les ressources templates - mais doit tout de même être définie. - + + La troisiéme fonction est supposée retourner true + ou false selon si la ressource demandée est svre + ou non. La fonction est utilisée seulement pour les ressources templates + mais doit tout de même être définie. + - - La quatriéme fonction est supposée retourner true - ou false selon si on peut faire confiance ou - non a la ressource demandée. Cette fonction est utilisée seulement - pour les composants de scripts PHP demandés par les balises - include_php ou insert - ayant un attribut src. Quoiqu'il en soit, - elle doit être définie pour les ressources templates. - + + La quatriéme fonction est supposée retourner true + ou false selon si on peut faire confiance ou + non a la ressource demandée. Cette fonction est utilisée seulement + pour les composants de scripts PHP demandés par les balises + include_php ou insert + ayant un attribut src. Quoiqu'il en soit, + elle doit être définie pour les ressources templates. + - - Regardez aussi - register_resource(), - unregister_resource(). - - - resource plugin - + + Regardez aussi + register_resource(), + unregister_resource(). + + + resource plugin + <?php /* * Smarty plugin @@ -130,25 +133,25 @@ function smarty_resource_db_trusted($tpl_name, &$smarty) // inutilisée pour les templates } ?> - - - \ No newline at end of file + + + diff --git a/docs/fr/programmers/plugins/plugins-writing.xml b/docs/fr/programmers/plugins/plugins-writing.xml index 22d328db..3deff41d 100644 --- a/docs/fr/programmers/plugins/plugins-writing.xml +++ b/docs/fr/programmers/plugins/plugins-writing.xml @@ -1,30 +1,31 @@ - - Ecrire des plugins - - Les plugins peuvent être soit chargés automatiquement par Smarty - depuis le systéme de fichier, soit être déclarés - pendant l'exécution via une fonction register_* de l'API. Ils peuvent - aussi être désalloués en utilisant une fonction unregister_* de - l'API. - - - Pour les plugins qui ne sont pas enregistrés pendant l'exécution, le nom - des fonctions n'ont pas a suivre la convention de nommage. - - - Si certaines fonctionnalités d'un plugin dépendent d'un autre plugin - (comme c'est le cas de certains plugins accompagnant Smarty), alors la maniére appropriée - de charger le plugin est la suivante : - - - + + + Ecrire des plugins + + Les plugins peuvent être soit chargés automatiquement par Smarty + depuis le systéme de fichier, soit être déclarés + pendant l'exécution via une fonction register_* de l'API. Ils peuvent + aussi être désalloués en utilisant une fonction unregister_* de + l'API. + + + Pour les plugins qui ne sont pas enregistrés pendant l'exécution, le nom + des fonctions n'ont pas a suivre la convention de nommage. + + + Si certaines fonctionnalités d'un plugin dépendent d'un autre plugin + (comme c'est le cas de certains plugins accompagnant Smarty), alors la maniére appropriée + de charger le plugin est la suivante : + + + require_once SMARTY_DIR . 'plugins/function.html_options.php'; - - Une régle générale est que chaque objet Smarty est toujours passé au plugin - en tant que dernier paramétre (a part pour les modificateurs). - + + Une régle générale est que chaque objet Smarty est toujours passé au plugin + en tant que dernier paramétre (a part pour les modificateurs). + \ No newline at end of file +--> diff --git a/docs/fr/programmers/smarty-constants.xml b/docs/fr/programmers/smarty-constants.xml index f0011460..ec2455f2 100644 --- a/docs/fr/programmers/smarty-constants.xml +++ b/docs/fr/programmers/smarty-constants.xml @@ -1,22 +1,23 @@ - - Constantes - - - - SMARTY_DIR - - Il doit s'agir du chemin complet du répertoire oú - se trouvent les fichiers classes de Smarty. - S'il n'est pas défini, Smarty essaiera alors d'en - déterminer automatiquement la valeur. - S'il est défini, le chemin doit se terminer par un slash. - - - - SMARTY_DIR - + + + Constantes + + + + SMARTY_DIR + + Il doit s'agir du chemin complet du répertoire oú + se trouvent les fichiers classes de Smarty. + S'il n'est pas défini, Smarty essaiera alors d'en + déterminer automatiquement la valeur. + S'il est défini, le chemin doit se terminer par un slash. + + + + SMARTY_DIR + ]]> - - - + + +