Gemini Translate & Currency Pro (Manual Edition)
Plugin traductor de idioma y moneda ligero para WordPress. No crea duplicados usa solo API Google
by Gemini AI · github.com/angelfuerza/plugin-traductor-de-idioma-y-moneda-ligero-para-wordpress
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/angelfuerza/plugin-traductor-de-idioma-y-moneda-ligero-para-wordpress/archive/refs/heads/main.zip🚩 Gemini Translate & Currency Pro
Gemini Translate & Currency Pro es una solución ligera y de alto rendimiento para sitios de WordPress y WooCommerce que necesitan ofrecer una experiencia bilingüe (Español/Inglés) con conversión de divisas en tiempo real (EUR a USD).
A diferencia de otros plugins pesados, este utiliza la infraestructura de Google Translate combinada con un motor de conversión de moneda ultra rápido basado en JavaScript.
✨ Características Principales
- Traducción Instantánea: Alterna entre Español e Inglés sin recargar la página completamente.
- Conversor de Divisas Real-Time: Obtiene automáticamente la tasa de cambio EUR/USD cada 12 horas mediante API y convierte todos los precios de WooCommerce.
- Diseño "Stealth" (Invisible): Elimina por completo el banner superior intrusivo de Google Translate y los espacios en blanco en el encabezado.
- Persistencia de Selección: Gracias a
localStorage, el plugin recuerda el idioma y la moneda elegida por el usuario mientras navega por toda la web. - Banderas SVG Ultra-Ligeras: Iconos vectoriales integrados en el código para evitar peticiones HTTP adicionales y pérdida de calidad.
- Compatible con Bloques Modernos: Optimizado para el Editor del Sitio (FSE) y los nuevos bloques de productos de WooCommerce.
🚀 Instalación
- Descarga el repositorio o crea un archivo llamado
traductor-divisas.php. - Comprime el archivo en un
.zip. - Ve a tu panel de WordPress > Plugins > Añadir nuevo > Subir plugin.
- Activa el plugin.
🛠️ Configuración y Uso
Este plugin funciona exclusivamente mediante Shortcode para ofrecerte control total sobre el diseño.
Uso del Shortcode
Copia y pega el siguiente código en cualquier parte de tu web (Entradas, Páginas, Widgets o Pie de página):
[switch_idioma]
Integración en Menús de Navegación (FSE)
Para temas modernos (como Twenty Twenty-Four):
- Ve al Editor del Sitio > Cabecera.
- Selecciona tu bloque de Navegación.
- Añade un bloque hijo de tipo HTML Personalizado.
- Inserta el shortcode:
[switch_idioma].
📊 Especificaciones Técnicas
| Característica | Tecnología |
|---|---|
| Lenguajes | PHP 7.4+, JavaScript (ES6+), CSS3 |
| API de Divisa | Exchange Rate API |
| Traducción | Google Translate Element API |
| Manejo de DOM | MutationObserver (para contenido dinámico/AJAX) |
| Almacenamiento | WP Transients (Server) / LocalStorage (Client) |
🛡️ Solución de Problemas (FAQ)
¿Por qué no se traducen los precios nuevos al filtrar productos?
El plugin incluye un MutationObserver que vigila cambios en el DOM. Si usas un sistema de filtrado muy agresivo, asegúrate de limpiar la caché de tu plugin de optimización (WP Rocket, LiteSpeed, etc.).
¿Cómo cambio la tasa de cambio manualmente?
El plugin utiliza una tasa automática. Si deseas forzar una, puedes editar la función gtc_get_rate_v7 en el archivo principal.
📄 Licencia
Este proyecto está bajo la Licencia MIT. Siéntete libre de usarlo, modificarlo y distribuirlo.
Desarrollado con ❤️ para mejorar la accesibilidad global de los e-commerce.