diff --git a/docs/fr/designers/chapter-debugging-console.xml b/docs/fr/designers/chapter-debugging-console.xml index 383b58f7..426b89e4 100644 --- a/docs/fr/designers/chapter-debugging-console.xml +++ b/docs/fr/designers/chapter-debugging-console.xml @@ -1,38 +1,41 @@ - + + Console de débogage Il existe une console de débogage dans Smarty. La console vous indique - toutes les templates incluses, + toutes les templates incluses, les variables assignées et chargées depuis un fichier de - configuration pour le template courant. - Un template appelé "debug.tpl" est inclus dans la distribution de Smarty qui contrôle - le formattage de la console.Définissez $debugging - à true dans Smarty et, si besoin, vous pouvez définir - $debug_tpl de façon à ce que ce dernier - contienne le chemin du template à utiliser(dans - SMARTY_DIR par defaut). + configuration pour le template courant. + Un template appelé debug.tpl est inclus dans la distribution de Smarty qui contrôle + le formattage de la console. Définissez $debugging + à &true; dans Smarty et, si besoin, vous pouvez définir + $debug_tpl + de façon à ce que ce dernier contienne le chemin du template à utiliser(dans + SMARTY_DIR par defaut). Lorsque vous chargez la page, une console javascript est censée surgir et vous donner les noms de toutes les variables inclues et assignées dans votre page courante. Pour voir toutes les variables d'un template particulier, - voir la fonction {debug}. + voir la fonction {debug}. Pour désactiver la console de débogage, définissez - $debugging à false. + $debugging à &false;. Vous pouvez également temporairement activer le débogage en indiquant - SMARTY_DEBUG dans l'url si tant est que l'option - $debugging_ctrl soit activée. + SMARTY_DEBUG dans l'url si tant est que l'option + $debugging_ctrl + soit activée. Note technique - La console de débogage ne fonctionne pas si vous utilisez l'API - fetch(), - mais seulement lorsque vous utilisez display(). - C'est en effet un jeu d'instructions javascripts à la fin du template qui déclenchent + La console de débogage ne fonctionne pas si vous utilisez l'API + fetch(), + mais seulement lorsque vous utilisez + display(). + C'est en effet un jeu d'instructions javascripts à la fin du template qui déclenchent l'ouverture de la fenêtre. Si vous n'aimez pas javascript, vous pouvez modifier - debug.tpl pour formater les données de la façon qui vous conviendra le + debug.tpl pour formater les données de la façon qui vous conviendra le mieux. Les données de débogage ne sont pas mises en cache et les informations de debug.tpl ne sont pas incluses dans la sortie de la console de débogage. @@ -47,10 +50,11 @@ Voir aussi troubleshooting, - $error_reporting - et trigger_error(). + $error_reporting + et trigger_error(). + - + + Fichiers de configuration @@ -63,13 +64,13 @@ pass=foobar section, la variable de section est prioritaire. Si vous appelez deux variables dans une même section de la même façon, la dernière déclarée prime. (voir - $config_overwrite) + $config_overwrite) Les fichiers de configuration sont chargés dans le template grâce aux fonctions {config_load} - (voir aussi config_load()). + linkend="language.function.config.load">{config_load} + (voir aussi config_load()). Vous pouvez masquer des variables ou des sections entières en préfixant @@ -82,11 +83,11 @@ pass=foobar Voir aussi - {config_load}, - $config_overwrite, - get_config_vars(), - clear_config() et - config_load(). + {config_load}, + $config_overwrite, + get_config_vars(), + clear_config() et + config_load(). diff --git a/docs/fr/designers/language-builtin-functions.xml b/docs/fr/designers/language-builtin-functions.xml index d776001f..436ab980 100644 --- a/docs/fr/designers/language-builtin-functions.xml +++ b/docs/fr/designers/language-builtin-functions.xml @@ -1,6 +1,6 @@ - + Fonctions natives @@ -14,10 +14,10 @@ Quelques-unes de ces fonctions ont un attribut - assign qui récupère le résultat de la + assign qui récupère le résultat de la fonction et la place dans une variable nommée dans le template plutôt que de l'afficher.tout comme la fonction - {assign}. + {assign}. &designers.language-builtin-functions.language-function-capture; diff --git a/docs/fr/designers/language-modifiers.xml b/docs/fr/designers/language-modifiers.xml index 54777d57..2a3efc1a 100644 --- a/docs/fr/designers/language-modifiers.xml +++ b/docs/fr/designers/language-modifiers.xml @@ -1,6 +1,6 @@ - + Modificateurs de variables @@ -14,8 +14,9 @@ est succeptible d'accepter des paramètres additionnels, qui en affectent le comportement. Ces paramètres suivent le nom du modificateur et sont séparés par un : (deux points). - De plus, toutes les fonctions PHP peuvent être utilisées en tant que modifieurs - implicitement. + Toutes les fonctions PHP peuvent être utilisées en tant que modifieurs + implicitement (plus d'informations ci-dessous) et les modificateurs peuvent + être combinés. Exemple de modificateur @@ -57,41 +58,64 @@ ]]> + + Si vous appliquez un modificateur de variable à un tableau plutôt qu'à une variable simple, le modificateur sera appliqué à chaque valeur du tableau. Si vous souhaitez que le modificateur travaille réellement avec le tableau en tant que tel, vous devez préfixer le nom du modificateur avec un symbole - @ comme ceci: {$titreArticle|@count} - (Affiche le nombre d'élements du tableau $titreArticle.) + @ + + Exemple + {$articleTitle|@count} - affichera le nombre + d'éléments dans le tableau $articleTitle en utilisant + la fonction PHP count() + comme modificateur. + + + + + Les modificateurs sont chargés automatiquement depuis votre répertoire - de plugin $plugins_dir - ou peuvent être enregistrés explicitement avec register_modifier() ; ceci est utile - pour partager une fonction dans un scirpt PHP et les templates Smarty. + de plugin $plugins_dir + ou peuvent être enregistrés explicitement avec + register_modifier() ; + ceci est utile pour partager une fonction dans un scirpt PHP et les templates Smarty. + + + Toutes les fonction PHP peuvent être utilisées comme modificateur, - sans autre déclaration. (L'exemple avec - @count ci-dessus utilise la fonction count(), et non un modificateur - Smarty. Utiliser des fonctions PHP en tant que modificateur comporte deux - risques: Premièrement: il arrive que l'ordre des paramètres ne soit pas - celui attendu ({"%2.f"|sprintf:$float} fonctionne, - mais demande une syntaxe plus naturelle, par exemple{$float|string_format:"%2.f"} - fourni dans la distribution Smarty). Deuxièmement : lorsque $security est activé, les fonctions PHP - utilisées en tant que modificateur doivent être explicitement déclarées - comme connues dans le tableau - $security_settings['MODIFIER_FUNCS']. - + sans autre déclaration, tel que dans l'exemple ci-dessus. + Cepdendant, l'utilisation de fonctions PHP comme modificateurs + contient deux petits pièges à éviter : + + Le premier - quelques fois, l'ordre des paramètres de la fonction + n'est pas celui attendu. Le formattage de $foo avec + {"%2.f"|sprintf:$foo} fonctionne actuellement, mais + n'est pas aussi intuitif que + {$foo|string_format:"%2.f"}, ce qui est fournit par Smarty. + + + Le deuxième - Si + $security est activé, toutes les fonctions PHP + qui devront être utilisées comme modificateurs, doivent être déclarées dans l'élément + MODIFIER_FUNCS du tableau + + $security_settings. + + + + Voir aussi - register_modifier(), - register_function(), - étendre Smarty avec des plugins - et les modifieurs. + register_modifier(), + les modificateurs combinés. + et étendre Smarty avec des plugins. &designers.language-modifiers.language-modifier-capitalize; diff --git a/docs/fr/designers/language-variables.xml b/docs/fr/designers/language-variables.xml index 8abfa9a1..93e3a981 100644 --- a/docs/fr/designers/language-variables.xml +++ b/docs/fr/designers/language-variables.xml @@ -1,6 +1,7 @@ - + + Variables @@ -15,7 +16,9 @@ conditionnelles, etc. Pour afficher une variable, il suffit de l'entourer par des délimiteurs de - telle sorte qu'elle soit la seule chose qu'ils contiennent. Exemple : + telle sorte qu'elle soit la seule chose qu'ils contiennent. + + Exemple de variables ]]> - + + + + Astuce + La façon de la simple d'analyser les variables Smarty est + d'utiliser la + console de débogage. - + + + &designers.language-variables.language-assigned-variables; &designers.language-variables.language-config-variables; &designers.language-variables.language-variables-smarty; - +