From bb46b87b66c317d23d2da09e0e3aff10bde2d3a7 Mon Sep 17 00:00:00 2001 From: yannick Date: Sun, 8 Oct 2006 12:39:15 +0000 Subject: [PATCH] sync with EN --- .../language-function-strip.xml | 9 +- docs/fr/programmers/caching.xml | 11 +- .../programmers/caching/caching-cacheable.xml | 40 ++-- .../fr/programmers/caching/caching-groups.xml | 67 ++++-- .../caching/caching-multiple-caches.xml | 36 +-- .../caching/caching-setting-up.xml | 59 ++--- .../plugins/plugins-block-functions.xml | 141 +++++------ .../plugins/plugins-compiler-functions.xml | 18 +- .../programmers/plugins/plugins-functions.xml | 24 +- .../programmers/plugins/plugins-inserts.xml | 6 +- .../programmers/plugins/plugins-modifiers.xml | 19 +- .../plugins/plugins-naming-conventions.xml | 79 ++++--- .../plugins/plugins-outputfilters.xml | 11 +- .../plugins-prefilters-postfilters.xml | 14 +- .../programmers/plugins/plugins-resources.xml | 221 +++++++++--------- .../programmers/plugins/plugins-writing.xml | 18 +- docs/fr/programmers/smarty-constants.xml | 18 +- 17 files changed, 444 insertions(+), 347 deletions(-) diff --git a/docs/fr/designers/language-builtin-functions/language-function-strip.xml b/docs/fr/designers/language-builtin-functions/language-function-strip.xml index 42d61472..20807901 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-strip.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-strip.xml @@ -1,6 +1,6 @@ - + {strip} @@ -12,16 +12,15 @@ code illisible et impossible à maintenir. - Tout contenu situé entre les balises {strip}{/strip} se verra + Tout contenu situé entre les balises {strip}{/strip} se verra allégé des espaces superflus et des retours chariots en début ou en fin de ligne, avant qu'il ne soit affiché. De la sorte, vous pouvez conserver vos templates lisibles, sans vous soucier des effets indésirables que peuvent apporter les espaces superflus. - Note technique - {strip}{/strip} n'affecte en aucun cas le contenu des variables de + {strip}{/strip} n'affecte en aucun cas le contenu des variables de template. Voir aussi le modificateur strip pour un rendu identique pour les variables. @@ -62,7 +61,7 @@ Voir aussi - le modificateur strip. + le modificateur strip. diff --git a/docs/fr/programmers/caching.xml b/docs/fr/programmers/caching.xml index 69bb9305..637567b0 100644 --- a/docs/fr/programmers/caching.xml +++ b/docs/fr/programmers/caching.xml @@ -1,18 +1,19 @@ - + + Cache Le cache est utilisée pour accélérer l'appel de display() ou de fetch() en sauvegardant leur résultat + linkend="api.display">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 façon 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 + 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. diff --git a/docs/fr/programmers/caching/caching-cacheable.xml b/docs/fr/programmers/caching/caching-cacheable.xml index fec2fad6..2552cc5e 100644 --- a/docs/fr/programmers/caching/caching-cacheable.xml +++ b/docs/fr/programmers/caching/caching-cacheable.xml @@ -1,28 +1,29 @@ - + 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 + 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 + 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. + {insert}. - Contrairement à insert + Contrairement à {insert} les attributs pour le plugin ne sont pas mis en cache par défaut. Celà peut être le cas en utilisant le quatrième paramètre $cache_attrs. $cache_attrs @@ -36,10 +37,7 @@ caching = true; +$smarty->caching = 1; function remaining_seconds($params, &$smarty) { $remain = $params['endtime'] - time(); @@ -62,7 +60,7 @@ $smarty->display('index.tpl'); ]]> - Où index.tpl contient : + Où index.tpl contient : endtime} ]]> - Le nombre de secondes avant que la date de fin de $obj ne soit atteinte + 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 base de données lors de la mise en cache de @@ -97,17 +95,17 @@ $smarty->display('index.tpl'); ]]> - Où index.tpl contient : + Où index.tpl contient : @@ -116,9 +114,9 @@ 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 - celà ne sera pas mis en cache comme le reste de la page. + différentes. L'une est dynamic et l'autre est static. + Vous pouvez faire ce que vous voulez 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 c4754bd2..31790447 100644 --- a/docs/fr/programmers/caching/caching-groups.xml +++ b/docs/fr/programmers/caching/caching-groups.xml @@ -1,40 +1,61 @@ - + 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-groupe - avec une barre verticale "|" dans la valeur de l'identifiant de cache. + groupes de $cache_id. Il suffit de séparer chaque sous-groupe + avec une barre verticale | dans la valeur de $cache_id. Vous pouvez faire autant de sous-groupes que vous le désirez. - - Vous pouvez voir les groupes de cache comme une hiérarchie de dossiers. - Par exemple, un groupe de cache "a|b|c" peut être considéré comme - la hiérarchie de dossiers "/a/b/c/". Ainsi, - clear_cache(null,"a|b|c") supprimerait - les fichiers "/a/b/c/*". clear_cache(null,"a|b") supprimerait les fichiers - "/a/b/*". Si vous spécifiez un $compile_id - de cette façon : clear_cache(null,"a|b","foo"), il sera traité comme un groupe de - cache apposé "/a/b/c/foo/". Si vous spécifiez un nom de template de cette façon : - clear_cache("foo.tpl","a|b|c"), alors Smarty tentera d'effacer "/a/b/c/foo.tpl". - Vous ne POUVEZ PAS effacer un nom de template spécifié sous un groupe de - cache multiple comme "/a/b/*/foo.tpl", le groupement de cache fonctionne - UNIQUEMENT de gauche à droite. Vous pourriez vouloir grouper vos templates - sous un groupe de cache simple hiérarchisé pour être capable de les effacer - comme un groupe. - + + + + Vous pouvez voir les groupes de cache comme une hiérarchie de dossiers. + Par exemple, un groupe de cache 'a|b|c' peut être considéré comme + la hiérarchie de dossiers '/a/b/c/'. + + + + clear_cache(null,'a|b|c') + supprimera les fichiers + '/a/b/c/*'. clear_cache(null,'a|b') + supprimera les fichiers '/a/b/*'. + + + + Si vous spécifiez un + $compile_id + de cette façon clear_cache(null,'a|b','foo') il sera traité comme un groupe de + cache apposé '/a/b/c/foo/'. + + + + Si vous spécifiez un nom de template de cette façon + clear_cache('foo.tpl','a|b|c') alors Smarty tentera d'effacer + '/a/b/c/foo.tpl'. + + + + Vous ne POUVEZ PAS effacer un nom de template spécifié sous un groupe de + cache multiple comme '/a/b/*/foo.tpl', le groupement de cache fonctionne + UNIQUEMENT de gauche à droite. Vous pourriez vouloir grouper vos templates + sous un groupe de cache simple hiérarchisé pour être capable de les effacer + comme un groupe. + + + Le groupement de cache ne devrait pas être confondu avec votre hiérarchie de dossiers de templates, le groupement de cache n'a aucune connaissance de la façon dont vos templates sont structurés. Donc, par exemple, si - vous avez une structure de template comme "themes/blue/index.tpl" et - que vous voulez être capable d'effacer tous les fichiers de cache pour le thème "blue", + vous avez une structure de template comme themes/blue/index.tpl et + que vous voulez être capable d'effacer tous les fichiers de cache pour le thème blue, vous devriez créer une structure de groupe de cache qui reflète la structure - de fichiers de vos templates, comme display("themes/blue/index.tpl","themes|blue"), - et les effacer avec clear_cache(null,"themes|blue"). + de fichiers de vos templates, comme display('themes/blue/index.tpl','themes|blue'), + et les effacer avec clear_cache(null,'themes|blue'). Groupes d'identifiants de cache diff --git a/docs/fr/programmers/caching/caching-multiple-caches.xml b/docs/fr/programmers/caching/caching-multiple-caches.xml index 1951d860..4da14dc4 100644 --- a/docs/fr/programmers/caching/caching-multiple-caches.xml +++ b/docs/fr/programmers/caching/caching-multiple-caches.xml @@ -1,17 +1,17 @@ - + 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 + 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 celà en passant un identifiant de - cache ($cache_id) en deuxiéme paramètre a l'appel de fonction. + cache ($cache_id) en deuxiéme paramètre à l'appel de fonction. Passage d'un $cache_id à display() @@ -31,11 +31,11 @@ $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, + Nous passons ci-dessus la variable $my_cache_id à + 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 + article_id a été passé dans l'URL et est utilisé en tant qu'identifiant de cache. @@ -43,10 +43,10 @@ $smarty->display('index.tpl',$my_cache_id); 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 + ci-dessus consistant à 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 + donc si l'utilisateur décide de donner une trés grande valeur à article_id ou d'écrire un script qui envoie des article_id de façon aléatoire, celà 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 @@ -57,12 +57,12 @@ $smarty->display('index.tpl',$my_cache_id); Assurez-vous de bien passer le même identifiant aux fonctions - is_cached() et - clear_cache(). + is_cached() et + clear_cache(). Passer un cache_id a is_cached() - + 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 - à clear_cache(). + de cache particulier en passant &null; en tant que premier paramètre + à clear_cache(). Effacement de tous les fichiers de cache pour un identifiant de cache particulier - + caching = true; // efface tous les fichiers de cache avec "sports" comme identifiant -$smarty->clear_cache(null,"sports"); +$smarty->clear_cache(null,'sports'); -$smarty->display('index.tpl',"sports"); +$smarty->display('index.tpl','sports'); ?> ]]> diff --git a/docs/fr/programmers/caching/caching-setting-up.xml b/docs/fr/programmers/caching/caching-setting-up.xml index 295df9ce..72d0b8a1 100644 --- a/docs/fr/programmers/caching/caching-setting-up.xml +++ b/docs/fr/programmers/caching/caching-setting-up.xml @@ -1,13 +1,14 @@ - + Paramétrer le cache La première chose à faire est d'activer le cache en - mettant $caching = 1 - (ou 2). + mettant + $caching + = 1 (ou 2). Activation du cache @@ -25,31 +26,32 @@ $smarty->display('index.tpl'); - Avec le cache activé, la fonction display('index.tpl') va afficher + 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é à la réutilisation - du template. + $cache_dir. + Au prochain appel de display('index.tpl'), le fichier de cache sera préféré + à la réutilisation du template. Note technique - Les fichiers situés dans $cache_dir + Les fichiers situés dans + $cache_dir sont nommés de la même façon que les templates. - Bien qu'ils aient une extension ".php", ils ne sont pas vraiment directement exécutable. - N'éditez surtout pas ces fichiers ! + Bien qu'ils aient une extension .php, ils ne sont pas vraiment + directement 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 + linkend="variable.cache.lifetime">$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 à chaque fichier de cache en réglant - $caching = 2. + $caching=2. Se reporter à la documentation de $cache_lifetime pour plus de + linkend="variable.cache.lifetime">$cache_lifetime pour plus de détails. @@ -81,12 +83,13 @@ $smarty->display('home.tpl'); - Si $compile_check est actif, - chaque fichier de template et de configuration qui a un rapport + 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 couteux, donc, - pour des raisons de performances, mettez ce paramètre à false pour une application + pour des raisons de performances, mettez ce paramètre à &false; pour une application en production. @@ -106,15 +109,15 @@ $smarty->display('index.tpl'); - Si $force_compile est actif, + Si $force_compile est actif, les fichiers de cache sont toujours regénérés. Ceci revient finalement à - désactiver le cache. $force_compile + désactiver le cache. $force_compile est utilisé à des fins de débogage, un moyen plus efficace de désactiver le cache est de régler - $caching = 0. + $caching = 0. - La fonction is_cached() permet + 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 à une base de données, vous pouvez utiliser cette méthode plutôt @@ -144,20 +147,20 @@ $smarty->display('index.tpl'); Vous pouvez rendre dynamiques seulement certaines parties d'une page avec la fonction de template {insert}. + linkend="language.function.insert">{insert}. Imaginons que toute une page doit être mise en cache à part une bannière en bas à droite. En utilisant une fonction - {insert} pour la + {insert} pour la bannière, vous pouvez garder cet élément dynamique dans le contenu qui est en cache. Reportez-vous à la documentation - {insert} pour plus de détails + {insert} pour plus de détails ainsi que des exemples. Vous pouvez effacer tous les fichiers du cache avec la fonction clear_all_cache(), ou de façon + linkend="api.clear.all.cache">clear_all_cache(), ou de façon individuelle (ou par groupe) - avec la fonction clear_cache(). + avec la fonction clear_cache(). Nettoyage du cache @@ -169,12 +172,12 @@ $smarty = new Smarty; $smarty->caching = 1; -// efface tous les fichiers du cache -$smarty->clear_all_cache(); - // efface le fichier de cache du template 'index.tpl' $smarty->clear_cache('index.tpl'); +// efface tous les fichiers du cache +$smarty->clear_all_cache(); + $smarty->display('index.tpl'); ?> ]]> diff --git a/docs/fr/programmers/plugins/plugins-block-functions.xml b/docs/fr/programmers/plugins/plugins-block-functions.xml index 98c58409..2a8df1e9 100644 --- a/docs/fr/programmers/plugins/plugins-block-functions.xml +++ b/docs/fr/programmers/plugins/plugins-block-functions.xml @@ -1,6 +1,7 @@ - + + Fonctions de blocs @@ -12,89 +13,95 @@ - Les fonctions de blocs sont des fonctions de la forme {func} .. {/func}. + 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}. + 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}. - - Par défaut, 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 (voir &$repeat ci-dessous - sur la façon de modifier ce comportement). - - - 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 - contenus dans le tableau associatif $params. - Vous pouvez accéder à ces valeurs directement par - $params['start']. - 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 à - 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. - - - - Le paramètre &$repeat est passé - par référence à la fonction d'implémentation et fournit la possibilité - de contrôler le nombre d'affichage du bloc. Par défaut, - $repeat vaut true - lors du premier appel à la fonction de bloc (le bloc d'ouverture du tag) et - false lors de tous les autres appels à la fonction - de bloc (le bloc de fermeture du tag). Chaque fois que la fonction - d'implémentation retourne avec le paramètre - &$repeat vallant true, le contenu situé - entre {func} .. {/func} est évalué et la fonction d'implémentation est appelé - une nouvelle fois avec le nouveau bloc de contenu en tant que paramètre - $content. - - + + + + Par défaut, 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 (voir $repeat ci-dessous + sur la façon de modifier ce comportement). + + + 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 + contenus dans le tableau associatif $params. + 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 à &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. + + + + Le paramètre $repeat est passé + par référence à la fonction d'implémentation et fournit la possibilité + de contrôler le nombre d'affichage du bloc. Par défaut, + $repeat vaut + &true; lors du premier appel à la fonction de bloc (le bloc d'ouverture du tag) et + &false; lors de tous les autres appels à la fonction + de bloc (le bloc de fermeture du tag). Chaque fois que la fonction + d'implémentation retourne avec le paramètre + $repeat vallant &true;, le contenu situé + {func}...{/func} est évalué et la fonction d'implémentation est appelé + une nouvelle fois avec le nouveau bloc de contenu en tant que paramètre + $content. + + + Si vous imbriqué des fonctions de bloc, il est possible de connaître - la fonction de bloc parente grâce à la variable $smarty->_tag_stack. - Faîtes un var_dump() dessus et la structure devrait apparaître. - - - Regardez aussi : - register_block(), - unregister_block(). + la fonction de bloc parente grâce à la variable $smarty->_tag_stack. + Faîtes un var_dump() + dessus et la structure devrait apparaître. Fonction de bloc - ]]> + + Voir aussi : + register_block() et + unregister_block(). + - + + 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é. + une fonction personnalisée + ont le même nom, la fonction de compilation a priorité. @@ -22,11 +24,6 @@ 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 @@ -53,8 +50,10 @@ function smarty_compiler_tplheader($tag_arg, &$smarty) Cette fonction peut-être appelée depuis le template comme suivant : + Le code PHP résultant dans les templates compilés ressemblerait à ça : @@ -67,6 +66,11 @@ echo 'index.tpl compiled at 2002-02-20 20:02'; ]]> + + Voir aussi : + register_compiler_function() et + unregister_compiler_function(). + - + + Les fonctions de templates @@ -11,25 +12,23 @@ - Tous les attributs passés aux fonctions de template à partir du template + Tous les attributs + passés aux fonctions de template à partir du template sont contenus dans le tableau associatif $params. Le retour de la fonction sera substituée à la balise de fonction - du template (fonction fetch par exemple). Sinon, - la fonction peut simplement accomplir une autre tâche sans sortie - (la fonction assign par exemple). + du template (fonction + {fetch} + par exemple). Sinon, la fonction peut simplement accomplir une autre tâche 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 celà. - - Référez-vous aussi à : - register_function(), - unregister_function(). - Fonction de plugin avec sortie @@ -105,6 +104,11 @@ function smarty_function_assign($params, &$smarty) + + Voir aussi : + register_function() et + unregister_function(). + - + Insertions Les plugins d'insertion sont utilisés pour implémenter les fonctions qui sont appelées par les balises - {insert} + {insert} dans les templates. @@ -23,7 +23,7 @@ La fonction d'insertion est supposée retourner le résultat qui sera - substitué à la balise {insert} dans le template. + substitué à la balise {insert} dans le template. Plugin d'insertion diff --git a/docs/fr/programmers/plugins/plugins-modifiers.xml b/docs/fr/programmers/plugins/plugins-modifiers.xml index 86f6792a..7a6064a4 100644 --- a/docs/fr/programmers/plugins/plugins-modifiers.xml +++ b/docs/fr/programmers/plugins/plugins-modifiers.xml @@ -1,10 +1,12 @@ - + + Modificateurs - Les modificateurs sont des petites fonctions appliquées à une variable + Les modificateurs + sont de petites fonctions appliquées à une variable de template avant qu'elle ne soit affichée ou utilisée dans un autre contexte. Les modificateurs peuvent être chaînés entre eux. @@ -22,12 +24,8 @@ effectué. - Le modificateur doit retourner le résultat de son exécution. - - - Lisez également - register_modifier() et - unregister_modifier(). + Le modificateur doit retourner + le résultat de son exécution. Plugin modificateur simple @@ -93,6 +91,11 @@ function smarty_modifier_truncate($string, $length = 80, $etc = '...', ]]> + + Voir aussi : + register_modifier() et + unregister_modifier(). + - + + Conventions de nommage @@ -8,7 +9,7 @@ de nommage très spécifique pour être localisés par Smarty. - Les fichiers de plugins doivent être nommés de la façon suivante : + Les fichiers de plugins doivent être nommés de la façon suivante :
@@ -17,31 +18,39 @@
+ + + + 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, voir les + variables php. + + + + Quelques exemples : function.html_select_date.php, + resource.db.php, + modifier.spacify.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 + Les fonctions de plugins dans les fichiers de plugins doivent être nommées de la façon suivante :
@@ -49,16 +58,24 @@
- - Les significations de type et de nom sont les mêmes - que précédemment. - + + + + Les significations de type et de nom sont les mêmes + que précédemment. + + + Un exemple de nom de modificateur foo serait + function smarty_modifier_foo(). + + Smarty donnera des messages d'erreurs appropriés 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 8ed4f1bd..8347df68 100644 --- a/docs/fr/programmers/plugins/plugins-outputfilters.xml +++ b/docs/fr/programmers/plugins/plugins-outputfilters.xml @@ -1,6 +1,7 @@ - + + Filtres de sortie @@ -45,7 +46,15 @@ function smarty_outputfilter_protect_email($output, &$smarty) ]]> + + Voir aussi + + register_outputfilter() et + + unregister_outputfilter(). + + - + + filtres de pré-compilation/filtres de post-compilation @@ -84,6 +85,17 @@ ]]> + + Voir aussi + + register_prefilter(), + + unregister_prefilter() + + register_postfilter() et + + unregister_postfilter(). + - + + Ressources - - Les plugins ressources sont un moyen générique de fournir des sources - de templates ou des composants de scripts PHP à Smarty. Quelques exemples - de ressources : bases de données, LDAP, mémoire partagée, sockets, etc. - - - Il y au total 4 fonctions qui ont besoin d'être enregistrées pour - chaque type de ressource. Chaque fonction reçoit 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 - - + + Les plugins ressources sont un moyen générique de fournir des sources + de templates ou des composants de scripts PHP à Smarty. Quelques exemples + de ressources : bases de données, LDAP, mémoire partagée, sockets, etc. + + + Il y au total quatre fonctions qui ont besoin d'être enregistrées pour + chaque type de ressource. Chaque fonction reçoit 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éussit à 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éussit à 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 - réussit à 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 + réussit à 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 sûre - 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 sûre + 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 l'on peut faire confiance ou - non à 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 l'on peut faire confiance ou + non à 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. + + - - Lisez également - register_resource() et - unregister_resource(). - - - resource plugin - + + resource plugin + query("select tpl_source - from my_table - where tpl_name='$tpl_name'"); - if ($sql->num_rows) { - $tpl_source = $sql->record['tpl_source']; - return true; - } else { - return false; - } + // fait des requêtes BD pour récupérer votre template + // et remplir $tpl_source + $sql = new SQL; + $sql->query("select tpl_source + from my_table + where tpl_name='$tpl_name'"); + if ($sql->num_rows) { + $tpl_source = $sql->record['tpl_source']; + return true; + } else { + return false; + } } function smarty_resource_db_timestamp($tpl_name, &$tpl_timestamp, &$smarty) { - // fait des requêtes BD pour remplir $tpl_timestamp - $sql = new SQL; - $sql->query("select tpl_timestamp - from my_table - where tpl_name='$tpl_name'"); - if ($sql->num_rows) { - $tpl_timestamp = $sql->record['tpl_timestamp']; - return true; - } else { - return false; - } + // fait des requêtes BD pour remplir $tpl_timestamp + $sql = new SQL; + $sql->query("select tpl_timestamp + from my_table + where tpl_name='$tpl_name'"); + if ($sql->num_rows) { + $tpl_timestamp = $sql->record['tpl_timestamp']; + return true; + } else { + return false; + } } function smarty_resource_db_secure($tpl_name, &$smarty) { - // suppose que tous les templates sont svrs - return true; + // suppose que tous les templates sont svrs + return true; } function smarty_resource_db_trusted($tpl_name, &$smarty) { - // inutilisée pour les templates + // inutilisée pour les templates } ?> ]]> + + Voir aussi : + register_resource() et + unregister_resource(). + + + --> \ 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 ee597e5b..71fe0904 100644 --- a/docs/fr/programmers/plugins/plugins-writing.xml +++ b/docs/fr/programmers/plugins/plugins-writing.xml @@ -1,6 +1,7 @@ - + + Ecrire des plugins @@ -28,9 +29,20 @@ require_once $smarty->_get_plugin_filepath('function', 'html_options'); Une règle générale est que chaque objet Smarty est toujours passé au plugin - en tant que dernier paramètre (à part pour les modificateurs). + en tant que dernier paramètre, sauf pour deux exceptions : + + + les modificateurs ne sont pas passés du tout à l'objet Smarty + + + les blocs récupèrent le paramètre + $repeat passé après l'objet Smarty afin de + conserver une compatibilité avec les anciennes versions de Smarty. + + + +--> \ No newline at end of file diff --git a/docs/fr/programmers/smarty-constants.xml b/docs/fr/programmers/smarty-constants.xml index aada05a3..6b5e9076 100644 --- a/docs/fr/programmers/smarty-constants.xml +++ b/docs/fr/programmers/smarty-constants.xml @@ -1,6 +1,6 @@ - + Constantes @@ -10,7 +10,7 @@ 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 + S'il n'est pas défini dans votre script, Smarty essaiera alors d'en déterminer automatiquement la valeur. S'il est défini, le chemin doit se terminer par un slash. @@ -20,10 +20,10 @@ Voir aussi - $smarty.const et - $php_handling constants. + $smarty.const et + $php_handling constants. SMARTY_CORE_DIR - Il doit s'agir du chemin complet du répertoire où + Il doit s'agir du chemin complet du répertoire où se trouvent les fichiers internes de Smarty. S'il n'est pas défini, Smarty placera comme valeur par défaut la valeur de la constante précédente - SMARTY_DIR. S'il est + SMARTY_DIR. S'il est défini, le chemin doit se terminer par un slash. Utilisez cette constante lorsque vous incluez manuellement n'importe quel fichier core.*. @@ -65,7 +65,7 @@ require_once(SMARTY_CORE_DIR . 'core.get_microtime.php'); Voir aussi - $smarty.const. + $smarty.const.