diff --git a/docs/fr/programmers/advanced-features.xml b/docs/fr/programmers/advanced-features.xml index 7c892387..551460ea 100644 --- a/docs/fr/programmers/advanced-features.xml +++ b/docs/fr/programmers/advanced-features.xml @@ -1,6 +1,6 @@ - + Fonctionnalités avancées &programmers.advanced-features.advanced-features-objects; diff --git a/docs/fr/programmers/advanced-features/advanced-features-objects.xml b/docs/fr/programmers/advanced-features/advanced-features-objects.xml index bef33ae0..f75573e0 100644 --- a/docs/fr/programmers/advanced-features/advanced-features-objects.xml +++ b/docs/fr/programmers/advanced-features/advanced-features-objects.xml @@ -1,10 +1,10 @@ - + Objets - Smarty donne l'accès aux objets PHP a travers les templates. Il y + Smarty donne l'accès aux objets PHP à 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 @@ -28,23 +28,38 @@ 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 + Par défaut, les paramètres passés aux objets depuis le template le sont de la + même façon que les fonctions utilisateurs les récupèrent. + Le premier paramètre correspond à un tableau associatif, le second à l'objet + Smarty. Si vous souhaitez que les paramètres soient passés un à un, comme dans un appel traditionnel, définissez registration, quatrième paramètre optionnel, - a false. + à false. + + + Le cinquième paramètre optionnel n'a d'effet que si le paramètre + format vaut true et il contient + une liste de méthodes qui doivent être traitées comme des blocks. Celà signifie + que ces méthodes ont un tag fermant dans le template + ({foobar->meth2}...{/foobar->meth2}) et que les paramètres + de ces méthodes fonctionnent de la même façon que les paramètres des blocks + de fonctions des plugins : Ils contiennent 4 paramètres + $params, + $content, + &$smarty et + &$repeat et ils fonctionnent de la même + façon que les blocks de fonctions des plugins. - utilisation d'un objet alloué ou assigné - -<?php + Utilisation d'un objet alloué ou assigné + +register_object("foobar",$myobj,null,false); $smarty->assign_by_ref("myobj", $myobj); $smarty->display("index.tpl"); -?> - -TEMPLATE: +?> +?> +]]> + + + Et voici comment accéder à vos objets dans index.tpl: + + +meth1 p1="foo" p2=$bar} @@ -71,7 +92,9 @@ TEMPLATE: the output was {$output) {* access our assigned object *} -{$myobj->meth1("foo",$bar)} +{$myobj->meth1("foo",$bar)} +]]> + - + 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 + sa sortie est envoyée à travers un ou plusieurs filtres de sorties. + Ils diffèrent des filtres de post-compilation dans le sens où 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 - -<?php + 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 + +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 -?> - - +?> +]]> + + + - + 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 + ê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 + 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 + +\n\"; ?>\n".$tpl_source; } // enregistre le filtre de post-compilation $smarty->register_postfilter("add_header_comment"); $smarty->display("index.tpl"); -?> - -{* template Smarty compilé index.tpl *} -<!-- Created by Smarty! --> -{* reste du contenu du template... *} - - +?> +]]> + + + Votre template Smarty index.tpl ressemblera, après compilation à : + + + +{* reste du contenu du template... *} +]]> + + + - + Filtres de pré-compilation @@ -8,51 +8,58 @@ 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. - 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 + déclarés, soit chargés + à partir des répertoires de plugins en utilisant la fonction + load_filter() ou en réglant + la variable + $autoload_filters. + + + Smarty passera à 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 + +/U","",$tpl_source); } // enregistrer le filtre de pré-compilation $smarty->register_prefilter("remove_dw_comments"); $smarty->display("index.tpl"); -?> - -{* template Smarty index.tpl *} -<!--# cette ligne va être supprimée par le filtre de pré-compilation --> - - - +?> +]]> + + + Ceci effacera tous les commentaires de la source du template. + + + + 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 0272380f..c6bcb69f 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 @@ -5,33 +5,33 @@ 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 + de cache) consiste à 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 + fonction à 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 - du cache. Pour écrire, Smarty passe le contenu du cache dans ces paramètres. - Pour lire, Smarty s'attend a ce que votre fonction accepte ce paramètre - par référence et que vous le remplissiez avec les données du cache. Pour effacer, - il suffit de passer une variable fictive car cette dernière n'est pas utilisée. - 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. - - - Note: Le dernier paramètre ($exp_time) a été ajouté dans Smarty-2.6.0. - - - exemple d'utilisation de MySQL pour la source du cache - - + + Note: Le dernier paramètre ($exp_time) a été ajouté dans Smarty-2.6.0. + + + Exemple d'utilisation de MySQL pour la source du cache + +display('index.tpl'); la base mysql est attendu dans ce format : - + create database SMARTY_CACHE; create table CACHE_PAGES( @@ -58,78 +58,78 @@ CacheContents MEDIUMTEXT NOT NULL function mysql_cache_handler($action, &$smarty_obj, &$cache_content, $tpl_file=null, $cache_id=null, $compile_id=null) { - // l'h(te de la bd, l'utilisateur, et le mot de passe - $db_host = 'localhost'; - $db_user = 'myuser'; - $db_pass = 'mypass'; - $db_name = 'SMARTY_CACHE'; - $use_gzip = false; - - // crée un identifiant de cache unique - $CacheID = md5($tpl_file.$cache_id.$compile_id); - - if(! $link = mysql_pconnect($db_host, $db_user, $db_pass)) { - $smarty_obj->_trigger_error_msg("cache_handler: could not connect to database"); - return false; - } - mysql_select_db($db_name); + // l'hôte de la bd, l'utilisateur, et le mot de passe + $db_host = 'localhost'; + $db_user = 'myuser'; + $db_pass = 'mypass'; + $db_name = 'SMARTY_CACHE'; + $use_gzip = false; + + // crée un identifiant de cache unique + $CacheID = md5($tpl_file.$cache_id.$compile_id); + + if(! $link = mysql_pconnect($db_host, $db_user, $db_pass)) { + $smarty_obj->_trigger_error_msg("cache_handler: could not connect to database"); + return false; + } + mysql_select_db($db_name); + + switch ($action) { + case 'read': + // récupère le cache dans la base de données + $results = mysql_query("select CacheContents from CACHE_PAGES where CacheID='$CacheID'"); + if(!$results) { + $smarty_obj->_trigger_error_msg("cache_handler: query failed."); + } + $row = mysql_fetch_array($results,MYSQL_ASSOC); + + if($use_gzip && function_exists("gzuncompress")) { + $cache_content = gzuncompress($row["CacheContents"]); + } else { + $cache_content = $row["CacheContents"]; + } + $return = $results; + break; + case 'write': + // sauvegarde le cache dans la base de données + + if($use_gzip && function_exists("gzcompress")) { + // compresse le contenu pour gagner de la place + $contents = gzcompress($cache_content); + } else { + $contents = $cache_content; + } + $results = mysql_query("replace into CACHE_PAGES values( + '$CacheID', + '".addslashes($contents)."') + "); + if(!$results) { + $smarty_obj->_trigger_error_msg("cache_handler: query failed."); + } + $return = $results; + break; + case 'clear': + // efface les données du cache + if(empty($cache_id) && empty($compile_id) && empty($tpl_file)) { + // les efface toutes + $results = mysql_query("delete from CACHE_PAGES"); + } else { + $results = mysql_query("delete from CACHE_PAGES where CacheID='$CacheID'"); + } + if(!$results) { + $smarty_obj->_trigger_error_msg("cache_handler: query failed."); + } + $return = $results; + break; + default: + // erreur, action inconnue + $smarty_obj->_trigger_error_msg("cache_handler: unknown action \"$action\""); + $return = false; + break; + } + mysql_close($link); + return $return; - switch ($action) { - case 'read': - // récupère le cache dans la base de données - $results = mysql_query("select CacheContents from CACHE_PAGES where CacheID='$CacheID'"); - if(!$results) { - $smarty_obj->_trigger_error_msg("cache_handler: query failed."); - } - $row = mysql_fetch_array($results,MYSQL_ASSOC); - - if($use_gzip && function_exists("gzuncompress")) { - $cache_content = gzuncompress($row["CacheContents"]); - } else { - $cache_content = $row["CacheContents"]; - } - $return = $results; - break; - case 'write': - // sauvegarde le cache dans la base de données - - if($use_gzip && function_exists("gzcompress")) { - // compresse le contenu pour gagner de la place - $contents = gzcompress($cache_content); - } else { - $contents = $cache_content; - } - $results = mysql_query("replace into CACHE_PAGES values( - '$CacheID', - '".addslashes($contents)."') - "); - if(!$results) { - $smarty_obj->_trigger_error_msg("cache_handler: query failed."); - } - $return = $results; - break; - case 'clear': - // efface les données du cache - if(empty($cache_id) && empty($compile_id) && empty($tpl_file)) { - // les efface toutes - $results = mysql_query("delete from CACHE_PAGES"); - } else { - $results = mysql_query("delete from CACHE_PAGES where CacheID='$CacheID'"); - } - if(!$results) { - $smarty_obj->_trigger_error_msg("cache_handler: query failed."); - } - $return = $results; - break; - default: - // erreur, action inconnue - $smarty_obj->_trigger_error_msg("cache_handler: unknown action \"$action\""); - $return = false; - break; - } - mysql_close($link); - return $return; - } ?> diff --git a/docs/fr/programmers/advanced-features/template-resources.xml b/docs/fr/programmers/advanced-features/template-resources.xml index 8b5bc0d6..abe18f04 100644 --- a/docs/fr/programmers/advanced-features/template-resources.xml +++ b/docs/fr/programmers/advanced-features/template-resources.xml @@ -1,52 +1,68 @@ - + 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. + par le chemin approprié et le nom du template. Si une ressource n'est pas + explicitement donnée, la valeur de la variable $default_resource_type + sera utilisée. 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 + la ressource "file" pour être cohérent. Vous n'avez qu'à 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 + +display("index.tpl"); $smarty->display("admin/menu.tpl"); -$smarty->display("file:admin/menu.tpl"); // le même que celui ci-dessus +$smarty->display("file:admin/menu.tpl"); // le même que ci-dessus +?> {* le template Smarty *} {include file="index.tpl"} -{include file="file:index.tpl"} {* le même que celui ci-dessus *} +{include file="file:index.tpl"} {* le même que ci-dessus *} +]]> + - Templates a partir de n'importe quel répertoire + Templates à 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 + Utilisation d'un template depuis n'importe quel répertoire + +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"} +?> +]]> + + + Le template Smarty : + + + + @@ -55,17 +71,26 @@ $smarty->display("file:/path/to/my/templates/menu.tpl"); 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. + conflits d'espace de noms et obtenir les résultats escomptés. - utilisation de templates avec des chemins de fichiers Windows - -// le script PHP + Utilisation de templates avec des chemins de fichiers Windows + +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"} +?> +]]> + + + Le template Smarty : + + + + @@ -73,15 +98,17 @@ $smarty->display("file:F:/path/to/my/templates/menu.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, + Vous pouvez récupérer les templates à partir de n'importe quelle + source à 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. + Reportez-vous à la section ressource plugins + pour plus d'informations sur les fonctions que vous êtes censé fournir. + Notez que vous ne pouvez pas écraser la ressource file native, @@ -91,12 +118,12 @@ $smarty->display("file:F:/path/to/my/templates/menu.tpl"); - utilisation de ressources utilisateurs - -// le script PHP - + Utilisation de ressources utilisateurs + +register_resource("db", array("db_get_template", // utilise la ressource depuis le script PHP $smarty->display("db:index.tpl"); - -{* utilise la ressource depuis le template Smarty *} -{include file="db:/extras/navigation.tpl"} +?> +]]> + + + Le template Smarty : + + + + @@ -156,35 +191,38 @@ $smarty->display("db:index.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 + 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. + la création de templates à la volée. utilisation de la fonction de gestion de template par défaut - -<?php + +_write_file($resource_name,$template_source); - return true; - } - } else { - // pas un fichier - return false; + if( $resource_type == 'file' ) { + if ( ! is_readable ( $resource_name )) { + // crée le fichier de template et renvoie le contenu + $template_source = "Ceci est un nouveau template."; + $template_timestamp = time(); + $smarty_obj->_write_file($resource_name,$template_source); + return true; } + } else { + // pas un fichier + return false; + } } // régle la fonction par défaut $smarty->default_template_handler_func = 'make_template'; -?> +?> +]]> + diff --git a/docs/fr/programmers/api-functions.xml b/docs/fr/programmers/api-functions.xml index f1e35411..12a983f3 100644 --- a/docs/fr/programmers/api-functions.xml +++ b/docs/fr/programmers/api-functions.xml @@ -1,8 +1,15 @@ - - + + Méthodes + + +
+ + <para></para> + </section> + </partintro> &programmers.api-functions.api-append; &programmers.api-functions.api-append-by-ref; &programmers.api-functions.api-assign; @@ -42,7 +49,9 @@ &programmers.api-functions.api-unregister-postfilter; &programmers.api-functions.api-unregister-prefilter; &programmers.api-functions.api-unregister-resource; -</chapter> + +</reference> + <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/docs/fr/programmers/api-variables.xml b/docs/fr/programmers/api-variables.xml index 3198f873..d84c68a1 100644 --- a/docs/fr/programmers/api-variables.xml +++ b/docs/fr/programmers/api-variables.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision$ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <chapter id="api.variables"> <title>Variables @@ -11,8 +11,6 @@ &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; @@ -35,9 +33,12 @@ &programmers.api-variables.variable-right-delimiter; &programmers.api-variables.variable-compiler-class; &programmers.api-variables.variable-request-vars-order; + &programmers.api-variables.variable-request-use-auto-globals; + &programmers.api-variables.variable-error-reporting; &programmers.api-variables.variable-compile-id; &programmers.api-variables.variable-use-sub-dirs; &programmers.api-variables.variable-default-modifiers; + &programmers.api-variables.variable-default-resource-type; - + Cache @@ -9,25 +9,26 @@ linkend="api.fetch">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 + 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 + 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. + à la façon 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 + de météo mise 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; + + &programmers.caching.caching-cacheable; - + 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 + utilisée pour pratiquement toutes les fonctionnalités personnalisables de Smarty. Ceci comprend : les fonctions @@ -19,9 +19,9 @@ les insertions A part pour les ressources, la compatibilité avec les anciennes - fatons d'enregistrer les fonctions de gestion avec l'API register_ + façons 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 + à 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. diff --git a/docs/fr/programmers/smarty-constants.xml b/docs/fr/programmers/smarty-constants.xml index ec2455f2..5f084ff3 100644 --- a/docs/fr/programmers/smarty-constants.xml +++ b/docs/fr/programmers/smarty-constants.xml @@ -1,20 +1,18 @@ - + Constantes - SMARTY_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 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 @@ -26,6 +24,30 @@ define("SMARTY_DIR","/usr/local/lib/php/Smarty/"); require_once(SMARTY_DIR."Smarty.class.php"); ?> +]]> + + + + + SMARTY_CORE_DIR + + 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 + défini, le chemin doit se terminer par un slash. Utilisez cette + constante lorsque vous incluez manuellement n'importe + quel fichier core.*. + + + SMARTY_CORE_DIR + + ]]>