FAQ PrestaShop en Plesk | Errores comunes y soluciones

Introducción: ¿Por qué surgen errores en PrestaShop dentro de Plesk?

Si tienes una tienda online con PrestaShop alojada en un servidor con panel Plesk, es posible que de vez en cuando te encuentres con algún error inesperado. No te preocupes, es algo normal. Plesk es un panel de control muy potente y popular, pero a veces la configuración del servidor o pequeños detalles en los archivos de PrestaShop pueden generar conflictos. Este artículo es tu guía de preguntas frecuentes (FAQ) para resolver los errores más comunes que aparecen al usar PrestaShop en Plesk.

Vamos a resolver dudas como: ¿Por qué no se conecta a la base de datos? ¿Qué hago si la página carga en blanco? ¿Cómo soluciono el error de las URLs amigables? Todo explicado paso a paso, como si estuvieras hablando con un técnico de soporte amigable.

## 1. Error de conexión a la base de datos: "Cannot connect to database"

Este es uno de los problemas más frecuentes. Sueles verlo al instalar PrestaShop o al intentar acceder a tu tienda después de un tiempo. El mensaje puede variar, pero la causa casi siempre es la misma: los datos de acceso a la base de datos no son correctos.

### ¿Por qué ocurre?

Contraseña o usuario incorrectos: Al cambiar la contraseña de MySQL desde Plesk, olvidas actualizar el archivo de configuración de PrestaShop.
Nombre de la base de datos mal escrito: Puede tener un prefijo añadido por Plesk (ej: tuusuario_nombrebd).
El servidor MySQL no está funcionando: Aunque es raro, puede pasar.

### Solución paso a paso:

Accede a Plesk: Inicia sesión en tu panel de control. Normalmente es algo como https://tudominio.com:8443 o la URL que te haya dado tu proveedor.
Ve a "Bases de datos": Busca la sección de "Bases de datos" o "MySQL".
Verifica los datos: Anota el nombre exacto de la base de datos, el usuario y la contraseña (puedes cambiarla desde aquí si no la recuerdas).
Localiza el archivo parameters.php: Este archivo está en la carpeta raíz de tu PrestaShop, dentro de app/config/parameters.php. Puedes acceder a él por FTP o desde el "Administrador de archivos" de Plesk.

Edita el archivo: Busca estas líneas y asegúrate de que coinciden con los datos de Plesk:

'database_host' => 'localhost',
'database_name' => 'TU_NOMBRE_BD',
'database_user' => 'TU_USUARIO_BD',
'database_password' => 'TU_CONTRASEÑA_BD',

Guarda los cambios y recarga tu tienda.

[TIP] Si cambiaste la contraseña en Plesk, debes actualizarla también en este archivo. Es un error muy común.

## 2. Página en blanco o "Error 500 Internal Server Error"

Ver una página completamente en blanco (también llamado "White Screen of Death") es desesperante. Generalmente significa que PHP está teniendo un error fatal, pero el servidor tiene oculta la visualización de errores.

### ¿Por qué ocurre?

Módulo incompatible: Instalaste un módulo de pago o envío que no es compatible con tu versión de PrestaShop.
Límite de memoria de PHP excedido: Tu tienda necesita más memoria de la que el servidor le permite.
Error en el archivo .htaccess: Algo mal escrito en este archivo de configuración de Apache.

### Solución paso a paso:

Activa la visualización de errores (temporal): Accede al archivo config/defines.inc.php en la raíz de PrestaShop. Busca la línea:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
Importante: Esto mostrará los errores en pantalla. Una vez resuelto el problema, vuelve a poner false.
Aumenta el límite de memoria PHP: Desde Plesk, ve a "Hosting & DNS" > "Configuración de PHP". Busca la opción memory_limit y cámbiala a un valor más alto, por ejemplo 256M o 512M.
Revisa el archivo .htaccess: Si el error persiste, renombra temporalmente el archivo .htaccess de la raíz de PrestaShop a .htaccess_old. Si la página funciona, el problema está ahí. Luego, desde el panel de administración de PrestaShop, ve a "Configuración de la tienda" > "Tráfico y SEO" y haz clic en "Guardar" para regenerarlo.

[WARNING] No dejes el modo desarrollo (_PS_MODE_DEV_) activado en una tienda en producción, ya que expone información sensible.

## 3. Error con las URLs amigables (SEO URLs)

Las URLs amigables son clave para el SEO. Si al activarlas te sale un error 404 o la página no carga, es un problema típico de PrestaShop en Plesk.

### ¿Por qué ocurre?

Falta el módulo mod_rewrite de Apache: Aunque Plesk suele tenerlo activado, a veces no está habilitado para tu dominio.
El archivo .htaccess no se ha generado correctamente.
Problemas con el archivo index.php en subcarpetas.

### Solución paso a paso:

Verifica que mod_rewrite está activo: En Plesk, ve a "Hosting & DNS" > "Configuración de Apache y nginx" (puede variar según la versión). Asegúrate de que la opción "mod_rewrite" esté marcada.
Regenera el .htaccess: Accede al panel de administración de PrestaShop (ej: tudominio.com/admin1234). Ve a "Configuración de la tienda" > "Tráfico y SEO". En la sección "URLs amigables", desmarca y vuelve a marcar la opción, y luego haz clic en "Guardar".
Verifica los permisos de archivos: Asegúrate de que la carpeta raíz de PrestaShop tenga permisos 755 y los archivos 644. Esto lo puedes hacer desde el "Administrador de archivos" de Plesk.

[INFO] Si usas nginx como servidor web, las URLs amigables se configuran de forma diferente. Plesk a menudo usa Apache como proxy inverso, pero si es nginx puro, necesitarás editar la configuración de nginx manualmente.

## 4. Errores al instalar o actualizar módulos

A veces, al instalar un módulo desde el marketplace de PrestaShop o al subir un archivo ZIP, te aparece un error como "No se puede extraer el archivo" o "El módulo no es válido".

### ¿Por qué ocurre?

Límite de tamaño de subida de PHP: El archivo ZIP del módulo es demasiado grande.
Permisos de carpetas incorrectos: La carpeta modules no tiene permisos de escritura.
Versión incompatible: El módulo es para una versión de PrestaShop diferente a la tuya.

### Solución paso a paso:

Aumenta el límite de subida (upload_max_filesize): En Plesk, ve a "Configuración de PHP" y busca upload_max_filesize. Cámbialo a 64M o 128M. También aumenta post_max_size al mismo valor.
Verifica permisos de la carpeta modules: Usando el "Administrador de archivos" de Plesk, navega a la carpeta modules de PrestaShop. Asegúrate de que tenga permisos 755 (o 777 temporalmente para la instalación, pero luego vuelve a 755).
Instala manualmente: Si el error persiste, descomprime el módulo en tu ordenador y sube la carpeta completa por FTP a tudominio.com/modules/. Luego, desde el back office, ve a "Módulos" > "Gestor de módulos" y busca el módulo en la lista para instalarlo.

## 5. Problemas con el correo electrónico (no se envían emails)

Tu tienda no envía correos de confirmación de pedido ni de recuperación de contraseña. Esto es crítico para las ventas.

### ¿Por qué ocurre?

Configuración SMTP incorrecta en PrestaShop.
El servidor bloquea el puerto 25 (SMTP).
Falta la extensión PHP mail() o está deshabilitada.

### Solución paso a paso:

Configura SMTP en PrestaShop: Ve a "Configuración de la tienda" > "Contacto" > "Correo electrónico". Cambia la opción "Usar la función mail() de PHP" a "Establecer mis propios parámetros SMTP". Introduce los datos de tu servidor de correo (puede ser el mismo de tu dominio o Gmail, etc.).
Prueba con una cuenta de Gmail: Si no tienes un servidor SMTP, puedes usar los de Gmail:
- Servidor: smtp.gmail.com
- Puerto: 587
- Protocolo: TLS
- Autenticación: Sí
- Usuario: tucorreo@gmail.com
- Contraseña: tucontraseña (si tienes verificación en dos pasos, genera una contraseña de aplicación).
Verifica desde Plesk: En Plesk, ve a "Correo" y asegúrate de que la cuenta de correo de tu dominio esté activa y funcionando.

[TIP] Si usas servicios de correo transaccional como SendGrid o Mailgun, es más fiable que el correo del propio hosting.

## 6. El catálogo no se muestra o hay imágenes rotas

Las imágenes de tus productos no cargan, o ves el temido "alt" en lugar de la foto.

### ¿Por qué ocurre?

Permisos incorrectos en la carpeta img o upload.
La regeneración de imágenes falló tras una actualización.
Problemas con el caché de imágenes.

### Solución paso a paso:

Reconstruye el caché de imágenes: Desde el back office de PrestaShop, ve a "Configuración de la tienda" > "Imágenes" y haz clic en "Regenerar miniaturas". Esto puede tardar unos minutos.
Verifica permisos: Asegúrate de que las carpetas img y upload tengan permisos 755 o 777 temporalmente.
Limpia la caché de PrestaShop: Ve a "Configuración avanzada" > "Rendimiento" y limpia la caché (tanto de Smarty como de CSS/JS).

## 7. Preguntas frecuentes adicionales (FAQ rápida)

### ¿Cómo accedo a phpMyAdmin desde Plesk?

En Plesk, ve a "Bases de datos", selecciona tu base de datos y haz clic en el icono de "phpMyAdmin". Se abrirá una ventana para gestionar las tablas.

### ¿Cómo hago una copia de seguridad de mi PrestaShop?

Plesk tiene una herramienta integrada. Ve a "Herramientas y utilidades" > "Administrador de copias de seguridad". Puedes programar copias diarias o semanales. También es recomendable hacer una copia manual antes de cualquier actualización importante.

### ¿Por qué mi tienda está lenta?

Activa la caché de PrestaShop (en "Rendimiento").
Optimiza las imágenes (usa formatos WebP).
Verifica si tienes muchos módulos innecesarios activados.
Contacta a tu hosting para que revisen los recursos del servidor.

### ¿Qué hago si olvido la contraseña del administrador de PrestaShop?

Puedes cambiarla desde phpMyAdmin. Busca la tabla ps_employee (el prefijo ps_ puede variar). Localiza tu usuario y edita el campo passwd. Usa una función MD5 para generar la nueva contraseña (por ejemplo: MD5('tunuevaclave')). Luego, en el campo passwd, pega el hash generado.

[WARNING] No compartas nunca tu contraseña de administrador ni de la base de datos. Usa contraseñas seguras.

## Conclusión: Resolver errores en PrestaShop con Plesk es más fácil de lo que parece

Como has visto, la mayoría de los errores comunes de PrestaShop en Plesk tienen soluciones simples, como revisar permisos, actualizar datos de conexión o limpiar la caché. La clave está en mantener un registro de los cambios que haces y en no perder la calma. Con esta guía de PrestaShop Plesk FAQ ya tienes las herramientas para solucionar los problemas más habituales.

Recuerda que si el error persiste, siempre puedes contactar con el soporte técnico de tu hosting. Diles exactamente qué error ves y qué pasos has seguido. ¡Esto les ahorrará tiempo y te ayudará a ti más rápido!

Esperamos que este artículo de solución problemas PrestaShop te haya sido de gran ayuda. Si tienes más dudas, no dudes en consultar nuestra sección de ayuda o escribirnos. ¡Buena suerte con tu tienda online!