Afficher du contenu selon la devise sélectionnée dans WordPress
Pour afficher du contenu selon la devise sélectionnée dans WordPress, par exemple une note de paiement réservée aux visiteurs qui règlent en dollars américains, un lien de commande différent pour chaque devise, ou une mention légale pour tous ceux qui ne voient pas la devise de base, votre code doit savoir quelle devise le visiteur a choisie. WPCS la conserve dans une seule propriété PHP et la reprend dans une classe de la balise <body> ainsi que dans une variable JavaScript. Vous trouverez ci-dessous comment utiliser chacune d'elles, comment transmettre la devise sélectionnée dans les liens, et ce qui change lorsque le site utilise un cache de pages.
Où WPCS conserve la devise sélectionnée
Le plugin crée un objet global, $WPCS. Deux de ses propriétés comptent ici :
$WPCS->current_currency: le code de la devise que le visiteur voit actuellement, exactement tel qu'il est écrit dans l'onglet Devises (Currencies), par exempleUSDouEUR.$WPCS->default_currency: la devise de base, celle qui est cochée avec le bouton radio dans cet onglet.
La devise courante est le dernier choix du visiteur dans le sélecteur ou dans un lien ?currency=EUR ou, lors de la première visite, la devise d'accueil ou une règle GeoIP. Le plugin la mémorise pour chaque visiteur (option Stockage de la devise (Currency storage) : transient, session ou cookie) et la relit à chaque chargement de page. Les règles GeoIP sont appliquées sur le hook WordPress init ; lisez donc la propriété dans un shortcode, un template ou un hook exécuté après init, et non au niveau supérieur de functions.php.
La même valeur parvient au front-end à deux autres endroits :
| Où | Valeur lorsque EUR est sélectionnée | Utile pour |
|---|---|---|
$WPCS->current_currency en PHP | EUR | Les shortcodes et les templates du thème |
Classe de la balise <body> | currency-eur (en minuscules) | Afficher et masquer des blocs avec CSS |
Variable JavaScript wpcs_current_currency | un objet, wpcs_current_currency.name vaut EUR | Vos propres scripts |
Comparez toujours la propriété, pas l'objet. Une condition comme if ($WPCS == 'USD') compare l'objet complet du plugin à une chaîne et n'est jamais vraie : le contenu n'apparaît donc jamais. La forme correcte est if ($WPCS->current_currency === 'USD').
Afficher du contenu selon la devise sélectionnée avec un shortcode
Pour une phrase, une note ou un lien au milieu d'une page, un shortcode englobant est le plus pratique : l'éditeur entoure le texte, et les visiteurs ayant une autre devise ne le reçoivent tout simplement pas. Déclarez-le une seule fois :
/*
* Child theme functions.php or a code snippets plugin.
* [show_for_currency currency="USD"]...[/show_for_currency] only for USD
* [show_for_currency currency="USD,CAD"]...[/show_for_currency] for USD or CAD
* [show_for_currency not="USD"]...[/show_for_currency] for every currency except USD
*/
add_shortcode('show_for_currency', function ($atts, $content = '') {
global $WPCS;
if (empty($WPCS)) {
return '';
}
$atts = shortcode_atts(array('currency' => '', 'not' => ''), $atts, 'show_for_currency');
$current = strtoupper($WPCS->current_currency);
$only = array_filter(array_map('trim', explode(',', strtoupper($atts['currency']))));
$except = array_filter(array_map('trim', explode(',', strtoupper($atts['not']))));
if ($only && !in_array($current, $only, true)) {
return '';
}
if ($except && in_array($current, $except, true)) {
return '';
}
return do_shortcode((string) $content);
});
Utilisez-le ensuite dans le contenu :
[show_for_currency currency="USD"]American Express cards are accepted.[/show_for_currency]
[show_for_currency not="USD"]Prices in your currency are approximate. Payment is taken in US dollars.[/show_for_currency]
Les shortcodes imbriqués, comme [wpcs_price], continuent de fonctionner, car le contenu passe par do_shortcode(). Les codes de devise sont comparés en majuscules ; currency="usd" fonctionne donc aussi.
Dans un template de thème, utilisez directement la même vérification :
<?php
// A template file of your child theme
global $WPCS;
if (!empty($WPCS) && $WPCS->current_currency === 'USD') : ?>
<p class="payment-note">American Express cards are accepted.</p>
<?php endif; ?>
Afficher ou masquer des blocs entiers avec des classes CSS
Lorsqu'un groupe entier de blocs, une section de constructeur de pages ou un widget dépend de la devise, l'envelopper dans un shortcode est peu commode. Utilisez plutôt la classe du body. WPCS ajoute currency- suivi du code en minuscules à la balise <body> par le filtre standard body_class ; tout thème qui affiche body_class() reçoit donc currency-usd, currency-eur, etc.
- Donnez une classe au bloc : dans l'éditeur de blocs, ouvrez les réglages du bloc, Avancé (Advanced) → Classe(s) CSS supplémentaire(s) (Additional CSS class(es)), et saisissez
only-usd(afficher uniquement pour USD) ouhide-usd(masquer pour USD). Les constructeurs de pages ont le même champ ; dans Elementor, il s'agit de Avancé (Advanced) → Classes CSS (CSS Classes). - Ajoutez les règles une seule fois, une ligne par devise utilisée :
/* Appearance → Customize → Additional CSS (Styles → Additional CSS in a block theme) */
body:not(.currency-usd) .only-usd,
body:not(.currency-eur) .only-eur,
body.currency-usd .hide-usd {
display: none !important;
}
La différence avec le shortcode : le bloc masqué reste dans le code source de la page, il n'est simplement pas affiché. C'est parfait pour des notes, des bandeaux et des boutons, mais pas pour ce qui doit rester confidentiel, comme un code de réduction destiné à un seul marché.
Afficher la devise courante : [wpcs_current_currency]
Pour indiquer aux visiteurs la devise qu'ils voient, le plugin dispose de son propre shortcode, [wpcs_current_currency]. Par défaut, il affiche Current currency is:, le code et le drapeau de la devise. Ses attributs :
| Attribut | Valeur par défaut | Effet |
|---|---|---|
text | Current currency is: | Le texte placé avant le code. text="none" n'affiche aucun texte |
code | 1 | 0 masque le code de la devise |
flag | 1 | 0 masque le drapeau. Mettez 0 si vos devises n'ont pas d'images de drapeau, sinon une image vide est affichée |
currency | la devise sélectionnée | Affiche à la place la devise indiquée, par exemple currency="EUR". Elle doit faire partie de vos devises |
Exemple : [wpcs_current_currency text="Prices are shown in" flag=0]. Le résultat est enveloppé dans <span class="wpcs_current_currency wpcs_current_currency_EUR">, avec les éléments dans .wpcs_current_currency_text, .wpcs_current_currency_code et .wpcs_current_currency_flag ; vous pouvez donc styliser l'étiquette pour chaque devise, par exemple .wpcs_current_currency_EUR .wpcs_current_currency_code { color: #1e5aa8; }. Pour le code seul, sans balisage, consultez comment afficher le code de la devise courante.
Transmettre la devise sélectionnée dans les liens
Toute adresse de page contenant ?currency= suivi d'un code fait passer le visiteur à cette devise, et le plugin la mémorise, comme décrit dans une devise différente selon les pages. Les liens entre les pages de votre propre site n'ont pas besoin du paramètre : le choix mémorisé s'applique déjà partout. Il vous le faut lorsque le lien sort de ce stockage, par exemple vers un formulaire de réservation, une page de commande ou un autre site qui lit la devise dans l'adresse.
Ce shortcode renvoie n'importe quelle URL avec la devise du visiteur ajoutée, mais uniquement lorsqu'il ne s'agit pas de la devise de base. Pour les visiteurs en devise de base, les liens restent identiques à l'URL d'origine, ce qui les garde compatibles avec le cache et évite les adresses en double :
/*
* Child theme functions.php or a code snippets plugin.
* [current_currency_url url="https://booking.example.com/form/"]
* returns https://booking.example.com/form/?currency=EUR for a visitor in EUR,
* and the URL unchanged for a visitor in the base currency.
*/
add_shortcode('current_currency_url', function ($atts) {
global $WPCS;
$atts = shortcode_atts(array('url' => home_url('/')), $atts, 'current_currency_url');
$url = $atts['url'];
if (!empty($WPCS) && $WPCS->current_currency !== $WPCS->default_currency) {
$url = add_query_arg('currency', $WPCS->current_currency, $url);
}
return esc_url($url);
});
add_query_arg() ajoute & ou ? selon le cas et remplace un paramètre currency existant. WordPress exécute les shortcodes à l'intérieur des attributs HTML entre guillemets ; le shortcode peut donc servir d'adresse de lien dans un bloc HTML personnalisé ou dans l'éditeur classique. Utilisez des apostrophes à l'intérieur, car le href utilise des guillemets doubles :
<a class="button" href="[current_currency_url url='https://booking.example.com/form/']">Book now</a>
Les champs de lien de l'éditeur de blocs et des constructeurs de pages n'exécutent généralement pas les shortcodes. Pour ces liens, utilisez la classe wpcs-currency-link de la section suivante.
Si la cible attend des paramètres différents pour chaque devise plutôt qu'un paramètre currency, par exemple un formulaire qui présélectionne une option différente selon le marché, écrivez un lien par devise à l'intérieur de [show_for_currency] :
[show_for_currency currency="USD"]<a href="https://forms.example.com/order?plan=us">Order now</a>[/show_for_currency]
[show_for_currency currency="EUR,GBP"]<a href="https://forms.example.com/order?plan=eu">Order now</a>[/show_for_currency]
[show_for_currency not="USD,EUR,GBP"]<a href="https://forms.example.com/order">Order now</a>[/show_for_currency]
Pages servies depuis un cache : changer le contenu dans le navigateur
Tout ce que PHP affiche, shortcodes ci-dessus compris, fait partie du HTML que stocke un cache de pages. Les visiteurs suivants reçoivent cette copie et voient le contenu choisi pour le visiteur qui a rempli le cache, quelle que soit leur propre devise. La classe du body et la variable wpcs_current_currency sont mises en cache avec lui.
Il y a deux issues. Exclure du cache de pages les pages dont le contenu dépend de la devise : PHP s'exécute alors pour chaque visiteur et rien d'autre n'est nécessaire. Ou laisser le navigateur corriger la page. Lorsque J'utilise un plugin de cache sur mon site (I am using cache plugin on my site) est réglé sur Oui (Yes) dans Réglages (Settings) → Currency Switcher → Options, le plugin envoie après chaque chargement de page une requête avec action=wpcs_get_prices_html pour redessiner les prix, et la réponse contient la vraie devise du visiteur dans current_currency. Ce snippet écoute cette réponse, remet la classe du body à jour et met à jour les liens qui portent la classe wpcs-currency-link (sur le lien lui-même ou sur son conteneur, comme avec les blocs Bouton) :
/*
* Child theme functions.php or a code snippets plugin.
* Keeps the body class currency-xxx and links with the class wpcs-currency-link
* in step with the visitor's currency, on cached pages too.
*/
add_action('wp_footer', function () {
?>
<script>
(function ($) {
function applyCurrency(code) {
if (!code) {
return;
}
code = String(code);
var body = $('body');
$.each((body.attr('class') || '').split(/\s+/), function (i, cls) {
if (cls.indexOf('currency-') === 0) {
body.removeClass(cls);
}
});
body.addClass('currency-' + code.toLowerCase());
var base = (typeof wpcs_default_currency !== 'undefined') ? wpcs_default_currency.name : '';
$('a.wpcs-currency-link, .wpcs-currency-link a').each(function () {
if (!this.getAttribute('href')) {
return;
}
var url = new URL(this.href, window.location.href);
if (code === base) {
url.searchParams.delete('currency');
} else {
url.searchParams.set('currency', code);
}
this.href = url.toString();
});
}
// the currency the page was built for
$(function () {
if (typeof wpcs_current_currency !== 'undefined' && wpcs_current_currency) {
applyCurrency(wpcs_current_currency.name);
}
});
// the visitor's real currency, from the plugin's request on cached pages
$(document).on('ajaxSuccess', function (event, xhr, settings) {
if (typeof settings.data !== 'string' || settings.data.indexOf('action=wpcs_get_prices_html') === -1) {
return;
}
try {
applyCurrency(JSON.parse(xhr.responseText).current_currency);
} catch (e) {}
});
})(jQuery);
</script>
<?php
}, 100);
Grâce à lui, la méthode des classes CSS fonctionne aussi sur les pages en cache : les bons blocs apparaissent un instant après le chargement de la page, dès que la réponse arrive. Le shortcode englobant ne peut pas être corrigé de cette façon, car le contenu des autres devises n'a jamais été envoyé au navigateur ; sur les pages en cache, utilisez donc les classes CSS ou excluez la page. Le plugin n'envoie pas sa requête sur les adresses qui contiennent déjà ?currency= ; ces adresses sont de toute façon construites pour cette devise. Si vous différez le JavaScript avec un plugin d'optimisation, le snippet doit s'exécuter sans délai, tout comme le sélecteur ; les exclusions à prévoir sont détaillées dans le sélecteur de devises ne fonctionne pas avec un plugin de cache.
Si cela ne fonctionne pas
- Le texte du shortcode apparaît sur la page. Le snippet n'est pas actif, ou le champ n'exécute pas les shortcodes. Testez-le d'abord dans un simple paragraphe d'une page.
- Rien ne change lorsque vous changez de devise. Ouvrez le code source de la page et cherchez
currency-dans la ligne<body class=. S'il est absent, le thème n'appelle pasbody_class(); s'il affiche l'ancienne devise alors que vous êtes déconnecté, la page provient d'un cache. - Cela fonctionne pour vous, pas pour les visiteurs. Les caches de pages ignorent généralement les administrateurs connectés. Testez dans une fenêtre de navigation privée après avoir vidé toutes les couches de cache.
- Une condition PHP ne correspond jamais. Comparez
$WPCS->current_currencyet non$WPCS, utilisez le code exactement comme dans l'onglet Devises (Currencies), et exécutez le test aprèsinit. - Le lien perd la devise. Vérifiez que la devise du visiteur n'est pas la devise de base :
[current_currency_url]et le snippet laissent volontairement sans paramètre les liens en devise de base.
Si le contenu ne suit toujours pas la devise sélectionnée, ouvrez un sujet sur le forum d'assistance WPCS en indiquant le lien de la page, le code que vous avez ajouté et si un plugin de cache ou d'optimisation est actif.