WPCS - WordPress Currency Switcher Professional

Formato de precio del selector de monedas de WordPress: código y separadores

El formato de precio del selector de monedas de WordPress se define en varios lugares: el símbolo, su posición, los céntimos, los decimales y los separadores se eligen por moneda, mientras que el formato de precio personalizado con el código de moneda se aplica a todas. Saber qué ajuste construye qué parte del precio te permite obtener $751.45 (CAD), 1.250,00 € o un precio sin símbolo sin tener que adivinar. Cambiar el importe en sí (redondear a 10 o a .99) es otra tarea, tratada en cómo redondear los precios convertidos.

Cómo construye WPCS un precio

Cada shortcode [wpcs_price] se imprime en cuatro pasos:

  1. El número convertido recibe formato según los ajustes de céntimos, Decimales (Decimals) y Formato (Format) de la moneda actual: 751.45.
  2. El símbolo de la moneda se coloca a la izquierda o a la derecha del número, según su Pos. del símbolo (Symbol pos.): $751.45.
  3. La opción Formato de precio personalizado (Custom price format), si está rellena, envuelve el resultado y puede añadir el código de moneda: $751.45 (CAD).
  4. Todo se envuelve en HTML con dos clases CSS, y el filtro wpcs_price_html_tail puede añadir más antes de la etiqueta de cierre.
<span class="wpcs_price" id="wpcs_..." data-amount="544.53"><span class="wpcs_price_symbol">$</span>751.45 (CAD)</span>

Los ajustes están en dos lugares de Ajustes (Settings) → Currency Switcher:

AjusteDóndeSe aplica a
Símbolo, Pos. del símbolo (Symbol pos.)Fila de la moneda, pestaña Monedas (Currencies)Esa moneda
Mostrar céntimos (Show cents) / Ocultar céntimos (Hide cents), Decimales (Decimals)Fila de la monedaEsa moneda
Formato (Format) (separadores)Fila de la monedaEsa moneda
Separador decimal (Decimal separator), Separador de miles (Thousandth separator)Pestaña Opciones (Options)Las monedas cuyo Formato (Format) es predeterminado (default)
Signos de moneda personalizados (Custom money signs.)Pestaña Opciones (Options)Añade símbolos a la lista de símbolos
Formato de precio personalizado (Custom price format)Pestaña Opciones (Options)Todos los precios en todas las monedas

Símbolo y posición del símbolo por moneda

El símbolo es un desplegable en cada fila de moneda. Si tu signo no está en la lista (KSh, S/, GH₵), escríbelo en Signos de moneda personalizados (Custom money signs.), en la pestaña Opciones (Options), separado por comas, pulsa Guardar opciones (Save options) y aparecerá en la lista de símbolos de todas las filas. Los desarrolladores pueden ampliar la lista con el filtro wpcs_currency_symbols.

El selector de posición que tiene al lado admite cuatro valores:

  • izquierda (left): $99.00
  • derecha (right): 99.00$
  • izquierda con espacio (left space): $ 99.00
  • derecha con espacio (right space): 99.00 €

El espacio es un espacio de no separación, de modo que el símbolo nunca pasa a la línea siguiente sin su número.

Mostrar el código de moneda después del precio

La opción Formato de precio personalizado (Custom price format) de la pestaña Opciones (Options) acepta dos claves: __PRICE__ es el número junto con su símbolo (ya colocado), y __CODE__ es el código de la moneda que se muestra. Deja el campo vacío para el formato predeterminado.

Formato de precio personalizadoResultado
__PRICE__ (__CODE__)$751.45 (CAD)
__CODE__ __PRICE__CAD $751.45
__PRICE__ __CODE__, símbolo oculto con CSS751.45 CAD

Es la herramienta adecuada cuando varias monedas comparten símbolo, como USD, CAD y AUD. Se aplica a todos los precios del sitio, los precios fijos incluidos, y en los ajustes no se puede limitar a algunas páginas. Para añadir el código solo a unos pocos precios, usa el atributo del shortcode que se muestra en la sección sobre el texto después del precio.

Separadores decimal y de miles por moneda

Cada fila de moneda tiene un selector Formato (Format): predeterminado (default), 1,000.00, 1.000,00, 1 000,00, 1 000.00, 1000,00 y 1000.00. Así, USD puede mostrarse como 1,250.00, EUR como 1.250,00 y CHF como 1 250.00 en el mismo sitio. Una moneda en predeterminado (default) usa los valores globales de Separador decimal (Decimal separator) y Separador de miles (Thousandth separator) de la pestaña Opciones (Options) (un punto y una coma, salvo que los cambies). Respuestas antiguas del foro dicen que los separadores solo se pueden definir para todas las monedas a la vez; el selector Formato (Format) por moneda sustituyó ese límite.

El número de decimales también se define por moneda:

  • Decimales: 0 (Decimals: 0) a Decimales: 8 (Decimals: 8) define el número de decimales, por ejemplo 3 para precios como 0,084. Solo funciona mientras la fila esté en Mostrar céntimos (Show cents).
  • Ocultar céntimos (Hide cents) imprime números enteros, diga lo que diga Decimales (Decimals).
  • JPY y TWD se imprimen siempre sin céntimos.

Estos ajustes solo cambian la presentación. El value que escribes en [wpcs_price value=1250.50] usa siempre un punto para los decimales y ningún separador de miles, sea cual sea el formato de las monedas.

Un precio sin símbolo, o solo el símbolo

[wpcs_price] no tiene ningún atributo para quitar el símbolo, pero el símbolo está en su propio elemento, así que el CSS puede ocultarlo. Para todos los precios, o solo dentro de un bloque de tu página:

/* 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; }

Define la posición del símbolo como izquierda (left) o derecha (right) para esas monedas; de lo contrario, el espacio de no separación se queda delante del número.

Cuando necesitas el número a secas o el símbolo a secas como texto, para un campo de formulario, un atributo data o un script, registra dos shortcodes pequeños. Usan $WPCS->price(), que convierte y da formato al importe (con tu filtro de redondeo incluido), y $WPCS->get_currencies() para el símbolo:

/*
 * [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']) : '';
});

Ambos se imprimen cuando se construye la página. Con Uso un plugin de caché en mi sitio (I am using cache plugin on my site) en Sí (Yes), el plugin solo vuelve a dibujar los elementos .wpcs_price tras la carga, por lo que en una página en caché estos dos conservan la moneda de la copia en caché.

Añadir texto después del precio

Después de cada precio en una moneda

El filtro wpcs_price_html_tail añade HTML dentro del elemento del precio. Se ejecuta con cada precio, así que comprueba la moneda:

/*
 * 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;
});

Como el texto forma parte del elemento del precio, también se vuelve a dibujar correctamente en las páginas en caché.

Solo después de precios seleccionados

WPCS pasa todos los atributos de [wpcs_price], incluidos los que no usa por sí mismo, al filtro wpcs_shortcode_price_html_manipulation, junto con la moneda que se muestra. Eso hace posibles tus propios atributos:

[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);

El texto se coloca después del elemento del precio, y el redibujado AJAX para sitios con caché no ejecuta este filtro: en una página en caché se queda como estaba cuando se guardó en caché. Para frases o bloques completos que dependen de la moneda, consulta mostrar contenido para la moneda seleccionada.

Dar estilo al precio con CSS

Usa .wpcs_price para todo el precio y .wpcs_price_symbol para el símbolo; la FAQ muestra cómo poner el precio en negrita. Los decimales no tienen un elemento propio. Para darles estilo, por ejemplo más pequeños y elevados, envuélvelos con el filtro 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; }

Los precios sin céntimos se dejan sin cambios. Para mostrar un importe en varias monedas una al lado de otra, usa el atributo fix_currency, descrito en mostrar precios en varias monedas.

Si el formato no cambia

  • Pulsa Guardar opciones (Save options) después de editar una fila de moneda; los ajustes de la fila se guardan con la página, no al instante.
  • Una moneda en Formato: predeterminado (Format: default) sigue los separadores globales de la pestaña Opciones (Options), de modo que cambiar los globales solo cambia esas monedas.
  • Decimales (Decimals) no tiene efecto mientras la fila esté en Ocultar céntimos (Hide cents), y ninguno en absoluto para JPY y TWD.
  • Vacía la caché de páginas y comprueba en una ventana privada: las páginas en caché conservan el formato antiguo.

Si un precio sigue viéndose mal, publica el shortcode y una captura de pantalla de la fila de la moneda en el foro de soporte de WPCS.