Widget de Calculadora de Oro: Guía de Integración y Uso
Ofrezca a los visitantes de su sitio web cálculos precisos e interactivos de metales preciosos. El Widget de Calculadora de Oro permite valorar al instante tanto oro como plata en múltiples purezas, unidades de peso y 150 divisas internacionales sin necesidad de mantenimiento.
1. Inicio Rápido: Cómo Insertar el Widget
Insertar la calculadora es muy sencillo. Coloque el script y la etiqueta HTML personalizada dentro del <body> de su página web donde desee que se muestre el widget:
<!-- Cargar el motor del widget -->
<script src="https://www.forexinvestors.com/widgets/gold-calculator/widget.js"></script>
<!-- Elemento de la Calculadora de Oro -->
<gold-calculator-widget
lang="es"
currency="USD"
show-header="on"
header-text="Calculadora de Oro"
theme="default"
border-radius="5">
</gold-calculator-widget>
Consejo de rendimiento: El archivo JavaScript solo necesita importarse una vez por página, incluso si inserta múltiples instancias de la calculadora en el mismo diseño.
2. Atributos de Personalización
Configure la apariencia inicial y el estado predeterminado modificando los atributos del elemento <gold-calculator-widget>:
| Atributo | Tipo | Por defecto | Descripción |
|---|---|---|---|
lang |
Texto (String) | en |
Define el idioma de la interfaz y el formato numérico (en, ar, fr, es, ru). Activa automáticamente el diseño RTL para idiomas de derecha a izquierda como el árabe (ar). |
currency |
Texto (String) | USD |
Código de divisa predeterminada inicial (ISO 4217, p. ej., USD, EUR, GBP, SAR, AED, EGP, INR). |
show-header |
Texto (String) | on |
Controla la visibilidad de la barra de encabezado del widget (on u off). |
header-text |
Texto (String) | Gold Calculator |
Texto de título personalizado en el encabezado cuando show-header="on" (por defecto muestra el título traducido según el atributo lang). |
header-link |
Texto (String) | https://www.goldpricedata.com/ |
URL de destino opcional (http o https) para el enlace del título del encabezado. |
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 y los campos (entero de 0 a 20 en el configurador, hasta 50 soportado, p. ej., 0, 5, 12). |
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 del widget y de los controles del formulario. |
text-color |
222222 |
Color de texto principal para etiquetas, campos y marca de tiempo. |
input-bg-color |
FFFFFF |
Color de fondo para campos de entrada, menús desplegables y el cuadro de resultado. |
bg-color-button |
535353 |
Color de fondo para los botones de acción del pie del widget. |
button-border-color |
2E2E2E |
Color del borde para los botones de acción del pie del widget. |
button-hover-color |
8A8A8A |
Color de resaltado al pasar el cursor sobre los botones del pie y las opciones de divisas. |
3. Funciones para el Usuario Final
Los visitantes que interactúan con el widget en su sitio disfrutan de las siguientes capacidades integradas:
- Soporte para Oro y Plata: Cambie al instante entre Oro y Plata, actualizando automáticamente las opciones de pureza según el metal elegido.
- Selección completa de quilates y leyes de pureza:
- Quilates de oro:
24K(.999),23K(.965),22K(.916),21K(.875),18K(.750),14K(.585),12K(.500),10K(.417),9K(.375) y8K(.333). - Leyes de la plata:
999(Plata pura),958(Britannia),925(Plata de ley / Sterling),900(Plata de moneda) y800(Plata de joyería).
- Quilates de oro:
- Flexibilidad de peso y unidades: Ingrese cualquier peso personalizado y alterne entre las unidades estándar de metales preciosos: Onza (onza troy), Gramo y Tola.
- Selector de divisas con búsqueda y banderas: Explore 150 monedas mundiales organizadas en Favoritas (
USD,EUR,GBP,CAD,AUD,JPY,CHF,INR,AED,SAR) y Todas las monedas, con banderas de países, filtro de búsqueda instantáneo y navegación por teclado. - Encapsulación Shadow DOM: Se renderiza dentro de un Shadow DOM aislado para que las hojas de estilo de su sitio web no entren en conflicto con el diseño de la calculadora.
- Cotizaciones con marca de tiempo: Muestra la fecha y hora de la última actualización de tasas en el pie del widget junto con enlaces rápidos a la fuente de datos 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
<gold-calculator-widget>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
280pxa360pxpara una alineación óptima de dos columnas.
5. Preguntas Frecuentes (FAQ)
¿Con qué frecuencia se actualizan los precios del oro y la plata en el widget?
Las tasas del mercado se actualizan cada 5 minutos a partir de fuentes en vivo de metales preciosos y divisas. La marca de tiempo en la parte inferior del widget indica la hora de la última actualización.
¿Este widget ralentizará la velocidad de carga de mi sitio web?
No. El script del Web Component es ligero, obtiene los datos de tasas de forma asíncrona y se renderiza dentro de un Shadow DOM aislado sin bloquear el diseño de su página.
¿Puedo colocar varios widgets en la misma página?
Sí. Puede añadir múltiples elementos <gold-calculator-widget> con diferentes idiomas, monedas predeterminadas o temas. La etiqueta externa <script> solo debe incluirse una vez por página.
¿El widget es compatible con dispositivos móviles y diseño RTL?
Sí. El widget utiliza un diseño flexible y adaptable que se ajusta al ancho de su contenedor en teléfonos, tabletas y barras laterales de escritorio, y cambia automáticamente a la alineación de derecha a izquierda (RTL) cuando se selecciona lang="ar".
¿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.