Añadir idioma a PrestaShop: Guía para Plesk y cPanel

¿Por qué necesitas un PrestaShop multidioma?

Si tu tienda online vende productos o servicios a clientes de diferentes países, ofrecer tu sitio en varios idiomas no es un lujo, es una necesidad. Un cliente que lee la ficha de un producto en su idioma nativo tiene muchas más probabilidades de comprar que uno que tiene que traducir mentalmente cada frase. Además, Google premia a las webs multidioma con mejor posicionamiento en las búsquedas locales de cada región.

Añadir un nuevo idioma a tu PrestaShop no es un proceso complejo, pero requiere que sigas los pasos en el orden correcto. En este artículo, te guiaré a través de todo el proceso, tanto si tu hosting utiliza Plesk como si utiliza cPanel. Son los dos paneles de control más comunes en el mercado y, aunque la interfaz cambia, el objetivo final es el mismo: tener tu tienda funcionando en varios idiomas sin romper nada por el camino.

Vamos a ello. No necesitas ser un experto en programación, solo tener paciencia y seguir las instrucciones al pie de la letra.

Antes de empezar: ¿Qué necesitas?

Para añadir un idioma a tu PrestaShop, vas a necesitar dos cosas fundamentales:

Acceso a tu panel de administración de PrestaShop (la parte privada de tu tienda, normalmente en /admin o una URL personalizada).
Acceso a tu panel de control del hosting (Plesk o cPanel) para poder subir los archivos de traducción y, en algunos casos, modificar la base de datos.

También es recomendable que hagas una copia de seguridad completa de tu tienda antes de empezar. Esto incluye tanto los archivos como la base de datos. Si algo sale mal, podrás restaurar todo en minutos. No te saltes este paso, por favor.

Paso 1: Descargar el paquete de idioma de PrestaShop

PrestaShop no viene con todos los idiomas instalados por defecto. Debes descargar el paquete de idioma que te interese. La forma más sencilla de hacerlo es desde el propio administrador de tu tienda.

Desde el administrador de tu tienda

Ve a International > Localization en el menú lateral izquierdo.
En la pestaña Languages, verás una lista con los idiomas que ya están instalados.
Haz clic en el botón Add new language (Añadir nuevo idioma) que encontrarás en la parte superior derecha.
Se abrirá un formulario. En el campo Language code, escribe el código del idioma que quieres añadir (por ejemplo, en para inglés, fr para francés o de para alemán).
PrestaShop intentará descargar automáticamente el paquete de traducción desde su servidor. Si lo consigue, verás un mensaje de éxito. Si no, tendrás que descargarlo manualmente (te explico cómo en el siguiente punto).

[INFO] Si el código de idioma que introduces no es válido, PrestaShop te dará un error. Asegúrate de usar los códigos ISO 639-1 (dos letras) como es, en, fr, etc.

Descarga manual desde el sitio de PrestaShop

Si la descarga automática falla (a veces por problemas de permisos en el servidor), tendrás que hacerlo manualmente.

Ve a la página de descargas de PrestaShop (busca "PrestaShop language packs" en tu navegador).
Busca el idioma que necesitas y descarga el archivo .gzip o .zip correspondiente a tu versión de PrestaShop (por ejemplo, 1.7 u 8.x).
Guarda el archivo en tu ordenador. No lo descomprimas todavía, lo necesitamos comprimido para el siguiente paso.

Paso 2: Subir el idioma a tu servidor (Plesk y cPanel)

Una vez que tienes el paquete de idioma descargado (o si la descarga automática falló), necesitas subirlo a tu servidor. Aquí es donde entran en juego Plesk y cPanel.

Si tu hosting usa Plesk

Plesk tiene una estructura de carpetas muy clara. Para subir el archivo de idioma:

Accede a tu panel de Plesk. Normalmente es algo como https://tudominio.com:8443.
En el menú lateral, busca la sección Archivos o File Manager.
Navega hasta la carpeta raíz de tu tienda. Normalmente es /httpdocs o /public_html. Busca la carpeta /app y dentro de ella, la carpeta /Resources. Luego, entra en /translations.
Una vez dentro de /translations, verás carpetas con códigos de idioma (como es, en, fr). Sube tu archivo de idioma comprimido (.gzip o .zip) directamente a esta carpeta. No lo descomprimas aquí.
Ahora, vuelve a tu administrador de PrestaShop (International > Localization > Languages) y haz clic en Add new language. Introduce el código del idioma y PrestaShop detectará el archivo que has subido y lo instalará automáticamente.

[TIP] Si no ves la carpeta /translations, activa la opción "Mostrar archivos ocultos" en el administrador de archivos de Plesk.

Si tu hosting usa cPanel

En cPanel, el proceso es muy similar pero con una interfaz diferente.

Accede a tu panel de cPanel (normalmente en https://tudominio.com:2083).
Busca la herramienta Administrador de archivos (File Manager).
Navega hasta la carpeta raíz de tu tienda, que suele ser public_html. Si tu tienda está en una subcarpeta (como public_html/tienda), navega hasta esa carpeta.
Al igual que en Plesk, busca la ruta /app/Resources/translations.
Sube el archivo de idioma comprimido a esa carpeta.
Ve a tu administrador de PrestaShop y repite el proceso de Add new language para que PrestaShop lo instale.

[WARNING] Es muy importante que subas el archivo a la carpeta correcta. Si lo subes a otro sitio, PrestaShop no lo encontrará y te dará un error de "Paquete de idioma no encontrado".

Paso 3: Activar el idioma en PrestaShop

Una vez que el paquete de idioma se ha instalado correctamente, ya puedes activarlo para que tus clientes lo vean.

En tu administrador de PrestaShop, ve a International > Localization.
En la pestaña Languages, busca el idioma que acabas de instalar.
Asegúrate de que el interruptor de Activo (o el icono de la "X" o la "V") esté en verde o en "Sí".
Haz clic en el icono del ojo o en Editar para configurar detalles como la bandera, el código ISO o si es el idioma por defecto.

[INFO] El idioma por defecto es el que verán los visitantes que no tengan configurado un idioma en su navegador. Puedes tener varios idiomas activos, pero solo uno puede ser el predeterminado.

Paso 4: Configurar el selector de idiomas en tu tienda

Ahora que tienes el idioma instalado y activo, necesitas que tus clientes puedan cambiar de idioma fácilmente. PrestaShop incluye un bloque de selector de idiomas, pero a veces está desactivado o no aparece en el tema que usas.

Ve a Improve > Design > Positions (o Diseño > Posiciones).
Busca el hook llamado DisplayNav o DisplayTop. Estos son los lugares habituales donde se muestra el selector de idiomas.
Si no ves el módulo Language selector (o "Selector de idiomas") en esos hooks, tendrás que trasladarlo.
Haz clic en el botón Transplant a module (Trasplantar un módulo).
Selecciona el módulo "Language selector" en el desplegable.
En "Transplant to", elige el hook DisplayNav o DisplayTop y guarda.

[TIP] Si usas un tema de pago, es posible que el selector de idiomas ya esté integrado en el diseño. En ese caso, no necesitas hacer nada más.

Paso 5: Traducir el contenido de tu tienda

Instalar el idioma es solo la mitad del trabajo. La otra mitad es traducir el contenido de tu tienda: productos, categorías, páginas de texto, etc. PrestaShop no traduce tu contenido automáticamente, solo traduce la interfaz (botones, menús, mensajes del sistema).

Para traducir tu contenido:

Ve a International > Translations.
Verás varias opciones: Modify translations (Modificar traducciones), Add / Update a language (Añadir/Actualizar un idioma), etc.
Haz clic en Modify translations.
En Type of content, elige "Products" (Productos) o "Categories" (Categorías) según lo que quieras traducir.
En Language, selecciona el idioma al que quieres traducir (por ejemplo, "English").
Se abrirá un editor con todos los campos de texto de tus productos. Traduce cada campo y guarda los cambios.

[WARNING] Traducir productos uno a uno puede ser muy tedioso si tienes cientos de artículos. Considera usar módulos de traducción automática (como los que se integran con Google Translate o DeepL) para agilizar el proceso, pero revisa siempre las traducciones porque suelen tener errores de contexto.

Paso 6: Configurar la URL para cada idioma (SEO)

Para que Google indexe correctamente tus páginas en diferentes idiomas, es recomendable que cada idioma tenga su propia URL. PrestaShop te permite hacerlo de dos maneras:

Por subdirectorio: tudominio.com/en/, tudominio.com/fr/.
Por dominio: en.tudominio.com, fr.tudominio.com (más complejo de configurar).

La opción más común es la de subdirectorios. Para configurarla:

Ve a International > Localization > Languages.
Haz clic en Editar en el idioma que quieras configurar.
En el campo URL pattern, escribe el prefijo que quieras usar (por ejemplo, en para inglés).
Guarda los cambios.

[INFO] Si ya tenías la tienda funcionando en un solo idioma, cambiar la estructura de URL puede afectar a tu SEO temporalmente. Asegúrate de configurar las redirecciones 301 desde las URLs antiguas a las nuevas para no perder posicionamiento.

Resolución de problemas comunes

A veces, el proceso no sale a la primera. Aquí tienes los problemas más habituales y sus soluciones:

"El paquete de idioma no se encuentra"

Esto suele ocurrir cuando el archivo no se ha subido a la carpeta correcta. Revisa que esté en /app/Resources/translations y que el nombre del archivo coincida con el código de idioma que estás intentando instalar.

"El idioma aparece pero no se ve en la tienda"

Esto suele ser un problema de caché. Ve a Improve > Performance y limpia la caché (botón "Clear cache"). También puedes forzar la compilación de las plantillas en Advanced Parameters > Performance y activar la opción "Force compile".

"No puedo subir el archivo al servidor"

Si el Administrador de archivos de cPanel o Plesk te da error, prueba a subir el archivo por FTP usando un cliente como FileZilla. Asegúrate de tener permisos de escritura en la carpeta /translations (suele ser 755 o 775).

Preguntas frecuentes (FAQ)

¿Puedo añadir varios idiomas a la vez?

Sí, puedes instalar todos los idiomas que quieras. Solo tienes que repetir el proceso de instalación y activación para cada uno. Ten en cuenta que cuantos más idiomas tengas, más trabajo de traducción de contenido tendrás.

¿Necesito una base de datos diferente para cada idioma?

No. PrestaShop guarda las traducciones en la misma base de datos, pero en tablas separadas por idioma. Es transparente para el usuario.

¿Afecta al rendimiento de mi tienda tener varios idiomas?

Ligeramente. Cada idioma añade consultas a la base de datos. Si tu tienda tiene mucho tráfico, es recomendable usar un sistema de caché (como Memcached o Redis) para mitigar el impacto.

¿Qué pasa con HestiaCP (Syspanel)?

Si tu hosting utiliza Syspanel (anteriormente conocido como HestiaCP), el proceso es prácticamente igual al de cPanel. Accede a tu panel a través del puerto 2106 (por ejemplo, https://tudominio.com:2106), busca el Administrador de archivos y sigue los mismos pasos que te he indicado para cPanel. La estructura de carpetas es la misma (public_html).

Conclusión

Añadir un nuevo idioma a tu PrestaShop es un proceso muy gratificante que te abrirá las puertas a nuevos mercados. Recuerda que la clave está en hacerlo paso a paso y no tener miedo a experimentar. Si sigues esta guía, tendrás tu tienda multidioma funcionando en menos de una hora.

Y si te atascas en algún punto, no dudes en consultar la documentación oficial de PrestaShop o preguntar en los foros de la comunidad. ¡Buena suerte con tu tienda multidioma!