Mostrar contenido según la moneda seleccionada en WordPress
Para mostrar contenido según la moneda seleccionada en WordPress, por ejemplo una nota de pago solo para los visitantes que pagan en dólares estadounidenses, un enlace de pedido distinto para cada moneda o un aviso para todo el que no esté viendo la moneda base, tu código necesita saber qué moneda ha elegido el visitante. WPCS la guarda en una propiedad de PHP y la repite en una clase de la etiqueta <body> y en una variable de JavaScript. A continuación verás cómo usar cada una, cómo pasar la moneda seleccionada a los enlaces y qué cambia cuando el sitio usa una caché de página.
Dónde guarda WPCS la moneda seleccionada
El plugin crea un único objeto global, $WPCS. Dos de sus propiedades importan aquí:
$WPCS->current_currency: el código de la moneda que el visitante ve ahora, tal como está escrito en la pestaña Monedas (Currencies), por ejemploUSDoEUR.$WPCS->default_currency: la moneda base, la que se marca con el botón de opción en esa pestaña.
La moneda actual es la última elección del visitante en el selector o en un enlace ?currency=EUR o, en la primera visita, la moneda de bienvenida o una regla de GeoIP. El plugin la guarda por visitante (la opción Almacenamiento de la moneda (Currency storage): transient, sesión o cookie) y la lee en cada carga de página. Las reglas de GeoIP se aplican en el hook init de WordPress, así que lee la propiedad en un shortcode, una plantilla o un hook que se ejecute después de init, no en el nivel superior de functions.php.
El mismo valor llega al front end por dos vías más:
| Dónde | Valor cuando se selecciona EUR | Útil para |
|---|---|---|
$WPCS->current_currency en PHP | EUR | Shortcodes y plantillas del tema |
Clase en la etiqueta <body> | currency-eur (en minúsculas) | Mostrar y ocultar bloques con CSS |
Variable de JavaScript wpcs_current_currency | un objeto; wpcs_current_currency.name es EUR | Tus propios scripts |
Compara siempre la propiedad, no el objeto. Una condición como if ($WPCS == 'USD') compara el objeto completo del plugin con una cadena de texto y nunca se cumple, así que el contenido no aparece. La forma correcta es if ($WPCS->current_currency === 'USD').
Mostrar contenido según la moneda seleccionada con un shortcode
Para una frase, una nota o un enlace dentro de una página, lo más cómodo es un shortcode de apertura y cierre: el editor envuelve el texto y los visitantes con otra moneda no lo reciben en absoluto. Regístralo una sola vez:
/*
* 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);
});
Después, úsalo en el contenido:
[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]
Los shortcodes anidados, como [wpcs_price], siguen funcionando porque el contenido pasa por do_shortcode(). Los códigos de moneda se comparan en mayúsculas, así que currency="usd" también funciona.
En una plantilla del tema, usa la misma comprobación directamente:
<?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; ?>
Mostrar u ocultar bloques enteros con clases CSS
Cuando un grupo entero de bloques, una sección de un constructor de páginas o un widget depende de la moneda, envolverlo en un shortcode resulta incómodo. Usa mejor la clase del body. WPCS añade currency- más el código en minúsculas a la etiqueta <body> mediante el filtro estándar body_class, de modo que cualquier tema que imprima body_class() recibe currency-usd, currency-eur, etcétera.
- Asigna una clase al bloque: en el editor de bloques abre los ajustes del bloque, Avanzado (Advanced) → Clase(s) CSS adicional(es) (Additional CSS class(es)), y escribe
only-usd(mostrar solo para USD) uhide-usd(ocultar para USD). Los constructores de páginas tienen el mismo campo; en Elementor es Avanzado (Advanced) → Clases CSS (CSS Classes). - Añade las reglas una sola vez, una línea por cada moneda que uses:
/* 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 diferencia con el shortcode: el bloque oculto sigue estando en el código fuente de la página, solo que no se muestra. Eso está bien para notas, banners y botones, pero no para nada que deba seguir siendo privado, como un código de descuento para un solo mercado.
Mostrar la moneda actual: [wpcs_current_currency]
Para decir a los visitantes qué moneda están viendo, el plugin incluye su propio shortcode, [wpcs_current_currency]. Por defecto muestra Current currency is:, el código y la bandera de la moneda. Sus atributos:
| Atributo | Valor por defecto | Qué hace |
|---|---|---|
text | Current currency is: | El texto previo al código. text="none" no muestra ningún texto |
code | 1 | 0 oculta el código de la moneda |
flag | 1 | 0 oculta la bandera. Ponlo en 0 si tus monedas no tienen imágenes de bandera; de lo contrario se imprime una imagen vacía |
currency | la moneda seleccionada | Muestra en su lugar la moneda indicada, por ejemplo currency="EUR". Debe ser una de tus monedas |
Ejemplo: [wpcs_current_currency text="Prices are shown in" flag=0]. La salida va envuelta en <span class="wpcs_current_currency wpcs_current_currency_EUR">, con las partes en .wpcs_current_currency_text, .wpcs_current_currency_code y .wpcs_current_currency_flag, de modo que puedes dar estilo a la etiqueta para cada moneda, por ejemplo .wpcs_current_currency_EUR .wpcs_current_currency_code { color: #1e5aa8; }. Para obtener solo el código, sin marcado, consulta cómo mostrar el código de la moneda actual.
Pasar la moneda seleccionada a los enlaces
Cualquier dirección de página con ?currency= y un código cambia al visitante a esa moneda, y el plugin la recuerda, como se explica en una moneda distinta en cada página. Los enlaces entre páginas de tu propio sitio no necesitan el parámetro: la elección guardada ya se aplica en todas partes. Lo necesitas cuando el enlace sale de ese almacenamiento, por ejemplo un formulario de reserva, una página de pedido u otro sitio que lee la moneda de la dirección.
Este shortcode devuelve cualquier URL con la moneda del visitante añadida, pero solo cuando no es la moneda base. Los enlaces de los visitantes en la moneda base quedan idénticos a la URL simple, lo que los mantiene aptos para la caché y evita direcciones duplicadas:
/*
* 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() añade & o ? según haga falta y sustituye un parámetro currency existente. WordPress ejecuta los shortcodes dentro de atributos HTML entrecomillados, así que el shortcode puede ser la dirección del enlace en un bloque de HTML personalizado o en el editor clásico. Usa comillas simples dentro de él, porque el href usa comillas dobles:
<a class="button" href="[current_currency_url url='https://booking.example.com/form/']">Book now</a>
Los campos de enlace del editor de bloques y de los constructores de páginas normalmente no ejecutan shortcodes. Para esos enlaces, usa la clase wpcs-currency-link de la sección siguiente.
Si el destino espera parámetros distintos para cada moneda en lugar de un parámetro currency, por ejemplo un formulario que preselecciona una opción diferente por mercado, escribe un enlace por moneda dentro 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]
Páginas servidas desde una caché: cambiar el contenido en el navegador
Todo lo que imprime PHP, incluidos los shortcodes anteriores, pasa a formar parte del HTML que guarda una caché de página. Los siguientes visitantes reciben esa copia y ven el contenido elegido para el visitante que llenó la caché, sea cual sea su propia moneda. La clase del body y la variable wpcs_current_currency se guardan en caché con ella.
Hay dos salidas. Excluye de la caché de página las páginas con contenido que depende de la moneda; así PHP se ejecuta para cada visitante y no hace falta nada más. O deja que el navegador corrija la página. Con Uso un plugin de caché en mi sitio (I am using cache plugin on my site) en Sí (Yes) en Ajustes (Settings) → Currency Switcher → Opciones (Options), el plugin envía una petición con action=wpcs_get_prices_html después de cada carga de página para redibujar los precios, y la respuesta contiene la moneda real del visitante en current_currency. Este fragmento escucha esa respuesta, vuelve a establecer la clase del body y actualiza los enlaces que llevan la clase wpcs-currency-link (en el propio enlace o en su contenedor, como en los bloques de Botones):
/*
* 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);
Con él, el método de las clases CSS funciona también en páginas en caché: los bloques correctos aparecen un instante después de cargar la página, cuando llega la respuesta. El shortcode de apertura y cierre no se puede corregir así, porque el contenido de las demás monedas nunca se envió al navegador; por eso, en páginas en caché usa clases CSS o excluye la página. El plugin omite su petición en las direcciones que ya contienen ?currency=; esas direcciones ya están construidas para esa moneda. Si retrasas JavaScript con un plugin de optimización, el fragmento debe ejecutarse sin retraso, igual que el selector; las exclusiones se indican en el selector de monedas no funciona con un plugin de caché.
Si no funciona
- El texto del shortcode aparece en la página. El fragmento no está activo, o el campo no ejecuta shortcodes. Pruébalo primero en un párrafo normal de una página.
- No cambia nada al cambiar de moneda. Abre el código fuente de la página y busca
currency-en la línea<body class=. Si falta, el tema no llama abody_class(); si muestra la moneda anterior mientras no has iniciado sesión, la página viene de una caché. - A ti te funciona, a los visitantes no. Las cachés de página suelen omitir a los administradores con sesión iniciada. Prueba en una ventana privada después de vaciar todas las capas de caché.
- Una condición de PHP nunca se cumple. Compara
$WPCS->current_currency, no$WPCS, usa el código exactamente como en la pestaña Monedas (Currencies) y haz la comprobación después deinit. - El enlace pierde la moneda. Comprueba que la moneda del visitante no sea la base:
[current_currency_url]y el fragmento dejan a propósito sin el parámetro los enlaces en la moneda base.
Si el contenido sigue sin seguir la moneda seleccionada, abre un tema en el foro de soporte de WPCS con el enlace de la página, el código que añadiste y si hay un plugin de caché u optimización activo.