Documentación completa de WP-Translate
De la primera instalación a la referencia técnica: todas las funciones explicadas, paso a paso, en una sola página con índice para saltar a lo que buscas.
Qué es WP-Translate
WP-Translate convierte tu WordPress en un sitio multilingüe sin salir del frontend. Abres tu propia página en el idioma que quieras, haces clic sobre el texto que necesitas cambiar y lo editas mirando el diseño real, de modo que una traducción nunca rompe un botón ni un titular.
No necesitas cuenta, ni clave de API, ni registro: se instala y funciona. Un motor de traducción gratuito integrado traduce desde el primer minuto, y puedes conectar tu propia clave de DeepL, Google, Gemini o Yandex cuando quieras.
Traducción visual en tu propia web, con el contexto delante.
Cada idioma publicado en su propia URL, indexable por Google.
Todo se guarda en tu base de datos: al visitante se le sirve HTML normal, sin llamadas a ninguna API.
Instalación y activación
Instálalo como cualquier otro plugin de WordPress: sube el archivo ZIP desde Plugins → Añadir nuevo → Subir plugin, o copia la carpeta en /wp-content/plugins/. Después actívalo desde el menú de Plugins.
Requisitos: WordPress 6.1 o superior y PHP 8.0 o superior.
No hace falta tocar la base de datos: al activarse crea sus propias tablas automáticamente.
Si actualizas de una versión anterior, las tablas nuevas se crean solas en la primera carga tras el update.
El motor gratuito no requiere ninguna configuración. Puedes traducir tu primer idioma sin crear ninguna cuenta ni introducir ninguna clave de API.
El asistente de configuración
La primera vez que activas el plugin aparece un asistente guiado que te deja listo para traducir en cuatro pasos. Es la forma más rápida de dejar el sitio configurado sin recorrer todos los ajustes a mano.
Los cuatro pasos
1. Bienvenida. Un resumen de lo que vas a conseguir.
2. Idioma de origen. Confirmas en qué idioma está escrito tu sitio ahora mismo.
3. Primer idioma adicional. Eliges el idioma al que quieres traducir; se crea con su prefijo de URL.
4. Motor de traducción. Te quedas con el motor gratuito o pegas tu clave de DeepL/Google/Gemini/Yandex, y se lanza el primer escaneo del sitio.
Puedes volver a abrirlo cuando quieras desde el enlace «Asistente» de la fila del plugin, en la pantalla de Plugins. No borra nada de lo ya configurado.
Añadir tu primer idioma
En WP-Translate → Idiomas defines el idioma principal (el que ya tiene tu sitio) y añades los idiomas de destino. Cada idioma adicional se publica bajo su propio prefijo de URL —por ejemplo /en/ o /fr/— con sus etiquetas hreflang recíprocas.
El idioma principal marca desde qué texto se traduce todo lo demás.
Cada idioma de destino tiene su código, su bandera y su prefijo de URL.
Puedes activar o desactivar un idioma sin perder lo que ya se tradujo en él.
La versión gratuita publica tu idioma principal más un idioma adicional. Con licencia, los idiomas son ilimitados.
Editor visual en el frontend
Es el corazón del plugin. Abres cualquier página de tu sitio en el idioma que estás traduciendo y entras en modo edición desde la barra de herramientas. A partir de ahí, cada texto de la página es clicable: titulares, botones, menús, textos de imagen. Al hacer clic, un panel lateral te sugiere la traducción automática y tú la ajustas.
Traduces mirando el diseño final: ves al momento si un texto largo descuadra un botón.
El panel propone la traducción del motor y te deja corregirla antes de guardar.
Cambias de idioma desde la propia barra para revisar cómo queda cada versión.
El acceso al editor está en la barra de administración de WordPress cuando visitas tu web habiendo iniciado sesión. Solo lo ven los usuarios con permiso para editar el sitio.
Escaneo del sitio completo
En lugar de ir página por página, el escaneo extrae de una sola vez todas las cadenas traducibles de tus entradas y páginas y las deja listas en el gestor de cadenas. Así puedes traducirlas en bloque sin tener que abrir cada una en el editor visual.
Detecta el texto real de cada contenido, incluido el que generan los constructores.
Es idempotente: volver a escanear no duplica cadenas ya registradas.
Deja todo el trabajo pendiente reunido en un único sitio para traducir por lotes.
El escaneo del sitio entero es una función de la versión con licencia. En la versión gratuita traduces con el editor visual y con la traducción por lotes de lo ya detectado.
Traducción por lotes
Con un clic envías a traducir todas las cadenas pendientes. La cola trabaja en tandas, retoma donde se quedó si se interrumpe y nunca traduce dos veces la misma cadena, porque consulta antes la memoria de traducción.
Procesa por tandas para no saturar el servidor ni el motor.
Se reanuda sola: si cierras la pestaña, al volver sigue por donde iba.
Muestra el avance real y cuántas cadenas quedan por idioma.
La versión gratuita traduce en tandas de 10 cadenas; con licencia, la traducción por lotes es completa.
Gestor de cadenas
El gestor de cadenas es la lista central de todo el texto de tu sitio y de su estado de traducción en cada idioma. Desde aquí filtras, buscas y decides qué se traduce y cómo.
Estados de una traducción
| Estado | Qué significa |
|---|---|
| Pendiente | La cadena existe pero aún no tiene traducción en ese idioma. |
| Automática | Traducida por el motor, todavía sin revisar por una persona. |
| Manual | Escrita o corregida a mano. La traducción automática nunca la pisa. |
| Revisada | Marcada como comprobada y definitiva. |
Cuando una traducción es manual o revisada, ningún proceso automático la sobrescribe. Es la forma de «fijar» un texto —por ejemplo, el nombre de tu marca— para que una traducción por lotes no lo cambie.
Memoria de traducción
Cada cadena traducida se guarda en tu propia base de datos. Si la misma frase aparece en doscientas páginas, el motor se llama una sola vez y las otras ciento noventa y nueve reutilizan esa traducción.
Ahorra llamadas al motor y, por tanto, coste y tiempo.
Mantiene la coherencia: la misma frase se traduce igual en todo el sitio.
Es tuya: si algún día quitas el plugin, puedes exportar tus traducciones antes.
Motores de traducción
Eliges el motor en Ajustes → Proveedor de traducción. El motor gratuito funciona sin ninguna clave; los de pago usan tu propia clave de API y facturas directamente al proveedor.
| Motor | Clave | Notas |
|---|---|---|
| Gratuito (por defecto) | No | Traduce sin configuración. Usa el endpoint público de Google y, como respaldo, MyMemory. |
| Google Cloud Translation | Tu clave | Calidad y cuota de Google Cloud, facturada a tu cuenta. |
| DeepL | Tu clave | Muy buena calidad en idiomas europeos. |
| Google Gemini | Tu clave | Traducción con IA; procesa varias cadenas por llamada. |
| Yandex Translate | Tu clave | Alternativa con buena cobertura de idiomas. |
Se envía una petición únicamente cuando tú traduces activamente una cadena o lanzas un lote, y contiene solo el texto a traducir y el código del idioma. Mientras un visitante ve páginas ya traducidas, no se contacta ningún servicio externo.
Cambiar de motor sin perder nada
Puedes cambiar de motor en cualquier momento sin perder lo ya traducido. El texto que ya está en tu base de datos se conserva; el motor nuevo solo se usa para las traducciones que pidas a partir de ese momento.
Empieza con el motor gratuito y pasa a DeepL o Gemini cuando quieras más calidad.
Lo ya traducido se queda tal cual; solo lo nuevo usa el motor nuevo.
Puedes retraducir una cadena concreta a mano si quieres rehacerla con el motor nuevo.
URLs por idioma
Cada idioma adicional se publica bajo su propio prefijo de URL. La versión traducida no es un parámetro ni una capa encima: es una dirección real que Google puede rastrear e indexar como una página independiente.
Estructura limpia por prefijo: tusitio.com/en/…, tusitio.com/fr/….
El idioma principal se queda en la raíz, sin prefijo.
Los slugs pueden traducirse para que la URL también esté en el idioma de destino.
hreflang, canonical y sitemap
Para que Google entienda que cada URL es la versión de la misma página en otro idioma, el plugin añade automáticamente las señales que exige el buscador.
Etiquetas hreflang recíprocas entre todas las versiones de idioma de cada página.
Canonical auto-referente en cada idioma, para que no se marquen como contenido duplicado.
Sitemap por idioma, para que el buscador descubra todas las versiones (función con licencia).
Sí. Al publicarse bajo su propia URL, con hreflang recíproco y canonical propio, cada idioma es indexable de forma independiente.
Selector de idioma (switcher)
El selector permite al visitante cambiar de idioma. Está disponible en cuatro formas, para que encaje en cualquier sitio sin tocar código.
| Forma de insertarlo | Dónde se usa |
|---|---|
Shortcode | En cualquier contenido, página o texto. |
| Widget del tema | En barras laterales y zonas de widgets clásicas. |
| Ítem de menú | Como una entrada más de tus menús de navegación. |
| Widget de Elementor | Arrastrándolo en el editor de Elementor. |
Varios estilos: desplegable, lista, banderas o en línea.
Muestra bandera y nombre, o solo bandera, según lo que prefieras.
Compatibilidad
WP-Translate funciona con lo que ya tienes montado, sin plantillas especiales ni configuraciones frágiles.
Cualquier tema. No depende del tema para detectar ni servir las traducciones.
Elementor y Elementor Pro. Lee los diseños desde su propio formato interno, así que no se escapa ni el texto de los widgets de Elementor Pro.
WooCommerce. Cubre los textos de productos y de páginas de la tienda.
Plugins de caché habituales. Como cada idioma se sirve como HTML normal, convive con el cacheado.
Con licencia, el plugin también puede traducir los correos salientes (avisos de WordPress y de WooCommerce) al idioma del destinatario.
Panel de ajustes
Todo lo que no es traducir texto se controla desde WP-Translate → Ajustes: el motor activo y su clave, el comportamiento del selector, y opciones avanzadas como traducir al guardar.
Proveedor de traducción y clave de API (si usas un motor de pago).
Traducir al guardar: cuando editas una entrada, sus cambios se traducen automáticamente (función con licencia).
Meta título y descripción traducidos para el SEO de cada idioma (función con licencia).
Qué incluye cada versión
La versión gratuita es totalmente funcional para un sitio con un idioma adicional. La licencia levanta los límites y añade las funciones de escala. Nunca se limita lo esencial: el editor visual, el selector, las URLs por idioma, el hreflang, el canonical y servir lo ya traducido funcionan siempre.
| Función | Free | Con licencia |
|---|---|---|
| Idiomas adicionales | 1 | Ilimitados |
| Motor | Google gratuito | Gemini, DeepL, Google y Yandex |
| Cuota automática | 500 cadenas/mes | Sin tope |
| Traducción por lotes | Tandas de 10 | Completa |
| Escanear el sitio entero | — | Sí |
| Traducir al guardar | — | Sí |
| Meta título y descripción traducidos | — | Sí |
| Sitemap por idioma | — | Sí |
| Correos de WordPress y WooCommerce | — | Sí |
Un sitio que deje de tener licencia sigue funcionando y no pierde idiomas: solo deja de tener acceso a las funciones de pago. Lo ya traducido se sigue sirviendo.
Licencia y actualizaciones
La licencia es de por vida (pago único, sin renovación). Lo que define cada plan es el número de sitios en los que puedes activarla, no un tiempo de caducidad.
Pegas la clave en la pantalla de licencia y se abren las funciones de pago, sin reinstalar ni perder traducciones.
Las actualizaciones del plugin llegan a tu escritorio de WordPress como las de cualquier otro plugin.
Puedes liberar un sitio para mover la licencia a otra instalación dentro de tu límite de sitios.
Referencia técnica
Para perfiles más técnicos, estos son los puntos de integración que el plugin expone a nivel de uso. No hace falta tocar código para usar el plugin; esta sección es solo para quien quiera integrarlo con precisión.
Shortcodes
| Shortcode | Para qué |
|---|---|
| Inserta el selector de idioma en cualquier contenido. |
Widget de Elementor
El selector de idioma está disponible como widget nativo de Elementor: se arrastra al diseño y se configura su estilo (desplegable, lista, banderas o en línea) desde el propio editor.
API REST
El plugin registra sus operaciones bajo un espacio de nombres propio de la API REST de WordPress (wptm/v1). Las rutas están protegidas por los permisos de administración de WordPress: solo un usuario autorizado puede lanzar escaneos o traducciones. El detalle interno de cada ruta forma parte del funcionamiento del plugin y no es necesario para usarlo.
Dónde se guarda todo
Todas las traducciones viven en tablas propias dentro de tu base de datos de WordPress, no en un servicio externo. Esto es lo que hace que servir un idioma no dependa de ninguna API y que las traducciones sean tuyas.
Las traducciones y su estado (automática, manual, revisada) se guardan por cadena y por idioma.
La memoria de traducción evita volver a llamar al motor para una frase repetida.
Al desinstalar, el plugin te pregunta si quieres conservar o borrar sus tablas.
La lógica interna —cómo detecta las cadenas, cómo reescribe las URLs o cómo firma las peticiones— forma parte del producto y no se documenta aquí. Esta guía cubre todo lo que necesitas para usarlo y sacarle partido.
Resolución de problemas
Las dudas más habituales, resueltas.
¿Listo para traducir tu sitio?
Instala WP-Translate y ten tu primer idioma publicado en minutos. Sin clave para empezar.