Documentación do widget
Guía completa para inserir e personalizar o widget de conversor de moedas Currency.Wiki no teu sitio web.
Índice
1 Primeiros pasos
Engadir un widget de conversor de moedas ao teu sitio web é fácil. Sigue estes pasos sinxelos:
- Vai á páxina do Construtor de Widget e personaliza a aparencia
- Selecciona o estilo, moedas e tema preferidos
- Copia o código de inserción xerado (Script ou Iframe)
- Pega o código no HTML do teu sitio web onde queiras que apareza o widget
Consello: Usa as preconfiguracións rápidas no Construtor de Widget para comezar rapidamente cun widget preconfigurado.
2 Métodos de inserción
Inserción Script (Recomendado)
O método de inserción por script inxecta o widget directamente na túa páxina. Os menús despregables de moeda aparecerán por riba do contido para facilitar a selección.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Os despregables aparecen fóra do contedor do widget
- Ideal para selección interactiva de moedas
- Integración perfecta coa túa páxina
Inserción Iframe
O método de inserción por iframe crea un contedor illado para o widget. Este método é seguro e funciona en contornos con políticas de contido estritas.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Completamente illado dos estilos da túa páxina
- Funciona con políticas de seguridade de contido estritas
- Implementación sinxela e segura
Nota: Usa inserción Script para interactividade total (despregables sobre o contido). Usa Iframe cando precises illamento ou restricións CSP.
3 Estilos do widget
Escolle entre 11 estilos de widget diferentes para adaptar ao deseño do teu sitio web. Cada estilo está optimizado para diferentes usos e tamaños.
mini
250x140px
Conversor compacto dunha liña. Perfecto para cabeceiras ou espazos reducidos.
square
250x250px
Widget 1:1 con botón de intercambio. Ideal para barras laterais.
compact
300x180px
Conversor pequeno con todas as funcións esenciais.
inline
480x56px
Disposición horizontal. Ideal para inserir en contido ou navegación.
tall
200x280px
Disposición vertical tipo barra lateral con etiquetas clásicas.
mini-chart
250x260px
Conversor compacto con gráfica de liña mostrando o historial de taxas.
multi-expandable
300x320px
Conversor multi-moeda. Os usuarios poden engadir/eliminar moedas.
multi-fixed
300x300px
Lista fixa de taxas de cambio. Ideal para mostrar taxas específicas.
rates-compact
250x320px
Lista condensada de taxas de cambio con hora de actualización.
rates-viewer
300x500px
Vista completa de gráfica con información detallada de taxas.
rates-viewer-compact
300x400px
Versión compacta do visor de taxas con gráficas.
4 Parámetros de URL
Personaliza o teu widget usando parámetros de URL. Estes parámetros funcionan tanto con Script como con Iframe.
| Parámetro | Predeterminado | Descrición |
|---|---|---|
| style | compact | Estilo do widget (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Tema de cor (light, dark ou auto) |
| from | USD | Código de moeda de orixe (ex: USD, EUR, GBP) |
| to | EUR | Código de moeda de destino (ex: EUR, USD, JPY) |
| amount | 1000 | Importe predeterminado para conversión |
| accent | #2563eb | Cor de acento en formato hex (sen #) |
| lang | en | Código de idioma do widget (ex: en, es, fr, de) |
| flags | 1 | Mostrar bandeiras de países (1=mostrar, 0=ocultar) |
| display | iso | Formato de visualización da moeda (iso=USD, symbol=$) |
| lock | 0 | Bloquear moedas (1=bloqueado, 0=desbloqueado) |
| currencies | EUR,GBP,JPY | Lista separada por comas de moedas para widgets multi-moeda |
| dropdown | all | Moedas no despregable (all, top10, top20 ou lista separada por comas) |
| branding | 1 | Mostrar marca (1=mostrar, 0=ocultar) |
| brandinglink | 1 | Facer marca clicable (1=ligazón, 0=só texto) |
| format | auto | Formato numérico (auto, us, eu, french, indian) |
| decimals | 2 | Número de decimais (0-6) |
| chart | 0 | Activar gráfica (1=activado, 0=desactivado) |
| chartperiod | 7d | Período da gráfica (7d, 14d, 30d, 90d) |
Exemplos
Conversor compacto con tema escuro:
?style=compact&theme=dark&from=USD&to=EUR
Taxas de cambio multi-moeda:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini conversor con gráfica de 30 días:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Mostrar símbolos de moeda en vez de códigos:
?style=compact&display=symbol&from=USD&to=EUR
Moedas bloqueadas con importe personalizado:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Opcións de personalización
Opcións de tema
- light - Fondo claro con texto escuro
- dark - Fondo escuro con texto claro
- auto - Adáptase automaticamente á preferencia do sistema do usuario
Formato de visualización da moeda
- iso - Mostra códigos ISO como USD, EUR, GBP
- symbol - Mostra símbolos de moeda como $, €, £
Formatos numéricos
- auto - Detecta automaticamente a configuración do navegador do visitante
- us - Formato US: 1,234.56
- eu - Formato europeo: 1.234,56
- french - Formato francés: 1 234,56
- indian - Formato indio: 1,23,456.78
Opcións de moedas no despregable
- all - Todas as 170+ moedas soportadas
- top10 - As 10 moedas máis populares
- top20 - As 20 moedas con máis volume de negociación
- USD,EUR,GBP,... - Lista personalizada de moedas específicas
Consello: Usa o Construtor de Widget para configurar visualmente todas estas opcións e xerar o código de inserción automaticamente.
6 Resolución de problemas
O widget non se mostra
Asegúrate de que o código de inserción está colocado correctamente no teu HTML. Para inserción por script, comproba que existe o div contedor co ID correcto. Revisa a consola do navegador por erros de JavaScript.
O despregable non funciona
Se usas inserción por iframe, os despregables desprazaranse dentro da área do widget. Para funcionalidade completa dos despregables, usa o método de inserción por script.
Conflitos de estilo
Se o CSS do teu sitio afecta á aparencia do widget, proba o método de inserción por iframe que illará os estilos do widget.
Problemas coa política de seguridade de contido
Se tes unha CSP estrita, pode que precises engadir currency.wiki ás túas directivas permitidas en script-src e frame-src. Exemplo: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
¿Precisas axuda?
¿Non atopas o que buscas? O noso equipo de soporte está aquí para axudar.
