Cómo instalar y configurar módulos en PrestaShop desde Syspanel

Antes de empezar: ¿Qué es Syspanel y por qué es importante para instalar módulos PrestaShop?

Si estás buscando cómo instalar módulos en PrestaShop desde tu panel de control, seguramente ya has escuchado hablar de Syspanel. Pues bien, para que lo entiendas desde el principio: Syspanel es el nombre que recibe el panel de administración de tu hosting (similar a otros paneles como cPanel o Plesk). Es la herramienta que te permite gestionar archivos, bases de datos, dominios y, por supuesto, los módulos de tu tienda online.

La gran ventaja de usar Syspanel PrestaShop módulos es que tienes un control total sobre tu instalación sin necesidad de depender de terceros. Puedes subir, descomprimir, mover y configurar archivos directamente desde un entorno gráfico, lo que facilita muchísimo el trabajo, incluso si no tienes experiencia técnica avanzada.

[INFO] Para acceder a Syspanel, normalmente lo haces a través de la URL https://tu-dominio.com:2106 o desde el enlace que te proporcionó tu proveedor de hosting al contratar el servicio. Recuerda siempre que el puerto de acceso es el 2106.

En este artículo, te voy a guiar paso a paso por todo el proceso: desde la descarga del módulo hasta su configuración final. Vamos a hacerlo de una forma sencilla, visual y sin tecnicismos innecesarios. Al final, serás capaz de agregar módulo PrestaShop por tu cuenta y resolver los problemas más comunes que puedan surgir.

---

Paso 1: Descarga correcta del módulo PrestaShop

Antes de tocar Syspanel, necesitas tener el archivo del módulo en tu ordenador. Este archivo siempre viene en formato .zip o .tar.gz. Es importante que lo descargues de una fuente fiable: el marketplace oficial de PrestaShop, el sitio del desarrollador del módulo o, si es un módulo personalizado, de tu agencia de desarrollo.

[WARNING] Evita descargar módulos de sitios piratas o de dudosa procedencia. Además de que pueden contener malware, suelen estar desactualizados y no ser compatibles con tu versión de PrestaShop. Esto podría romper tu tienda o comprometer los datos de tus clientes.

¿Qué versión de PrestaShop tienes?

Para asegurar la compatibilidad, necesitas saber qué versión de PrestaShop tienes instalada. Puedes verlo en tu panel de administración de PrestaShop, en el apartado de Parámetros avanzados > Información. Anota el número (por ejemplo, 1.7.8.10 o 8.1.2). La mayoría de los módulos modernos son compatibles con las versiones 1.7 y 8.x, pero es mejor comprobarlo antes de continuar.

---

Paso 2: Acceder a Syspanel desde tu navegador

El primer paso para trabajar con Syspanel PrestaShop módulos es acceder correctamente al panel. Te explico cómo hacerlo de forma clara:

1. Abre tu navegador web preferido (Chrome, Firefox, Edge, etc.).
2. Escribe la dirección de acceso a Syspanel en la barra de direcciones: https://tu-dominio.com:2106. Sustituye tu-dominio.com por tu dominio real.
3. Pulsa Enter. Es posible que el navegador te muestre un aviso de seguridad porque el certificado SSL es autogenerado. No te preocupes, es normal. Haz clic en "Avanzado" y luego en "Continuar" para acceder.
4. Introduce tu usuario y contraseña de acceso a Syspanel. Estas credenciales las tienes en el correo de bienvenida de tu hosting o en la factura del servicio.

[INFO] Si no recuerdas tu contraseña, puedes restablecerla desde el propio panel de Syspanel o contactando con el soporte técnico de tu hosting. En algunos casos, también puedes acceder desde el área de cliente de tu proveedor.

Una vez dentro, verás un panel con diferentes iconos: Archivos, Bases de datos, Dominios, Correo, etc. Para nuestro objetivo, nos interesa principalmente el apartado de Archivos (o "Administrador de archivos").

---

Paso 3: Localizar la carpeta de módulos de PrestaShop

Ahora viene la parte clave. Necesitas encontrar la carpeta donde PrestaShop guarda todos sus módulos. Esta carpeta se llama modules y está dentro de la raíz de tu instalación de PrestaShop.

¿Cómo identificarla en Syspanel?

1. En Syspanel, haz clic en el icono de Administrador de archivos (suele ser una carpeta amarilla).
2. Se abrirá una ventana con la estructura de directorios de tu servidor. Normalmente, verás una carpeta llamada public_html (o htdocs). Esa es la raíz de tu sitio web.
3. Haz doble clic en public_html para entrar. Dentro, busca una carpeta llamada modules. Si tu PrestaShop está instalado en una subcarpeta (por ejemplo, public_html/tienda), entonces la carpeta modules estará dentro de esa subcarpeta.

[TIP] Si no encuentras la carpeta modules, revisa si tu PrestaShop está instalado en un subdirectorio. También puedes usar el buscador de archivos de Syspanel (campo "Buscar") y escribir "modules" para localizarla rápidamente.

Una vez dentro de la carpeta modules, verás una lista enorme de carpetas con nombres extraños (ps_contactinfo, ps_mainmenu, etc.). Cada una de esas carpetas es un módulo. No te asustes, es normal. Solo debes asegurarte de no borrar nada por accidente.

---

Paso 4: Subir el archivo ZIP del módulo a Syspanel

Ahora que estás en la carpeta modules, es el momento de subir el archivo ZIP que descargaste en el Paso 1. Puedes hacerlo de dos formas:

Opción A: Subir el ZIP y descomprimirlo en el servidor

1. En la parte superior del administrador de archivos de Syspanel, busca el botón Subir (suele tener un icono de flecha hacia arriba).
2. Haz clic y selecciona el archivo .zip de tu módulo desde tu ordenador.
3. Espera a que la subida termine. El tiempo dependerá del tamaño del archivo y la velocidad de tu conexión.
4. Una vez subido, verás el archivo .zip en la lista de archivos de la carpeta modules.
5. Haz clic derecho sobre el archivo .zip y selecciona la opción Extraer (o "Descomprimir").
6. Confirma la extracción. Syspanel creará automáticamente una nueva carpeta con el nombre del módulo dentro de modules.

Opción B: Subir el módulo ya descomprimido

Si prefieres evitar la extracción en el servidor, puedes descomprimir el ZIP en tu ordenador y subir la carpeta completa.

1. Descomprime el archivo ZIP en tu PC.
2. Verás una carpeta con el nombre del módulo (por ejemplo, micodigomodulo).
3. En Syspanel, haz clic en Subir y arrastra la carpeta completa (o selecciónala) hacia la zona de subida.
4. Syspanel subirá todos los archivos de la carpeta. Asegúrate de que la carpeta se suba dentro de modules, no en otra ubicación.

[WARNING] Al subir la carpeta completa, verifica que no se cree una carpeta duplicada (por ejemplo, modules/micodigomodulo/micodigomodulo). Si eso ocurre, simplemente mueve los archivos internos una carpeta hacia arriba.

---

Paso 5: Instalar el módulo desde el panel de administración de PrestaShop

Ya tienes los archivos del módulo en el servidor. Ahora, el siguiente paso es instalar módulos PrestaShop desde el propio panel de administración de tu tienda. PrestaShop detectará automáticamente los módulos que están en la carpeta modules y te permitirá instalarlos.

Pasos para la instalación:

1. Accede a tu panel de administración de PrestaShop (normalmente en tu-dominio.com/admin).
2. Ve al menú lateral izquierdo y busca Módulos > Módulos y servicios.
3. Se cargará una página con todos los módulos disponibles. En la parte superior derecha, verás un botón que dice Subir un módulo (o "Instalar un módulo").
4. Haz clic en ese botón. Se abrirá una ventana emergente.
5. En esa ventana, PrestaShop te pedirá que selecciones el archivo ZIP del módulo. Ojo, aquí es importante: aunque ya hayas subido los archivos por Syspanel, PrestaShop te pedirá el ZIP de nuevo para registrarlo en su sistema. Esto es normal y necesario.
6. Selecciona el archivo ZIP desde tu ordenador y haz clic en Subir.
7. PrestaShop procesará el archivo y te mostrará un mensaje de éxito o error. Si es correcto, el módulo aparecerá en la lista de módulos.
8. Busca tu módulo en la lista y haz clic en Instalar (botón azul).
9. PrestaShop te pedirá confirmación. Haz clic en Sí para continuar.
10. ¡Listo! El módulo quedará instalado y aparecerá en tu menú lateral o en la página de configuración del módulo.

[INFO] A veces, PrestaShop no te pide el ZIP y te muestra directamente el módulo en la lista si ya está en la carpeta modules. Si no aparece, usa siempre la opción "Subir un módulo" con el archivo ZIP original.

---

Paso 6: Configurar el módulo PrestaShop correctamente

Ahora viene la fase de configurar módulos PrestaShop. Cada módulo tiene su propia interfaz de configuración, pero te voy a dar las pautas generales que aplican a la mayoría.

Localizar la configuración del módulo

1. En el menú de administración de PrestaShop, ve a Módulos > Módulos y servicios.
2. Busca el módulo que acabas de instalar. Puedes usar el buscador para encontrarlo más rápido.
3. Haz clic en el botón Configurar (suele ser un icono de engranaje o el nombre del módulo).

Ajustes básicos que debes revisar

• Estado del módulo: Asegúrate de que esté "Habilitado". Si está deshabilitado, actívalo desde el botón correspondiente.
• Configuración general: Lee atentamente las opciones. Normalmente tendrás campos como "Título", "Descripción", "Posición" (en qué columna o zona del tema aparecerá) y "Visibilidad" (en qué páginas se mostrará).
• Guardar cambios: Siempre hay un botón como "Guardar" o "Guardar configuración". Haz clic en él después de modificar cualquier valor.

Ejemplo práctico: Configurar un módulo de banners

Imagina que has instalado un módulo de banners para tu tienda. Los pasos típicos serían:

1. En la configuración, sube la imagen del banner (300x250 px, por ejemplo).
2. Escribe la URL a la que debe enlazar el banner.
3. Selecciona la posición (por ejemplo, "Columna derecha" o "Carrusel del inicio").
4. Activa la opción "Mostrar en la página de inicio".
5. Guarda los cambios.

[TIP] Si el módulo tiene muchas opciones, no te agobies. Empieza con la configuración mínima (activar, posicionar y guardar) y ve probando. Siempre puedes volver a ajustar más tarde.

---

Paso 7: Comprobar que el módulo funciona en tu tienda

Después de la configuración, es fundamental verificar que todo funciona correctamente. Esto te evitará sustos y problemas de rendimiento.

Qué debes comprobar

1. Accede a tu tienda en una ventana de incógnito (para evitar caché).
2. Busca el módulo en la zona donde debería aparecer (por ejemplo, en la página de inicio, en el lateral, en el pie de página).
3. Haz clic en él si es un enlace o botón, para verificar que funciona correctamente.
4. Revisa la consola de errores de tu navegador (F12 > pestaña Consola). Si ves errores en rojo relacionados con el módulo, es que hay algún problema de compatibilidad o de código.

[WARNING] Si la tienda muestra un error 500 o una pantalla en blanco después de instalar el módulo, no entres en pánico. Desactiva el módulo desde la base de datos o desde el administrador de archivos (renombra la carpeta del módulo). Luego contacta con el desarrollador del módulo para obtener soporte.

---

Paso 8: Solución de problemas comunes al instalar módulos PrestaShop

Aunque el proceso es sencillo, a veces surgen inconvenientes. Aquí te dejo los problemas más habituales y cómo resolverlos.

Error: "El módulo no se pudo instalar" o "Archivo no válido"

Esto suele pasar cuando el ZIP no es correcto, está corrupto o no es compatible con tu versión de PrestaShop.

Solución:

• Vuelve a descargar el módulo desde la fuente original.
• Asegúrate de que el ZIP contiene la carpeta del módulo directamente en su raíz (no una carpeta intermedia).
• Comprueba la compatibilidad con tu versión de PrestaShop en la ficha del módulo.

Error: "No se puede conectar con el servidor web" o "Error de permisos"

Generalmente es un problema de permisos de archivos. Los archivos deben tener permisos 755 (directorios) y 644 (archivos).

Solución:

• En Syspanel, selecciona la carpeta del módulo y haz clic en Permisos (o "Chmod").
• Establece los permisos a 755 para carpetas y 644 para archivos. Aplica los cambios recursivamente.

El módulo aparece pero no funciona correctamente

Puede ser un conflicto con otros módulos o con el tema.

Solución:

• Desactiva temporalmente otros módulos para ver si el problema desaparece.
• Prueba con el tema por defecto de PrestaShop (como Classic) para descartar incompatibilidades.

[INFO] Si después de todos estos pasos el problema persiste, lo más recomendable es contactar con el soporte técnico del desarrollador del módulo. Ellos conocen su código y te podrán dar una solución específica.

---

Preguntas frecuentes (FAQ) sobre módulos PrestaShop y Syspanel

¿Puedo instalar módulos PrestaShop sin usar Syspanel?

Sí, puedes hacerlo directamente desde el panel de administración de PrestaShop usando la opción "Subir un módulo". Sin embargo, Syspanel te da control adicional si necesitas subir módulos grandes, corregir errores de permisos o gestionar archivos manualmente. Es la vía más completa.

¿Qué hago si no veo la carpeta modules en Syspanel?

Si no la ves, es probable que tu PrestaShop esté instalado en una subcarpeta. Busca en public_html y revisa si hay una carpeta con el nombre de tu tienda. Dentro de ella estará modules. También puedes usar el buscador de Syspanel.

¿Es seguro instalar módulos desde Syspanel?

Sí, siempre que uses módulos de fuentes fiables. Syspanel solo te da acceso a los archivos; la seguridad depende de dónde obtengas el módulo y de que mantengas tu PrestaShop actualizado.

¿Cuánto tarda en instalarse un módulo?

La instalación en sí suele ser instantánea (unos segundos). Lo que puede tardar es la subida del archivo ZIP, dependiendo de su peso y tu conexión.

¿Puedo desinstalar un módulo desde Syspanel?

Puedes desinstalarlo desde PrestaShop, pero para eliminarlo por completo (incluyendo sus archivos), deberás borrar la carpeta del módulo desde Syspanel. Eso sí, asegúrate de desactivarlo primero desde PrestaShop para evitar errores.

¿Syspanel es compatible con cualquier hosting?

Syspanel es el panel de control de tu hosting. Si tu proveedor lo usa, tendrás acceso a él. Si no, tu panel será otro (cPanel, Plesk). Los pasos son muy similares, aunque las rutas pueden variar ligeramente.

---

Conclusión: Ya sabes cómo instalar y configurar módulos en PrestaShop