Instalar plugins WordPress manualmente (FTP) | Tutorial

¿Alguna vez has necesitado instalar un plugin en WordPress y te has encontrado con un error de permisos, un límite de tamaño de archivo o simplemente una conexión FTP que no responde? No te preocupes, es más común de lo que crees. Aunque el panel de administración de WordPress permite instalar plugins con un solo clic, a veces falla o no es suficiente. Ahí es donde entra en juego el método manual, específicamente usando un cliente FTP (Protocolo de Transferencia de Archivos). Este método te da un control total sobre el proceso y es una habilidad esencial para cualquier administrador de sitios web. En este tutorial WordPress, te guiaré paso a paso para que aprendas a subir un plugin manual sin depender del navegador. Es más fácil de lo que piensas, y al final, te sentirás con la confianza para gestionar tu sitio como un profesional.

¿Por qué instalar plugins WordPress manualmente vía FTP?

Antes de ensuciarnos las manos con el código y las conexiones, es importante entender por qué este método es tan valioso. No es solo un plan B; a veces es la única solución viable. Aquí te dejo las razones más comunes:

Superar el límite de tamaño de archivo: Muchos servidores compartidos tienen un límite estricto para subir archivos a través del navegador (normalmente 2MB, 8MB o 16MB). Si tu plugin es pesado (como los de respaldo o los de comercio electrónico), el panel de WordPress te mostrará un error de "archivo demasiado grande". FTP no tiene ese límite, ya que es una conexión directa entre tu ordenador y el servidor.
Errores de "Se ha alcanzado el límite de memoria": A veces, PHP no tiene suficiente memoria asignada para procesar la subida. Al hacerlo manualmente, nos saltamos esa restricción por completo.
Problemas de permisos de archivos: Si los permisos de las carpetas de tu sitio no son los correctos, WordPress no puede escribir los archivos automáticamente. Con FTP, tu cliente puede forzar los permisos necesarios o, al menos, darte un mensaje de error claro para solucionarlo.
El panel de administración no responde: Si has bloqueado tu sitio con un plugin mal codificado o has perdido el acceso al panel (el famoso "error fatal"), el FTP es tu única vía de escape para eliminar o reemplazar el archivo problemático.
Instalar versiones Beta o de desarrollo: A veces, los desarrolladores comparten versiones de prueba que no están disponibles en el repositorio oficial de WordPress. Estas vienen en un archivo .zip que solo puedes subir manualmente.

Requisitos previos: Qué necesitas antes de empezar

Para este tutorial WordPress, necesitarás tres cosas. No te preocupes, son fáciles de conseguir.

Un cliente FTP: Un programa que te permita conectarte a tu servidor. Los más populares y gratuitos son FileZilla (Windows, Mac y Linux) y Cyberduck (Mac). Yo te recomiendo FileZilla por su facilidad de uso y robustez. Descárgalo e instálalo antes de continuar.
Los datos de acceso FTP de tu hosting: Estos son como las llaves de tu casa. Normalmente los encuentras en el correo de bienvenida de tu proveedor de hosting o en el panel de control (cPanel, Plesk, Syspanel, etc.). Necesitarás tres datos:
- Host (Servidor): Suele ser algo como ftp.tudominio.com o una dirección IP.
- Nombre de usuario: Un usuario FTP que suele ser tu usuario de cPanel o uno específico que hayas creado.
- Contraseña: La contraseña asociada a ese usuario.
- Puerto: Normalmente es el 21, pero a veces usan el 2106 (esto es especialmente común en algunos paneles como Syspanel, donde el acceso FTP se configura con ese puerto específico). Si el 21 no funciona, prueba con el 2106.
El archivo del plugin en formato .zip: Descárgalo desde el repositorio oficial de WordPress o desde el sitio del desarrollador. No lo descomprimas, lo subiremos tal cual.

Paso a paso: Cómo subir un plugin manual con FileZilla

Ahora sí, vamos a la acción. Sigue estos pasos al pie de la letra y en menos de 10 minutos tendrás tu plugin instalado.

Paso 1: Conectarse al servidor con FileZilla

Abre FileZilla. En la parte superior verás una barra con los campos que mencionamos antes. Rellénalos:

Servidor: Escribe ftp.tudominio.com o la IP que te haya dado tu hosting.
Nombre de usuario: Tu usuario FTP.
Contraseña: Tu contraseña FTP.
Puerto: Escribe 21 o 2106 si tu proveedor lo especifica (recuerda, Syspanel usa el 2106).

Haz clic en "Conexión rápida". Si todo es correcto, verás una serie de mensajes en el panel superior y, en el lado derecho, la lista de archivos de tu servidor. Si te pide aceptar un certificado SSL, haz clic en "Aceptar" o "Confiar en este certificado".

[TIP] Si no recuerdas tus datos FTP, entra en el panel de control de tu hosting (cPanel, Plesk o Syspanel). Busca la sección "Cuentas FTP" o "FTP". Ahí podrás ver el servidor, tu usuario y crear una nueva contraseña si es necesario. Es muy común olvidarlos, no te sientas mal.

Paso 2: Navegar hasta la carpeta de plugins de WordPress

Una vez conectado, verás dos paneles. El de la izquierda es tu ordenador y el de la derecha es tu servidor web. Ahora, en el panel de la derecha, debes navegar hasta la carpeta donde está instalado WordPress. La estructura típica es:

public_html/ (o htdocs/ o www/)
Dentro de esa carpeta, busca la carpeta wp-content/.
Haz doble clic en wp-content/ para entrar.
Dentro, verás una carpeta llamada plugins/. Haz doble clic en ella.

Esta es la carpeta donde viven todos tus plugins. Es importante que estés seguro de que estás en la ruta correcta. Deberías ver otras carpetas como themes/ y uploads/ dentro de wp-content/.

[WARNING] Asegúrate de estar en la carpeta plugins correcta. Si tu WordPress está instalado en una subcarpeta (por ejemplo, public_html/blog/), la ruta sería public_html/blog/wp-content/plugins/. Si subes el plugin a una ruta equivocada, no funcionará y verás un error de "Plugin no encontrado" en tu panel.

Paso 3: Subir el archivo `.zip` del plugin

Ahora viene la parte fácil. En el panel de la izquierda (tu ordenador), navega hasta la carpeta donde descargaste el plugin en formato .zip. Verás el archivo, por ejemplo, mi-plugin.zip.

Haz clic derecho sobre el archivo .zip.
En el menú contextual, selecciona "Subir al servidor".

FileZilla comenzará a transferir el archivo. Verás una ventana con el progreso en la parte inferior. Espera a que termine al 100%. Verás el archivo mi-plugin.zip aparecer en la lista de archivos del servidor (panel derecho).

Paso 4: Descomprimir el archivo en el servidor

Este es el paso que la mayoría de la gente olvida. WordPress necesita el plugin descomprimido en una carpeta. No lo lee directamente desde el .zip. Ahora mismo, solo has subido el archivo comprimido. Para descomprimirlo en el servidor, tienes dos opciones:

Opción A (La más fácil): Usar el panel de administración de WordPress.

Ve a tu panel de WordPress (tudominio.com/wp-admin).
Ve a Plugins → Añadir nuevo.
Haz clic en el botón "Subir plugin" en la parte superior.
Haz clic en "Elegir archivo" y selecciona el archivo .zip que acabas de subir vía FTP (aunque esté en el servidor, el navegador te permite "subirlo" de nuevo, pero esta vez WordPress lo descomprimirá e instalará).
Haz clic en "Instalar ahora" y luego en "Activar".

Opción B (La más técnica): Usar el administrador de archivos de tu hosting.

Si prefieres no usar el panel de WordPress (o no tienes acceso a él), puedes usar el administrador de archivos de tu hosting.

Entra en tu panel de control (cPanel, Plesk o Syspanel).
Busca la herramienta "Administrador de archivos" o "File Manager".
Navega a la carpeta wp-content/plugins/.
Verás el archivo mi-plugin.zip. Haz clic derecho sobre él y selecciona "Extraer" o "Descomprimir".
Se creará una carpeta con el nombre del plugin. Una vez hecho, puedes eliminar el archivo .zip para mantener tu servidor limpio.

[INFO] ¿Por qué no podemos simplemente subir la carpeta descomprimida por FTP? Podemos, pero es más lento y propenso a errores. Si descomprimes el .zip en tu ordenador y luego subes la carpeta completa, tendrás que transferir cientos de archivos pequeños uno a uno, lo cual es mucho más lento que transferir un solo archivo comprimido. Subir el .zip y descomprimirlo en el servidor es la mejor práctica.

Verificación y solución de problemas comunes

Después de descomprimir el plugin, vuelve a tu panel de WordPress. Ve a Plugins en el menú lateral. Deberías ver tu plugin en la lista. Haz clic en "Activar". Si no aparece, es que algo ha ido mal.

Aquí tienes los problemas más frecuentes y cómo solucionarlos:

"El plugin no tiene una cabecera válida": Esto significa que el archivo .zip no se descomprimió correctamente o que no es un plugin válido. Asegúrate de que el archivo que descargaste es realmente de un plugin y no de un tema. Revisa que en la carpeta del plugin exista un archivo llamado nombre-del-plugin.php con la información del plugin.
"Error fatal: ...": Esto suele ocurrir si el plugin es incompatible con tu versión de PHP o de WordPress. Vía FTP, elimina la carpeta del plugin que acabas de subir (la que se creó al descomprimir) para restaurar tu sitio.
Permisos de archivos: Si tienes problemas de permisos, FTP te permite solucionarlo. Haz clic derecho sobre la carpeta del plugin en FileZilla y selecciona "Permisos de archivo". Asegúrate de que esté configurado en 755 para las carpetas y 644 para los archivos. Si ves que los permisos son incorrectos, cámbialos aquí.
El FTP no conecta: Revisa el puerto. Prueba con el 21 y si falla, con el 2106. Asegúrate de que tu proveedor de hosting no bloquee el acceso FTP. Algunos usan SFTP (un tipo de FTP seguro) que requiere un puerto diferente, normalmente el 22. En FileZilla, puedes cambiar el protocolo en el campo "Servidor" escribiendo sftp://tudominio.com.

[TIP] Para evitar problemas de memoria o de tamaño, te recomiendo que siempre que puedas, intentes primero la instalación desde el panel de WordPress. El método FTP es para cuando ese método falla o para solucionar problemas urgentes. Es una herramienta más en tu caja de herramientas.

Conclusión

Instalar plugins WordPress manualmente vía FTP es una habilidad que te sacará de más de un apuro. Aunque al principio pueda parecer técnico, con la práctica se convierte en un proceso mecánico de dos minutos: conectar, subir .zip, descomprimir y activar. Has aprendido a superar los límites del servidor, a gestionar tus archivos directamente y a solucionar errores comunes. Ya no dependes de que el panel de administración funcione perfectamente; ahora tienes el control total de tu instalación. Recuerda siempre usar un cliente FTP fiable como FileZilla, tener a mano tus credenciales de acceso y, sobre todo, mantener la calma si algo sale mal. Con este tutorial WordPress, ya tienes el conocimiento para resolverlo. ¡Practica con un plugin de prueba y verás lo fácil que es!