From 2504b1b6c4afcd02bdc55f6e6c58d4c2115a542c Mon Sep 17 00:00:00 2001 From: yannick Date: Sun, 26 Dec 2004 20:05:31 +0000 Subject: [PATCH] sync with EN & typo --- docs/fr/language-defs.ent | 1 + docs/fr/language-snippets.ent | 27 +++ docs/fr/livedocs.ent | 2 +- .../fr/programmers/caching/caching-groups.xml | 53 +++-- .../caching/caching-multiple-caches.xml | 10 +- .../caching/caching-setting-up.xml | 201 ++++++++++-------- .../plugins/plugins-block-functions.xml | 137 +++++++----- .../plugins/plugins-compiler-functions.xml | 95 +++++---- .../programmers/plugins/plugins-functions.xml | 116 +++++----- docs/fr/programmers/plugins/plugins-howto.xml | 11 +- .../programmers/plugins/plugins-inserts.xml | 67 +++--- .../programmers/plugins/plugins-modifiers.xml | 95 +++++---- .../plugins/plugins-naming-conventions.xml | 14 +- .../plugins/plugins-outputfilters.xml | 61 +++--- .../plugins-prefilters-postfilters.xml | 49 +++-- .../programmers/plugins/plugins-resources.xml | 68 +++--- .../programmers/plugins/plugins-writing.xml | 24 ++- 17 files changed, 579 insertions(+), 452 deletions(-) diff --git a/docs/fr/language-defs.ent b/docs/fr/language-defs.ent index 7ffb0d71..8eb16df1 100644 --- a/docs/fr/language-defs.ent +++ b/docs/fr/language-defs.ent @@ -1,4 +1,5 @@ + diff --git a/docs/fr/language-snippets.ent b/docs/fr/language-snippets.ent index e69de29b..70163b09 100644 --- a/docs/fr/language-snippets.ent +++ b/docs/fr/language-snippets.ent @@ -0,0 +1,27 @@ + + + + + Note technique + + Le paramètre merge respecte les clés du tableau, + donc, si vous fusionnez deux tableaux indexés numériquement, ils peuvent + se recouvrir les uns les autres ou aboutir à des clés non séquentielles. Ceci + est diférent de la fonction PHP array_merge() qui élimine des clés numériques + et les renumérote. + +'> + + + En tant que troisième paramètre optionnel, vous pouvez passer un + identifiant de compilation compile_id. + C'est au cas où vous voudriez compiler plusieurs versions du + même template, par exemple, pour avoir des templates compilés + pour différents langages. Une autre utilité pour l'identifiant de compilation + compile_id est lorsque vous utilisez plus d'un $template_dir mais + seulement un $compile_dir. Définissez un compile_id + séparé pour chaque $template_dir, sinon, les templates du même nom + s'effaceront. Vous pouvez également définir la variable + $compile_id une seule fois + plutôt que de la passer à chaque appel à la fonction. +'> \ No newline at end of file diff --git a/docs/fr/livedocs.ent b/docs/fr/livedocs.ent index 912fc842..0e9e5652 100644 --- a/docs/fr/livedocs.ent +++ b/docs/fr/livedocs.ent @@ -1,5 +1,5 @@ - + '> '> diff --git a/docs/fr/programmers/caching/caching-groups.xml b/docs/fr/programmers/caching/caching-groups.xml index 95a3dae4..2b510a49 100644 --- a/docs/fr/programmers/caching/caching-groups.xml +++ b/docs/fr/programmers/caching/caching-groups.xml @@ -1,17 +1,43 @@ - + - groupes de fichiers 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 + 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. 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. + + + 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 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"). + - groupes d'identifiants de cache - + Groupes d'identifiants de cache + +clear_cache(null,"sports|basketball"); // Inclue donc "sports|basketball" ou "sports|nimportequoi|nimportequoi|..." $smarty->clear_cache(null,"sports"); -$smarty->display('index.tpl',"sports|basketball"); +$smarty->display('index.tpl',"sports|basketball"); +?> +]]> + - - 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 - les fichiers de cache dans le répertoire "theme/blue". Si vous voulez - 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'). - - - + Paramétrer le cache - La premiére chose a faire est d'activer le cache. Cela est fait en + La première chose à faire est d'activer le cache. Cela est fait en mettant $caching = true (ou 1). - activation du cache - + Activation du cache + +caching = true; -$smarty->display('index.tpl'); +$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 ! - - + display('index.tpl'), le fichier de cache sera préféré à la réutilisation + du template. + + + Note technique - 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. + 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 exécutable. + N'éditez surtout pas ces fichiers ! - - réglage individuel de cache_lifetime - + + + 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 à chaque fichier de cache en réglant + $caching = 2. + Se reporter à la documentation de $cache_lifetime pour plus de + détails. + + + Réglage individuel de cache_lifetime + +display('home.tpl'); // plus la valeur de $cache_lifetime. Le cache de home.tpl expirera toujours // 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. - - - activation de $compile_check - +$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 couteux, donc, + pour des raisons de performances, mettez ce paramètre à false pour une application + en production. + + + Activation de $compile_check + +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, - un moyen plus efficace de désactiver le cache est de régler - $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. - - - utilisation de is_cached() - +$smarty->display('index.tpl'); +?> +]]> + + + + Si $force_compile est actif, + les fichiers de cache sont toujours regénérés. Ceci revient finalement à + 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 = 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 + à une base de données, vous pouvez utiliser cette méthode plutôt + que $compile_check. + + + Exemple avec is_cached() + +caching = true; if(!$smarty->is_cached('index.tpl')) { // pas de cache disponible, on assigne - $contents = get_database_contents(); - $smarty->assign($contents); + $contents = get_database_contents(); + $smarty->assign($contents); } -$smarty->display('index.tpl'); - - - Vous pouvez rendre dynamiques seulement certaines parties d'une - page avec la fonction de templates insert. - Imaginons que toute une page doit être mise en cache a part - une banniére en bas a droite. En utilisant une fonction insert pour la - 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. - - - 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 - +$smarty->display('index.tpl'); +?> +]]> + + + + Vous pouvez rendre dynamiques seulement certaines parties d'une + page avec la fonction de template 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 + 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 + ainsi que des exemples. + + + Vous pouvez effacer tous les fichiers du cache avec la fonction clear_all_cache(), ou de façon + individuelle (ou par groupe) avec la fonction clear_cache(). + + + Nettoyage du cache + +clear_all_cache(); // efface le fichier de cache du template 'index.tpl' $smarty->clear_cache('index.tpl'); -$smarty->display('index.tpl'); - - +$smarty->display('index.tpl'); +?> +]]> + + + - -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(), + + + 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}. + + + 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. + + + + 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(). - - - fonction de bloc - -<?php + + + Fonction de bloc + + - - +} +?> +]]> + + + - -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(), + + + 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 chaîne 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 + + + Fonction de compilation simple + + - - Cette fonction peut-être appelé depuis le template comme suivant : - - +?> +]]> + + + Cette fonction peut-être appelée 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 : - - -<php +{tplheader} + + + Le code PHP résultant dans les templates compilés ressemblerait à ça : + + + - - +?> +]]> + + + - -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(), + + + Les fonctions de templates + + + void smarty_function_name + array $params + object &$smarty + + + + 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). + + + 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 - -<?php + + + + Fonction de plugin avec sortie + + - - - - peut être utilisée dans le template de la faton suivante : - - +?> +]]> + + + + + peut être utilisée dans le template de la façon suivante : + + Question: Will we ever have time travel? -Answer: {eightball}. - - - fonction de plugin sans sortie - -<?php +Answer: {eightball}. + + + + Fonction de plugin sans sortie + + * Purpose : assigne une valeur a une variable de template * ------------------------------------------------------------- */ -function smarty_function_assign($params, &$smarty) +function smarty_function_assign($params, &$smarty) { extract($params); @@ -98,10 +100,12 @@ function smarty_function_assign($params, &$smarty) $smarty->assign($var, $value); } -?> - - - +?> +]]> + + + + - + Comment fonctionnent les plugins - Les plugins sont toujours chargés a la demande. Seuls les modificateurs + Les plugins sont toujours chargés à 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 @@ -19,9 +19,10 @@ 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. + Le répertoire de plugin peut + être une chaîne de caractères contenant un chemin ou un tableau contenant + de multiples chemins. Pour installer un plugin, placez-le simplement + dans un de ces dossiers et Smarty l'utilisera automatiquement. - -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 + + + 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é à la fonction est une tableau associatif + d'attributs. + + + La fonction d'insertion est supposée retourner le résultat qui sera + substitué à la balise insert dans le template. + + + Plugin d'insertion + +trigger_error("insert time: missing 'format' parameter"); @@ -50,8 +49,10 @@ function smarty_insert_time($params, &$smarty) $datetime = strftime($params['format']); return $datetime; } -?> - +?> +]]> + + - -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(), + + + Modificateurs + + Les modificateurs sont des 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. + + + + 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. + + + Lisez également + register_modifier() et unregister_modifier(). + + + Plugin modificateur simple + + Ce plugin est un alias d'une fonction PHP. Il n'a aucun paramètre + supplémentaires. - - plugin modificateur simple - - Ce plugin est un alias d'une fonction PHP. Il n'a aucun paramétre - supplémentaires. - - -<?php + + - - - - un plugin modificateur un peu plus complexe - -<?php +?> +]]> + + + + + Un plugin modificateur un peu plus complexe + + - - +?> +]]> + + + - + 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. + de nommage très spécifique pour être localisés par Smarty. - Les fichiers de plugins doivent être nommés de la faton suivante : + Les fichiers de plugins doivent être nommés de la façon suivante :
@@ -18,7 +18,7 @@
- Oú type est l'une des valeurs suivantes : + Où type est l'une des valeurs suivantes : function modifier @@ -42,7 +42,7 @@ Les fonctions de plugins dans les fichiers de plugins doivent être - nommées de la faton suivante : + nommées de la façon suivante :
smarty_type_nom @@ -54,8 +54,8 @@ 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 + 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. diff --git a/docs/fr/programmers/plugins/plugins-outputfilters.xml b/docs/fr/programmers/plugins/plugins-outputfilters.xml index 8122d920..8ed4f1bd 100644 --- a/docs/fr/programmers/plugins/plugins-outputfilters.xml +++ b/docs/fr/programmers/plugins/plugins-outputfilters.xml @@ -1,28 +1,31 @@ - -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é à 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 pré-compilation/filtres de post-compilation - Les filtres de pré-compilation et les filtres de post-compilation ont des concepts trés + 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. + moment où ils sont exécutés. @@ -17,9 +17,9 @@ 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 + juste avant la compilation. Le premier paramètre passé à 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. + d'autres filtres 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. @@ -32,16 +32,17 @@ 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. + (le code PHP) juste après que la compilation a été faîte mais juste + avant que le template ne soit sauvegardé sur le système de fichiers. + Le premier paramètre passé à la fonction de filtre de post-compilation est le code + du template compilé, éventuellement déja modifié par d'autres filtres de post-compilations. + Le plugin est censé retourner la version modifiée du code. - plugin de filtre de post-compilation - -<?php + Plugin de filtre de post-compilation + +]+>!e', 'strtolower("$1")', $source); } -?> +?> +]]> + - plugin de filtre de post-compilation - -<?php + Plugin de filtre de post-compilation + +\nget_template_vars()); ?>\n" . $compiled; return $compiled; } -?> +?> +]]> + - + 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. + 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 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. + 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. @@ -40,31 +39,31 @@ - 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 + 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. + 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 + 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. + 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 svre + 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 on peut faire confiance ou - non a la ressource demandée. Cette fonction est utilisée seulement + 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, @@ -72,14 +71,15 @@ - Regardez aussi - register_resource(), - unregister_resource(). - - - resource plugin - -<?php + Lisez également + register_resource() et + unregister_resource(). + + + resource plugin + + - - +?> +]]> + + + - + Ecrire des plugins Les plugins peuvent être soit chargés automatiquement par Smarty - depuis le systéme de fichier, soit être déclarés + 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. + des fonctions n'ont pas à 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 : + (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'; + +_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 (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 (à part pour les modificateurs).