repo_zf1/documentation/manual/fr/module_specs/Zend_View-Helpers-Currency.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<sect3 id="zend.view.helpers.initial.currency">
    <title>Aide Currency</title>

    <para>
        Afficher des informations de monnaie localisées est très courant; l'aide de vue de
        <classname>Zend_Currency</classname> est dédiée à cela. Voyez le chapitre
        <link linkend="zend.currency.introduction">sur Zend Currency</link> pour les détails sur la
        localisation. Dans cette section, nous apprendrons à manipuler l'aide de vue uniquement.
    </para>

    <para>
        Il existe plusieurs manières d'initialiser l'aide de vue <emphasis>Currency</emphasis>:
    </para>

    <itemizedlist>
        <listitem>
            <para>
                Enrigistrée dans une instance de
                <classname>Zend_Registry</classname>.
            </para>
        </listitem>

        <listitem>
            <para>
                Grâce à une interface fluide.
            </para>
        </listitem>

        <listitem>
            <para>
                En instanciant directement la classe.
            </para>
        </listitem>
    </itemizedlist>

    <para>
        L'enregistrement en registre de <classname>Zend_Currency</classname> est la manière recommandée.
        Grâce à cela vous pouvez selectionner la monnaie à utiliser puis ajouter son adaptateur au registre.
    </para>

    <para>
        Pour séléctionner la valeur de la monnaie à utiliser, passez une chaine ou
        encore une locale ce qui est recommandé car les informations provenant du client HTTP seront alors
        utilisées par défaut.
    </para>

    <note>
        <para>
            Nous parlons bien de "locales" et non de "langues" car la langue peut varier en fonction de
            la position géorgraphique au sein d'un même pays.Par exemple, l'anglais est parlé dans différents
            dialectes : Anglais ou Américain. Une monnaie est liée directement à une région, vous devrez
            donc utiliser une locale complète c'est à dire représentant le pays <emphasis>et</emphasis>
            la région. Nous parlons donc de "locale" plutôt que de "langue."
        </para>
    </note>

    <example id="zend.view.helpers.initial.currency.registered">
        <title>Instance en registre</title>

        <para>
            Pour utiliser une instance en registre, créez une instance de
            <classname>Zend_Currency</classname> et enregistrez la dans
            <classname>Zend_Registry</classname> en utilisant la clé
            <classname>Zend_Currency</classname>.
        </para>

        <programlisting language="php"><![CDATA[
// notre monnaie d'exemple
$currency = new Zend_Currency('de_AT');
Zend_Registry::set('Zend_Currency', $currency);

// Dans votre vue
echo $this->currency(1234.56);
// Ceci affiche '€ 1.234,56'
]]></programlisting>
    </example>

    <para>
        Si vous préférez utiliser l'interface fluide, vous pouvez alors créer une instance
        dans votre vue et la configurer après cela.
    </para>

    <example id="zend.view.helpers.initial.currency.afterwards">
        <title>Instance dans la vue</title>

        <para>
            Pour utiliser l'interface fluide, créez une instance de <classname>Zend_Currency</classname>,
            appelez l'aide de vue sans paramètre et appelez ensuite la méthode <methodname>setCurrency()</methodname>.
        </para>

        <programlisting language="php"><![CDATA[
// Dans votre vue
$currency = new Zend_Currency('de_AT');
$this->currency()->setCurrency($currency)->currency(1234.56);
// Ceci affiche '€ 1.234,56'
]]></programlisting>
    </example>

    <para>
        Si vous utilisez l'aide sans <classname>Zend_View</classname> alors vous pouvez aussi
        l'utiliser de manière directe, via instanciation manuelle.
    </para>

    <example id="zend.view.helpers.initial.currency.directly.example-1">
        <title>Utilisation directe via instanciation</title>

        <programlisting language="php"><![CDATA[
// Notre monnaie d'exemple
$currency = new Zend_Currency('de_AT');

// Initialisation de l'aide de vue
$helper = new Zend_View_Helper_Currency($currency);
echo $helper->currency(1234.56); // Ceci affiche '€ 1.234,56'
]]></programlisting>
    </example>

    <para>
        Comme déja vu, la méthode <methodname>currency()</methodname> est utilisée pour retourner
        la chaine représentant la monnaie. Appelez la simplement avec la valeur que vous voulez
        voir affichée. Des options sont aussi disponibles, elles servent à changer le comportement
        interne de l'aide.
    </para>

    <example id="zend.view.helpers.initial.currency.directly.example-2">
        <title>Utilisation directe</title>

        <programlisting language="php"><![CDATA[
// Notre monnaie d'exemple
$currency = new Zend_Currency('de_AT');

// Initialisation de l'aide de vue
$helper = new Zend_View_Helper_Currency($currency);
echo $helper->currency(1234.56); // Ceci affiche '€ 1.234,56'
echo $helper->currency(1234.56, array('precision' => 1));
// Ceci affiche '€ 1.234,6'
]]></programlisting>
    </example>

    <para>
        Concernant les options disponibles, voyez la méthode
        <methodname>toCurrency()</methodname> de  <classname>Zend_Currency</classname>.
    </para>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->