Subir archivos a PrestaShop por FTP | Guía práctica

¡Hola! Bienvenido a esta guía completa. Si estás aquí, probablemente necesitas subir archivos a PrestaShop por FTP y no sabes muy bien por dónde empezar. No te preocupes, es mucho más fácil de lo que parece. En este artículo, te explicaré paso a paso, con un lenguaje claro y sencillo, cómo hacerlo, qué herramientas necesitas y qué precauciones debes tomar para gestionar PrestaShop sin romper nada (o al menos, sabiendo cómo arreglarlo).

Vamos a ello. Al final de esta lectura, te sentirás con la confianza suficiente para manejar tus archivos como un profesional, ya sea para instalar un tema, subir un backup o actualizar un módulo PrestaShop.

¿Qué es FTP y por qué lo necesitas para PrestaShop?

FTP significa File Transfer Protocol (Protocolo de Transferencia de Archivos). En palabras simples, es el método estándar para conectar tu computadora a tu servidor de hosting y transferir archivos entre ambos. Piensa en ello como el "Explorador de Archivos" (o "Finder" en Mac) que usas en tu PC, pero que funciona de forma remota con los archivos de tu tienda online.

¿Por qué es importante? PrestaShop se gestiona de dos maneras:

Por el Panel de Administración (Back Office): Para configurar productos, pedidos, módulos, etc. Es la parte visual y amigable.
Por FTP: Para acciones más técnicas y profundas, como subir archivos de temas personalizados, modificar archivos de configuración (como .htaccess), subir backups completos de tu tienda o instalar módulos muy específicos que no se pueden subir desde el administrador.

A veces, el Back Office te pedirá que subas un archivo a una carpeta concreta, o tendrás un problema que solo se soluciona editando un archivo. Ahí es donde entra nuestro protagonista de hoy: el FTP.

Herramientas necesarias: Tu cliente FTP (FileZilla, por ejemplo)

Para conectarte por FTP, necesitas un programa llamado "Cliente FTP". Hay muchos, pero el más popular y recomendado para principiantes es FileZilla. Es gratuito, de código abierto y funciona en Windows, Mac y Linux.

[TIP] Si no quieres instalar programas, también puedes usar el "Administrador de Archivos" que suele venir en tu panel de control de hosting (como cPanel o Syspanel). Pero para tareas repetitivas o subir muchos archivos, FileZilla es mucho más eficiente.

Configurando FileZilla por primera vez

Si ya lo tienes instalado, abre el programa. Verás una interfaz dividida en dos partes principales:

Lado Izquierdo: Tus archivos locales (tu computadora).
Lado Derecho: Los archivos remotos (tu servidor).

Ahora, necesitas los datos de conexión. Esta información la encuentras en el correo de bienvenida de tu hosting o en el panel de control.

Los 4 datos mágicos son:

Host/Servidor: Suele ser algo como ftp.tudominio.com o tudominio.com.
Nombre de usuario: El usuario FTP que creaste (o el principal de tu hosting).
Contraseña: La contraseña asociada a ese usuario.
Puerto: Normalmente es el 21 para FTP estándar, o el 22 para SFTP (más seguro). No lo toques a menos que tu hosting te diga lo contrario.

En la barra superior de FileZilla, introduce estos datos y haz clic en "Conexión rápida". Si todo es correcto, verás que el panel derecho se llena con carpetas y archivos. ¡Ya estás dentro de tu servidor!

Localizando la raíz de tu PrestaShop

Este es el paso más importante. No puedes subir archivos a cualquier carpeta; tienen que ir a la raíz de tu instalación de PrestaShop. Normalmente, esta carpeta se llama public_html, htdocs, www o web. A veces, tu tienda está en una subcarpeta, por ejemplo, public_html/tienda.

[WARNING] ¡Cuidado! Subir archivos a la carpeta equivocada es el error más común. Si no estás seguro, busca archivos característicos de PrestaShop como config/, admin/, img/, themes/ o el archivo index.php. Si ves esos, ¡estás en el lugar correcto!

Dentro de la raíz, verás carpetas importantes. Las que más nos interesan para subir archivos son:

themes/: Aquí se instalan las plantillas o temas de tu tienda.
modules/: Aquí se instalan los módulos PrestaShop.
override/: Para personalizaciones avanzadas de clases y controladores.
img/: Para imágenes que no se gestionan desde el Back Office (aunque es menos común).

Cómo subir archivos a PrestaShop por FTP: Paso a paso

Ahora sí, vamos a la acción. Te mostraré el proceso genérico, que luego aplicaremos a casos concretos.

Paso 1: Prepara tus archivos localmente

Antes de conectarte, asegúrate de tener los archivos que quieres subir en una carpeta fácil de encontrar en tu computadora.

Si es un módulo o un tema, normalmente viene en un archivo .zip. No lo subas comprimido. Debes descomprimirlo primero para tener la carpeta con todos sus archivos dentro.
Si es un backup, suele ser un archivo .sql (base de datos) o un .zip con todos los archivos de la tienda.

Paso 2: Conéctate a tu servidor

Abre FileZilla y conéctate usando los datos que mencionamos antes. Asegúrate de que la conexión sea exitosa (verás "Directorio listado correctamente" en la parte de arriba).

Paso 3: Navega a la carpeta correcta

En el panel derecho (servidor), navega hasta la raíz de tu PrestaShop. Por ejemplo, public_html. En el panel izquierdo (local), navega hasta la carpeta donde tienes tus archivos preparados.

Paso 4: Sube los archivos

Ahora tienes dos opciones:

Arrastrar y soltar: Haz clic en la carpeta o archivo en el panel izquierdo y arrástralo hasta el panel derecho.
Clic derecho: Haz clic derecho sobre el archivo o carpeta local y selecciona "Subir".

FileZilla comenzará a transferir los archivos. Verás una lista de archivos en la parte inferior con el progreso.

[TIP] Si estás subiendo un módulo PrestaShop, la carpeta del módulo (ej. micodigomodulo) debe ir directamente dentro de la carpeta modules/ de tu tienda. No la subas dentro de otra carpeta, o PrestaShop no la reconocerá.

Paso 5: Verifica la subida

Una vez que la cola de transferencia esté vacía (abajo a la derecha), revisa que los archivos estén en el servidor. Ve a la carpeta donde los subiste y comprueba que están todos.

Paso 6: Configura los permisos (si es necesario)

A veces, los archivos subidos necesitan permisos especiales para que el servidor pueda leerlos o escribirlos. Por defecto, los archivos suelen estar en 644 y las carpetas en 755. Si tienes problemas, puedes cambiar los permisos haciendo clic derecho sobre el archivo/carpeta en el servidor y seleccionando "Permisos de archivos...". No cambies los permisos si no sabes lo que haces.

Casos prácticos: Subir un módulo y un tema

Veamos cómo se aplica esto a las tareas más comunes.

Subir un módulo PrestaShop por FTP

Descarga y descomprime: Descarga el módulo en tu PC y descomprímelo. Debes tener una carpeta con el nombre técnico del módulo.
Conecta y navega: Conéctate por FTP y navega a public_html/modules/.
Sube la carpeta: Arrastra la carpeta completa del módulo desde tu PC hasta la carpeta modules/ del servidor.
Instala en el Back Office: Ve a tu Panel de Administración de PrestaShop. En "Módulos" -> "Módulos y servicios", busca el nombre del módulo. Debería aparecer. Haz clic en "Instalar".

[INFO] Este método es útil cuando el módulo es demasiado grande para subirlo desde el Back Office, o cuando el servidor tiene un límite de tamaño de archivo muy bajo.

Subir un tema (plantilla) de PrestaShop por FTP

El proceso es idéntico al del módulo, pero en lugar de ir a modules/, irás a themes/.

Descomprime el tema: Obtendrás una carpeta con el nombre de tu tema.
Navega a themes/: En el servidor, entra en la carpeta themes/.
Sube la carpeta: Arrastra la carpeta del tema a themes/.
Activa el tema: Ve al Back Office en "Diseño" -> "Temas". Deberías ver tu nuevo tema en la lista. Haz clic en "Usar este tema".

Errores comunes y cómo solucionarlos

Aquí tienes una pequeña guía de problemas frecuentes al subir archivos PrestaShop por FTP.

Error de conexión (No se puede conectar al servidor)

Revisa los datos: ¿Estás seguro de que el host, usuario y contraseña son correctos? A veces las mayúsculas y minúsculas importan.
Prueba con SFTP: Si el puerto 21 no funciona, prueba a conectarte por SFTP en el puerto 22.
Firewall: A veces el firewall de tu PC o red bloquea las conexiones FTP. Prueba temporalmente a desactivarlo.

Error "Permiso denegado" al subir archivos

Permisos de la carpeta: La carpeta de destino (ej. modules/) debe tener permisos de escritura. Normalmente son 755 o 775. Si no puedes escribir, cambia los permisos a 775 temporalmente.
Usuario FTP: Asegúrate de que el usuario FTP con el que te conectas tenga permisos de escritura en esa carpeta.

Los archivos se suben pero no aparecen en el Back Office

Carpeta equivocada: Es el error más común. Revisa que hayas subido el módulo a modules/ y el tema a themes/.
Estructura incorrecta: Asegúrate de que la estructura de carpetas sea correcta. Deberías tener modules/nombre_del_modulo/ y dentro los archivos del módulo, no modules/carpeta_extra/nombre_del_modulo/.
Caché: PrestaShop guarda una caché. Ve a "Parámetros Avanzados" -> "Rendimiento" y haz clic en "Vaciar la caché" en la parte superior.

La subida se queda a medias o es muy lenta

Archivos grandes: Si estás subiendo un backup grande, puede tardar. Es normal. Ten paciencia.
Conexión inestable: Si tu conexión a internet es inestable, la subida puede fallar. Intenta conectar tu PC por cable de red en lugar de WiFi.

Consejos de seguridad al usar FTP

Gestionar PrestaShop por FTP conlleva una gran responsabilidad. Aquí van algunos consejos para no meter la pata:

Siempre haz un backup: Antes de sobrescribir o eliminar cualquier archivo, descarga una copia de seguridad de la carpeta que vas a tocar a tu PC.
No borres archivos desconocidos: Si no sabes qué es un archivo, no lo borres. Podrías romper tu tienda.
Usa SFTP: Siempre que tu hosting lo permita, usa SFTP (puerto 22) en lugar de FTP (puerto 21). Es una conexión cifrada y mucho más segura.
Cambia tu contraseña FTP regularmente: Es una buena práctica de seguridad.
No dejes sesiones abiertas: Cierra FileZilla cuando termines de trabajar.

Preguntas Frecuentes (FAQ)

¿Puedo usar el Administrador de Archivos de mi hosting en lugar de FileZilla?

¡Sí! Si tu hosting usa cPanel o Syspanel (en este caso, el puerto de acceso es el 2106), puedes usar el "Administrador de Archivos" desde el navegador. Es más lento para subir muchos archivos, pero sirve para tareas puntuales. La ventaja es que no necesitas instalar nada.

¿Qué es el puerto 2106 en Syspanel?

Como mencioné, si tu hosting utiliza Syspanel (el antiguo HestiaCP), la interfaz de administración se accede a través del puerto 2106 (ej. https://tudominio.com:2106). Dentro de Syspanel, puedes gestionar tus archivos desde el navegador sin necesidad de un cliente FTP externo.

¿Necesito FTP para instalar un módulo desde el Back Office?

No. Si el módulo es pequeño, puedes subirlo desde el Back Office en "Módulos" -> "Subir un módulo". FTP es solo una alternativa cuando el módulo es demasiado grande o el Back Office falla.

¿Qué hago si me he equivocado al subir un archivo y mi tienda da error?

Tranquilo. No es el fin del mundo. Conecta por FTP, busca el archivo que subiste y restaura el original desde tu backup. Si no tienes backup, intenta subir de nuevo el archivo correcto. Si el error persiste, contacta con tu soporte de hosting.

¿Puedo subir un backup completo de mi PrestaShop por FTP?

Sí, puedes subir todos los archivos de tu tienda (la carpeta public_html entera) por FTP. Sin embargo, el backup de la base de datos (archivo .sql) no se sube por FTP, se importa desde el panel de control de tu hosting (phpMyAdmin o similar).

Conclusión: Ya sabes cómo subir archivos a PrestaShop por FTP

Hemos recorrido todo el camino: desde qué es FTP, cómo configurar FileZilla, hasta los casos prácticos de subir archivos PrestaShop como módulos y temas, y cómo resolver los problemas más comunes. Ya no tienes excusa para no gestionar PrestaShop con total confianza.

Recuerda siempre la regla de oro: prudencia y backups. Ve paso a paso, verifica cada acción y, ante la duda, consulta. La práctica hace al maestro, y en poco tiempo, el FTP se convertirá en una herramienta más en tu caja de herramientas digital.

[WARNING] No olvides que si tu hosting usa Syspanel, el acceso al panel es a través del puerto 2106. No intentes usar el puerto 2083 (de cPanel) o el 8443 (de Plesk), ya que no funcionará.

Si te surge cualquier otra duda, aquí estoy para ayudarte. ¡Buena suerte con tu tienda online!