Documentación do Plugin de WordPress
Aprende a instalar, configurar e personalizar o teu widget conversor de moedas
Índice
1 Instalación
Método 1: Instalar desde WordPress (Recomendado)
- Accede ao panel de administración de WordPress
- Vai a Plugins > Engadir novo
- Busca "Currency.Wiki Converter"
- Preme en "Instalar agora" e logo en "Activar"
Método 2: Instalación manual
- Descarga o plugin desde WordPress.org
- Vai a Plugins > Engadir novo > Subir plugin
- Escolle o ficheiro ZIP descargado e preme en "Instalar agora"
- Activa o plugin despois da instalación
2 Uso do bloque Gutenberg
A forma máis sinxela de engadir o conversor de moedas ás túas páxinas:
- Edita calquera páxina ou entrada usando o editor Gutenberg
- Preme o botón + para engadir un novo bloque
- Busca "Currency Converter" ou navega pola categoría Widgets
- Configura o widget usando o panel lateral á dereita
Consello: Podes ver unha previsualización en tempo real do teu widget mentres cambias os axustes no editor de bloques.
3 Uso de Shortcode
Tamén podes engadir o widget usando shortcodes en entradas, páxinas ou plantillas de tema:
Uso básico
[currencywiki_converter]
Atributos dispoñibles
| Atributo | Por defecto | Descrición |
|---|---|---|
| style | compact | Estilo do widget (compacto, en liña, alto, mini-gráfica, etc.) |
| theme | auto | Tema de cor (auto, claro, escuro) |
| from | USD | Moeda de orixe por defecto (código ISO de 3 letras) |
| to | EUR | Moeda de destino por defecto (código ISO de 3 letras) |
| amount | 1 | Importe por defecto a converter |
| accent | #3b82f6 | Cor de acento (código hex como #3b82f6) |
| embed | script | Método de incrustación (script ou iframe) |
| width | auto | Anchura personalizada en píxeles |
| height | auto | Altura personalizada en píxeles |
Exemplos
Widget con tema escuro:
[currencywiki_converter theme="dark"]
Moedas e importe personalizados:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Estilo mini-gráfica:
[currencywiki_converter style="mini-chart"]
Usando incrustación iframe (para compatibilidade de tema):
[currencywiki_converter embed="iframe"]
4 Estilos do Widget
Escolle entre varios estilos de widget para adaptar ao deseño do teu sitio web:
mini
Conversor minimalista, perfecto para espazos reducidos (250x140px)
square
Conversor cadrado proporción 1:1 (250x250px)
compact
Conversor pequeno e eficiente en espazo (280x200px)
inline
Disposición horizontal, ideal para cabeceiras (450x120px)
tall
Disposición vertical con etiquetas clásicas (220x360px)
mini-chart
Conversor compacto con gráfica histórica (250x260px)
multi-expandable
Converter a múltiples moedas, os usuarios poden engadir/eliminar (300x400px)
multi-fixed
Lista fixa de conversións a varias moedas (280x360px)
rates-compact
Lista sinxela de taxas de cambio (260x260px)
rates-viewer
Visor completo de taxas con gráfica (350x420px)
rates-viewer-compact
Visor compacto de taxas con gráfica (300x340px)
Consello: Usa o Construtor de Widgets no teu panel de WordPress para previsualizar todos os estilos antes de engadilos ao teu sitio.
5 Opcións de configuración
A páxina de axustes do plugin no teu panel de WordPress permíteche configurar opcións por defecto:
Opcións de tema
- auto - Adáptase automaticamente ao esquema de cores do teu sitio
- light - Usar sempre fondo claro
- dark - Usar sempre fondo escuro
Método de incrustación
- script - Por defecto. O widget cárgase en liña con toda a funcionalidade. Os despregables de moeda móstranse sobre o contido circundante.
- iframe - Opción alternativa. O widget cárgase nun iframe illado. Úsao se experimentas conflitos de estilo co teu tema.
Nota: Se os despregables de moeda aparecen detrás doutros elementos ou quedan cortados, proba a cambiar ao modo de incrustación iframe.
6 Resolución de problemas
O widget non se mostra?
Asegúrate de que o plugin está activado. Comproba se hai plugins de caché que deban ser limpos. Proba a usar o método de incrustación iframe se o script non funciona.
O widget vese mal ou hai conflitos de estilos?
Algúns temas de WordPress poden entrar en conflito co script do widget. Cambia ao modo iframe engadindo embed="iframe" ao teu shortcode.
O despregable de moeda está oculto ou cortado?
Isto pode ocorrer cando os elementos contedores teñen overflow:hidden. Proba a usar o modo iframe ou axusta o CSS do teu tema para permitir overflow no contedor do widget.
O widget mostra taxas antigas?
As taxas de cambio actualízanse automaticamente. Se usas un plugin de caché, exclúe os scripts do widget do caché ou limpa a caché despois de facer cambios.
Precisas axuda?
Non atopas o que buscas? O noso equipo de soporte está aquí para axudarche.
