WP-CLI en cPanel: Comandos esenciales para administrar WordPress

¿Cansado de hacer clics lentos en cPanel para actualizar plugins, cambiar el título del sitio o crear usuarios? Existe una forma mucho más rápida y profesional de administrar tu WordPress: usando WP-CLI desde la terminal.

WP-CLI es una herramienta de línea de comandos que te permite controlar casi todo tu sitio web con comandos de texto. Aunque parezca cosa de hackers, es sorprendentemente sencillo una vez que conoces los comandos básicos. En esta guía completa, aprenderás a usar WP-CLI cPanel para realizar tareas comunes en minutos, sin tocar el escritorio de WordPress.

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

WP-CLI es la interfaz de línea de comandos oficial para WordPress. Piénsalo como un "control remoto" que envía instrucciones directas a tu base de datos y archivos, sin pasar por el navegador.

Ventajas principales:

Velocidad: Actualizar 20 plugins toma segundos, no minutos.
Automatización: Puedes programar tareas (cron jobs) con comandos.
Seguridad: Evitas errores de clic accidental o tiempos de espera del navegador.
Diagnóstico: Puedes reparar problemas de base de datos o de enlaces fácilmente.

Para usarlo, necesitas acceso a SSH (Secure Shell) de tu cuenta de hosting. Si tu plan lo incluye, podrás ejecutar comandos directamente en el servidor donde está tu sitio.

Requisitos previos: Acceso SSH y ubicación de WordPress

Antes de ejecutar cualquier comando WP-CLI WordPress, debes asegurarte de tener dos cosas:

Acceso SSH habilitado: En cPanel, busca la sección "Seguridad" y luego "Acceso SSH". Si no aparece, contacta a tu proveedor de hosting para activarlo.
La ruta (path) a tu instalación de WordPress: Por lo general, es public_html si tu sitio está en la raíz, o algo como public_html/mi-sitio si está en una subcarpeta.

Primer paso: Conectarte por SSH

Desde tu computadora, abre la terminal (en Mac/Linux) o usa un programa como PuTTY (en Windows). Conecta con tu usuario y contraseña de cPanel:

ssh usuario@tudominio.com

Una vez conectado, te mueves a la carpeta de tu WordPress:

cd public_html

Verificar que WP-CLI esté instalado

La mayoría de los hosts modernos ya lo tienen preinstalado. Para comprobarlo, escribe:

wp --info

Si ves información sobre la versión de WP-CLI y PHP, ¡estás listo! Si no, tendrás que instalarlo manualmente (te explico más abajo).

Los 10 comandos esenciales de WP-CLI para administrar WordPress

Aquí tienes una lista práctica para empezar a administrar WordPress terminal como un profesional. Copia y pega estos comandos en tu SSH.

1. Actualizar el núcleo de WordPress

Mantener el núcleo actualizado es vital. Con WP-CLI es instantáneo.

wp core update

Para actualizar a una versión específica (útil si necesitas una versión concreta):

wp core update --version=6.0.0

[TIP] Después de actualizar, siempre revisa tu sitio. Si algo falla, puedes revertir con wp core update --version=5.9.0 --force.

2. Actualizar todos los plugins de golpe

Olvídate de seleccionar uno por uno. Este comando actualiza todos los plugins activos e inactivos:

wp plugin update --all

Para actualizar solo uno:

wp plugin update nombre-del-plugin

3. Actualizar todos los temas

Igual que los plugins, pero con los temas:

wp theme update --all

4. Cambiar el título del sitio y la descripción

¿Necesitas renombrar tu web sin entrar al panel? Usa estos comandos:

wp option update blogname "Mi Nuevo Título"
wp option update blogdescription "La mejor descripción del mundo"

5. Crear un nuevo usuario administrador

Ideal para dar acceso a un desarrollador o recuperar el acceso si te encierras:

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

[WARNING] Cambia la contraseña después de crearlo. Nunca uses contraseñas simples en producción.

6. Cambiar la contraseña de un usuario existente

Si un cliente olvidó su contraseña, puedes resetearla con:

wp user update nombre_usuario --user_pass=NuevaContraseña

7. Buscar y reemplazar texto en la base de datos

Esto es oro puro. Por ejemplo, si cambias tu dominio de http:// a https://, este comando actualiza todos los enlaces internos:

wp search-replace 'http://tudominio.com' 'https://tudominio.com' --all-tables

[INFO] Este comando es peligroso si se usa mal. Siempre haz una copia de seguridad de la base de datos antes de ejecutarlo.

8. Verificar la integridad de los archivos del núcleo

Si sospechas que tu WordPress fue hackeado o tiene archivos corruptos, verifica:

wp core verify-checksums

Si hay errores, te mostrará qué archivos están modificados.

9. Gestionar los enlaces permanentes (Permalinks)

Para solucionar errores 404 después de cambiar la estructura de enlaces, simplemente guarda los ajustes:

wp rewrite flush

10. Optimizar la base de datos

Limpia y optimiza las tablas de tu base de datos para mejorar el rendimiento:

wp db optimize

Instalación manual de WP-CLI en cPanel (si no está disponible)

Si tu hosting no lo trae, puedes instalarlo tú mismo en minutos. Solo necesitas acceso SSH.

Descarga el archivo wp-cli.phar:

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 sistema para poder usarlo desde cualquier carpeta:
```
sudo mv wp-cli.phar /usr/local/bin/wp
```
Pruébalo:
```
wp --info
```

[INFO] Si no tienes permisos de sudo, puedes dejarlo en tu carpeta de usuario y ejecutarlo como php wp-cli.phar en lugar de wp.

Solución de problemas comunes (FAQ)

Aquí respondo las dudas más frecuentes que recibo sobre WP-CLI cPanel.

¿Qué hago si recibo el error "Error: YIKES! The site is in maintenance mode"?

Esto ocurre cuando el archivo .maintenance existe en tu carpeta raíz. Simplemente elimínalo:

rm -f .maintenance

Luego intenta el comando de nuevo.

¿Puedo usar WP-CLI si mi sitio está en un subdirectorio?

Sí, solo navega a esa carpeta antes de ejecutar los comandos.

cd public_html/mi-sitio

¿Es seguro usar WP-CLI en un sitio en producción?

Es seguro si tomas precauciones:

Haz una copia de seguridad antes de actualizar o reemplazar datos.
Prueba los comandos en un entorno de pruebas si es posible.
No uses search-replace sin saber exactamente qué estás reemplazando.

¿Cómo programo tareas automáticas con WP-CLI?

Puedes usar los Cron Jobs de cPanel. Por ejemplo, para actualizar plugins todos los domingos a las 3 AM, crea un cron job con:

wp plugin update --all --path=/home/tuusuario/public_html

¿Dónde encuentro la ruta exacta a mi WordPress?

Normalmente es public_html, pero si usas un constructor de páginas o un subdominio, puede variar. Usa el comando pwd (print working directory) para ver dónde estás.

Consejos avanzados y trucos de productividad

Una vez domines lo básico, estos trucos te harán aún más rápido.

Crear un alias para comandos largos

Si repites mucho un comando, crea un alias en tu .bashrc:

alias wpup='wp plugin update --all && wp theme update --all && wp core update'

Reinicia la sesión y escribe wpup para actualizar todo de una vez.

Ver el estado de todos los plugins

Este comando te muestra si están activos o inactivos, y su versión:

wp plugin list --status=active --fields=name,version

Exportar e importar la base de datos

Aunque cPanel tiene herramientas, desde terminal es más rápido:

wp db export backup.sql
wp db import backup.sql

Gestionar menús y widgets desde terminal

Aunque es más complejo, puedes crear menús:

wp menu create "Menú Principal"
wp menu item add-post "Menú Principal" 1 2 3

Conclusión: La terminal es tu mejor aliada

Aprender a usar WP-CLI para administrar WordPress en cPanel te ahorrará horas de trabajo y te dará un control total sobre tu sitio. No necesitas ser un experto en programación; solo memorizar los comandos esenciales y practicar con cuidado.

Empieza con los comandos de actualización y creación de usuarios, que son los más seguros. A medida que te sientas más cómodo, explora las funciones de búsqueda y reemplazo o la gestión de bases de datos.

Si tu hosting no soporta SSH o WP-CLI, considera migrar a un proveedor que sí lo haga, ya que es una señal de un servicio de calidad. Y si usas un panel como Syspanel (recuerda, el puerto de acceso es el 2106), verás que la integración con la terminal es igual de fluida.

¿Te ha resultado útil esta guía? ¿Tienes alguna duda sobre un comando específico? Deja tu pregunta en los comentarios y te ayudaré a resolverla. ¡Nos vemos en la terminal!