diff --git a/docs/fr/programmers/advanced-features/advanced-features-objects.xml b/docs/fr/programmers/advanced-features/advanced-features-objects.xml index 3ae4db0e..928df256 100644 --- a/docs/fr/programmers/advanced-features/advanced-features-objects.xml +++ b/docs/fr/programmers/advanced-features/advanced-features-objects.xml @@ -1,18 +1,28 @@ - + Objets Smarty donne l'accès aux objets - PHP à travers les templates. Il y a 2 moyens d'y avoir accès. Le premier consiste à + PHP à travers les templates. Il y a 2 moyens d'y avoir accès. + + + + Le premier consiste à allouer les objets au template puis de les utiliser avec une syntaxe similaire a celles des fonctions personnalisées. + + Le deuxième moyen consiste à assigner des objets aux templates et de les utiliser comme n'importe quelle - variable. La première méthode a une syntaxe beaucoup plus sympathique. + variable. + + + + La première méthode a une syntaxe beaucoup plus sympathique. Elle est aussi plus sécurisée, puisqu'un objet alloué ne peut avoir accès qu'a certaines méthodes et propriétés. Néanmoins, un objet alloué ne peut pas avoir de lien sur lui-même @@ -22,7 +32,7 @@ afin de réduire la syntaxe des templates au minimum. - Si l'option de sécurité + Si l'option de sécurité est activée, aucune méthode ou fonctions privées n'est accessible (commentant par "_"). S'il existe une méthode et une propriété du même nom, c'est la méthode qui sera utilisée. @@ -39,7 +49,7 @@ 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, - à false. + à &false;. Le cinquième paramètre optionnel n'a d'effet que si le paramètre @@ -47,8 +57,8 @@ 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 : + 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, @@ -87,7 +97,7 @@ $smarty->display('index.tpl'); ]]> - Et voici comment accéder à vos objets dans index.tpl: + Et voici comment accéder à vos objets dans index.tpl : Voir aussi - register_object() et - assign(). + register_object() et + assign(). diff --git a/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml b/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml index 3c5db556..2a850fc3 100644 --- a/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml +++ b/docs/fr/programmers/advanced-features/advanced-features-outputfilters.xml @@ -1,13 +1,13 @@ - + Filtres de sortie Quand le template est appelé via les fonctions - display() ou - fetch(), + display() ou + fetch(), 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 @@ -19,9 +19,9 @@ déclarés soit chargés depuis les répertoires des plugins en utilisant la fonction - load_filter() + load_filter() ou en réglant la variable - $autoload_filters. + $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. @@ -51,11 +51,11 @@ $smarty->display('index.tpl'); Voir aussi - register_outpurfilter(), - load_filter(), - $autoload_filters, + register_outpurfilter(), + load_filter(), + $autoload_filters, les filtres de post-compilation et - $plugins_dir. + $plugins_dir. diff --git a/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml b/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml index f47f5fa0..97bbf334 100644 --- a/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml +++ b/docs/fr/programmers/advanced-features/advanced-features-postfilters.xml @@ -1,16 +1,18 @@ - + 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 + exécutent après avoir été compilés. Les filtres de post-compilation + peuvent être soit déclarés, soit chargés depuis les répertoires des plugins - en utilisant la fonction load_filter() ou en réglant - la variable $autoload_filters. + 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. @@ -32,7 +34,7 @@ $smarty->display('index.tpl'); ]]> - Votre template Smarty index.tpl ressemblera, après compilation à : + Votre template Smarty index.tpl ressemblera, après compilation à : display('index.tpl'); Voir aussi - register_postfilter(), + register_postfilter(), les pré-filtres et - load_filter(). + load_filter(). diff --git a/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml b/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml index 4021eb39..f8c53d12 100644 --- a/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml +++ b/docs/fr/programmers/advanced-features/advanced-features-prefilters.xml @@ -1,12 +1,12 @@ - + Filtres de pré-compilation Les filtres de pré-compilation sont des fonctions PHP que vos templates - exécutent avant qu'ils ne soient compilés. Celà peut être utile + exécutent avant qu'ils ne soient compilés. Celà 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. @@ -14,9 +14,9 @@ Les filtre de pré-compilations peuvent être soit déclarés, soit chargés à partir des répertoires de plugins - en utilisant la fonction load_filter() ou + en utilisant la fonction load_filter() ou en réglant la variable - $autoload_filters. + $autoload_filters. Smarty passera à la fonction le code source en tant que premier argument, @@ -45,9 +45,9 @@ $smarty->display('index.tpl'); Voir aussi - register_prefilter(), + register_prefilter(), les post-filtres et - load_filter(). + load_filter(). 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 7b599c08..cb7991e5 100644 --- a/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml +++ b/docs/fr/programmers/advanced-features/section-template-cache-handler-func.xml @@ -1,6 +1,7 @@ - + + Fonction de gestion du cache @@ -14,25 +15,53 @@ 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 à 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 (optionnel). - - Note: Le dernier paramètre ($exp_time) a été ajouté dans Smarty-2.6.0. - + + + + Le premier argument est l'action, qui sera read, write and + 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 à 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 $cache_id. + + + + Le sixième est l'identifiant optionnel + $compile_id. + + + + Le septième et dernier paramètre $exp_time + a été ajouté dans Smarty-2.6.0. + + + + Exemple d'utilisation de MySQL pour la source du cache - + + Ressources Les templates peuvent provenir d'une grande variété de ressources. Quand vous - affichez (display()) ou - récupérez (fetch()) 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. Si une ressource n'est pas - explicitement donnée, la valeur de la variable $default_resource_type + affichez (display()) ou + récupérez (fetch()) 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. + 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 + 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'à fournir le chemin vers le template que vous voulez utiliser, relatif - au répertoire racine $template_dir. + au répertoire racine + $template_dir. Utilisation de templates depuis $template_dir @@ -43,9 +45,9 @@ $smarty->display("file:admin/menu.tpl"); // le m 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 + 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. @@ -53,8 +55,8 @@ $smarty->display("file:admin/menu.tpl"); // le m display("file:/export/templates/index.tpl"); -$smarty->display("file:/path/to/my/templates/menu.tpl"); +$smarty->display('file:/export/templates/index.tpl'); +$smarty->display('file:/path/to/my/templates/menu.tpl'); ?> ]]> @@ -63,7 +65,7 @@ $smarty->display("file:/path/to/my/templates/menu.tpl"); @@ -73,7 +75,7 @@ $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 + Assurez-vous de bien mettre file: dans le chemin pour éviter des conflits d'espace de noms et obtenir les résultats escomptés. @@ -81,8 +83,8 @@ $smarty->display("file:/path/to/my/templates/menu.tpl"); display("file:C:/export/templates/index.tpl"); -$smarty->display("file:F:/path/to/my/templates/menu.tpl"); +$smarty->display('file:C:/export/templates/index.tpl'); +$smarty->display('file:F:/path/to/my/templates/menu.tpl'); ?> ]]> @@ -91,7 +93,7 @@ $smarty->display("file:F:/path/to/my/templates/menu.tpl"); @@ -114,7 +116,7 @@ $smarty->display("file:F:/path/to/my/templates/menu.tpl"); - Notez que vous ne pouvez pas écraser la ressource file native, + Notez que vous ne pouvez pas écraser la ressource file: native, toutefois, vous pouvez fournir une ressource qui récupère un template depuis le système de fichier par un autre moyen en l'enregistrant sous un autre nom de ressource. @@ -184,7 +186,7 @@ $smarty->display("db:index.tpl");