Redondear precios convertidos en WordPress Currency Switcher: 10, 5 o .99
Los precios convertidos salen exactos: 49 USD a un tipo de 0,86 son 42,14 EUR, y 12.500 USD a 88,2 son 1.102.500 INR. Para redondear los precios convertidos en WordPress Currency Switcher (WPCS) a números enteros, a la decena o al millar más cercanos, o a terminaciones como .99, puedes cambiar los decimales de la moneda o añadir unas líneas de PHP al filtro wpcs_price. El filtro tiene una trampa que rompe la mayoría de los fragmentos de redondeo en PHP 8 en cuanto un precio supera los 1.000. El código de abajo la evita.
Menos decimales sin código
Cada fila de moneda de la pestaña Monedas (Currencies) (Ajustes (Settings) → Currency Switcher) tiene dos selectores que controlan los decimales:
- Ocultar céntimos (Hide cents) imprime números enteros. 42,14 pasa a 42 y 42,50 pasa a 43, porque el plugin redondea hacia arriba la mitad cuando elimina los céntimos.
- Decimales: 0 (Decimals: 0) a Decimales: 8 (Decimals: 8) define cuántos decimales se imprimen. Solo funciona mientras la fila esté en Mostrar céntimos (Show cents).
JPY y TWD se imprimen siempre sin céntimos, diga lo que diga su fila. Guarda con Guardar opciones (Save options) y vacía la caché de páginas.
Estos ajustes cambian cuántos dígitos se muestran, no la cantidad en sí: no pueden convertir 42,14 en 45 o en 42,99. Para eso necesitas el filtro. Cómo se imprime el número (separadores, posición del símbolo, código de moneda) es otro tema, tratado en personalizar el formato de precio.
Cómo funciona el filtro wpcs_price y por qué fallan muchos fragmentos
Cada precio impreso por [wpcs_price] pasa por el método price() del plugin. Este multiplica el importe en la moneda base por el tipo, da formato al resultado con los decimales y los separadores de la moneda, y solo entonces aplica el filtro:
return apply_filters('wpcs_price', $this->format_price_numeric($price, $currency));
Así, el filtro wpcs_price recibe texto como 1,234.50 o 1.234,50, no un número, y lo que devuelve se imprime tal cual. De ello se derivan dos cosas:
- Pasar
$pricedirectamente around(),ceil()o una división funciona mientras los precios estén por debajo de 1.000 y usen un punto como decimal, y falla por encima. En PHP 8,round('1,234.50', -3)lanza unTypeErrorfatal y WordPress muestra «Ha habido un error crítico en este sitio web».'1,234.50' / 10solo da una advertencia y calcula con 1. Un fragmento de una línea comoreturn round($price, -3);falla exactamente así, y solo con los precios altos. - Devolver un número sin más descarta el formato: 1000 se imprime como
1000en lugar de1,000.00.
El filtro también se ejecuta con los precios mostrados en la moneda base, porque se les da formato del mismo modo. El enfoque que funciona: convertir el texto de nuevo en número con los separadores de la moneda actual, redondearlo y darle formato otra vez con $WPCS->format_price_numeric(), el método que usa el propio plugin.
Un fragmento de redondeo que funciona con cualquier precio
Añádelo al functions.php de un tema hijo o a un plugin de fragmentos de código. Define una regla por moneda. La moneda base y las monedas sin regla se quedan exactas.
/*
* 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);
});
Sustituye los códigos y las reglas por los tuyos. Algunos detalles importan:
get_thousands_separator()yget_decimal_separator()devuelven los separadores del selector Formato (Format) de la moneda, o los globales cuando está en predeterminado (default). El fragmento sigue funcionando si más adelante cambias un formato.format_price_numeric()aplica los ajustes de céntimos y Decimales (Decimals) de la fila. Una terminación .99 necesita Mostrar céntimos (Show cents) con dos decimales. Para reglas de números enteros, define la moneda en Ocultar céntimos (Hide cents); si no, 4,330 se imprime como 4,330.00.- Para redondear todas las monedas del mismo modo, sustituye todo el bloque
switchpor una sola regla, por ejemplo$number = ceil($number / 10) * 10;.
Fórmulas de redondeo
Pon una de estas líneas en lugar de una regla del fragmento. $number es el importe convertido exacto.
| Resultado | Ejemplo | Código |
|---|---|---|
| Hacia arriba hasta la siguiente decena | 341.20 → 350 | $number = ceil($number / 10) * 10; |
| Múltiplo de 5 más cercano | 511 → 510, 514 → 515 | $number = round($number / 5) * 5; |
| Millar más cercano | 345,667 → 346,000 | $number = round($number, -3); |
| 0,50 más cercano | 12.30 → 12.50 | $number = round($number * 2) / 2; |
| Terminación en .99 | 41.20 → 41.99 | $number = floor($number) + 0.99; |
| Número entero más cercano terminado en 9 | 517 → 519, 521 → 519 | $number = max(9, round($number / 10) * 10 - 1); |
ceil() y la regla .99 nunca muestran menos que la conversión exacta; round() va al valor más cercano en cualquier dirección. Para pasos mayores, sustituye 10 por 50 o 100. El manual de PHP describe round() y su argumento de precisión.
Precios que el filtro no redondea
- Precios fijos.
[wpcs_price type=fixed value=USD:49,EUR:45]muestra cada importe tal como lo escribiste y se salta el filtro; consulta los precios fijos por moneda. - Importes convertidos en PHP.
$WPCS->wpcs_exchange_value()y la acciónwpcs_exchange_valuedan formato al resultado sin el filtro. En tus propias plantillas, usa en su lugar$WPCS->price($amount): convierte, da formato y ejecuta el filtro, de modo que se aplica tu redondeo (devuelve el número sin el símbolo de moneda). - Conversor y tabla de tipos.
[wpcs_converter]y[wpcs_rates]muestran importes y tipos exactos. - El icono de información del precio. Con Mostrar icono de información del precio (Show price info icon) activado, la lista de otras monedas bajo el icono se calcula mientras la moneda del visitante sigue siendo la actual, de modo que una regla escrita para esa moneda se aplica a todas las líneas. Revisa la lista o desactiva el icono cuando redondees de forma distinta por moneda.
Con Uso un plugin de caché en mi sitio (I am using cache plugin on my site) en Sí (Yes), los precios se vuelven a dibujar por AJAX después de cargar la página. Ese redibujado usa el mismo método price(), así que el redondeo también se aplica ahí.
Comprueba el resultado
Crea una página en borrador con estas líneas y previsualízala:
[wpcs]
[wpcs_price value=9.99]
[wpcs_price value=499]
[wpcs_price value=12500]
- Cambia a cada moneda con una regla. La última línea es la importante: supera los 1.000 en todas las monedas y detecta el código que ignora el separador de miles.
- Cambia a la moneda base: los tres importes deben ser exactamente los que escribiste.
- Un error crítico tras añadir el fragmento significa que sigue activo en algún sitio otro fragmento de redondeo (tema, plugin de fragmentos). El registro de errores de PHP lo señala con
round(): Argument #1 ($num) must be of type int|float, string given. - Vacía la caché de páginas después de cada cambio y prueba en una ventana privada donde no hayas iniciado sesión.
Si los números siguen sin cuadrar, publica el fragmento que usas y los ajustes de moneda de la fila afectada en el foro de soporte de WPCS.