Devise

Dans l’espace privé du site

Dans la page de préférences d’un auteur, il est possible de remplir le champ « Devise préférée » afin d’associer une devise à un auteur. La signification exacte de cette association peut varier suivant les cas ; elle est laissée à l’appréciation du ou de la webmestre.

Utilisation générale dans les squelettes

Dans tout le site, il est possible d’utiliser directement les chaînes de langues fournies. Par exemple :
-  <:devise:EUR:> renvoie le nom de la monnaie dans la langue du contexte. Par exemple : Euro
-  <:devise:s_EUR:> renvoie le nom de la monnaie au singulier pour un prix. Par exemple, 1&nbsp;<:devise:s_EUR:> affichera « 1 euro ».
-  <:devise:p_EUR:> renvoie le nom de la monnaie au pluriel pour un prix. Par exemple, 42&nbsp;<:devise:p_EUR:> affichera « 42 euros ».

Utilisation dans une boucle AUTEURS

Dans une boucle AUTEURS, il est possible d’utiliser la balise #DEVISE pour récupérer le code à 3 lettres de la monnaie choisie par cet auteur.

Dans le cas (probable) où l’on souhaite afficher le nom de la monnaie en toutes lettres (et dans la langue du contexte), les modèles suivants sont tout indiqués :
-  #MODELE{auteur_nom_devise} fournit le nom général de la devise (Euro, Dollar des États-Unis, etc.)
-  #MODELE{auteur_devise_singulier} et #MODELE{auteur_devise_pluriel} permettent d’utiliser le nom dans un prix.

Dans une boucle POUR

La balise #DEVISES renvoie un tableau contenant tous les codes à 3 lettres des monnaies disponibles. Ceci permet de l’utiliser par exemple dans une boucle POUR si jamais SPIP-Bonux est installé.

Fonctions PHP et filtres

Deux fonctions/filtres sont fournies.

formater_devise($devise, $format) ou |formater_devise{format} permet d’afficher un nom de devise de façon personnalisée. Le format peut utiliser les codes suivants :
-  %C : code ISO de la devise.
-  %N, %sN, %pN : son nom en toutes lettres : générique, singulier ou pluriel.
-  %% : signe « % ».

devises_codes([$description]) renvoie un tableau avec les codes ISO de toutes les devises connues. Si une description est fournie et contient les codes décrits plus haut, c’est un tableau associatif qui est renvoyée, avec pour clés les codes ISO et pour valeurs la description demandée.

Saisie

Le plugin fournit également une saisie devise, pour faciliter la création de formulaires. Ses paramètres sont ceux de la saisie « selection »

Améliorations possibles

Il serait fort pratique d’intégrer une fonction de conversion en temps réel (par exemple en utilisant un webservice), pour s’adapter aux variations de taux de change. Ceci permettrait de fournir des prix dans la devise choisie par le visiteur.

Exemple

Ce plugin est utilisé sur le site d’arts Plaztika, pour afficher le prix lorsqu’on sélectionne un tableau.