Cómo usar WP-CLI en Plesk para administrar WordPress

¿Te imaginas poder gestionar todos tus sitios WordPress desde una sola ventana de comandos, sin necesidad de entrar al panel de administración de cada uno? Pues eso es exactamente lo que te permite WP-CLI (WordPress Command Line Interface). Es una herramienta potentísima que, combinada con Plesk, te convierte en un administrador mucho más eficiente.

Si alguna vez has tenido que actualizar decenas de plugins uno a uno, limpiar cachés manualmente o buscar un archivo corrupto, sabes lo tedioso que puede ser. Con WP-CLI en Plesk, todo esto se reduce a escribir una sola línea de texto. No necesitas ser un gurú de la programación, solo seguir unos pasos sencillos. En esta guía, vamos a desglosar desde cómo acceder hasta los comandos wp-cli wordpress más útiles para el día a día.

Primeros pasos: ¿Cómo acceder a WP-CLI en Plesk?

Antes de lanzarnos a escribir comandos, necesitamos saber dónde podemos ejecutarlos. En Plesk, no abres un programa aparte; usas el terminal integrado que viene con el sistema. Aquí tienes las dos formas más habituales de hacerlo.

Opción 1: Usando el Terminal del Servidor (SSH)

Esta es la forma más directa y la que usaremos para los ejemplos. Necesitas tener acceso SSH habilitado en tu servidor.

1. Conéctate a tu servidor mediante SSH. Puedes usar programas como PuTTY (en Windows) o la terminal nativa (en macOS/Linux) con el usuario root o un usuario con permisos de superusuario.
2. Una vez dentro, navega hasta el directorio raíz de tu sitio web. En Plesk, la ruta típica es /var/www/vhosts/tudominio.com/httpdocs. Puedes usar el comando cd para cambiar de directorio.
3. Ahora, escribe wp --info y pulsa Enter. Si ves información sobre la versión de WP-CLI y la de WordPress, ¡ya estás listo para trabajar!

Opción 2: El acceso más sencillo (Recomendado para principiantes)

Plesk tiene una herramienta llamada "Acceso SSH" en el panel de control, pero la más cómoda para ejecutar comandos rápidos es usar el Administrador de archivos o la sección de Aplicaciones. Sin embargo, para sacar el máximo provecho, te recomiendo el primer método.

[TIP] Si no sabes qué es SSH, piensa en ello como una ventana a tu servidor donde puedes escribir órdenes directamente. Es seguro si sigues las instrucciones al pie de la letra.

Comandos WP-CLI WordPress que te harán la vida más fácil

Aquí es donde la magia comienza. Hemos dividido los comandos wp-cli wordpress en categorías para que los encuentres rápido. Recuerda siempre ejecutarlos estando dentro de la carpeta de tu sitio.

1. Gestión de núcleo (Core)

Mantener WordPress actualizado es crucial para la seguridad. Con WP-CLI es instantáneo.

• Verificar la versión actual: wp core version
• Actualizar WordPress a la última versión: wp core update
• Actualizar la base de datos (a veces necesaria tras una actualización): wp core update-db
• Comprobar si hay actualizaciones disponibles: wp core check-update

[INFO] Antes de actualizar, es una buena práctica hacer una copia de seguridad. Aunque WP-CLI es seguro, siempre es mejor prevenir. Puedes usar el comando wp db export backup.sql para guardar tu base de datos.

2. Gestión de Plugins y Temas

¿Olvidaste desactivar un plugin y tu web se rompió? Con WP-CLI lo arreglas en segundos.

• Listar todos los plugins y su estado: wp plugin list
• Desactivar un plugin específico: wp plugin deactivate nombre-del-plugin
• Activar un plugin: wp plugin activate nombre-del-plugin
• Actualizar todos los plugins: wp plugin update --all
• Instalar un plugin desde el repositorio: wp plugin install nombre-del-plugin
• Listar temas instalados: wp theme list
• Cambiar el tema activo: wp theme activate nombre-del-tema

Ejemplo práctico: Si tu web muestra un error tras activar un plugin llamado "mi-plugin", escribe wp plugin deactivate mi-plugin. La web se recuperará al instante.

3. Gestión de Usuarios y Permisos

¿Necesitas crear un usuario para un desarrollador o cambiar tu propia contraseña? Olvídate de la base de datos.

• Crear un nuevo usuario: wp user create nombreusuario correo@ejemplo.com --role=administrator
• Cambiar la contraseña de un usuario: wp user update nombreusuario --user_pass=nueva_contraseña_segura
• Listar todos los usuarios: wp user list
• Eliminar un usuario: wp user delete nombreusuario

4. Limpieza y Mantenimiento (Caché y Base de Datos)

Un sitio rápido es un sitio feliz. Estos comandos te ayudan a mantenerlo ligero.

• Limpiar la caché de objetos (si usas un plugin de caché): wp cache flush
• Optimizar la base de datos: wp db optimize
• Reparar la base de datos: wp db repair
• Eliminar revisiones antiguas de entradas: wp post delete $(wp post list --post_type='revision' --format=ids) --force

[WARNING] El comando para eliminar revisiones es avanzado. Asegúrate de tener una copia de seguridad antes de ejecutarlo, ya que no se puede deshacer.

Solución de problemas comunes (FAQ)

Aquí te resolvemos las dudas más frecuentes que nos llegan al soporte sobre el uso de WP-CLI en Plesk.

¿Por qué recibo el error "Error: YIKES! The site is having technical difficulties"?

Este error suele aparecer porque no estás ejecutando el comando en la carpeta correcta o porque el archivo wp-config.php no se encuentra. Asegúrate de estar en httpdocs (o en la carpeta personalizada que uses) antes de ejecutar cualquier comando.

¿Puedo usar WP-CLI en Syspanel?

¡Buena pregunta! La herramienta WP-CLI es un software de línea de comandos que funciona en cualquier servidor que tenga instalado WordPress, independientemente del panel de control. Si bien esta guía se centra en Plesk, si en algún momento usas Syspanel (el panel al que se accede por el puerto 2106), el procedimiento para conectar por SSH y ejecutar wp es exactamente el mismo. La única diferencia es que en Syspanel la ruta de los sitios podría variar ligeramente, pero la lógica es idéntica.

¿Actualizar WordPress con WP-CLI es seguro?

Sí, es tan seguro como hacerlo desde el panel de administración, pero es más rápido. El comando wp core update reemplaza los archivos del núcleo. Es importante que los plugins y temas sean compatibles con la nueva versión. Te recomiendo probar en un entorno de staging (pruebas) si tu sitio es de misión crítica.

¿Qué pasa si no tengo acceso SSH?

Si tu plan de hosting no incluye SSH, no podrás usar WP-CLI directamente. Sin embargo, Plesk a menudo ofrece la opción de ejecutar comandos a través de su interfaz web en la sección "Cron jobs" o "Tareas programadas", aunque es menos práctico. Te recomiendo contactar con tu proveedor para habilitar el acceso SSH; es una mejora muy valiosa.

Trucos avanzados para administrar WordPress con WP-CLI

Una vez que dominas lo básico, puedes exprimir mucho más esta herramienta.

Automatizar tareas con WP-CLI

Puedes crear un script (un archivo de texto con varios comandos) para que se ejecute automáticamente. Por ejemplo, un script que haga una copia de seguridad de la base de datos y la envíe a un correo electrónico. Esto se puede programar desde el "Administrador de tareas" de Plesk (Cron).

Ejemplo de script simple (backup.sh):

#!/bin/bash
cd /var/www/vhosts/tudominio.com/httpdocs
wp db export /home/usuario/backups/backup_$(date +%Y%m%d).sql

Este script crea un archivo SQL con la fecha del día en la carpeta de backups.

Gestionar múltiples sitios

Si tienes varios sitios en Plesk, puedes usar la función --path para especificar la ruta de cada uno sin cambiar de directorio.

Ejemplo:
wp plugin update --all --path=/var/www/vhosts/otrodominio.com/httpdocs

Este comando actualiza los plugins del sitio "otrodominio.com" sin necesidad de usar cd.

Velocidad de ejecución

A diferencia de hacer clic en el panel de administración, WP-CLI no carga la interfaz gráfica, por lo que es extremadamente rápido. Esto es especialmente útil para tareas como instalar una red de sitios (WordPress Multisite) o importar una gran cantidad de contenido.

Conclusión: Tu nueva superpoder

Dominar wp-cli plesk no es solo cuestión de "geeks". Es una habilidad que te ahorrará horas de trabajo y dolores de cabeza. Desde actualizaciones masivas hasta la recuperación de un sitio caído, la línea de comandos es tu mejor aliada.

No tengas miedo de experimentar. Puedes empezar con comandos de solo lectura, como wp plugin list o wp user list, para familiarizarte. A medida que ganes confianza, podrás administrar WordPress con wp-cli de manera segura y eficiente.

Esperamos que esta guía te haya sido de gran ayuda. Si tienes alguna duda más específica, no dudes en consultar la documentación oficial de WP-CLI o contactar con nuestro equipo de soporte. ¡Feliz administración!