Configurer un sélecteur de devises WooCommerce : FOX pas à pas

Voici comment configurer le sélecteur de devises WooCommerce FOX, de l'installation à une boutique testée : la devise de base, les devises dans lesquelles vous vendez, les taux de change, la devise de paiement et le sélecteur sur la page. Comptez une quinzaine de minutes. Presque tous les problèmes de « prix erronés après l'installation » viennent de l'une de trois causes traitées dans les premières étapes : aucune devise de base marquée, un taux de base différent de 1, ou un code de devise que les services de taux et les passerelles de paiement ne reconnaissent pas. Réglez ces points et le reste relève de la préférence d'affichage.

Comment FOX convertit les prix

WooCommerce enregistre un seul prix par produit, dans une seule devise. FOX l'appelle la devise de base et ne modifie jamais les prix enregistrés : chaque fois qu'un prix est affiché, il multiplie le prix de base par le taux de la devise du visiteur. Un produit enregistré à 50 avec une base en euros et un taux du dollar de 1,10 s'affiche à 55 $ ; en revenant à l'euro, on retrouve 50 €. Rien n'est écrit dans les produits.

Deux conséquences en découlent. Tous les prix des produits doivent être saisis dans la devise de base. Et marquer plus tard une autre devise comme devise de base ne convertit rien : les mêmes nombres sont simplement lus dans la nouvelle devise, de sorte qu'une boutique qui passe sa base de l'EUR à l'USD vend pour 50 $ son produit à 50 €. Décidez d'abord de la devise de base.

Tous les réglages se trouvent dans WooCommerce → Réglages → Devise (WooCommerce → Settings → Currency), répartis sur les onglets Devises (Currencies), Options, Avancé (Advanced), Paiements (Payments), GeoIP, Statistiques (Statistic), Designer, Latéral (Side) et Aide (Help). Les tutoriels vidéo parcourent les mêmes écrans.

Étape 1 : marquer la devise de base et garder son taux à 1

À la première activation, FOX remplit l'onglet Devises (Currencies) avec deux lignes : la devise de votre boutique WooCommerce, marquée comme base, et une seconde devise (EUR si la boutique est en dollars américains, sinon USD). Les taux de ces lignes de départ sont des valeurs provisoires, et pour les boutiques dans une devise autre que l'USD ou l'EUR, même la ligne de base démarre avec un taux provisoire. La première action est donc toujours la même :

1. Vérifiez que le bouton radio de la colonne De base (Basic) est sur la devise dans laquelle vos prix de produits sont saisis. Sinon, cliquez dessus.
2. Cliquez sur Mettre à jour tous les taux (Update all rates) en haut de l'onglet.
3. Cliquez sur Enregistrer les modifications (Save changes) en bas de la page.

Un clic sur le bouton radio De base (Basic) fixe le taux de cette devise à exactement 1, verrouille le champ, efface tout intérêt et charge des taux actualisés pour toutes les autres devises par rapport à elle. Mettre à jour tous les taux (Update all rates) fait la même chose pour la devise déjà marquée. Les nouveaux taux sont placés dans les champs, mais seul Enregistrer les modifications (Save changes) les enregistre. L'enregistrement inscrit aussi la devise de base dans le réglage de devise propre à WooCommerce, de sorte que les deux ne divergent jamais.

Ce qui se passe lorsque cette étape est ignorée :

• Aucune devise marquée comme base. FOX retombe sur l'USD comme base. Une boutique dont les prix sont en dollars canadiens affiche alors ses prix, et enregistre ses commandes, comme s'il s'agissait de dollars américains.
• Un taux de base différent de 1. Chaque taux du tableau signifie « cette quantité de la devise pour 1 unité de la devise de base » ; la ligne de base elle-même doit donc indiquer 1. Son champ est verrouillé, mais il conserve la valeur qu'il contient tant que vous ne cliquez pas sur le bouton radio ou sur Mettre à jour tous les taux (Update all rates), et les conversions d'une devise à l'autre divisent par cette valeur, si bien que les résultats sont faux.
• Des taux laissés à 1 pour toutes les devises. Les prix ne sont pas du tout convertis : un produit à 500 Rs apparaît à 500 $ après le changement. Mettez les taux à jour.

Ne marquez pas une devise comme base uniquement pour que les visiteurs la voient en premier. C'est le rôle de Devise d'accueil (Welcome currency) dans l'onglet Options ; voir afficher une devise différente de la devise de base.

Étape 2 : ajouter les devises dans lesquelles vous vendez

Cliquez sur Ajouter une devise à la fin (Append Currency) (ajoute une ligne en bas) ou sur Ajouter une devise au début (Prepend Currency) (en haut), puis remplissez la ligne :

1. Saisissez en majuscules le code ISO 4217 à trois lettres dans le champ du code : AUD, NZD, XPF. Ce code est ce que reconnaissent les passerelles de paiement et les agrégateurs de taux ; il doit donc être exact : EUR, et non EURO.
2. Choisissez le symbole dans la liste. Plusieurs devises partagent $ ; pour un signe distinct comme A$, cliquez sur Ajouter des symboles de devise personnalisés (Add custom currency symbols), ajoutez-le dans le champ Symboles de devise personnalisés (Custom currency symbols) de l'onglet Options, enregistrez, puis sélectionnez-le. Plus de détails dans modifier le symbole de la devise.
3. Choisissez la position : P$ - droite (P$ - right), P $ - droite avec espace (P $ - right space), $ P - gauche avec espace ($ P - left space) ou $P - gauche ($P - left).
4. Appuyez sur le bouton aux flèches rondes à côté du champ du taux pour charger le taux actuel.
5. Cliquez sur Enregistrer les modifications (Save changes).

Le bouton Assistant de devises (Currency Wizard) fait la même chose pour plusieurs devises à la fois : cochez-les dans une liste et cliquez sur Installer les devises sélectionnées (Install selected currencies) ; les symboles, les drapeaux et les taux sont remplis pour vous.

Les autres colonnes d'une ligne de devise :

Les décimales, les séparateurs et la position du symbole se règlent ici, devise par devise. Sur le front-end, ils remplacent les options de prix de WooCommerce → Réglages → Général (WooCommerce → Settings → General), ce qui explique que leur modification n'ait aucun effet visible tant que FOX est actif.

Pour remplacer une devise, modifiez le code de sa ligne au lieu d'en ajouter une nouvelle. Lorsqu'une devise est renommée (le florin des Antilles néerlandaises ANG est devenu le florin caribéen XCG), changez le code et le symbole, puis chargez le taux ; aucune mise à jour du plugin n'est nécessaire.

Quelles devises sont prises en charge

N'importe quel code peut être saisi, pas seulement ceux des suggestions, et même un code inventé fonctionne pour l'affichage (voir codes de devise personnalisés). Qu'une devise soit utilisable en pratique dépend de deux autres services :

• L'agrégateur de taux doit disposer d'un taux pour elle. Si le bouton de taux ne renvoie rien ou 0, choisissez un autre agrégateur dans l'onglet Options ou saisissez le taux à la main et tenez-le à jour vous-même, car les mises à jour automatiques ne peuvent pas actualiser un taux que l'agrégateur ne possède pas.
• La passerelle de paiement doit l'accepter, si les clients paient dans cette devise. PayPal, par exemple, n'accepte qu'une liste fixe de devises. Voir lorsque la passerelle ne prend pas en charge la devise.

Chaque code ne peut être utilisé qu'une fois. Les lignes sont enregistrées par code de devise : une seconde ligne EUR remplace donc la première à l'enregistrement. Deux variantes d'une même devise (prix HT et TTC, ou euro présenté séparément pour l'Allemagne et la France) ne sont pas possibles : le sélecteur choisit des devises, pas des pays. Pour attribuer automatiquement à chaque pays sa devise, utilisez l'onglet GeoIP, décrit dans changer de devise selon le pays.

Étape 3 : mise à jour des taux et devise de paiement

Dans l'onglet Options :

• Agrégateur de devises (Currency aggregator) est la source des taux. Certains exigent une clé dans Clé API de l'agrégateur (Aggregator API key).
• Mise à jour automatique des taux (Rate auto update) démarre sur aucune mise à jour automatique (no auto update) : les taux restent donc ceux du jour où vous les avez enregistrés. Choisissez un intervalle (quotidienne (daily) convient à la plupart des boutiques) et enregistrez. Les mises à jour passent par le cron de WordPress, et la ligne Planificateur (Scheduler) sous l'option indique la dernière et la prochaine exécution. Si elle ne s'exécute jamais, voir taux de change qui ne se mettent pas à jour.
• Devise d'accueil (Welcome currency) est la devise que voit un visiteur lors de sa première visite.

Dans l'onglet Avancé (Advanced), Plusieurs devises autorisées (Is multiple allowed) détermine la devise dans laquelle le client paie. Avec Oui (Yes) (le réglage après la première activation), le panier, le paiement et la commande utilisent la devise sélectionnée. Avec Non (No), la boutique affiche des prix convertis à titre indicatif et le client paie toujours dans la devise de base, ce qui convient aux passerelles ou à une comptabilité qui n'acceptent qu'une seule devise. Le second modèle est expliqué dans afficher la devise locale, facturer en devise de base.

Étape 4 : placer le sélecteur sur le site

• Le shortcode [woocs], partout où les shortcodes s'exécutent.
• Le widget Sélecteur de devises FOX (FOX Currency Switcher) dans une barre latérale ou un pied de page.
• Le sélecteur flottant de l'onglet Latéral (Side), décrit dans le sélecteur de devises flottant.
• Le menu principal, comme dans ajouter le sélecteur à un menu.

L'aspect de la liste déroulante par défaut se choisit en haut de l'onglet Devises (Currencies) (liste déroulante simple, styles numérotés, drapeaux, ddslick, Chosen, wSelect). L'onglet Designer permet de créer des designs personnalisés que vous placez avec [woocs sd=ID]. Si le site utilise un cache de pages, activez J'utilise un plugin de cache sur mon site (I am using cache plugin on my site) dans l'onglet Options et lisez pourquoi un sélecteur de devises et un cache de pages se battent avant la mise en ligne.

Tester la configuration en cinq minutes

1. Ouvrez la boutique dans une fenêtre de navigation privée. FOX mémorise la dernière devise choisie par chaque visiteur, et la géolocalisation ne s'applique qu'à la première visite : votre navigateur habituel ne montre donc pas ce que voit un nouveau client.
2. Ouvrez une page produit et passez en revue toutes les devises. Chaque prix doit être égal au prix de base multiplié par le taux. Le nombre de base avec un nouveau symbole signifie que le taux vaut encore 1 ; un prix de 0 signifie que le taux est 0 ou vide.
3. Ajoutez le produit au panier et ouvrez la page de paiement. Le total doit être dans la devise sélectionnée si Plusieurs devises autorisées (Is multiple allowed) est sur Oui (Yes), ou dans la devise de base s'il est sur Non (No).
4. Passez une commande de test dans une devise autre que la devise de base, avec un moyen de paiement qui l'accepte.
5. Le lendemain, vérifiez la ligne Planificateur (Scheduler) sous Mise à jour automatique des taux (Rate auto update) : la dernière exécution doit être récente.

Si les prix ne changent pas lorsque vous changez de devise, suivez le sélecteur de devises ne change pas les prix. Si des devises disparaissent après l'enregistrement, le serveur tronque le formulaire ; voir réglages qui ne s'enregistrent pas. Pour tout le reste, publiez votre tableau de devises et ce que vous attendiez sur le forum de support de FOX.