WPCS - WordPress Currency Switcher Professional

Format des prix du sélecteur de devises WordPress : code, symbole, séparateurs

Le format des prix du sélecteur de devises WordPress se règle à plusieurs endroits : le symbole, sa position, les centimes, les décimales et les séparateurs se choisissent devise par devise, tandis que le format de prix personnalisé avec le code de la devise s'applique à toutes. Savoir quel réglage construit quelle partie du prix vous permet d'obtenir $751.45 (CAD), 1.250,00 € ou un prix sans symbole sans tâtonner. Modifier le montant lui-même (arrondir à 10 ou à .99) est une autre tâche, traitée dans comment arrondir les prix convertis.

Comment WPCS construit un prix

Chaque shortcode [wpcs_price] est affiché en quatre étapes :

  1. Le nombre converti est mis en forme avec les réglages des centimes, de Décimales (Decimals) et de Format de la devise courante : 751.45.
  2. Le symbole de la devise est placé à gauche ou à droite du nombre, selon sa Position du symbole (Symbol pos.) : $751.45.
  3. L'option Format de prix personnalisé (Custom price format), si elle est remplie, enveloppe le résultat et peut ajouter le code de la devise : $751.45 (CAD).
  4. Le tout est enveloppé dans du HTML avec deux classes CSS, et le filtre wpcs_price_html_tail peut en ajouter davantage avant la balise fermante.
<span class="wpcs_price" id="wpcs_..." data-amount="544.53"><span class="wpcs_price_symbol">$</span>751.45 (CAD)</span>

Les réglages se trouvent à deux endroits dans Réglages (Settings) → Currency Switcher :

RéglageEmplacementS'applique à
Symbole, Position du symbole (Symbol pos.)Ligne de devise, onglet Devises (Currencies)Cette devise
Afficher les centimes (Show cents) / Masquer les centimes (Hide cents), Décimales (Decimals)Ligne de deviseCette devise
Format (séparateurs)Ligne de deviseCette devise
Séparateur décimal (Decimal separator), Séparateur des milliers (Thousandth separator)Onglet OptionsDevises dont le Format est par défaut (default)
Symboles monétaires personnalisés (Custom money signs.)Onglet OptionsAjoute des symboles à la liste des symboles
Format de prix personnalisé (Custom price format)Onglet OptionsTous les prix dans toutes les devises

Symbole et position du symbole par devise

Le symbole se choisit dans une liste déroulante de chaque ligne de devise. Si votre signe ne figure pas dans la liste (KSh, S/, GH₵), saisissez-le dans Symboles monétaires personnalisés (Custom money signs.), dans l'onglet Options, séparé par des virgules, cliquez sur Enregistrer les options (Save options), et il apparaît dans la liste des symboles de chaque ligne. Les développeurs peuvent étendre la liste avec le filtre wpcs_currency_symbols.

Le sélecteur de position placé à côté propose quatre valeurs :

  • gauche (left) : $99.00
  • droite (right) : 99.00$
  • gauche avec espace (left space) : $ 99.00
  • droite avec espace (right space) : 99.00 €

L'espace est une espace insécable : le symbole ne passe donc jamais à la ligne suivante sans son nombre.

Afficher le code de la devise après le prix

L'option Format de prix personnalisé (Custom price format), dans l'onglet Options, accepte deux clés : __PRICE__ est le nombre accompagné de son symbole (déjà positionné), __CODE__ est le code de la devise affichée. Laissez le champ vide pour le format par défaut.

Format de prix personnaliséRésultat
__PRICE__ (__CODE__)$751.45 (CAD)
__CODE__ __PRICE__CAD $751.45
__PRICE__ __CODE__, symbole masqué par CSS751.45 CAD

C'est le bon outil lorsque plusieurs devises partagent un symbole, comme USD, CAD et AUD. Il s'applique à tous les prix du site, prix fixes compris, et ne peut pas être limité à certaines pages dans les réglages. Pour ajouter le code à quelques prix seulement, utilisez l'attribut de shortcode présenté dans la section sur le texte après le prix.

Séparateurs décimal et des milliers par devise

Chaque ligne de devise comporte un sélecteur Format : par défaut (default), 1,000.00, 1.000,00, 1 000,00, 1 000.00, 1000,00 et 1000.00. USD peut ainsi s'afficher 1,250.00, EUR 1.250,00 et CHF 1 250.00 sur le même site. Une devise réglée sur par défaut (default) utilise les Séparateur décimal (Decimal separator) et Séparateur des milliers (Thousandth separator) globaux de l'onglet Options (un point et une virgule, sauf modification). D'anciennes réponses du forum disent que les séparateurs ne peuvent être réglés que pour toutes les devises à la fois ; le sélecteur Format par devise a supprimé cette limite.

Le nombre de décimales se règle lui aussi par devise :

  • Décimales : 0 (Decimals: 0) à Décimales : 8 (Decimals: 8) définit le nombre de décimales, par exemple 3 pour des prix comme 0.084. Cela ne fonctionne que si la ligne est réglée sur Afficher les centimes (Show cents).
  • Masquer les centimes (Hide cents) affiche des nombres entiers, quoi que dise Décimales (Decimals).
  • JPY et TWD sont toujours affichées sans centimes.

Ces réglages ne modifient que l'affichage. La valeur value que vous écrivez dans [wpcs_price value=1250.50] utilise toujours un point pour les décimales et aucun séparateur des milliers, quel que soit le format des devises.

Un prix sans symbole, ou le symbole seul

[wpcs_price] n'a pas d'attribut pour supprimer le symbole, mais le symbole se trouve dans son propre élément : le CSS peut donc le masquer. Pour tous les prix, ou seulement à l'intérieur d'un bloc de votre page :

/* Appearance → Customize → Additional CSS */
.wpcs_price_symbol { display: none; }

/* or only inside an element with the class pricing-table */
.pricing-table .wpcs_price_symbol { display: none; }

Réglez la position du symbole sur gauche (left) ou droite (right) pour ces devises, sinon l'espace insécable reste devant le nombre.

Lorsque vous avez besoin du nombre seul ou du symbole seul comme texte, pour un champ de formulaire, un attribut data ou un script, enregistrez deux petits shortcodes. Ils utilisent $WPCS->price(), qui convertit et met en forme le montant (votre filtre d'arrondi compris), et $WPCS->get_currencies() pour le symbole :

/*
 * [my_price_number value=100] prints the converted number, e.g. 86.00
 * [my_currency_symbol]        prints the symbol of the current currency
 * Child theme functions.php or a code snippets plugin.
 */
add_shortcode('my_price_number', function ($atts) {
    global $WPCS;
    $atts = shortcode_atts(array('value' => 0), $atts);
    if (empty($WPCS)) {
        return '';
    }
    return esc_html($WPCS->price(floatval($atts['value'])));
});

add_shortcode('my_currency_symbol', function () {
    global $WPCS;
    if (empty($WPCS)) {
        return '';
    }
    $currencies = $WPCS->get_currencies();
    $code = $WPCS->current_currency;
    return isset($currencies[$code]) ? wp_kses_post($currencies[$code]['symbol']) : '';
});

Les deux sont affichés au moment de la construction de la page. Lorsque J'utilise un plugin de cache sur mon site (I am using cache plugin on my site) est sur Oui (Yes), le plugin ne redessine après le chargement que les éléments .wpcs_price : sur une page en cache, ces deux shortcodes gardent donc la devise de la copie mise en cache.

Ajouter du texte après le prix

Après chaque prix dans une devise

Le filtre wpcs_price_html_tail ajoute du HTML à l'intérieur de l'élément du prix. Il s'exécute pour chaque prix : vérifiez donc la devise :

/*
 * WPCS: add a note after every price shown in USD.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('wpcs_price_html_tail', function ($price_html) {
    global $WPCS;
    if (!empty($WPCS) && $WPCS->current_currency === 'USD') {
        $price_html .= ' <span class="my-price-note">excl. VAT</span>';
    }
    return $price_html;
});

Comme le texte fait partie de l'élément du prix, il est aussi redessiné correctement sur les pages en cache.

Après certains prix seulement

WPCS transmet chaque attribut de [wpcs_price], y compris ceux qu'il n'utilise pas lui-même, au filtre wpcs_shortcode_price_html_manipulation, avec la devise affichée. Cela rend possibles vos propres attributs :

[wpcs_price value=544.53 after=" ({code})"]          → $751.45 (CAD)
[wpcs_price value=1.99 after="/yr" after_for="USD"]  → $1.99/yr, only in USD
/*
 * WPCS: [wpcs_price ... after="text"] adds text after this price only.
 * {code} is replaced by the currency code; after_for="USD,CAD" limits it to these currencies.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('wpcs_shortcode_price_html_manipulation', function ($price_html, $atts, $currency) {
    if (!is_array($atts) || !isset($atts['after']) || $atts['after'] === '') {
        return $price_html;
    }
    if (!empty($atts['after_for'])) {
        $codes = array_map('trim', explode(',', strtoupper($atts['after_for'])));
        if (!in_array($currency, $codes, true)) {
            return $price_html;
        }
    }
    $text = str_replace('{code}', $currency, $atts['after']);
    return $price_html . '<span class="my-price-after">' . esc_html($text) . '</span>';
}, 10, 3);

Le texte est placé après l'élément du prix, et le redessin AJAX des sites avec cache n'exécute pas ce filtre : sur une page en cache, il reste tel qu'il était lors de la mise en cache. Pour des phrases entières ou des blocs qui dépendent de la devise, voir afficher du contenu pour la devise sélectionnée.

Styler le prix avec du CSS

Utilisez .wpcs_price pour l'ensemble du prix et .wpcs_price_symbol pour le symbole ; la FAQ montre comment mettre le prix en gras. Les décimales n'ont pas d'élément propre. Pour les styler, par exemple plus petites et surélevées, enveloppez-les avec le filtre tail :

/*
 * WPCS: wrap the decimal part of every price in <span class="my-price-decimals">.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('wpcs_price_html_tail', function ($price_html) {
    global $WPCS;
    if (empty($WPCS)) {
        return $price_html;
    }
    $sep = $WPCS->get_decimal_separator($WPCS->current_currency);
    if ($sep === '') {
        return $price_html;
    }
    // The separator and the digits after it, outside HTML attributes.
    return preg_replace(
        '/(\d)' . preg_quote($sep, '/') . '(\d+)(?![^<]*>)/',
        '$1<span class="my-price-decimals">' . $sep . '$2</span>',
        $price_html,
        1
    );
});
/* Additional CSS */
.my-price-decimals { font-size: 0.6em; vertical-align: super; }

Les prix sans centimes restent inchangés. Pour afficher un même montant dans plusieurs devises côte à côte, utilisez l'attribut fix_currency, décrit dans afficher les prix dans plusieurs devises.

Si le format ne change pas

  • Cliquez sur Enregistrer les options (Save options) après avoir modifié une ligne de devise ; les réglages de la ligne sont enregistrés avec la page, pas instantanément.
  • Une devise en Format : par défaut (Format: default) suit les séparateurs globaux de l'onglet Options : modifier les séparateurs globaux ne change donc que ces devises.
  • Décimales (Decimals) n'a aucun effet lorsque la ligne est sur Masquer les centimes (Hide cents), et aucun du tout pour JPY et TWD.
  • Videz le cache des pages et vérifiez dans une fenêtre de navigation privée : les pages en cache conservent l'ancien format.

Si un prix a toujours un mauvais rendu, publiez le shortcode et une capture d'écran de la ligne de devise sur le forum d'assistance WPCS.