Documentación del Plugin de WordPress
Aprende a instalar, configurar y personalizar tu widget de conversor de divisas
Tabla de Contenidos
1 Instalación
Método 1: Instalar desde WordPress (Recomendado)
- Ve al panel de administración de WordPress
- Navega a Plugins > Añadir nuevo
- Busca "Currency.Wiki Converter"
- Haz clic en "Instalar ahora" y luego en "Activar"
Método 2: Instalación Manual
- Descarga el plugin desde WordPress.org
- Ve a Plugins > Añadir nuevo > Subir plugin
- Selecciona el archivo ZIP descargado y haz clic en "Instalar ahora"
- Activa el plugin después de la instalación
2 Uso del Bloque Gutenberg
La forma más fácil de añadir el conversor de divisas a tus páginas:
- Edita cualquier página o entrada usando el editor Gutenberg
- Haz clic en el botón + para añadir un nuevo bloque
- Busca "Currency Converter" o navega a la categoría Widgets
- Configura el widget usando el panel lateral derecho
Consejo: Puedes ver una vista previa en vivo de tu widget mientras cambias la configuración en el editor de bloques.
3 Uso de Shortcode
También puedes añadir el widget usando shortcodes en entradas, páginas o plantillas de tema:
Uso Básico
[currencywiki_converter]
Atributos Disponibles
| Atributo | Por defecto | Descripción |
|---|---|---|
| style | compact | Estilo del widget (compacto, en línea, alto, mini-gráfico, etc.) |
| theme | auto | Tema de color (auto, claro, oscuro) |
| from | USD | Divisa de origen por defecto (código ISO de 3 letras) |
| to | EUR | Divisa de destino por defecto (código ISO de 3 letras) |
| amount | 1 | Cantidad por defecto a convertir |
| accent | #3b82f6 | Color de acento (código hex como #3b82f6) |
| embed | script | Método de inserción (script o iframe) |
| width | auto | Ancho personalizado en píxeles |
| height | auto | Alto personalizado en píxeles |
Ejemplos
Widget en tema oscuro:
[currencywiki_converter theme="dark"]
Divisas y cantidad personalizadas:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Estilo mini-gráfico:
[currencywiki_converter style="mini-chart"]
Usando inserción por iframe (para compatibilidad de temas):
[currencywiki_converter embed="iframe"]
4 Estilos del Widget
Elige entre varios estilos de widget para que coincidan con el diseño de tu sitio web:
mini
Conversor minimalista, perfecto para espacios reducidos (250x140px)
square
Conversor cuadrado con relación 1:1 (250x250px)
compact
Conversor pequeño y eficiente en espacio (280x200px)
inline
Diseño horizontal, ideal para encabezados (450x120px)
tall
Diseño vertical con etiquetas clásicas (220x360px)
mini-chart
Conversor compacto con gráfico histórico (250x260px)
multi-expandable
Convierte a múltiples divisas, los usuarios pueden añadir/quitar (300x400px)
multi-fixed
Lista fija de conversiones a varias divisas (280x360px)
rates-compact
Lista simple de tasas de cambio (260x260px)
rates-viewer
Visor de tasas completo con gráfico (350x420px)
rates-viewer-compact
Visor de tasas compacto con gráfico (300x340px)
Consejo: Usa el Generador de Widgets en tu panel de WordPress para previsualizar todos los estilos antes de añadirlos a tu sitio.
5 Opciones de Configuración
La página de configuración del plugin en tu panel de WordPress te permite ajustar las opciones por defecto:
Opciones de Tema
- auto - Coincide automáticamente con el esquema de colores de tu sitio
- light - Usar siempre fondo claro
- dark - Usar siempre fondo oscuro
Método de Inserción
- script - Por defecto. El widget se carga en línea con funcionalidad completa. Los desplegables de divisas se muestran sobre el contenido circundante.
- iframe - Opción alternativa. El widget se carga en un iframe aislado. Úsalo si experimentas conflictos de estilos con tu tema.
Nota: Si los desplegables de divisas aparecen detrás de otros elementos o se cortan, prueba cambiar al modo de inserción por iframe.
6 Solución de Problemas
¿El widget no se muestra?
Asegúrate de que el plugin esté activado. Verifica si algún plugin de caché necesita ser limpiado. Prueba usar el método de inserción por iframe si el script no funciona.
¿El widget se ve mal o hay conflicto de estilos?
Algunos temas de WordPress pueden entrar en conflicto con el script del widget. Cambia al modo de inserción por iframe añadiendo embed="iframe" a tu shortcode.
¿El desplegable de divisas está oculto o cortado?
Esto puede ocurrir cuando los elementos contenedores tienen overflow:hidden. Prueba usar el modo de inserción por iframe, o ajusta el CSS de tu tema para permitir overflow en el contenedor del widget.
¿El widget muestra tasas antiguas?
Las tasas de cambio se actualizan automáticamente. Si usas un plugin de caché, asegúrate de excluir los scripts del widget de la caché o limpia la caché después de hacer cambios.
¿Necesitas ayuda?
¿No encuentras lo que buscas? Nuestro equipo de soporte está aquí para ayudarte.