Solucionar problemas de la traducción asistida por IA
Los problemas de traducción se dividen en tres grupos: la herramienta no está disponible, un elemento falló o el resultado es incorrecto. Cada uno tiene una primera pregunta distinta.
La herramienta no está disponible
No aparece la entrada AI translate en Languages.
La herramienta solo se registra cuando Polylang o Polylang Pro está activo. Sin uno de ellos no se carga en absoluto, incluso si AI translations está marcado en Settings → POM AI → AI Tools.
Comprueba, por orden:
- Polylang o Polylang Pro está activo.
- La herramienta está habilitada en AI Tools.
- Tu usuario puede editar entradas.
No aparecen los botones Translate to … en la pantalla de edición.
Misma causa, más una adicional: los botones aparecen por idioma, por lo que un sitio con un solo idioma configurado no tiene ninguno que mostrar.
La pantalla existe pero no muestra idiomas.
Polylang no tiene idiomas configurados. Configúralos primero en Polylang.
No se pudo traducir un elemento
La pantalla por lotes informa de los fallos en línea en el resumen y continúa con el resto de la selección. Lee el resumen en lugar de fiarte de la barra de progreso.
| Patrón del mensaje | Significado | Acción |
|---|---|---|
| Marked as not translatable | Polylang no trata ese tipo de contenido o taxonomía como traducible | Habilítalo en los ajustes de Polylang |
| Translation already exists | El elemento ya tiene una traducción en el idioma de destino | Nada; la pantalla por lotes los omite a propósito |
| Invalid term o invalid post | El elemento desapareció o no se puede leer | Vuelve a ejecutar Analyze elements y selecciona de nuevo |
| Empty translation response | El servicio no devolvió nada utilizable | Reintenta ese único elemento |
| Un error de créditos | Se alcanzó el saldo o un límite de dominio | Consulta Resolver un error de créditos insuficientes |
| Un error de licencia o de dominio | Falló la autorización | Consulta Solucionar errores de licencia y de dominio |
La ejecución se detuvo a mitad de camino. La pantalla controla la ejecución desde el navegador, por lo que cerrar la pestaña o salir de la página la finaliza. Los elementos ya traducidos siguen traducidos y siguen facturados. Vuelve a analizar y selecciona el resto: los elementos completados ya no ofrecen casilla de verificación.
Todo falló de inmediato. Eso casi siempre es licencia, créditos o conectividad, no traducción. Comprueba que el saldo de créditos se cargue en Settings → POM AI → License.
La traducción existe pero es incorrecta
Algunas etiquetas siguen en el idioma de origen.
Normalmente se trata de un atributo del maquetador que no está declarado como traducible, por lo que nunca se extrae. Nada en POM AI puede cambiarlo; corrígelo a mano y avisa a tus revisores para que lo esperen. Consulta Conservar el formato, los shortcodes y los enlaces.
El extracto no está traducido.
Es lo esperado. Los extractos se copian, no se traducen. Tradúcelos a mano.
Se tradujeron nombres de productos o marcas.
No hay ninguna función de glosario. Mencionar los términos fijos en la descripción breve del negocio ayuda; una pasada de revisión es lo que realmente los detecta. Consulta Proporcionar contexto y terminología.
El idioma es correcto, pero la variedad no.
La región procede de la configuración regional del sitio y de la definición de idioma de Polylang: es_ES y es_MX son distintas. Corrige la configuración regional en lugar del texto.
Los enlaces apuntan al idioma de origen.
Los enlaces solo se reescriben cuando el destino ya tiene una traducción. Traduce los destinos antes que las páginas que enlazan a ellos, o vuelve a comprobar los enlaces después.
Se rompió el diseño.
El texto traducido suele ser más largo que el original. Comprueba las secciones de altura fija, los botones y la navegación en el front-end, no en el editor.
Una traducción sobrescribió correcciones manuales.
El botón Translate to … de cada entrada sobrescribe una traducción existente. La pantalla por lotes no lo hace: no ofrece casilla de verificación para los elementos ya traducidos. Usa la pantalla por lotes cuando existan correcciones.
No ocurre nada cuando inicio una ejecución
- Confirma que al menos una casilla de verificación esté marcada; la herramienta avisa si no hay ninguna.
- Confirma que el saldo de créditos se cargue.
- Comprueba si un plugin de seguridad está bloqueando
admin-ajax.php, lo que detendría tanto el análisis como la ejecución. - Comprueba que el servidor pueda realizar peticiones HTTPS salientes.
Falta algo después de traducir
La entrada traducida no está enlazada con la original. Comprueba las columnas de idioma de Polylang. Si falta el enlace, la traducción probablemente se creó fuera de este flujo de trabajo.
Una página hija no está bajo un padre traducido. El padre no tenía traducción cuando se procesó la hija. Traduce el padre y vuelve a comprobar. Seleccionar padres e hijos juntos en una sola ejecución lo gestiona automáticamente, porque los elementos se procesan con los padres primero.
Faltan términos en la entrada traducida. Los términos se traducen como parte de la ejecución de la entrada. Si un término falló, su entrada conserva los términos que sí se completaron. Traduce los términos como su propio lote y vuelve a comprobar.
Antes de contactar con el soporte
Recopila:
- la URL del sitio y la versión de POM AI;
- Polylang o Polylang Pro, y su versión;
- el par de idiomas;
- si usaste la pantalla por lotes o el botón de cada entrada;
- el mensaje exacto del resumen, copiado y no parafraseado;
- el tipo de elemento y el ID que falló;
- si falla de forma constante para un elemento o aleatoriamente entre muchos.
No envíes nunca la clave de licencia. Consulta Actualizaciones, soporte y mantenimiento seguro.