From c5ebd65858f0a74812fa0f7ee09ac6ab6d451ed4 Mon Sep 17 00:00:00 2001 From: yannick Date: Sat, 30 Sep 2006 15:12:18 +0000 Subject: [PATCH] sync with EN --- .../language-function-capture.xml | 41 +- .../language-function-config-load.xml | 30 +- .../language-function-foreach.xml | 422 +++++++++++++----- .../language-function-if.xml | 16 +- 4 files changed, 358 insertions(+), 151 deletions(-) diff --git a/docs/fr/designers/language-builtin-functions/language-function-capture.xml b/docs/fr/designers/language-builtin-functions/language-function-capture.xml index 0c166245..0ae1e4e5 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-capture.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-capture.xml @@ -1,26 +1,28 @@ - + {capture} - {capture} est utilisé pour récupérer la sortie d'éléments dans une variable - au lieu de les afficher. Tout contenu situé entre {capture - name='foo'} et {/capture} est intercepté dans une variable dont le nom est - spécifié dans l'attribut name. + {capture} est utilisé pour récupérer la sortie d'éléments dans + une variable au lieu de les afficher. Tout contenu situé entre + {capture name='foo'} et {/capture} + est intercepté dans une variable dont le nom est spécifié dans l'attribut + name. Le contenu capturé peut être utilisé dans le template par l'intermédiaire de la variable spéciale - $smarty.capture.foo - où "foo" est la valeur de l'attribut name. Si vous ne donnez pas de valeur - à l'attribut name, alors "default" est utilisé en tant que nom, i.e. - $smarty.capture.default. + $smarty.capture.foo + où foo est la valeur de l'attribut name. + Si vous ne donnez pas de valeur à l'attribut name, alors + default est utilisé en tant que nom, i.e. + $smarty.capture.default. - {capture} peut être imbriqué. + {capture} peut être imbriqué. @@ -59,11 +61,11 @@ - Faîtes attention lorsque vous interceptez la sortie de commandes {insert}. + Faîtes attention lorsque vous interceptez la sortie de commandes + {insert}. Si vous avez configuré le cache pour que ce dernier soit actif, et que vous avez des commandes {insert} + linkend="language.function.insert">{insert} supposées s'exécuter dans un contenu en cache, ne tentez pas de capturer ce contenu. @@ -87,7 +89,7 @@ {capture} dans une variable de template Cet exemple démontre également la fonction - {popup} + {popup} Voir aussi - $smarty.capture, - {eval}, - {fetch}, - fetch() et - {assign}. + $smarty.capture, + {eval}, + {fetch}, + fetch() et + {assign}. diff --git a/docs/fr/designers/language-builtin-functions/language-function-config-load.xml b/docs/fr/designers/language-builtin-functions/language-function-config-load.xml index 3e104a75..2222a5ff 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-config-load.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-config-load.xml @@ -1,13 +1,13 @@ - + {config_load} - {config_load} est utiliseé pour charger des variables - #variables# + {config_load} est utiliseé pour charger des variables + #variables# depuis un fichier de configuration dans un template. @@ -75,9 +75,9 @@ - fonction {config_load} + Fonction {config_load} - example.conf + Le fichier example.conf Les fichiers de configuration peuvent contenir des sections. Vous pouvez charger des variables d'une section donnée avec le - nouvel attribut 'section'. + nouvel attribut section. - Les sections des fichiers de configuration - et la fonction native - {section} + Les sections des fichiers de configuration + et la fonction native + {section} n'ont rien en commun, il s'avère simplement qu'elles portent le même nom. @@ -150,17 +150,17 @@ pageTitle = "Info personnalis - Voir aussi $config_overwrite + Voir aussi $config_overwrite pour les tableaux de variables de configuration. Voir aussi - les fichiers de configuration, - les variables de configuration, - $config_dir, - get_config_vars() et - config_load(). + les fichiers de configuration, + les variables de configuration, + $config_dir, + get_config_vars() et + config_load(). diff --git a/docs/fr/designers/language-builtin-functions/language-function-foreach.xml b/docs/fr/designers/language-builtin-functions/language-function-foreach.xml index d910f7f3..3f7d5115 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-foreach.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-foreach.xml @@ -1,31 +1,22 @@ - + {foreach},{foreachelse} - - Les boucles {foreach} sont une alternative aux boucles - section. - Les boucles {foreach} - sont utilisées pour parcourir des tableaux associatifs simples. - La syntaxe des boucles {foreach} est bien plus simple - que celle des boucles {section}, mais en contrepartie, - elles ne peuvent être utilisées que pour des tableaux associatifs - simples. La balise {foreach} doit toujours être accompagnée - de la balise {/foreach}. Les paramètres requis sont - from et item. Le nom des boucles - {foreach} doit être composés exclusivement de lettres, - chiffres et underscores, selon vos préférences. Les boucles - {foreach} peuvent être imbriquées. - La variable from (généralement le tableau à - parcourir) détermine le nombre de fois que {foreach} - sera exécuté. {foreachelse} est exécuté si aucune - valeur n'est présente dans la variable donnée à l'attribut - from. + {foreach} est utilisé pour parcourir un + simple tableau associatif, + contrairement à {section} + qui effectue une boucle sur les tableaux de données. + La synthaxe pour + {foreach} est plus simple que + {section}, + mais ne peut être utilisé que pour des tableau simple. + Chaque {foreach} doit aller de paire avec une balise fermante + {/foreach}. - + @@ -70,27 +61,89 @@ Non n/a Le nom de la boucle foreach, qui nous permettra - d'accéder à ses propriétés. + d'accéder à ses propriétés. + + + + + Required attributes are from and item. + + + + The name of the {foreach} loop can be anything + you like, made up of letters, numbers and underscores, like + PHP variables. + + + + {foreach} loops can be nested, and the nested + {foreach} names must be unique from each other. + + + + The from attribute, usually an array of values, + determines the number of times {foreach} will loop. + + + + {foreachelse} is executed when there are no + values in the from variable. + + + + {foreach} loops also have their own variables that handle properties. + These are accessed with: + + {$smarty.foreach.name.property} with + name being the + name attribute. + + + Note + The name attribute is only required when + you want to access a {foreach} property, unlike + {section}. + Accessing a {foreach} property with name + undefined does not throw an error, but leads to unpredictable results instead. + + + + + + {foreach} properties are + index, + iteration, + first, + last, + show, + total. + + + - foreach + L'attribut <parameter>item</parameter> assign('custid', $arr); +$arr = array(1000, 1001, 1002); +$smarty->assign('myArray', $arr); ?> ]]> + + Template pour afficher $myArray dans une liste non-ordonnée. + -{/foreach} +
    + {foreach from=$myArray item=foo} +
  • {$foo}
    • + {/foreach} +
]]> @@ -98,38 +151,116 @@ $smarty->assign('custid', $arr); -id: 1001
-id: 1002
+
    +
  • 1000
    • +
  • 1001
    • +
  • 1002
    • +
]]> - foreach key + Utilisation des attributs <parameter>item</parameter> et <parameter>key</parameter> assign('contacts', array( - array('phone' => '1', - 'fax' => '2', - 'cell' => '3'), - array('phone' => '555-4444', - 'fax' => '555-3333', - 'cell' => '760-1234')) - ); +$arr = array(9 => 'Tennis', 3 => 'Natation', 8 => 'Programmation'); +$smarty->assign('myArray', $arr); ?> ]]> + + Le template affiche le tableau $myArray comme paire clé/valeur, + comme la fonction PHP + foreach. + + + + {foreach from=$myArray key=k item=v} +
  • {$k}: {$v}
    • + {/foreach} + +]]> +     + + L'exemple ci-dessus affichera : + + + +
  • 9: Tennis
    • +
  • 3: Natation
    • +
  • 8: Programmation
    • + +]]> +     +     + + + {foreach} avec un attribut associatif <parameter>item</parameter> + + array('no' => 2456, 'label' => 'Salad'), + 96 => array('no' => 4889, 'label' => 'Cream') +); +$smarty->assign('items', $items_list); +?> +]]> + + + Le template affiche $items avec + $myId dans l'URL. + + + + {foreach from=$items key=myId item=i} +
  • {$i.no}: {$i.label}
    • + {/foreach} + + ]]> +     + + L'exemple ci-dessus affichera : + + + +
  • 2456: Salad
    • +
  • 4889: Cream
    • + +]]> + +     + + + {foreach} avec <parameter>item</parameter> et <parameter>key</parameter> + Assigne un tableau à Smarty, la clé contient la clé pour chaque valeur de la boucle. + +assign('contacts', array( +array('phone' => '1', + 'fax' => '2', + 'cell' => '3'), + array('phone' => '555-4444', + 'fax' => '555-3333', + 'cell' => '760-1234') +)); +?> +]]> + + Le template affiche $contact. - {foreach key=key item=item from=$contact} - {$key}: {$item}
    - {/foreach} +
    + {foreach key=key item=item from=$contact} + {$key}: {$item}
    + {/foreach} {/foreach} ]]>     @@ -139,92 +270,167 @@ $smarty->assign('contacts', array( - phone: 1
    - fax: 2
    - cell: 3
    +phone: 1
    +fax: 2
    +cell: 3
    - phone: 555-4444
    - fax: 555-3333
    - cell: 760-1234
    +phone: 555-4444
    +fax: 555-3333
    +cell: 760-1234
    ]]>     - {foreach} - Exemple avec une base de données (eg PEAR ou ADODB) + Exemple d'une base de données avec {foreachelse} + Exemple d'un script de recherche dans une base de données (e.g. PEAR ou ADODB), + le résultat de la requête est assigné à Smarty. assign("contacts", $db->getAssoc($sql)); +$search_condition = "where name like '$foo%' "; +$sql = 'select contact_id, name, nick from contacts '.$search_condition.' order by name'; +$smarty->assign('results', $db->getAssoc($sql) ); ?> ]]> + Le template qui affiche None found + si aucun résultat avec {foreachelse}. {$con.name} - {$con.nick}
    +{foreach key=cid item=con from=$results} +{$con.name} - {$con.nick}
    +{foreachelse} +Aucun élément n'a été trouvé dans la recherche +{/foreach} +]]> + + + + + .index + + index contient l'index courant du tableau, en commançant par zéro. + + + Exemple avec <parameter>index</parameter> + + + {foreach from=$items key=myId item=i name=foo} + {if $smarty.foreach.foo.index % 5 == 0} + Title + {/if} + {$i.label} + {/foreach} + +]]> + + + + + + .iteration + + iteration contient l'itération courante de la boucle et commence + toujours à 1, contrairement à + index. + Il est incrémenté d'un, à chaque itération. + + + Exemple avec <parameter>iteration</parameter> et <parameter>index</parameter> + + - - + + + .first + + first vaut &true; si l'itération courante de + {foreach} est l'initial. + + + Exemple avec <parameter>first</parameter> + + + {foreach from=$items key=myId item=i name=foo} + + {if $smarty.foreach.foo.first}LATEST{else}{$myId}{/if} + {$i.label} + + {/foreach} + +]]> + + + + + .last - Les boucles {foreach} ont également leurs propres variables qui gèrent les propriétés - de {foreach}. Elles sont indiquées par : - {$smarty.foreach.foreachname.varname} - où foreachname est le nom spécifié par l'attribut name - de foreach. + last est défini à &true; si l'itération courante de + {foreach} est la dernière. - - Voir {section} - pour des exemples avec les proriétés ci-dessus. + + Exemple avec <parameter>last</parameter> + +{$prod}{if $smarty.foreach.products.last}
    {else},{/if} +{foreachelse} +... contenu ... +{/foreach} +]]> +     +     +     + + .show + + show est utilisé en tant que paramètre à {foreach}. + show est une valeur booléenne. S'il vaut + &false;, {foreach} ne sera pas affiché. + S'il y a un {foreachelse}, il sera affiché alternativement. + - - iteration - - iteration est utilisé pour afficher l'itération de la boucle courante. - iteration commence toujours par 1 et est incrémenté - à chaque itération. - - + + .total + + total contient le nombre d'itérations que cette boucle + {foreach} effectuera. + Il peut être utilisé dans ou après un {foreach}. + + + Exemple avec <parameter>total</parameter> + +
    +{if $smarty.foreach.foo.last} +
    {$smarty.foreach.foo.total} items
    +{/if} +{foreachelse} +... quelque chose d'autre ... +{/foreach} +]]> +     +     - - first - - first est défini à true si l'itération courante de foreach est la première. - - - - - last - - last est défini à true si l'itération courante de foreach est la dernière. - - - - - show - - show est utilisé en tant que paramètre de foreach. - show est un booléen (true ou false). - S'il vaut false, foreach ne sera pas affiché. Si foreachelse est présent, - il sera affiché alternativement. - - - - - total - - total est utilisé pour afficher le nombre d'itérations - bouclées par ce foreach. Il peut être utilisé dans ou après le foreach. - Voir aussi - {section} et - $smarty.foreach. + {section} + et $smarty.foreach.     diff --git a/docs/fr/designers/language-builtin-functions/language-function-if.xml b/docs/fr/designers/language-builtin-functions/language-function-if.xml index e6647b09..224d913f 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-if.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-if.xml @@ -1,25 +1,25 @@ - + {if},{elseif},{else} - L'instruction {if} dans Smarty dispose de la même flexibilité que l'instruction - PHP if, + L'instruction {if} dans Smarty dispose de la même flexibilité que l'instruction + PHP if, avec quelques fonctionnalités supplémentaires pour le - moteur de template. Tous les {if} doivent être - utilisés de pair avec un {/if}. - {else} et {elseif} sont également + moteur de template. Tous les {if} doivent être + utilisés de pair avec un {/if}. + {else} et {elseif} sont également des balises autorisées. Toutes les conditions et fonctions PHP sont reconnues, comme ||, or, &&, and, is_array(), etc. - Si $security est actif, + Si $security est actif, alors le tableau IF_FUNCS dans le tableau - $security_settings (?!). + $security_settings (?!). La liste suivante présente les opérateurs reconnus, qui doivent être entourés d'espaces.