WP Manifestindependent plugin directory
manifest / utilities / tasa-cambio-bcc

Tasa de Cambio BCC

Plugin de Wordpress para visualizar la Tasa de Cambio Monetario en Cuba

by Yoenis Pantoja Zaldívar · github.com/yoenispantoja/tasa-cambio-bcc · website

★ 1stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/yoenispantoja/tasa-cambio-bcc/archive/refs/heads/main.zip
Readme github.com/yoenispantoja/tasa-cambio-bcc ↗

💱 Tasa de Cambio BCC - Plugin WordPress

Plugin de WordPress para mostrar las tasas de cambio del Banco Central de Cuba con diseño profesional, responsive y actualización automática.

📸 Vista Previa

Banner Horizontal (Desktop)

Perfecto para headers de sitios web, muestra automáticamente las monedas que caben en el espacio disponible.

Banner Preview

Widget para Sidebar

Diseño vertical compacto ideal para barras laterales.

Widget Preview

Más capturas: Las capturas de pantalla detalladas están disponibles en SCREENSHOTS.md

✨ Características

  • ✅ Widget para Sidebar: Muestra tasas de cambio en formato vertical
  • ✅ Banner Horizontal Responsive: Muestra automáticamente las monedas que caben sin scroll
  • ✅ Carrusel Móvil: Navegación táctil optimizada para smartphones
  • ✅ Vista Completa con Tabs: Las 13 monedas con los 3 segmentos (I, II, III)
  • ✅ Diseño Profesional: Interfaz moderna con colores del BCC (dorado y azul)
  • ✅ Cache Inteligente: Sistema de caché de 1 hora para optimizar rendimiento
  • ✅ Actualización Automática: Refresco automático cada 30 minutos
  • ✅ API Oficial: Consume datos del Banco Central de Cuba en tiempo real
  • ✅ Sin Errores Visibles: Si el servicio falla, el banner simplemente no se muestra
  • ✅ 13 Monedas Disponibles: USD, EUR, CAD, RUB, GBP, MXN, JPY, CHF, CNY, AUD, SEK, NOK, DKK
  • ✅ Tooltip JPY: Explicación clara para la tasa inversa del yen japonés
  • ✅ Variaciones Coloreadas: Verde para aumentos, rojo para disminuciones

📦 Instalación

Opción 1: Descarga desde GitHub (Recomendado)

  1. Ve a Releases
  2. Descarga la última versión (archivo .zip)
  3. En WordPress, ve a Plugins > Añadir nuevo > Subir plugin
  4. Selecciona el archivo descargado y haz clic en Instalar ahora
  5. Activa el plugin

Opción 2: Instalación Manual

  1. Clona o descarga este repositorio
    git clone https://github.com/yoenispantoja/tasa-cambio-bcc.git
  2. Copia la carpeta tasa-cambio-bcc a /wp-content/plugins/
  3. Activa el plugin desde el menú 'Plugins' en WordPress
  4. ¡Listo! El plugin ya está funcionando

Opción 3: Instalación Directa con Git

cd wp-content/plugins/
git clone https://github.com/yoenispantoja/tasa-cambio-bcc.git tasa-cambio-bcc

🚀 Inicio Rápido

Una vez activado el plugin:

  1. Widget: Ve a Apariencia > Widgets y arrastra "Tasas de Cambio BCC" al sidebar
  2. Banner: Agrega [tasa_cambio_banner] en tu página o en el header
  3. Vista completa: Agrega [tasa_cambio_completo] en cualquier página

Para instrucciones detalladas, consulta INICIO-RAPIDO.md

🎨 Uso

Widget en Sidebar

  1. Ve a Apariencia > Widgets
  2. Arrastra el widget "Tasas de Cambio BCC" al sidebar deseado
  3. Configura:
    • Segmento por defecto (I, II o III)
    • Monedas a mostrar

Shortcodes

Banner Horizontal (para header)

[tasa_cambio_banner]

Parámetros opcionales:

  • segmento: tasaOficial|tasaPublica|tasaEspecial (por defecto: tasaEspecial)
  • monedas: USD,EUR,CAD,RUB (por defecto: principales)

Ejemplo:

[tasa_cambio_banner segmento="tasaEspecial" monedas="USD,EUR,CAD,RUB"]

Vista Completa con Tabs

[tasa_cambio_completo]

Parámetros opcionales:

  • segmento_inicial: tasaOficial|tasaPublica|tasaEspecial (por defecto: tasaEspecial)

Ejemplo:

[tasa_cambio_completo segmento_inicial="tasaEspecial"]

Integración en Tema

En header.php (banner superior)

<?php
if (shortcode_exists('tasa_cambio_banner')) {
    echo do_shortcode('[tasa_cambio_banner]');
}
?>

En cualquier template

<?php
if (shortcode_exists('tasa_cambio_completo')) {
    echo do_shortcode('[tasa_cambio_completo]');
}
?>

💱 Monedas Soportadas

El plugin muestra las siguientes 13 monedas:

  1. 🇺🇸 USD - Dólar Estadounidense
  2. 🇪🇺 EUR - Euro
  3. 🇨🇦 CAD - Dólar Canadiense
  4. 🇷🇺 RUB - Rublos Rusos
  5. 🇲🇽 MXN - Peso Mexicano
  6. 🇨🇳 CNY - Yuan Chino
  7. 🇬🇧 GBP - Libra Esterlina
  8. 🇯🇵 JPY - Yen Japonés
  9. 🇨🇭 CHF - Franco Suizo
  10. 🇦🇺 AUD - Dólar Australiano
  11. 🇸🇪 SEK - Corona Sueca
  12. 🇳🇴 NOK - Corona Noruega
  13. 🇩🇰 DKK - Corona Danesa

📊 Segmentos de Tasas

El Banco Central de Cuba maneja 3 segmentos de tasas:

  • Segmento I (tasaOficial): Tasa oficial
  • Segmento II (tasaPublica): Tasa pública
  • Segmento III (tasaEspecial): Tasa especial (por defecto)

🔧 Personalización

Colores y Estilos

Puedes personalizar los colores editando las variables CSS en assets/css/styles.css:

:root {
    --bcc-primary: #2c3e50;      /* Color principal */
    --bcc-secondary: #d4af37;    /* Color secundario (dorado) */
    --bcc-background: #f8f9fa;   /* Fondo */
    --bcc-border: #e0e0e0;       /* Bordes */
    --bcc-text: #333;            /* Texto */
    --bcc-text-light: #666;      /* Texto claro */
    --bcc-green: #27ae60;        /* Verde (positivo) */
    --bcc-red: #e74c3c;          /* Rojo (negativo) */
}

Cache

El cache se almacena por 1 hora por defecto. Para cambiarlo, edita includes/class-api-client.php:

private $cache_duration = 3600; // Cambia el valor en segundos

Para limpiar el cache manualmente:

delete_transient('tasa_cambio_bcc_cache');

📱 Responsive Design

El plugin es completamente responsive con breakpoints en:

  • Desktop: > 768px
  • Tablet: 481px - 768px
  • Móvil: < 480px
  • Móvil pequeño: < 320px

🔄 API del Banco Central

El plugin consume la API oficial del Banco Central de Cuba:

Endpoint: https://api.bc.gob.cu/v1/tasas-de-cambio/historico

Parámetros:

  • fechaInicio: Fecha inicio (YYYY-MM-DD)
  • fechaFin: Fecha fin (YYYY-MM-DD)
  • codigoMoneda: Código ISO de la moneda (USD, EUR, etc.)

Ejemplo de respuesta:

[
    {
        "fecha": "2026-01-13",
        "tasaOficial": 24,
        "tasaPublica": 120,
        "tasaEspecial": 413
    }
]

🛠️ Desarrollo

Estructura de Archivos

tasa-cambio-bcc/
├── tasa-cambio-bcc.php          # Archivo principal
├── README.md                     # Documentación
├── assets/
│   ├── css/
│   │   └── styles.css           # Estilos
│   └── js/
│       └── script.js            # JavaScript
└── includes/
    ├── class-api-client.php     # Cliente API
    ├── class-widget.php         # Widget WordPress
    └── shortcodes.php           # Shortcodes

Funciones AJAX

El plugin registra una acción AJAX para actualizar tasas:

// JavaScript
jQuery.ajax({
    url: tasaCambioBCC.ajax_url,
    type: 'POST',
    data: {
        action: 'tasa_cambio_bcc_get_rates',
        nonce: tasaCambioBCC.nonce,
        segmento: 'tasaEspecial'
    }
});

⚠️ Requisitos

  • WordPress 5.0 o superior
  • PHP 7.0 o superior
  • Conexión a Internet (para acceder a la API del BCC)

🐛 Solución de Problemas

Las tasas no se cargan

  1. Verifica que el sitio tenga acceso a https://api.bc.gob.cu
  2. Revisa los permisos de caché de WordPress
  3. Desactiva y reactiva el plugin para limpiar caché

Error de estilos

  1. Verifica que los archivos CSS estén en assets/css/styles.css
  2. Limpia la caché del navegador
  3. Verifica que no haya conflictos con otros plugins

Widget no aparece

  1. Asegúrate de que el plugin esté activado
  2. Verifica que el tema soporte widgets
  3. Revisa la consola del navegador para errores JavaScript

📝 Changelog

Versión 1.0.0

  • Lanzamiento inicial
  • Widget para sidebar
  • Banner horizontal
  • Vista completa con tabs
  • Sistema de caché
  • Diseño responsive
  • 13 monedas soportadas
  • 3 segmentos de tasas

👨‍💻 Autor

Yoenis Pantoja

📄 Licencia

Este plugin está licenciado bajo GPL v2 o posterior.

🤝 Contribuir

¿Quieres contribuir al proyecto? ¡Genial! Aquí te explicamos cómo:

  1. Fork el repositorio
  2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
  3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
  4. Push a la rama (git push origin feature/AmazingFeature)
  5. Abre un Pull Request

Reportar Bugs

Si encuentras un bug, por favor abre un issue con:

  • Descripción detallada del problema
  • Pasos para reproducirlo
  • Versión de WordPress y PHP
  • Screenshots si es posible

Sugerir Mejoras

Las sugerencias son bienvenidas. Abre un issue con la etiqueta enhancement describiendo tu idea.

📞 Soporte

Para soporte, abre un issue en: https://github.com/yoenispantoja/tasa-cambio-bcc/issues

Última actualización: Enero 2026