¿Cómo agrego ConveyThis a Joomla?

Integrar ConveyThis en tu sitio es rápido y sencillo, y Joomla no es una excepción. En unos minutos instalarás la extensión de ConveyThis, la conectarás a tu cuenta gratuita de ConveyThis y publicarás tu primer idioma traducido, sin escribir código.

Requisitos: Joomla 4, 5 o 6 y PHP 8.1 o posterior. Joomla 3 no es compatible.

1) Instala la extensión de ConveyThis

En el administrador de Joomla, ve a System → Install → Extensions y abre la pestaña Install from Web . Escribe ConveyThis en el campo de búsqueda y haz clic en el resultado de ConveyThis.

Joomla Install from Web tab with ConveyThis in the search results

Haz clic en Instalar, luego confirma en la siguiente pantalla.

ConveyThis extension page in Joomla with the Install button

Cuando Joomla muestre Installation of the package was successful, la extensión estará lista.

Joomla message: Installation of the package was successful

¿Prefieres subir el archivo tú mismo? Descarga conveythis.zip y arrástralo a la pestaña Upload Package File de la misma página.

2) Abre ConveyThis en Joomla

Ve a Components → ConveyThis.

Joomla Components menu with ConveyThis

La primera vez que lo abras, ConveyThis mostrará una breve configuración: crea una cuenta, pega tu clave API y confirma tus idiomas.

ConveyThis setup screen in Joomla with the Get an API key button

3) Crea tu cuenta gratuita de ConveyThis

Haz clic en Get an API key. La página de registro de ConveyThis se abre en una nueva pestaña. Crea tu cuenta (no se requiere tarjeta de crédito) y confirma tu dirección de correo electrónico.

ConveyThis sign-up page

Luego sigue la breve configuración: selecciona Joomla como tecnología de tu sitio web si se te pide, confirma tu dominio, elige el idioma en el que está escrito tu sitio y los idiomas que quieres añadir. Tu clave API aparece en el panel cuando termina la configuración. Tiene este aspecto: pub_xxxxxxxxxxxxxxxx.

4) Pega tu clave API y empieza a traducir

Vuelve a la pestaña de Joomla, pega la clave API y haz clic en Check this key. ConveyThis completa los idiomas que elegiste en tu cuenta, así que no tienes que elegirlos dos veces. Haz clic en Save and start translating.

ConveyThis setup in Joomla: API key checked, languages confirmed, Save and start translating

Llegarás a la configuración de ConveyThis. Aquí puedes cambiar los idiomas en cualquier momento y personalizar el selector de idioma en Widget style.

ConveyThis main configuration in Joomla

5) Activa «URL Rewriting» en Global Configuration

Cada idioma tiene su propia URL, por ejemplo /es/about. Para que esas URL funcionen, ve a System → Global Configuration, y en la sección SEO cambia Use URL Rewriting → Sí, luego haz clic en Guardar. Sin este ajuste, las páginas traducidas pueden devolver un error 404.

Joomla Global Configuration, SEO section with Use URL Rewriting set to Yes

Dependiendo de tu hosting:

  • Apache y LiteSpeed: cambia el nombre de htaccess.txt → .htaccess en la carpeta raíz de Joomla.
  • IIS: cambia el nombre de web.config.txt → web.config.
  • NGINX: debes configurar tu servidor.
  • Otros servidores o si no estás seguro: consulta a tu proveedor de hosting.

¿Usas el Language Filter de Joomla? Desactívalo. El plugin Language Filter de Joomla usa los mismos prefijos de idioma en la URL (/es/), y ambos entrarán en conflicto. ConveyThis lo detecta y te ofrece desactivarlo.

6) ¡Listo!

Eso es todo. Abre tu sitio web: el selector de idioma aparece en la esquina inferior derecha. La primera vez puede tardar uno o dos minutos en aparecer.

Joomla website translated into Chinese with the ConveyThis language switcher open

Cambie el idioma y su sitio web será multilingüe. Para revisar o editar traducciones, haga clic Edit Translations en tu panel de control de ConveyThis y elija su sitio web o utilice el editor visual para editarlos directamente en sus páginas.

¡Felicitaciones, ahora puedes comenzar a traducir tu sitio web!