WPCS - WordPress Currency Switcher Professional

Arrondir les prix convertis dans WordPress Currency Switcher : 10, 5 ou .99

Les prix convertis sont exacts : 49 USD au taux de 0,86 font 42,14 EUR, et 12 500 USD à 88,2 font 1 102 500 INR. Pour arrondir les prix convertis dans WordPress Currency Switcher (WPCS) à l'entier, à la dizaine ou au millier le plus proche, ou à des terminaisons comme .99, vous modifiez soit les décimales de la devise, soit quelques lignes de PHP dans le filtre wpcs_price. Ce filtre comporte un piège qui fait échouer la plupart des snippets d'arrondi sur PHP 8 dès qu'un prix dépasse 1 000. Le code ci-dessous l'évite.

Moins de décimales sans code

Chaque ligne de devise de l'onglet Devises (Currencies) (Réglages (Settings) → Currency Switcher) comporte deux sélecteurs qui contrôlent les décimales :

  • Masquer les centimes (Hide cents) affiche des nombres entiers. 42,14 devient 42 et 42,50 devient 43, car le plugin arrondit à l'unité supérieure à partir de la moitié lorsqu'il supprime les centimes.
  • Décimales : 0 (Decimals: 0) à Décimales : 8 (Decimals: 8) définit le nombre de décimales affichées. Cela ne fonctionne que si la ligne est réglée sur Afficher les centimes (Show cents).

JPY et TWD sont toujours affichées sans centimes, quel que soit le réglage de leur ligne. Enregistrez avec Enregistrer les options (Save options) et videz le cache de vos pages.

Ces réglages modifient le nombre de chiffres affichés, pas le montant lui-même : ils ne peuvent pas transformer 42,14 en 45 ou en 42,99. Pour cela, il faut le filtre. La façon dont le nombre est affiché (séparateurs, position du symbole, code de la devise) est un autre sujet, traité dans personnaliser le format des prix.

Comment fonctionne le filtre wpcs_price, et pourquoi tant de snippets échouent

Chaque prix affiché par [wpcs_price] passe par la méthode price() du plugin. Elle multiplie le montant en devise de base par le taux, met le résultat en forme avec les décimales et les séparateurs de la devise, puis seulement applique le filtre :

return apply_filters('wpcs_price', $this->format_price_numeric($price, $currency));

Le filtre wpcs_price reçoit donc un texte tel que 1,234.50 ou 1.234,50, et non un nombre, et tout ce qu'il renvoie est affiché tel quel. Deux conséquences en découlent :

  • Passer $price directement à round(), ceil() ou à une division fonctionne tant que les prix restent sous 1 000 et utilisent un point pour les décimales, et échoue au-delà. Sur PHP 8, round('1,234.50', -3) déclenche une TypeError fatale et WordPress affiche « Une erreur critique est survenue sur votre site web ». '1,234.50' / 10 ne produit qu'un avertissement et calcule avec 1. Un snippet d'une ligne comme return round($price, -3); échoue exactement ainsi, et seulement sur les prix élevés.
  • Renvoyer un nombre brut supprime la mise en forme : 1000 est affiché 1000 au lieu de 1,000.00.

Le filtre s'exécute aussi pour les prix affichés dans la devise de base, car ils sont mis en forme de la même manière. La bonne approche : retransformer le texte en nombre avec les séparateurs de la devise courante, l'arrondir, puis le mettre à nouveau en forme avec $WPCS->format_price_numeric(), la méthode que le plugin utilise lui-même.

Un snippet d'arrondi qui fonctionne avec n'importe quel prix

Ajoutez-le au fichier functions.php d'un thème enfant ou à un plugin de snippets de code. Il définit une règle par devise. La devise de base et les devises sans règle restent exactes.

/*
 * WPCS: round converted prices per currency.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('wpcs_price', function ($price) {
    global $WPCS;

    // Leave prices in the base currency exactly as you typed them.
    if (empty($WPCS) || $WPCS->current_currency === $WPCS->default_currency) {
        return $price;
    }

    $currency = $WPCS->current_currency;

    // $price arrives formatted, for example "1,234.50": turn it back into a number.
    $number = str_replace($WPCS->get_thousands_separator($currency), '', $price);
    $number = (float) str_replace($WPCS->get_decimal_separator($currency), '.', $number);

    switch ($currency) {
        case 'EUR':
            $number = floor($number) + 0.99;     // 42.14 -> 42.99
            break;
        case 'INR':
            $number = ceil($number / 10) * 10;   // 4,322 -> 4,330
            break;
        case 'IDR':
            $number = round($number, -3);        // 812,611 -> 813,000
            break;
        default:
            return $price;                       // other currencies: unchanged
    }

    // Print it again with the decimals and separators of this currency.
    return $WPCS->format_price_numeric($number, $currency);
});

Remplacez les codes et les règles par les vôtres. Quelques détails comptent :

  • get_thousands_separator() et get_decimal_separator() renvoient les séparateurs du sélecteur Format de la devise, ou les séparateurs globaux lorsqu'il est réglé sur par défaut (default). Le snippet continue de fonctionner si vous changez un format plus tard.
  • format_price_numeric() applique les réglages des centimes et de Décimales (Decimals) de la ligne. Une terminaison en .99 exige Afficher les centimes (Show cents) avec deux décimales. Pour les règles à nombre entier, réglez la devise sur Masquer les centimes (Hide cents), sinon 4,330 est affiché 4,330.00.
  • Pour arrondir toutes les devises de la même façon, remplacez tout le bloc switch par une règle unique, par exemple $number = ceil($number / 10) * 10;.

Formules d'arrondi

Placez l'une de ces lignes à la place d'une règle dans le snippet. $number est le montant converti exact.

RésultatExempleCode
Jusqu'à la dizaine suivante341.20 → 350$number = ceil($number / 10) * 10;
Multiple de 5 le plus proche511 → 510, 514 → 515$number = round($number / 5) * 5;
Millier le plus proche345,667 → 346,000$number = round($number, -3);
0,50 le plus proche12.30 → 12.50$number = round($number * 2) / 2;
Terminaison en .9941.20 → 41.99$number = floor($number) + 0.99;
Entier le plus proche se terminant par 9517 → 519, 521 → 519$number = max(9, round($number / 10) * 10 - 1);

ceil() et la règle .99 n'affichent jamais moins que la conversion exacte ; round() va vers la valeur la plus proche, dans un sens comme dans l'autre. Pour des pas plus grands, remplacez 10 par 50 ou 100. Le manuel PHP décrit round() et son argument de précision.

Les prix que le filtre n'arrondit pas

  • Les prix fixes. [wpcs_price type=fixed value=USD:49,EUR:45] affiche chaque montant tel que vous l'avez saisi et ignore le filtre ; voir prix fixes par devise.
  • Les montants convertis en PHP. $WPCS->wpcs_exchange_value() et l'action wpcs_exchange_value mettent le résultat en forme sans le filtre. Dans vos propres templates, utilisez plutôt $WPCS->price($amount) : elle convertit, met en forme et exécute le filtre, de sorte que votre arrondi s'applique (elle renvoie le nombre sans le symbole de la devise).
  • Le convertisseur et le tableau des taux. [wpcs_converter] et [wpcs_rates] affichent des montants et des taux exacts.
  • L'icône d'information sur le prix. Lorsque Afficher l'icône d'info sur le prix (Show price info icon) est activé, la liste des autres devises sous l'icône est calculée alors que la devise du visiteur est encore la devise courante : une règle écrite pour cette devise est donc appliquée à chaque ligne. Vérifiez la liste, ou désactivez l'icône si vous arrondissez différemment selon la devise.

Lorsque J'utilise un plugin de cache sur mon site (I am using cache plugin on my site) est sur Oui (Yes), les prix sont redessinés par AJAX après le chargement de la page. Ce redessin utilise la même méthode price() : l'arrondi s'y applique donc aussi.

Vérifier le résultat

Créez une page en brouillon avec ces lignes et prévisualisez-la :

[wpcs]
[wpcs_price value=9.99]
[wpcs_price value=499]
[wpcs_price value=12500]
  • Passez sur chaque devise qui a une règle. La dernière ligne est la plus importante : elle dépasse 1 000 dans toutes les devises et révèle le code qui ignore le séparateur des milliers.
  • Passez à la devise de base : les trois montants doivent être exactement ceux que vous avez saisis.
  • Une erreur critique après l'ajout du snippet signifie qu'un autre snippet d'arrondi est encore actif quelque part (thème, plugin de snippets). Le journal d'erreurs PHP le désigne avec round(): Argument #1 ($num) must be of type int|float, string given.
  • Videz le cache des pages après chaque modification, et testez dans une fenêtre de navigation privée où vous n'êtes pas connecté.

Si les chiffres semblent toujours faux, publiez le snippet que vous utilisez et les réglages de devise de la ligne concernée sur le forum d'assistance WPCS.