TradAI-WP

Soporte y Manual de Usuario - Guía de uso

TradAI-WP es un plugin avanzado de traducción automática para WordPress que permite traducir el contenido de tu sitio web en tiempo real sin modificar el código original. Se integra con las API de OpenAI, DeepSeek o Google Gemini para ofrecer traducciones de alta calidad. Por defecto y de manera gratuita, si no se especifica una API personalizada, TradAI-WP utiliza Google Gemini para realizar las traducciones, con un consumo límite máximo de 100,000 tokens, garantizando una traducción precisa y contextualizada.

Este documento servirá como guía para la instalación, configuración y uso de TradAI-WP.

---

Instalación

Requisitos

• Tener un sitio web en WordPress.
• Acceso de administrador para instalar plugins.
• Una clave API de OpenAI o DeepSeek (opcional para usar una API personalizada).
• PHP 7.4 o superior.

Instalación desde el Repositorio de WordPress

1. Accede a tu panel de WordPress y ve a Plugins > Añadir nuevo.
2. En el buscador, escribe TradAI-WP y presiona Enter.
3. Localiza TradAI-WP en los resultados y haz clic en Instalar ahora.
4. Una vez instalado, haz clic en Activar.

Instalación Manual

1. Descarga el plugin TradAI-WP desde nuestro sitio oficial en horizonsia.com/tradai-wp.
2. Accede a tu panel de WordPress y ve a Plugins > Añadir nuevo.
3. Haz clic en Subir plugin y selecciona el archivo ZIP de TradAI-WP.
4. Haz clic en Instalar ahora y luego en Activar.

---

Configuración Inicial

Para acceder a la configuración de TradAI-WP, ve a TradAI-WP > Ajustes en el panel de administración de WordPress o accede a la opción Ajustes en Plugins > Plugins instalados > TradAI-WP.

Activación de Licencia

TradAI-WP requiere una licencia para su funcionamiento. Existen cuatro tipos de licencias disponibles, adaptadas a diferentes necesidades:

• Licencia Gratuita: Uso sin coste, con una limitación de 10 páginas traducidas, incluyendo cada idioma seleccionado y almacenado en caché. No permite la generación de páginas HTML para SEO.
• Licencia Mensual: Acceso sin restricciones durante un mes, permitiendo traducciones ilimitadas y generación de HTML para SEO.
• Licencia Anual: Acceso completo sin restricciones por un año.
• Licencia Ilimitada: Acceso sin restricciones de forma indefinida.

Activación de la Licencia Gratuita

1. Haz clic en "Activar licencia".
2. Completa los datos solicitados en el formulario.
3. Una vez validada, el sistema activará la versión gratuita del plugin.

Si deseas obtener una licencia sin restricciones, visita la página del plugin en horizonsia.com/tradai-wp para adquirir la que mejor se adapte a tus necesidades.

Ingreso de una Licencia de Pago

1. Dirígete a la pestaña Licencia dentro de la configuración del plugin.
2. Introduce la clave de licencia que recibiste al comprar el plugin en el campo correspondiente.
3. Haz clic en Guardar para validar la licencia.
4. Una vez validada, el sistema desbloqueará todas las funciones avanzadas según el tipo de licencia adquirida.

---

Configuración de la API

TradAI-WP permite la conexión con algunas de las IAs más reconocidas del mercado, como OpenAI, DeepSeek, Anthropic y Google. Para ello, se utilizan APIs que facilitan la comunicación con estos servicios de modelos de lenguaje (LLMs).

Por defecto, si no configuras ninguna API personalizada, TradAI-WP empleará Google Gemini, utilizando el modelo 'gemini-2.0-flash-lite-preview-02-05', hasta un consumo máximo de 100,000 tokens, lo que equivale aproximadamente a 70,000 palabras (entrada + salida).

Si deseas eliminar este límite de uso o prefieres utilizar otro servicio API, puedes configurar los parámetros de conexión a una API personalizada en la pestaña API de la página de configuración:

• Selecciona el proveedor del servicio en el desplegable Servidor.
• En la pestaña API, introduce la URL del punto de acceso (endpoint) y la clave API (API KEY).
• Configura los encabezados y parámetros de la solicitud. Si no conoces estos datos, puedes dejarlos en blanco.
• Para más información, consulta la documentación del proveedor de la API.
• Especifica el modelo de LLM que deseas utilizar. Es importante ingresar el nombre del modelo exactamente como lo denomina el proveedor de la API.
• Haz clic en Guardar configuración para aplicar los cambios.

Una vez configurada la API personalizada, TradAI-WP utilizará este servicio para gestionar las traducciones, brindándote mayor control sobre la tecnología empleada.

Configuración de Idiomas

TradAI-WP admite la traducción a una amplia variedad de idiomas y dialectos locales. La cantidad de idiomas disponibles y la calidad de las traducciones dependen del modelo de IA (LLM) que se utilice. Por ejemplo, con el modelo GPT-4o de OpenAI, es posible traducir hasta 103 idiomas diferentes.

Para configurar los idiomas en los que deseas que se muestre tu sitio web, sigue estos pasos:

1. Accede a la pestaña General en la configuración de TradAI-WP.
2. En la lista de Idiomas disponibles, selecciona los idiomas a los que deseas que se traduzca tu sitio web, incluyendo el idioma original del contenido. Puedes añadir los idiomas uno por uno siguiendo el orden en el que deseas que aparezcan en el menú de selección o seleccionar varios a la vez:
• Mayúsculas (Shift): Para seleccionar un rango de idiomas consecutivos.
• Ctrl (Windows) / Cmd (Mac): Para seleccionar idiomas individuales sin seguir un orden.
3. Una vez seleccionados los idiomas, haz clic en Añadir>> para trasladarlos a la lista de Idiomas seleccionados.
4. Define el idioma por defecto, que corresponde al idioma original en el que está escrito el contenido del sitio.
5. Puedes personalizar la forma en que aparecerán los idiomas en el menú de selección, estableciendo abreviaturas o nombres personalizados en el campo Texto visualizable.
6. Haz clic en Guardar cambios para aplicar la configuración.

Etiquetas y Atributos a Traducir

En la pestaña Tags & Attrs, puedes definir qué etiquetas y atributos HTML deben considerarse para la traducción y cuáles deben excluirse. Esto permite adaptar TradAI-WP a las necesidades específicas de tu sitio web.

• Etiquetas traducibles: Lista de etiquetas HTML cuyo contenido textual será traducido. El sistema traducirá los textos ubicados entre la etiqueta de apertura y cierre (por ejemplo,<div>Texto a traducir</div>).
• Atributos traducibles: Algunos atributos dentro de las etiquetas también pueden requerir traducción. Por ejemplo, en el siguiente caso, tanto el texto dentro de la etiqueta como el valor del atributo title deben traducirse:
<a> href='home.html' title='Página de inicio'>Inicio</a>
• Para especificar qué atributos deben traducirse en cada etiqueta, introdúcelos separados por comas en la columna Atributos y asócialos a la Etiqueta correspondiente.
• Tratamiento especial para atributos complejos: Algunos atributos requieren reglas específicas, como la etiqueta . En este caso, se define en formato JSON qué atributo debe comprobarse (name="description") y cuál debe traducirse (content="texto a traducir").
• Excepciones: Lista de etiquetas y atributos que no deben ser traducidos. Si una etiqueta contiene un atributo excluyente, su contenido no será traducido. Por ejemplo:
  <div data-no-translate>Este texto no será traducido</div>
  En este caso, el atributo data-no-translate evita que el contenido de la etiqueta <div> sea traducido.

Personalización de la Interfaz

Puedes modificar diversos aspectos del selector de idiomas que aparecerá en tu sitio web para adaptarlo a su diseño y funcionalidad. Este selector permitirá a los usuarios cambiar de idioma con facilidad.

• Estilos personalizables: Ajusta colores, tipografía, tamaños y bordes del selector.
• Ubicación en pantalla: Define la posición del selector en la pantalla para evitar que se superponga con otros elementos importantes del sitio.
• Configuración específica para móviles: Dado que los dispositivos móviles tienen menos espacio en pantalla, TradAI-WP permite establecer una posición diferente para ellos, asegurando una mejor usabilidad.

Después de realizar cualquier modificación en la configuración del selector, recuerda hacer clic en Guardar cambios para aplicarlos correctamente.

---

Uso de TradAI-WP

Traducción Automática del Sitio

TradAI-WP detecta automáticamente los textos en el sitio web y los traduce de acuerdo con la configuración establecida. La primera vez que se accede a una página definida para ser traducida, TradAI-WP se conectará con la API de traducción configurada y solicitará la traducción de los textos identificados según las etiquetas y atributos marcados como traducibles.

Este proceso puede tardar algunos segundos, dependiendo de factores como la cantidad de texto en la página, la velocidad de conexión a la red y el modelo de IA utilizado. Para evitar demoras cuando los visitantes accedan a la versión traducida de la página, se recomienda realizar una primera carga manual en cada idioma deseado. Una vez que la traducción se haya generado, la página quedará almacenada en caché, lo que permitirá que futuras visitas en ese idioma se carguen a la velocidad normal.

Si deseas almacenar en caché múltiples páginas de manera simultánea sin acceder manualmente a cada una, puedes hacerlo desde la pestaña Caché en la página de Ajustes del plugin.

Traducción de Imágenes

TradAI-WP permite sustituir automáticamente imágenes en función del idioma seleccionado. Esto es útil cuando las imágenes contienen textos o elementos gráficos específicos para cada idioma.

Por ejemplo, si tu sitio web tiene un logotipo con un eslogan en español, puedes configurar una versión alternativa en inglés, francés u otros idiomas para que se muestre la imagen correspondiente en cada caso.

Pasos para configurar la traducción de imágenes:

• Accede a la pestaña Imágenes en los Ajustes de TradAI-WP.
• Selecciona un idioma del menú desplegable.
• Especifica las URLs alternativas para cada imagen, reemplazando la imagen original con su versión traducida.
• Guarda los cambios para que TradAI-WP aplique las imágenes correspondientes según el idioma seleccionado.

Este método garantiza que los visitantes vean la imagen adecuada en su idioma sin afectar la estructura del sitio. Guarda los cambios para que TradAI-WP use las versiones traducidas.

Generación de Caché

Desde la pestaña Caché, puedes gestionar y optimizar las traducciones almacenadas, asegurando tiempos de carga rápidos y versiones traducidas listas para su uso.

Beneficios de la caché de traducción:

• Permite servir versiones pretraducidas de las páginas sin esperar la respuesta de la API.
• Reduce la carga en el servidor y mejora la velocidad de respuesta.
• Facilita la indexación de versiones traducidas en los motores de búsqueda.

Cómo generar la caché:

• Accede a la pestaña Caché en los Ajustes de TradAI-WP.
• Selecciona los idiomas y páginas a cachear. A la derecha de cada página o entrada de blog, aparecerán las iniciales de los idiomas ya traducidos y cacheados.
• Para crear páginas HTML traducidas indexables por motores de búsqueda, marca la casilla Generar página para SEO antes de generar la caché.
• Haz clic en Generar Caché. Si seleccionas muchas páginas e idiomas a la vez, el proceso puede demorar más tiempo. Se recomienda generar la caché por grupos pequeños para comprobar los resultados progresivamente.

La versión gratuita de TradAI-WP tiene un límite de 10 archivos de caché simultáneos.

La licencia gratuita tiene un límite de 10 archivos de caché.

Corrección y Revisión de Traducciones

Una vez generadas las traducciones de cada una de las páginas de tu sitio, es recomendable revisarlas para corregir cualquier imprecisión que pudiera haber en el contenido traducido.

Si bien la mayoría de las traducciones son precisas, factores como la complejidad del texto, tecnicismos o particularidades idiomáticas pueden afectar la calidad de la traducción. Para garantizar la mejor experiencia para tus visitantes, TradAI-WP permite editar manualmente las traducciones.

Pasos para revisar y corregir traducciones:

• Accede a la pestaña Traducciones en los Ajustes de TradAI-WP.
• Selecciona la página que deseas revisar.
• Elige el idioma que quieres comprobar.
• Se mostrarán los textos originales junto con sus traducciones. Puedes editar cualquier texto en la columna correspondiente al idioma de traducción.
• Una vez finalizadas las correcciones, haz clic en Guardar Cambios para aplicar las modificaciones.

Ten en cuenta que las páginas HTML para SEO no se actualizarán automáticamente con las nuevas correcciones. Para reflejar los cambios en estas páginas, deberás regenerarlas en la pestaña Caché.

---

Resolución de Problemas

Errores Comunes y Soluciones

• No aparecen Idiomas Disponibles en la pestaña Caché: Es posible que no hayas añadido ningún idioma a la lista de Idiomas seleccionados. Accede a la pestaña General en los Ajustes, selecciona los idiomas que deseas en la lista de Idiomas disponibles y pulsa en Añadir para trasladarlos a la lista de Idiomas seleccionados. Finalmente, haz clic en Guardar Idiomas Seleccionados para registrar los cambios.
• Las traducciones no se aplican: Verifica que la API esté correctamente configurada y activa. Si estás utilizando una API personalizada, revisa que la clave de acceso sea válida y que no haya restricciones en tu cuenta.
• Algunas partes del sitio no se traducen: Asegúrate de que las etiquetas y atributos correctos estén configurados en la pestaña Tags & Attrs. Algunos elementos del sitio pueden estar excluidos por configuración o debido a atributos como data-no-translate.
• Problemas con la licencia: Confirma que la clave de licencia sea válida y esté activada. Si tu licencia está introducida correctamente, debería aparecer en la cabecera de la página de configuración el mensaje "Licencia válida hasta el XX/XX/XXXX" o "Licencia gratuita válida hasta el XX/XX/XXXX".
• Mensaje: "Has alcanzado el límite de XX páginas traducidas": Si has excedido el límite de páginas traducibles con la versión gratuita de TradAI-WP, aparecerá un mensaje en la página de Ajustes informándote de esta restricción. Para continuar usando la extensión sin restricciones, puedes:
• Eliminar archivos antiguos para liberar espacio y continuar traduciendo nuevas páginas.
• Actualizar a una licencia sin límites, lo que te permitirá traducir un número ilimitado de páginas sin restricciones.
• Mensaje: "Has alcanzado el límite de créditos establecidos": Si superas el máximo de tokens gratuitos disponibles sin una API Key propia, TradAI-WP dejará de realizar nuevas traducciones. Los modelos de IA utilizados para la traducción tienen un coste asociado, por lo que si superas el uso gratuito, deberás configurar tu propia API Key para continuar traduciendo sin limitaciones.

Si el problema persiste o tienes dudas adicionales, consulta nuestro soporte técnico para obtener asistencia personalizada.

---

Soporte

Para consultas adicionales, visita nuestro chat de soporte o contacta a nuestro equipo técnico.