Guia de uso
Todo lo necesario para instalar, configurar y usar Traductor WP con DeepL, incluyendo cuenta gratuita de DeepL API, configuracion del selector, cache y actualizacion manual de traducciones.
Resumen rapido
Frontend multilenguaje
Selector flotante
Shortcode
Cache persistente
URLs limpias
DeepL API
Este plugin traduce el contenido visible del frontend sin duplicar paginas y sin depender de un constructor especifico.
1. Requisitos
- WordPress 6.0 o superior.
- PHP 8.3x.
- Una cuenta de DeepL API.
- Una clave API valida de DeepL.
2. Instalacion del plugin
- Entra a WordPress como administrador.
- Ve a
Plugins > Anadir nuevo.
- Sube el archivo ZIP del plugin.
- Activa Traductor WP con DeepL.
- Abre el menu lateral Traductor WP con DeepL.
3. Cuenta gratuita de DeepL API
- Crea una cuenta en DeepL API.
- Elige el plan gratuito para empezar sin costo.
- Entra a la seccion
API Keys o API Keys & Limits.
- Crea una clave nueva.
- Pega esa clave en el campo API Key de DeepL dentro del plugin.
Nota: las claves Free suelen terminar en :fx y el plugin detecta automaticamente si debe usar endpoint Free o Pro.
4. Configuracion general
API Key de DeepL
Pega la clave API creada en tu cuenta de DeepL.
Idioma origen
Idioma original del sitio, por ejemplo ES.
Idiomas disponibles
Agrega un idioma por linea en formato CODIGO|Etiqueta.
EN|English
FR|Francais
PT-BR|Portugues Brasil
Idioma por defecto
Idioma inicial cuando no hay idioma en la URL ni preferencia previa del visitante.
Recordar ultimo idioma
Si se activa, el plugin guarda la ultima eleccion del visitante en una cookie.
Selector del contenido
Para traducir toda la pagina, usa body.
5. Selector de idioma
- Modo de insercion: flotante, shortcode o ambos.
- Shortcode:
[jdt_language_switcher]
- Contenido del boton: texto, banderitas o ambos.
- Estilo: pildoras, minimal desplegable o burbuja con banderas.
- Posicion del flotante: abajo derecha, abajo izquierda, arriba derecha o arriba izquierda.
- CSS personalizado: para colores, tamanos, bordes y separaciones.
6. URLs limpias
El plugin genera URLs limpias por idioma.
- Espanol:
/
- Ingles:
/EN
- Paginas internas:
/pagina/ y /pagina/EN
7. Cache y actualizacion de traducciones
El plugin guarda traducciones para reutilizarlas y no depender de DeepL en cada carga.
- Los textos ya traducidos pueden servirse desde cache.
- Si cambias textos del sitio, puedes usar Forzar actualizacion de traducciones.
- Si DeepL no esta disponible, las traducciones ya guardadas pueden seguir funcionando.
8. Diagnostico y estado
Dentro del plugin puedes revisar:
- Estado de la API
- Endpoint detectado
- Modo y preset del selector
- Posicion configurada
- Idioma por defecto
- Cantidad de traducciones persistentes guardadas
9. Configuracion recomendada
- Idioma origen:
ES
- Idioma por defecto:
ES
- Recordar ultimo idioma: desactivado si quieres que siempre inicie en espanol
- Selector del contenido:
body
- Modo de insercion: flotante o ambos
10. Solucion de problemas
El sitio carga en otro idioma
Revisa Idioma por defecto y Recordar ultimo idioma.
La posicion del flotante no cambia
Guarda cambios, limpia cache del sitio y del navegador, y confirma que no exista CSS personalizado moviendo el selector.
Cambie textos y no se actualizan
Usa el boton Forzar actualizacion de traducciones.
El selector no aparece
Confirma que el plugin este activo, que haya API configurada y que existan al menos 2 idiomas definidos.