Errores PrestaShop en WordPress Syspanel | Soluciones

Entendemos perfectamente la confusión. Has oído maravillas de PrestaShop para tu tienda online, pero también sabes que WordPress es ideal para tu blog o web corporativa. Y entonces, te encuentras con la opción de instalar PrestaShop dentro de WordPress, o quizás estás usando Syspanel (antes conocido como HestiaCP) y surgen los primeros tropiezos.

No te preocupes. Es un camino común, pero lleno de pequeñas trampas. En esta guía, vamos a desglosar los errores más frecuentes al intentar esta instalación, especialmente cuando gestionas tu servidor con Syspanel PrestaShop. Al final, sabrás exactamente qué evitar y cómo solucionarlo si ya te has topado con un muro.

Error #1: Confundir "Instalar en WordPress" con "Integrar" PrestaShop

Este es, con diferencia, el error conceptual más grande. No existe un plugin mágico que convierta WordPress en PrestaShop. Son dos sistemas completamente diferentes.

¿Qué significa realmente "instalar PrestaShop en WordPress"?

La mayoría de las veces, los usuarios quieren decir que quieren tener ambos sistemas en el mismo dominio o hosting, pero en carpetas separadas. Por ejemplo:

tudominio.com (WordPress para el blog)
tudominio.com/tienda (PrestaShop para el ecommerce)

El error común: Intentar instalar PrestaShop como si fuera un plugin de WordPress. Esto simplemente no funciona y genera errores de base de datos y de archivos.

[WARNING] No busques un plugin que convierta WordPress en PrestaShop. No existe una solución nativa y funcional. La única forma real es tener dos instalaciones separadas.

Cómo evitarlo en Syspanel:
Cuando entres a tu panel de control Syspanel (recuerda, accedes por el puerto 2106, por ejemplo: tudominio.com:2106), verás que puedes crear "Sitios Web". Cada sitio web puede tener múltiples "carpetas" o "subdominios". La estrategia correcta es:

Crear un sitio web para tu dominio principal (ej. tudominio.com).
Instalar WordPress en la raíz (carpeta public_html).
Crear una subcarpeta llamada tienda dentro de public_html.
Instalar PrestaShop en esa subcarpeta tienda.

Error #2: Ignorar los Requisitos de Servidor (PHP y Base de Datos)

Tanto WordPress como PrestaShop son exigentes, pero PrestaShop lo es mucho más. Un error típico es instalar PrestaShop en un servidor que apenas cumple con los requisitos mínimos de WordPress.

¿Qué suele fallar?

Versión de PHP: PrestaShop 8 necesita PHP 7.4 o superior (idealmente 8.0 o 8.1). Si tu Syspanel tiene PHP 7.2 por defecto, la instalación fallará o dará errores de compatibilidad.
Límite de memoria: PrestaShop consume mucha memoria PHP. Si el límite es muy bajo (por ejemplo, 64M), verás pantallas en blanco o errores 500.
Base de datos: Necesitas crear una base de datos y un usuario específico para PrestaShop. Usar la misma base de datos que WordPress es una pésima idea y causará conflictos.

[TIP] En Syspanel, puedes cambiar la versión de PHP para cada sitio web o incluso para cada carpeta. Ve a la configuración de tu sitio web y busca la opción "PHP". Asegúrate de seleccionar una versión igual o superior a 7.4.

Pasos para verificarlo en Syspanel:

Accede a tu Syspanel (puerto 2106).
Ve a la sección de tu dominio.
Busca "Avanzado" o "Configuración PHP".
Cambia la versión a "PHP 8.1" o "8.2".
Aumenta el memory_limit a al menos 256M o 512M. Esto se hace en el mismo lugar o editando el archivo php.ini.

Error #3: Olvidar Configurar el "Document Root" para la Subcarpeta

Este es un error muy técnico pero común. Cuando instalas PrestaShop en una subcarpeta (ej. /tienda), el servidor web (Nginx o Apache) debe saber que esa carpeta es un "punto de entrada" independiente.

El problema: Si no configuras bien el Document Root o las reglas de reescritura (rewrite rules), al intentar acceder a tudominio.com/tienda te dará un error 404 o te redirigirá a la raíz de WordPress.

[WARNING] Si usas Nginx como servidor web (es lo más común en Syspanel), las reglas de reescritura de WordPress y PrestaShop son diferentes. No puedes usar las mismas reglas para ambas.

Solución en Syspanel (para Nginx):

Dentro de la configuración de tu sitio web en Syspanel, busca la opción "Nginx" o "Reglas de reescritura".
Necesitas añadir un bloque especial para la carpeta /tienda.
El bloque debe decirle a Nginx que, para la ruta /tienda, use las reglas de PrestaShop. Un ejemplo básico sería:
```
location /tienda/ {
    try_files $uri $uri/ /tienda/index.php?$args;
}
```
Nota: Si no te sientes cómodo editando esto, muchos hosting con Syspanel tienen un botón "Agregar regla PrestaShop" o "WordPress". Selecciona la correcta para la subcarpeta.

Error #4: Conflictos de .htaccess y Archivos de Configuración

WordPress genera un archivo .htaccess en la raíz para sus enlaces permanentes. PrestaShop también genera su propio .htaccess dentro de su carpeta.

El error: Sobrescribir accidentalmente el .htaccess de la raíz con el de PrestaShop, o viceversa. Esto rompe la estructura de enlaces de uno de los dos sistemas.

Cómo evitarlo:

No toques el .htaccess de la raíz a menos que sepas exactamente lo que haces. Déjalo como lo generó WordPress.
El .htaccess de PrestaShop debe estar únicamente dentro de la carpeta /tienda. No lo copies a la raíz.
Si usas Nginx (recomendado), los .htaccess no se usan. En su lugar, las reglas se configuran en los archivos de configuración de Nginx, como vimos en el Error #3.

[INFO] Syspanel suele usar Nginx por defecto. Si ves un archivo .htaccess, es posible que tengas Apache como proxy o que estés en un plan de hosting compartido. En cualquier caso, respeta los archivos de cada sistema.

Error #5: No Configurar Correctamente las URLs de la Tienda

Después de instalar PrestaShop, te pedirá que configures la URL de la tienda. Aquí viene otro error clásico.

El error: Poner tudominio.com en lugar de tudominio.com/tienda.

Consecuencia: PrestaShop intentará cargar todos sus recursos (CSS, imágenes, JavaScript) desde la raíz del dominio, chocando con los de WordPress. Verás una tienda sin estilos, con imágenes rotas y un desastre visual.

Solución:
Durante la instalación de PrestaShop, cuando te pregunte por la URL de la tienda, asegúrate de que sea exactamente:
https://tudominio.com/tienda
(Sin barra al final, normalmente).

Si ya cometiste el error, puedes cambiarlo después desde el panel de administración de PrestaShop (Parámetros de la tienda > Tráfico y SEO > Configuración de la tienda), pero tendrás que vaciar la caché de PrestaShop y posiblemente regenerar el .htaccess de la carpeta /tienda.

Error #6: Problemas con los Permisos de Archivos y Carpetas

Tanto WordPress como PrestaShop necesitan escribir en ciertos archivos y carpetas (para subir imágenes, instalar módulos, etc.). Si los permisos no son los correctos, la instalación se detiene o la tienda no funciona.

El error común: Usar permisos demasiado restrictivos (como 644 para archivos y 755 para carpetas) que no permiten al servidor web escribir.

[TIP] En la mayoría de los servidores con Syspanel, los permisos correctos son:

Carpetas: 755
Archivos: 644

Sin embargo, durante la instalación, a veces necesitas permisos 777 temporalmente para ciertas carpetas como /config, /cache, /img, /modules, /themes.

Cómo hacerlo en Syspanel:

Usa el administrador de archivos de Syspanel (en la sección de tu dominio).
Navega a la carpeta de PrestaShop (public_html/tienda).
Selecciona las carpetas problemáticas y haz clic en "Permisos".
Pon 755 (o 777 solo temporalmente si un instalador lo pide explícitamente).
IMPORTANTE: Después de la instalación, vuelve a poner los permisos a 755 para evitar vulnerabilidades de seguridad.

Error #7: Olvidar los Ajustes de SSL y Cookies

Si tu dominio tiene SSL (HTTPS), y debería tenerlo, ambos sistemas deben funcionar bajo HTTPS.

El error: Tener WordPress funcionando con HTTPS, pero que PrestaShop intente cargar recursos con HTTP. Esto genera el famoso error de "contenido mixto" y el candado de seguridad se rompe.

Solución:

Asegúrate de que Syspanel tenga un certificado SSL activo para tu dominio (puedes usar Let's Encrypt desde el mismo panel).
Durante la instalación de PrestaShop, marca la opción "SSL activo" o "HTTPS".
En la configuración de PrestaShop, ve a Parámetros de la tienda > Tráfico y SEO y activa "Forzar SSL en todas las páginas".
Problema de cookies: A veces, las cookies de sesión de WordPress y PrestaShop pueden interferir. Para evitarlo, asegúrate de que el prefijo de las tablas de la base de datos de PrestaShop sea diferente al de WordPress (por ejemplo, ps_ para PrestaShop y wp_ para WordPress). Esto se configura al principio de la instalación.

FAQ Rápida: Preguntas Frecuentes

P: ¿Puedo usar el mismo usuario de base de datos para WordPress y PrestaShop?
R: Técnicamente sí, pero no es recomendable. Crea un usuario diferente para cada sistema. Es más seguro y evita conflictos.

P: Mi PrestaShop se ve en blanco después de instalarlo en la subcarpeta. ¿Qué hago?
R: Es casi seguro un problema de PHP o de reglas de reescritura. Primero, revisa el límite de memoria PHP (auméntalo a 256M). Segundo, verifica las reglas de Nginx en Syspanel para la subcarpeta /tienda.

P: ¿Syspanel (HestiaCP) me ayuda a instalar PrestaShop automáticamente?
R: Syspanel tiene un instalador de aplicaciones (llamado "Quick Installer" o "Instalador rápido") que incluye PrestaShop. Es la forma más fácil y evita muchos de estos errores. Búscalo en el panel de tu dominio.

P: ¿Es mala idea tener WordPress y PrestaShop en el mismo hosting?
R: No es mala idea, pero es más complejo que tenerlos por separado. Consume más recursos y requiere más mantenimiento. Si tu tráfico es bajo, funciona perfectamente. Si esperas miles de visitas, considera separarlos en planes de hosting distintos.

P: ¿Puedo compartir usuarios entre WordPress y PrestaShop?
R: No de forma nativa. Necesitarías un plugin de sincronización o un desarrollo a medida. Para la mayoría de los usuarios, tener dos sistemas de login separados es lo más sencillo.

Conclusión: Paciencia y Pasos Firmes

Instalar PrestaShop WordPress error es una frase que resume la frustración de muchos, pero con esta guía, ya sabes que la clave está en la planificación. No es un proceso de "un clic", pero es totalmente factible si sigues estos pasos:

Separa las instalaciones: Carpeta raíz para WordPress, subcarpeta para PrestaShop.
Configura bien tu Syspanel: PHP 8+, límite de memoria alto, y reglas de Nginx correctas.
Respeta los archivos de configuración: No mezcles .htaccess ni bases de datos.
Usa el instalador rápido de Syspanel si está disponible. Te ahorrará dolores de cabeza.
Si te atascas, busca en la documentación oficial de Syspanel (puerto 2106) o en foros especializados.

Recuerda, cada error es una oportunidad para aprender. ¡Ánimo con tu tienda online!