WP-CLI en cPanel: Comandos básicos para gestionar WordPress por SSH

¿Cansado de hacer clic tras clic en el panel de administración de WordPress para actualizar plugins, borrar caché o cambiar permisos?

Existe una forma mucho más rápida y eficiente de gestionar tu sitio web, especialmente si tu hosting utiliza cPanel.

Hablamos de WP-CLI, una herramienta de línea de comandos que te permite controlar casi todos los aspectos de WordPress escribiendo unas pocas palabras. Aunque parezca cosa de hackers, es más sencillo de lo que crees. En esta guía, pensada para principiantes, te enseñaré a usar WP-CLI en cPanel paso a paso, con los comandos básicos que te harán la vida mucho más fácil.

¿Qué es WP-CLI y por qué deberías usarlo?

WP-CLI (WordPress Command Line Interface) es una herramienta que te permite administrar tu sitio web directamente desde el servidor, sin necesidad de abrir el navegador.

En lugar de ir a "Plugins" y hacer clic en "Actualizar", simplemente escribes un comando como wp plugin update --all y listo.

Las ventajas de usar comandos wp-cli wordpress son enormes:

Velocidad: Las tareas se ejecutan en milisegundos, no en segundos.
Automatización: Puedes programar tareas (como copias de seguridad) con scripts.
Gestión remota: Si usas gestionar wordpress ssh, puedes administrar tu sitio desde cualquier lugar del mundo.
Menos errores: Evitas hacer clic en el lugar equivocado en la interfaz gráfica.
Acceso a funciones avanzadas: Puedes hacer cosas que la interfaz normal no permite fácilmente.

Requisitos previos: ¿Qué necesito para empezar?

Antes de lanzarnos a los comandos, necesitas tener tres cosas claras:

Acceso SSH a tu hosting: No todos los planes de hosting lo incluyen. Debes verificar en tu cPanel que tienes acceso a "Terminal" (a veces llamado "SSH Access").
WordPress instalado: Obviamente, necesitas un sitio WordPress funcionando en tu cuenta de cPanel.
Credenciales de acceso: Tu nombre de usuario y contraseña de SSH (o la clave privada).

[WARNING]
Ten mucho cuidado con los comandos que ejecutas. Un comando mal escrito puede romper tu sitio web. Te recomiendo encarecidamente que hagas una copia de seguridad completa (archivos y base de datos) antes de empezar a experimentar.

Paso 1: Acceder a la Terminal de cPanel

La mayoría de los cPanels modernos incluyen una aplicación de terminal integrada. Aquí te explico cómo acceder:

Inicia sesión en tu cPanel.
Busca la sección "Avanzado" o "Seguridad".
Haz clic en el icono "Terminal".
Se abrirá una ventana negra (o blanca) que simula una consola. ¡Ya estás dentro!

Si no encuentras la opción "Terminal", es porque tu proveedor de hosting no tiene habilitado el acceso SSH en tu plan. En ese caso, tendrás que contactar con su soporte o usar un cliente SSH como PuTTY desde tu ordenador.

Paso 2: Navegar a la carpeta de WordPress

Una vez dentro de la terminal, el primer paso es ir a la carpeta donde está instalado WordPress. Normalmente, en cPanel, los archivos del sitio web están en una carpeta llamada public_html.

Escribe el siguiente comando y presiona Enter:

cd public_html

Si tu WordPress está en una subcarpeta (por ejemplo, public_html/blog), escribe cd public_html/blog.

[TIP]
Para verificar que estás en la carpeta correcta, escribe pwd (print working directory) y presiona Enter. Te mostrará la ruta completa en la que te encuentras.

Paso 3: Verificar que WP-CLI funciona

Antes de ejecutar cualquier comando, es bueno saber si WP-CLI está disponible. Escribe:

wp --info

Si todo está bien, verás información sobre la versión de WP-CLI, la versión de PHP, etc. Si te da un error de "comando no encontrado", significa que WP-CLI no está instalado. No te preocupes, en la mayoría de los cPanels ya viene preinstalado. Si no, tendrás que instalarlo manualmente (algo que explicaré más adelante).

Comandos Básicos de WP-CLI para tu Día a Día

Ahora sí, vamos a lo que te interesa: los comandos. Aquí tienes una guía práctica de los más útiles.

1. Gestión de Plugins y Temas

Esta es una de las tareas más comunes y donde WP-CLI brilla con luz propia.

Ver todos los plugins instalados:
```
wp plugin list
```
Esto te mostrará una tabla con el estado de cada plugin (activo, inactivo, etc.).
Actualizar todos los plugins de una vez:
```
wp plugin update --all
```
¡Adiós a los clics uno a uno!
Actualizar un plugin específico:
```
wp plugin update nombre-del-plugin
```
Activar un plugin:
```
wp plugin activate nombre-del-plugin
```
Desactivar un plugin:
```
wp plugin deactivate nombre-del-plugin
```
Eliminar un plugin (y sus archivos):
```
wp plugin delete nombre-del-plugin
```
Ver los temas instalados:
```
wp theme list
```
Actualizar el tema activo:
```
wp theme update nombre-del-tema
```

[INFO]
Para los nombres de los plugins y temas, debes usar el nombre de la carpeta donde están instalados, no el nombre visible en el panel. Por ejemplo, para WooCommerce, el nombre es woocommerce.

2. Gestión del Núcleo de WordPress

Mantener el núcleo actualizado es crucial para la seguridad.

Ver la versión actual de WordPress:
```
wp core version
```
Actualizar WordPress a la última versión:
```
wp core update
```
Actualizar la base de datos (si es necesario tras una actualización):
```
wp core update-db
```

3. Gestión de Contenido (Entradas y Páginas)

¿Necesitas crear o modificar contenido desde la terminal? Es posible.

Ver las últimas 10 entradas:

wp post list --post_type=post --numberposts=10

Crear una nueva entrada:
```
wp post create --post_title="Mi nuevo post" --post_status=publish
```
Esto creará una entrada vacía y la publicará. Puedes añadir más parámetros como --post_content="Aquí el contenido".
Eliminar una entrada por su ID:
```
wp post delete 123
```
(Reemplaza 123 con el ID real de la entrada).

4. Gestión de Usuarios

Crear o cambiar usuarios también es pan comido.

Crear un nuevo usuario administrador:

wp user create nuevo_usuario correo@ejemplo.com --role=administrator --user_pass=ContraseñaSegura

Cambiar la contraseña de un usuario existente:

wp user update nombre_usuario --user_pass=NuevaContraseña

Listar todos los usuarios:
```
wp user list
```

5. Optimización y Mantenimiento

Estos son mis favoritos porque resuelven problemas comunes al instante.

Limpiar la caché de WordPress:
```
wp cache flush
```
Esto limpia la caché interna de WordPress. Si usas un plugin de caché como W3 Total Cache o WP Super Cache, puede que necesites usar sus propios comandos.
Optimizar la base de datos:
```
wp db optimize
```
Este comando repara y optimiza las tablas de tu base de datos, lo que puede acelerar tu sitio.
Revisar la salud del sitio:
```
wp site health check
```

Solución de Problemas Comunes (FAQ)

"No encuentro la Terminal en mi cPanel"

Como mencioné antes, no todos los hostings ofrecen acceso SSH. Si no ves la opción, contacta con tu proveedor de hosting. Si te dicen que no está disponible, no podrás usar WP-CLI directamente desde cPanel.

"El comando `wp` no se encuentra"

Esto significa que WP-CLI no está instalado en tu servidor. Puedes intentar instalarlo manualmente. Aquí tienes una forma rápida:

Descarga el archivo de WP-CLI: curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
Hazlo ejecutable: chmod +x wp-cli.phar
Muévelo a un directorio del PATH: sudo mv wp-cli.phar /usr/local/bin/wp

[WARNING]
Este método requiere permisos de administrador (sudo). Si no los tienes, tendrás que pedir ayuda a tu proveedor de hosting.

"¿Puedo dañar mi sitio con estos comandos?"

Sí, es posible. Por eso insisto en la precaución. Nunca ejecutes un comando si no sabes qué hace. Siempre es buena idea buscar en Google el comando específico que quieres usar para ver ejemplos y advertencias.

"¿Es lo mismo usar WP-CLI que usar el panel de administración?"

A nivel de resultado, sí, pero WP-CLI es más rápido y eficiente. Es como comparar conducir un coche manual vs. uno automático: el manual te da más control y es más rápido si sabes usarlo.

Consejos Finales para Dominar WP-CLI

Empieza poco a poco: No intentes hacer todo el primer día. Comienza con comandos simples como wp plugin list y ve subiendo la dificultad.
Usa la ayuda integrada: Si no recuerdas los parámetros de un comando, escribe wp help [comando]. Por ejemplo, wp help plugin update.
Crea scripts: Una vez que te sientas cómodo, puedes crear archivos .sh con varios comandos para automatizar tareas complejas, como una copia de seguridad completa.
Combínalo con SSH: Para una gestión más avanzada, puedes usar gestionar wordpress ssh desde tu ordenador local. Es más cómodo y te permite trabajar en varios sitios a la vez.

Conclusión

Aprender a usar WP-CLI en cPanel es una inversión de tiempo que te ahorrará horas de trabajo. Aunque al principio pueda parecer intimidante, la curva de aprendizaje es corta y los beneficios son inmensos.

Desde actualizar todos tus plugins con un solo comando hasta optimizar la base de datos, los comandos wp-cli wordpress te convierten en un administrador mucho más eficiente y te dan un control total sobre tu sitio web.

Anímate a probarlo, empieza con los comandos básicos de esta guía y verás cómo en poco tiempo te preguntarás cómo podías vivir sin esta herramienta.

Si tu hosting es de los que usan Syspanel (el panel de control que antes se conocía como HestiaCP), es importante que sepas que el acceso por terminal se realiza de forma similar, pero el puerto de acceso es el 2106. Es un detalle menor, pero te ahorrará un quebradero de cabeza si intentas conectarte por SSH externamente.

¡Espero que esta guía te haya sido de gran ayuda! Ahora ve y domina tu WordPress como un profesional.