Widget de Conversor de Divisas: Guía de Integración y Uso
Ofrezca conversiones de divisas rápidas e interactivas a los visitantes de su sitio web. El Widget de Conversor de Divisas admite más de 150 monedas mundiales, metales preciosos y Bitcoin con cálculos bidireccionales instantáneos, menús desplegables con búsqueda y banderas, y cero mantenimiento.
1. Inicio Rápido: Cómo Insertar el Widget
Insertar el conversor es muy sencillo. Coloque el script y la etiqueta HTML personalizada dentro del <body> de su página web donde desee que aparezca el widget:
<!-- Cargar el motor del widget -->
<script src="https://www.forexinvestors.com/widgets/currency-converter/widget.js"></script>
<!-- Elemento del Conversor de Divisas -->
<currency-converter
lang="es"
from="USD"
to="EUR"
amount="1"
theme="default"
border-radius="5">
</currency-converter>
Consejo de rendimiento: El archivo JavaScript solo necesita importarse una vez por página, incluso si inserta múltiples instancias del conversor de divisas en el mismo diseño.
2. Atributos de Personalización
Configure la apariencia inicial y el par de divisas predeterminado modificando los atributos del elemento <currency-converter>:
| Atributo | Tipo | Por defecto | Descripción |
|---|---|---|---|
lang |
Texto (String) | en |
Define el idioma de la interfaz para los nombres traducidos de las divisas y el formato de fecha (en, ar, fr, es, ru). |
from |
Texto (String) | EUR |
Código de la moneda de origen inicial (ISO 4217, además de BTC, XAU, XAG, XPT; p. ej., USD, EUR, GBP, SAR). |
to |
Texto (String) | USD |
Código de la moneda de destino inicial (ISO 4217 o BTC; p. ej., EUR, USD, JPY, AED, EGP). |
amount |
Número (Number) | 1 |
Cantidad numérica inicial a convertir al cargar (cualquier número positivo, p. ej., 1, 100, 50.5). |
theme |
Texto (String) | default |
Selecciona la paleta de colores: default, blue, green, yellow, red, ocean, purple, teal, dark, rose o custom. |
border-radius |
Número (Number) | 5 |
Radio de las esquinas en píxeles para el contenedor del widget (entero de 0 a 20 en el configurador, hasta 50 soportado, p. ej., 0, 5, 12). |
size |
Texto (String) | normal |
Controla la altura y el tamaño de fuente de los campos y menús desplegables (normal o large). |
native-dropdown |
Texto (String) | off |
Establézcalo en on para usar menús <select> nativos del navegador en lugar del menú desplegable con búsqueda y banderas. |
Atributos de Color del Tema Personalizado
Cuando se establece theme="custom", puede personalizar los colores individuales del widget utilizando valores hexadecimales de 6 dígitos (sin el prefijo #):
| Atributo | Por defecto | Descripción |
|---|---|---|
bg-color |
F6F6F6 |
Color de fondo del contenedor del widget. |
border-color |
BCBCBC |
Color del borde del contenedor, campos de entrada y menús desplegables. |
text-color |
222222 |
Color de texto principal para los campos, nombres de divisas y marca de tiempo. |
input-bg-color |
FFFFFF |
Color de fondo para los campos de importe y menús desplegables de divisas. |
bg-color-button |
535353 |
Color de fondo para el botón de intercambio (⇆) y los botones de acción del pie. |
button-border-color |
2E2E2E |
Color del borde para el botón de intercambio y los botones del pie. |
button-hover-color |
8A8A8A |
Color de resaltado al pasar el cursor sobre el botón de intercambio y los botones del pie. |
3. Funciones para el Usuario Final
Los visitantes que interactúan con el widget en su sitio disfrutan de las siguientes capacidades integradas:
- Cálculo bidireccional instantáneo: Escriba tanto en el campo superior (origen) como en el inferior (destino) para calcular la conversión en cualquier dirección al instante en el navegador sin solicitudes adicionales al servidor.
- Intercambio de divisas en un clic (
⇆): Invierta al instante las monedas de origen y destino mediante el botón de intercambio situado junto al campo superior. - Más de 150 divisas, metales y cripto: Convierta entre monedas fiduciarias globales, Bitcoin (
BTC) y metales preciosos (XAU,XAG,XPT), organizadas en Favoritas (USD,EUR,GBP,CAD) y Todas las monedas. - Menús desplegables con búsqueda y banderas: Encuentre rápidamente cualquier moneda por código o nombre con iconos de banderas y filtrado en tiempo real.
- Encapsulación Shadow DOM y contraste automático: Se renderiza dentro de un Shadow DOM aislado para que el CSS de su sitio web no afecte al conversor, con cálculo automático de contraste para el texto de los botones.
- Tasas de cambio con marca de tiempo: Muestra la fecha y hora de la última sincronización de tasas en el pie del widget junto con enlaces rápidos a la fuente de datos (
FI) y al configurador (+).
4. Instrucciones de Integración en CMS
WordPress / Gutenberg y Elementor
- Añada un bloque de HTML personalizado en su entrada, página o barra lateral.
- Pegue el cargador de script y el código del elemento
<currency-converter>generado arriba. - Actualice o publique su página.
Webflow, Wix y Shopify
- Inserte un elemento de Incrustación / Código personalizado (Embed / Custom Code) en el lienzo de diseño.
- Pegue el fragmento de código de inserción del widget.
- Asegúrese de que el contenedor padre mantenga un ancho mínimo de
240pxa340pxpara una visualización óptima.
5. Preguntas Frecuentes (FAQ)
¿Con qué frecuencia se actualizan las tasas de cambio en el widget?
Las tasas de cambio se actualizan cada 5 minutos a partir de fuentes del mercado de divisas en vivo. La marca de tiempo en la parte inferior del widget indica la hora de la última actualización.
¿Cambiar de moneda o escribir cantidades realiza solicitudes adicionales al servidor?
No. El widget descarga la tabla completa de tasas una sola vez al cargarse y realiza todas las conversiones, cambios de divisa e intercambios de forma instantánea en el navegador.
¿Puedo colocar varios conversores en la misma página?
Sí. Puede añadir múltiples elementos <currency-converter> con diferentes pares de divisas, importes o temas. La etiqueta externa <script> solo debe incluirse una vez por página.
¿El widget es compatible con dispositivos móviles?
Sí. El widget utiliza un diseño vertical adaptable que se ajusta al ancho de su contenedor padre en teléfonos móviles, tabletas y barras laterales de escritorio.
¿El widget requiere una clave API o el atributo data-endpoint?
No se requiere ninguna clave API ni es necesario especificar el atributo data-endpoint; el widget deduce automáticamente su punto de datos a partir de la URL del script widget.js.