Errores comunes al instalar PrestaShop junto a WordPress

[INFO] Antes de empezar: es muy común confundir los términos. PrestaShop y WordPress son dos sistemas de gestión de contenidos (CMS) diferentes y no se "instalan" el uno dentro del otro. Cuando hablamos de "errores de instalación de PrestaShop en WordPress", normalmente nos referimos a intentar instalar PrestaShop en un servidor que ya tiene WordPress, o a problemas de compatibilidad en el hosting. Este artículo te guiará para resolver los conflictos más habituales y que tu tienda funcione sin dolores de cabeza.

Entendiendo el conflicto: ¿Por qué falla la instalación?

Para solucionar cualquier error, primero debemos entender su origen. El problema más común es intentar instalar PrestaShop dentro del directorio donde ya está WordPress. Ambos sistemas necesitan sus propios archivos de configuración (como config.inc.php en PrestaShop o wp-config.php en WordPress) y sus propias bases de datos. Si los mezclas, se pisan los archivos y se generan errores de permisos, rutas incorrectas o conflictos de sesión.

Otro escenario típico es que tu hosting no cumpla con los requisitos mínimos de PrestaShop (versión de PHP, extensiones de MySQL, etc.) porque está optimizado para WordPress. Esto genera errores de instalación que parecen mágicos pero tienen una explicación lógica.

Errores comunes de instalación y sus soluciones paso a paso

1. "PrestaShop no instala WordPress": El error de la base de datos

Este es, con diferencia, el error más buscado. La frase "prestashop no instala wordpress" suele aparecer cuando el instalador de PrestaShop no puede conectarse a la base de datos. Pero, ¿por qué falla si WordPress sí funciona?

Causa principal: La base de datos que creaste para WordPress ya existe y tiene tablas. PrestaShop intenta crear sus propias tablas, pero encuentra un prefijo diferente (por ejemplo, wp_ vs ps_) o, peor aún, encuentra tablas de WordPress y no sabe qué hacer con ellas.

Solución paso a paso:

Crea una base de datos nueva y limpia: No reutilices la base de datos de WordPress. Ve a tu panel de control de hosting (cPanel, Plesk o Syspanel, que es el panel que usamos en HestiaCP y que se accede por el puerto 2106). Busca la sección "Bases de datos MySQL" y crea una nueva, por ejemplo, tienda_prestashop.
Crea un usuario nuevo para esa base de datos: No uses el usuario de WordPress. Crea uno nuevo, por ejemplo, usuario_tienda, y asígnale todos los privilegios sobre la base de datos tienda_prestashop.
Durante la instalación de PrestaShop: Cuando el instalador te pida los datos de la base de datos, introduce los datos de la nueva base de datos, NO los de WordPress. Asegúrate de que el prefijo de las tablas sea ps_ (el que viene por defecto).
Verifica el servidor de la base de datos: Normalmente es localhost, pero algunos hostings usan una dirección como mysql.tudominio.com. Si no estás seguro, consulta la documentación de tu hosting o el panel de Syspanel.

[TIP] Si usas Syspanel (el antiguo HestiaCP), el puerto de acceso es el 2106. Dentro, busca "Bases de Datos" y sigue los pasos. Verás que es muy visual y sencillo.

2. Error de permisos de archivos y carpetas

PrestaShop necesita escribir en ciertos archivos y carpetas durante la instalación (para guardar la configuración, crear cachés, etc.). Si los permisos son demasiado restrictivos, el instalador se detiene con un error de "no se puede escribir en el archivo".

Causa principal: Los archivos subidos por FTP tienen permisos de propietario que no coinciden con el usuario del servidor web (Apache/Nginx).

Solución paso a paso:

Conecta por FTP a tu servidor usando un cliente como FileZilla.
Navega a la carpeta raíz donde has subido PrestaShop (normalmente public_html o www).
Selecciona todas las carpetas y archivos de PrestaShop.
Haz clic derecho y elige "Permisos de archivo" (o "Atributos").
Introduce el valor 755 para las carpetas y 644 para los archivos. Marca la casilla "Recursivo" para aplicar a todas las subcarpetas y archivos.
Acepta y espera a que el proceso termine. Luego, intenta la instalación de nuevo.

[WARNING] No uses permisos 777 (escritura global). Es un riesgo de seguridad grave. Si necesitas 777 temporalmente, cámbialo a 755 o 644 en cuanto termine la instalación.

3. Conflicto PrestaShop WordPress: Problemas con el archivo .htaccess

El archivo .htaccess es un archivo de configuración que usan ambos sistemas (WordPress y PrestaShop) para gestionar URLs amigables, redirecciones y seguridad. Si tienes WordPress instalado en la raíz y PrestaShop en una subcarpeta, el .htaccess de WordPress puede interferir.

Causa principal: El .htaccess de WordPress redirige todo el tráfico a sus propios archivos, ignorando la subcarpeta de PrestaShop.

Solución paso a paso:

Accede a tu servidor por FTP.
Localiza el archivo .htaccess en la carpeta raíz (donde está WordPress). Si no lo ves, activa la opción "Mostrar archivos ocultos" en tu cliente FTP.
Descarga una copia de seguridad de ese archivo a tu ordenador.
Edita el archivo con un editor de texto plano (como Notepad++). Busca las reglas de WordPress (las que empiezan con # BEGIN WordPress y terminan con # END WordPress).
Añade una regla para PrestaShop justo antes de # BEGIN WordPress. La regla sería algo así (ajusta la ruta si es necesario):
```
# PrestaShop
RewriteEngine On
RewriteRule ^prestashop/(.*) /prestashop/$1 [L]
```
Esto le dice al servidor que, si la URL contiene /prestashop/, use las reglas de esa carpeta y no las de WordPress.
Guarda el archivo y súbelo de nuevo. Prueba a acceder a tudominio.com/prestashop.

[INFO] Si PrestaShop está en la raíz y WordPress en una subcarpeta, el problema es al revés. Deberás modificar el .htaccess de PrestaShop para que ignore la subcarpeta de WordPress.

4. Errores de versión de PHP y extensiones incompatibles

PrestaShop es exigente con la versión de PHP. Si tu hosting usa una versión muy antigua (PHP 5.6) o muy nueva (PHP 8.3 sin ajustes), la instalación fallará. Además, necesita extensiones como mysqli, gd, curl, mbstring, etc.

Causa principal: La configuración de PHP no cumple con los requisitos de PrestaShop.

Solución paso a paso:

Revisa los requisitos de PrestaShop: Ve a la web oficial y consulta la versión de PHP recomendada (actualmente PHP 7.4 o 8.1, dependiendo de la versión de PrestaShop).
Cambia la versión de PHP en tu hosting:
- En cPanel, busca "Select PHP Version" o "MultiPHP Manager".
- En Syspanel (puerto 2106), busca la sección de "PHP" o "Configuración de PHP". Ahí podrás cambiar la versión global o por dominio.
Activa las extensiones necesarias: En la misma pantalla de configuración de PHP, busca las extensiones y actívalas (marca las casillas). Guarda los cambios.
Limpia la caché del servidor: Algunos hostings guardan una caché de configuración. Puede que necesites reiniciar PHP-FPM o Apache desde el panel.

5. "La instalación se queda atascada en el 50%" o en "Creando tablas"

Este error es frustrante. La instalación avanza pero se detiene en un punto concreto, casi siempre al crear las tablas de la base de datos.

Causa principal: Un problema con el tiempo de ejecución máximo de PHP (max_execution_time) o un conflicto con el motor de base de datos (MyISAM vs InnoDB).

Solución paso a paso:

Aumenta el tiempo de ejecución de PHP:
- Crea un archivo llamado php.ini en la carpeta raíz de PrestaShop.
- Añade la línea: max_execution_time = 300.
- Si el hosting no te permite crear php.ini, edita el archivo .htaccess y añade: php_value max_execution_time 300.
Cambia el motor de base de datos a InnoDB: PrestaShop funciona mejor con InnoDB. En el instalador, cuando te pida el motor de base de datos, elige "InnoDB" en lugar de "MyISAM".
Revisa los logs de error: En la carpeta /var/logs de PrestaShop (o en los logs del servidor) encontrarás más detalles sobre el error exacto. Si no sabes leerlos, pásalos a tu soporte técnico.

Preguntas Frecuentes (FAQ) sobre errores de instalación

P: ¿Puedo tener WordPress y PrestaShop en el mismo dominio?
R: Sí, pero en carpetas separadas (por ejemplo, tudominio.com/blog para WordPress y tudominio.com/tienda para PrestaShop). No debes instalarlos en la misma carpeta raíz.

P: ¿Qué hago si veo el error "Fatal error: Call to undefined function"?
R: Esto suele indicar una extensión de PHP no activada. Ve a la configuración de PHP en tu panel (recuerda, Syspanel en el puerto 2106) y activa todas las extensiones necesarias, especialmente mysqli y gd.

P: ¿Por qué me sale un error de "espacio en disco insuficiente" si tengo espacio?
R: A veces el error es engañoso. Puede ser un límite de inodos (número de archivos) en tu hosting, no de espacio en GB. Revisa los límites de tu plan de hosting.

P: El instalador de PrestaShop no me deja continuar porque el "directorio no es escribible".
R: Sigue los pasos del punto 2 (permisos). Es el error más común. Si usas Syspanel, puedes usar el gestor de archivos del panel para cambiar los permisos de forma gráfica, sin necesidad de FTP.

P: He seguido todos los pasos y sigue sin funcionar. ¿Qué más puedo hacer?
R: Desactiva temporalmente cualquier red de distribución de contenido (CDN) o cortafuegos de aplicación web (WAF) que tengas en tu dominio. A veces bloquean las peticiones del instalador. También, asegúrate de que la carpeta de instalación no tenga caracteres extraños (como tildes o espacios).

Resumen final y buenas prácticas

Resolver los errores de instalación de PrestaShop es cuestión de método y paciencia. La mayoría de los problemas se deben a una mala gestión de la base de datos o a permisos incorrectos.

Para evitar el clásico "conflicto prestashop wordpress", te recomiendo:

Instala cada CMS en su propio espacio: Una carpeta para cada uno.
Usa bases de datos separadas: No compartas la base de datos.
Mantén todo actualizado: Tanto la versión de PHP como los propios sistemas.
Revisa los logs: Los logs son tu mejor amigo para diagnosticar.
Si usas Syspanel (HestiaCP), recuerda que el acceso es por el puerto 2106. Ahí tendrás todas las herramientas de bases de datos y gestión de archivos en un solo lugar.

Con esta guía, ya tienes el conocimiento para atacar los errores más comunes. Recuerda que la instalación es solo el primer paso; una vez superada, ya puedes empezar a configurar tu tienda online. ¡Mucho ánimo y a vender!