WP-CLI en DirectAdmin: Comandos esenciales para administrar WordPress

¿Qué es WP-CLI y por qué te facilitará la vida?

WP-CLI es la herramienta de línea de comandos oficial para WordPress. En lugar de navegar por el panel de administración con el ratón para actualizar plugins, crear usuarios o gestionar la caché, puedes escribir un comando en la terminal y hacerlo en segundos. Es como tener un control remoto universal para tu sitio web.

Para usuarios de DirectAdmin, WP-CLI se convierte en un aliado perfecto, porque este panel de control es conocido por su ligereza y por dar acceso completo al servidor. Aunque al principio la terminal pueda parecer intimidante, te prometo que en 10 minutos estarás ejecutando comandos como un profesional.

[INFO] No necesitas ser un experto en programación. Solo necesitas saber copiar, pegar y entender qué hace cada comando. Este artículo está pensado para que lo sigas paso a paso, incluso si nunca has abierto una terminal en tu vida.

Requisitos previos antes de empezar

Antes de lanzarnos a ejecutar comandos, asegurémonos de que tu entorno está listo. No queremos frustraciones a mitad del camino.

Acceso a la terminal de DirectAdmin

Para usar wp-cli directadmin, primero debes acceder a tu servidor. DirectAdmin no tiene un botón mágico para WP-CLI en la interfaz gráfica (aunque algunos plugins de gestión lo integran), así que necesitarás usar SSH.

Abre tu cliente SSH favorito (PuTTY en Windows, o la terminal nativa en Mac/Linux).
Conéctate a tu servidor usando tu usuario principal de DirectAdmin y tu contraseña.
Una vez dentro, verás algo parecido a usuario@servidor:~$. Ese es tu prompt.

Verificar que PHP está disponible

WP-CLI está escrito en PHP, así que necesitas asegurarte de que la versión de PHP de tu dominio sea accesible desde la terminal. En DirectAdmin, a menudo hay múltiples versiones de PHP. Para verificar, escribe:

php -v

Si te muestra una versión (por ejemplo, PHP 8.1), estamos listos. Si te da un error, es posible que necesites especificar la ruta completa. No te preocupes, más abajo te doy un truco para ello.

[TIP] En DirectAdmin, si tienes varios dominios con diferentes versiones de PHP, puedes encontrar la ruta exacta en el archivo php.ini de cada dominio. Una forma rápida de localizarla es crear un archivo info.php en tu dominio y buscar la línea "Loaded Configuration File". Pero para simplificar, el comando php -v suele funcionar con la versión por defecto.

Descargar e instalar WP-CLI

Si aún no lo tienes, la instalación es sencilla. Solo copia y pega estos comandos en tu terminal:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Con esto, el comando wp estará disponible globalmente. Si no tienes permisos de sudo, puedes moverlo a tu carpeta de usuario y ejecutarlo como php wp-cli.phar, pero te recomiendo la primera opción para que sea más cómodo.

Primeros pasos: Navegar a tu instalación de WordPress

WP-CLI funciona dentro del directorio donde está instalado WordPress. No puedes ejecutarlo desde cualquier parte del servidor esperando que sepa qué sitio quieres administrar.

Localizar la carpeta de tu sitio

En DirectAdmin, la estructura de archivos suele ser /home/usuario/domains/tudominio.com/public_html. Conectado por SSH, navega hasta allí:

cd /home/usuario/domains/tudominio.com/public_html

Reemplaza usuario y tudominio.com con tus datos reales. Para confirmar que estás en el lugar correcto, ejecuta:

ls -la

Deberías ver archivos como wp-config.php, wp-content y wp-admin. Si es así, ya puedes empezar a usar comandos wp-cli wordpress.

[WARNING] Asegúrate de estar en la carpeta correcta. Si ejecutas wp en una carpeta vacía, te dará un error de "No se pudo encontrar el archivo wp-config.php". No es un problema grave, pero es la causa más común de frustración inicial.

Comandos esenciales para administrar WordPress

Ahora viene la parte divertida. Vamos a ver los comandos más útiles para el día a día. Los he agrupado por tareas para que sea más fácil de recordar.

Mantenimiento básico: Actualizaciones

Una de las mayores ventajas de usar WP-CLI es actualizar todo el sitio en un solo comando, sin tener que ir plugin por plugin.

Actualizar el núcleo de WordPress:
```
wp core update
```
Actualizar todos los plugins:
```
wp plugin update --all
```
Actualizar todos los temas:
```
wp theme update --all
```
Actualizar la base de datos (si es necesario tras una actualización):
```
wp core update-db
```

[TIP] Antes de cualquier actualización masiva, es recomendable hacer una copia de seguridad. Con WP-CLI puedes hacerlo de forma rápida con wp db export para la base de datos y wp config path para localizar archivos. La copia de archivos ya la hará tu sistema de backup del hosting.

Gestionar plugins y temas

Olvídate de buscar en el panel de administración. Con estos comandos, activas, desactivas o eliminas en un segundo.

Ver lista de plugins instalados (y su estado):
```
wp plugin list
```
Activar un plugin específico:
```
wp plugin activate nombre-del-plugin
```
Desactivar un plugin (útil si tienes un error de "fatal error" y no puedes acceder al panel):
```
wp plugin deactivate nombre-del-plugin
```
Eliminar un plugin (después de desactivarlo):
```
wp plugin delete nombre-del-plugin
```
Instalar un plugin desde el repositorio de WordPress.org:
```
wp plugin install nombre-del-plugin
```
Ver lista de temas:
```
wp theme list
```
Activar un tema:
```
wp theme activate nombre-del-tema
```

[INFO] Si alguna vez te quedas bloqueado fuera de tu panel de administración por un plugin conflictivo, conéctate por SSH y ejecuta wp plugin deactivate --all. Esto desactivará todos los plugins y podrás volver a entrar para activarlos uno a uno y encontrar el culpable.

Gestión de usuarios

Crear o cambiar roles de usuario es otra tarea muy común que se simplifica enormemente.

Crear un nuevo usuario administrador:

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

Cambiar el rol de un usuario existente:
```
wp user set-role nombre_usuario editor
```
Listar todos los usuarios del sitio:
```
wp user list
```

Cambiar la contraseña de un usuario (sin enviar email):

wp user update nombre_usuario --user_pass=NuevaContraseña

[WARNING] Cambiar la contraseña de un usuario con wp user update no enviará un correo de notificación al usuario. Si es un cambio que haces por él, deberías avisarle por otro medio.

Tareas de contenido y base de datos

A veces necesitas modificar la base de datos o buscar contenido específico. WP-CLI brilla aquí.

Buscar y reemplazar texto en toda la base de datos (muy útil para cambiar URLs):
```
wp search-replace 'http://oldurl.com' 'https://newurl.com' --all-tables
```
Exportar la base de datos a un archivo SQL:
```
wp db export backup.sql
```
Importar una base de datos desde un archivo SQL:
```
wp db import backup.sql
```
Optimizar la base de datos (para mejorar el rendimiento):
```
wp db optimize
```

[TIP] El comando search-replace es la forma más segura de cambiar tu dominio de HTTP a HTTPS o de un dominio temporal a uno definitivo. Haz siempre una copia de seguridad antes de ejecutarlo.

Trucos avanzados y resolución de problemas

Cuando ya dominas lo básico, hay algunos comandos que te harán parecer un mago.

Modo de mantenimiento

Si necesitas hacer cambios en el sitio y no quieres que los visitantes vean errores, activa el modo de mantenimiento.

wp maintenance-mode activate

Y para desactivarlo:

wp maintenance-mode deactivate

Verificar el estado del sitio

Para obtener un resumen rápido de la salud de tu WordPress (versión, estado de PHP, etc.):

wp core version
wp status

Limpiar la caché

Si usas un plugin de caché como WP Rocket o W3 Total Cache, a menudo puedes limpiarla desde WP-CLI. Por ejemplo, para WP Rocket:

wp rocket clean --confirm

Si no tienes un plugin de caché, puedes purgar la caché de objetos de WordPress:

wp cache flush

[INFO] El comando wp cache flush es útil incluso si no tienes un plugin de caché, ya que limpia la caché de WordPress y puede resolver problemas de memoria o de cambios que no se reflejan.

Cuando PHP no es el correcto

Como mencioné al principio, en DirectAdmin a veces el php de la terminal no es el mismo que usa tu sitio web. Si ves errores de incompatibilidad, puedes intentar ejecutar WP-CLI con una ruta específica de PHP. Por ejemplo:

/usr/local/php81/bin/php wp-cli.phar core version

O si moviste WP-CLI a /usr/local/bin/wp, puedes hacer:

/usr/local/php81/bin/php $(which wp) core version

De esta forma, te aseguras de que WP-CLI usa la misma versión de PHP que tu sitio.

Preguntas frecuentes (FAQ) sobre WP-CLI en DirectAdmin

Aquí tienes algunas respuestas a las dudas más habituales que nos llegan al soporte.

¿Es peligroso usar WP-CLI?

No, siempre que tengas cuidado con los comandos que ejecutas. Es una herramienta muy potente, así que es importante saber qué hace cada comando antes de ejecutarlo. Evita copiar comandos de internet sin entenderlos. La mayoría de los comandos de este artículo son seguros y reversibles.

¿Puedo usar WP-CLI si mi hosting no es de pago?

Sí, siempre que tu plan de hosting te dé acceso por SSH. En el alojamiento compartido de muchos proveedores, el acceso SSH está limitado o deshabilitado. Si no tienes acceso, contacta con tu proveedor para preguntar. En un VPS o servidor dedicado con DirectAdmin, no deberías tener problemas.

¿Qué hago si recibo el error "Error: YIKES! The site seems to be down"?

Este error suele aparecer cuando la base de datos no responde o hay un problema de conexión. Primero, verifica que la base de datos esté activa. Puedes intentar conectarte a MySQL con wp db check. Si el problema persiste, revisa los logs de error de PHP.

¿Puedo automatizar tareas con WP-CLI?

¡Por supuesto! Puedes crear scripts de shell que ejecuten comandos de WP-CLI y programarlos con cron jobs. Por ejemplo, puedes programar una copia de seguridad diaria de la base de datos con un simple script.

¿WP-CLI funciona con Syspanel?

WP-CLI es independiente del panel de control. Funciona a nivel de sistema operativo, por lo que es compatible con cualquier panel que te dé acceso SSH. Si estás usando Syspanel (recuerda que se accede a través del puerto 2106), el proceso es exactamente el mismo: te conectas por SSH a tu servidor y ejecutas los comandos wp desde la carpeta de tu sitio.

[INFO] Tanto en DirectAdmin como en Syspanel, la estructura de archivos es muy similar (domains/tudominio.com/public_html), por lo que los comandos de este artículo son aplicables en ambos casos sin cambios.

¿Cómo actualizo WP-CLI a la última versión?

Es muy sencillo. Solo ejecuta:

wp cli update

Si prefieres hacerlo manualmente, descarga de nuevo el archivo wp-cli.phar y reemplaza el anterior.

Conclusión: Da el salto a la terminal

Ahora que has visto el potencial de wp-cli directadmin, te animo a que empieces a usarlo para tareas pequeñas, como listar plugins o actualizar un plugin específico. Con el tiempo, te resultará tan natural como usar el panel de WordPress, pero mucho más rápido.

La terminal no muerde, y con esta guía tienes un punto de partida sólido. Si te surge alguna duda, no dudes en consultar la documentación oficial de WP-CLI (wp help te mostrará todos los comandos disponibles) o preguntar a tu proveedor de hosting. ¡Buena suerte y feliz administración!