FAQ: Instalación de PrestaShop en Syspanel

Introducción: ¿Por qué una FAQ sobre PrestaShop en Syspanel?

Si estás leyendo esto, probablemente estés en medio de la instalación de tu tienda online con PrestaShop y estés usando Syspanel (nuestro panel de control basado en HestiaCP, accesible por el puerto 2106). Sabemos que montar un ecommerce puede ser abrumador, especialmente cuando surgen los primeros errores. Por eso hemos preparado esta FAQ PrestaShop con las preguntas más frecuentes que recibimos en soporte técnico.

Aquí encontrarás soluciones paso a paso para los errores comunes de instalación, configuración de base de datos, permisos de archivos y mucho más. Todo explicado como si estuviéramos al lado, sin tecnicismos raros.

## 1. Preguntas generales sobre PrestaShop Syspanel

### ¿Qué requisitos necesita mi hosting para PrestaShop?

Antes de instalar, asegúrate de que tu plan en Syspanel cumpla con estos requisitos mínimos:

PHP 7.4 o superior (recomendamos PHP 8.0+ para mejor rendimiento).
MySQL 5.6+ o MariaDB 10.1+.
Apache con mod_rewrite habilitado (por defecto en Syspanel).
Mínimo 256 MB de memoria PHP (lo ajustamos en el panel).

[INFO] En Syspanel, puedes verificar tu versión de PHP desde el menú "Ajustes de PHP" dentro del panel (puerto 2106).

### ¿Puedo instalar PrestaShop automáticamente con el instalador de Syspanel?

Sí, Syspanel incluye un instalador automático de aplicaciones. Busca la sección "Instalador de aplicaciones" en tu panel. Allí encontrarás PrestaShop listo para instalar con un par de clics. Solo necesitarás:

Elegir el dominio donde instalarlo.
Crear una base de datos (te ayudamos con eso).
Configurar el usuario administrador.

[TIP] Si usas el instalador automático, te ahorrarás los pasos manuales más tediosos. Pero si prefieres personalizar algo, la instalación manual también es sencilla.

## 2. Errores comunes durante la instalación

### Error: "No se puede conectar a la base de datos"

Este es uno de los errores comunes más frecuentes. Normalmente ocurre por datos incorrectos en el archivo app/config/parameters.php o en el paso de configuración de la instalación.

Solución paso a paso:

Ve a Syspanel (puerto 2106) y entra en "Base de datos".
Anota el nombre de la base de datos, el usuario y la contraseña exactos.
Durante la instalación de PrestaShop, asegúrate de escribir:
- Servidor de base de datos: localhost (a menos que te hayan indicado otro).
- Nombre de la base de datos: el que creaste en Syspanel.
- Usuario y contraseña: los mismos que en el panel.

[WARNING] No uses comillas ni espacios extra. Copia y pega directamente desde Syspanel para evitar errores tipográficos.

### Error: "El directorio no tiene permisos de escritura"

PrestaShop necesita permisos 755 en carpetas y 644 en archivos para funcionar correctamente. Si ves este error:

Conéctate a Syspanel y ve a "Administrador de archivos".
Navega hasta la carpeta donde instalaste PrestaShop (normalmente public_html).
Selecciona todas las carpetas y archivos.
Haz clic derecho > "Permisos" y establece:
- Carpetas: 755.
- Archivos: 644.

[TIP] Si usas FTP, también puedes hacerlo desde tu cliente. Pero desde el panel es más rápido.

### Error: "La versión de PHP no es compatible"

PrestaShop 1.7 requiere PHP 7.1 mínimo, y la versión 8.0 es la más recomendada. Si tu PHP es anterior:

En Syspanel, ve a "Ajustes de PHP".
Cambia la versión a 8.0 o 8.1 (según tu plan).
Guarda los cambios y espera unos segundos a que se apliquen.

[INFO] Si no ves la opción de cambiar versión, contacta con soporte para que lo habiliten.

## 3. Configuración post-instalación

### ¿Cómo activar el modo amigable (URLs limpias)?

Las URLs limpias mejoran el SEO de tu tienda. Para activarlas:

Accede al panel de administración de PrestaShop (ej: tudominio.com/admin).
Ve a Configurar > Parámetros de la tienda > Tráfico y SEO.
En la pestaña "SEO y URLs", marca la opción "Activar URLs amigables".
Haz clic en "Guardar".

[WARNING] Si ves un error 404 después de activarlo, ve a Syspanel > "Ajustes de Apache" y asegúrate de que mod_rewrite esté activo (lo está por defecto).

### ¿Cómo configurar el correo electrónico transaccional?

Para que tu tienda envíe correos (confirmaciones de pedido, recuperación de contraseñas, etc.):

En PrestaShop, ve a Configurar > Parámetros avanzados > Correo electrónico.
Elige "Usar servidor SMTP".
Introduce los datos de tu servidor SMTP (puedes usar el de Syspanel: servidor mail.tudominio.com, puerto 587, autenticación requerida).
Usa el mismo correo que creaste en Syspanel.

[TIP] Si no tienes un correo configurado, crea uno desde Syspanel > "Correo electrónico" > "Añadir cuenta".

## 4. Preguntas sobre rendimiento y seguridad

### ¿Cómo acelerar mi PrestaShop en Syspanel?

Algunos ajustes básicos que marcan la diferencia:

Activar la caché: En PrestaShop, ve a Configurar > Parámetros avanzados > Rendimiento. Activa la caché (recomendamos "Caché de archivos").
Comprimir CSS y JavaScript: En la misma sección, marca "Combinar y comprimir".
Usar CDN: Si tienes mucho tráfico, considera un CDN. Syspanel permite integrar Cloudflare fácilmente.

[INFO] También puedes aumentar la memoria PHP desde Syspanel > "Ajustes de PHP" > "memory_limit" a 256M o 512M.

### ¿Cómo proteger mi tienda contra ataques?

La seguridad es clave. Sigue estos pasos:

Cambia la URL de administración por defecto (en PrestaShop, en "Parámetros avanzados > Administración").
Activa el firewall desde Syspanel > "Seguridad" > "Firewall".
Usa contraseñas fuertes para el acceso a Syspanel y a PrestaShop.
Mantén todo actualizado: PrestaShop, módulos y el propio Syspanel.

[WARNING] No uses temas o módulos de fuentes no oficiales. Pueden contener malware.

## 5. Preguntas sobre migración y copias de seguridad

### ¿Cómo hacer una copia de seguridad de mi tienda?

Es vital antes de cualquier actualización. En Syspanel:

Ve a "Copias de seguridad".
Selecciona el dominio de tu tienda.
Marca "Incluir base de datos" y "Incluir archivos".
Haz clic en "Crear copia".

[TIP] Programa copias automáticas semanales desde la misma sección.

### ¿Puedo migrar mi PrestaShop desde otro hosting?

Sí, el proceso es sencillo:

Exporta tu base de datos desde el hosting anterior (usando phpMyAdmin).
Descarga todos los archivos de tu tienda (vía FTP o panel anterior).
Sube los archivos a la carpeta public_html de tu dominio en Syspanel.
Importa la base de datos desde Syspanel > "Base de datos" > "Importar".
Edita el archivo app/config/parameters.php con los nuevos datos de conexión (servidor, usuario, contraseña).

[WARNING] Si cambias de dominio, deberás actualizar también la URL en la tabla ps_configuration de la base de datos.

## 6. Solución de problemas avanzados

### Error 500 después de una actualización

Un error 500 suele deberse a incompatibilidad de módulos o PHP. Para solucionarlo:

Activa el modo debug de PrestaShop: edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ a true.
Así verás el error exacto. Normalmente es un módulo desactualizado.
Desactiva módulos desde la base de datos (consulta a soporte si no sabes cómo).
Vuelve a la versión anterior si tienes copia de seguridad.

[INFO] Siempre prueba las actualizaciones en un entorno de desarrollo primero.

### Problemas con la tienda en varios idiomas

Si añades idiomas y no se ven bien:

Ve a Internacional > Localización > Idiomas en PrestaShop.
Asegúrate de que el idioma esté activo y tenga su bandera.
Regenera las URLs amigables desde "Tráfico y SEO".
Limpia la caché de PrestaShop.

[TIP] Si los textos no se traducen, revisa que los módulos de idioma estén instalados.

## Conclusión: Resuelve tus dudas rápido

Esperamos que esta FAQ PrestaShop te haya ayudado a resolver los errores comunes que pueden surgir durante la instalación en Syspanel. Recuerda que siempre puedes contar con nuestro equipo de soporte técnico si algo no funciona como esperas.

[INFO] ¿Necesitas ayuda adicional? Abre un ticket desde Syspanel (puerto 2106) o escríbenos directamente. Estamos para ayudarte.

¡Buena suerte con tu tienda online!