WPCS

El shortcode acepta value, o meta_value con un post_id opcional; post_id sin meta_value lee la clave meta wpcs_price. price() multiplica por la tasa solo cuando la divisa actual difiere de la base, y luego pasa el número a format_price_numeric() y al filtro wpcs_price.

price_html() envuelve el resultado en un span con un ID único y data-amount con el valor base, que el modo de caché de página usa más tarde para volver a renderizarlo.

Para los precios fijos, el shortcode analiza la lista y la convierte en un mapa y muestra el importe de la divisa actual, o 'none' si falta. La lista de precio en todas las divisas usa el mismo mapa en lugar de convertir.

JPY y TWD se muestran siempre sin céntimos; cualquier divisa puede añadirse a esa lista con hide_cents. Los ajustes incluyen decimales por divisa y separadores decimal y de miles por divisa. La elección del separador es un índice en dos arrays paralelos, donde el índice 0 significa el ajuste global, de modo que los sitios existentes conservan su formato.

El interest es un importe fijo guardado junto a la tasa. get_currencies() lo suma a la tasa en todas partes salvo en la página de ajustes del plugin, de modo que el administrador edita la tasa limpia mientras que el front end convierte con la ajustada. Después se ejecuta un filtro wpcs_currency_data_manipulation para reglas personalizadas.

La lista de información de precios quita el separador de miles de la cadena ya formateada, normaliza el separador decimal, convierte de nuevo a la base con back_convert() (1/rate) y luego hacia delante a cada una de las demás divisas. El endpoint de [wpcs_converter] usa rate[to] / rate[from], ambas relativas a la base, y elimina los céntimos en las divisas sin céntimos.

Para un precio convertido, el shortcode recuerda la divisa del visitante, cambia a la solicitada si está configurada, renderiza y vuelve a cambiar, de modo que el resto de la página conserva la elección del visitante.

El changelog refleja esa rotación: Yahoo eliminado en 1.1.1 (2017), Google eliminado en 1.1.2 (2018), ambos añadidos de nuevo en 1.1.3 (2018), fuentes que dejaron de funcionar eliminadas otra vez en 1.1.3 y 1.1.4, agregadores personalizados mediante un hook en 1.1.5 (2020). Cada fuente es una clase con getApiUrl() y parseResponse() sobre una base compartida RateProvider.

get_rate_provider() asigna el valor de la opción a un nombre de clase; si no existe la clase, wpcs_add_aggregator_processor permite a un sitio conectar su propia fuente, y wpcs_announce_aggregator la añade a la lista de ajustes. La lista de ajustes tiene 14 fuentes.

El BCE publica frente a EUR, el Banco Nacional de Ucrania frente a UAH y el Magyar Nemzeti Bank frente a HUF. Cada proveedor gestiona tres casos: la base es la divisa del banco, el destino es la divisa del banco, ninguno de los dos. La fuente MNB es un servicio SOAP con comas decimales y cotizaciones por unidad (por ejemplo 100 JPY), que se normalizan antes de dividir.

get_rate() devuelve el texto de error del proveedor en lugar de un número cuando la tasa es negativa. rate_auto_update() convierte los resultados a float y sustituye una tasa solo cuando el nuevo valor es superior a cero, de modo que una fuente rota nunca escribe cero ni un texto de error como tasa.

Los ajustes ofrecen cada hora, dos veces al día, diario, semanal o mensual. El plugin registra los dos intervalos adicionales mediante cron_schedules y programa el evento con el intervalo seleccionado al cargar, cuando todavía no está programado.

El manejador AJAX guarda la nueva bandera is_etalon, establece en memoria la nueva divisa por defecto, solicita una tasa para cada una de las demás divisas mediante el proveedor activo y devuelve las tasas al formulario de ajustes.

WPCS_World_Currencies guarda el símbolo, la descripción, los decimales y el código de bandera de cada divisa. add_currencies_ajax() añade las seleccionadas, obtiene una tasa para cada una, registra los símbolos desconocidos como signos personalizados y descarga la bandera en la biblioteca de medios, recurriendo a una URL remota de la bandera si la descarga falla. El diálogo de alta masiva solo se muestra en la versión premium.

Cada span de precio lleva un ID único y el importe base. Con la opción de caché activada, front.js envía los pares id/importe a wpcs_get_prices_html, que resuelve la divisa del visitante en el servidor y devuelve un mapa de id a nuevo HTML más la divisa actual; después los widgets del conmutador se sincronizan con ella. El modo está presente en el código de 2016.

Mientras los widgets del conmutador se ajustan a la divisa devuelta, una bandera impide que sus eventos change inicien otro cambio de divisa.

WPCS_STORAGE construye el backend por nombre a partir de una clase abstracta Storage. SessionStorage::create() devuelve false cuando session_start() falla, y el wrapper recurre entonces al almacenamiento en transients. Todo valor se sanea al escribirse.

El changelog nombra la razón: los transients indexados por IP mezclan a los usuarios que comparten dirección. CookieStorage indexa los transients por una cookie UUID. Si las cabeceras ya se han enviado cuando se crea el ID, imprime un script en el pie que envía el ID a un endpoint AJAX con comprobación de nonce, el cual establece la cookie desde una respuesta limpia.

En el modo por defecto, wpcs_redirect() reconstruye la URL actual conservando los demás parámetros GET y el #ancla. En el modo 'No GET data in link', envía la divisa a wpcs_set_currency_ajax y recarga. Los parámetros GET reflejados en el script de la página se sanean antes de forma recursiva.

En la primera petición se guarda la divisa de bienvenida y se establece la bandera; las reglas geográficas también se ejecutan solo en una primera visita única. Si más tarde se elimina de la lista una divisa guardada, get_currencies() recurre a la base.

WC_Geolocation de WooCommerce no está disponible en un sitio WordPress simple, así que el plugin incluye su propia base de datos de países. lib/GeoIP.dat y geoip.inc se envuelven en OpenIpCountryResolver con una caché por IP en cada petición.

Con la base de datos incluida, la cabecera HTTP_CF_IPCOUNTRY de Cloudflare se usa directamente y se omite la consulta a la base de datos. Una petición cuyo REMOTE_ADDR es 127.0.0.1 o ::1 se resuelve como 8.8.8.8 antes de leer las cabeceras de proxy.

Con una clave de licencia de MaxMind, el administrador descarga el archivo GeoLite2-Country; el manejador descomprime el .tar.gz con PharData, localiza el archivo .mmdb, lo copia a uploads/currency-switcher y elimina los archivos temporales tanto si tiene éxito como si hay error. Sin clave, el plugin se queda con la base de datos incluida. Las consultas pasan por el paquete de Composer geoip2.

init_geo_currency() resuelve el país, lo pasa por wpcs_geo_position, lo guarda para el visitante y aplica la primera regla coincidente solo en una primera visita. [wpcs_check_country] imprime el país detectado para depurar una regla.

wpcs_get_prices_html está disponible para visitantes anónimos. Recorta la entrada a 500 elementos, acepta solo ids que coincidan con el juego de caracteres de uniqid() que usa price_html(), omite precios no escalares y codifica la respuesta con JSON_HEX_TAG, AMP, APOS y QUOT porque admin-ajax la sirve como text/html.

price_html() escribe en atributos data-* del span de precio valores que proceden de los atributos de [wpcs_price], como el importe base o la lista en bruto 'USD:15,EUR:20' de un precio fijo. Las claves y los valores se escapan y se entrecomillan, de modo que un valor de atributo no puede inyectar marcado.

wpcs_rates_current_currency pasa la entrada del visitante a do_shortcode(). Solo sobreviven los códigos de divisa que existen en la configuración, el resultado pasa por esc_attr y la precisión se convierte a int, de modo que no se puede inyectar sintaxis adicional de shortcode.

El campo del formulario del conmutador de divisas y el parámetro ?currency= se comprueban con array_key_exists() frente a la lista configurada antes de llegar al almacenamiento, y WPCS_STORAGE::set_val() sanea cada valor.

Símbolos como руб. se guardan como entidades. El select envía md5(symbol), y el manejador de guardado asigna el hash de vuelta a la entidad original de la lista conocida, de modo que la entidad ni se codifica dos veces ni se toma de la entrada en bruto. El guardado está protegido con check_admin_referer(), y position se comprueba frente a una lista fija.