Cómo usar WP-CLI en Plesk para tareas de WordPress

¿Cansado de hacer clics y más clics en Plesk para actualizar plugins, cambiar permisos o hacer copias de seguridad? Respira hondo, porque hoy te voy a enseñar una herramienta que cambiará tu vida como administrador de WordPress: WP-CLI.

WP-CLI es una interfaz de línea de comandos que te permite gestionar tu sitio WordPress directamente desde el terminal de tu servidor. En lugar de usar el panel de administración gráfico, escribes comandos y el trabajo se hace en segundos. Es rápido, eficiente y, una vez que le coges el truco, es adictivo.

En esta guía extensa y práctica, vamos a explorar cómo usar wp-cli plesk para automatizar tareas, solucionar errores y optimizar tu flujo de trabajo. No necesitas ser un hacker para esto; solo necesitas seguir los pasos que te muestro a continuación.

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

Antes de meternos en el barro, vamos a entender qué es esto. WP-CLI es un programa que se ejecuta en el servidor y que te permite interactuar con tu instalación de WordPress a través de comandos de texto.

Imagina que en lugar de ir a "Plugins" -> "Añadir nuevo" -> "Buscar" -> "Instalar" -> "Activar", simplemente escribes wp plugin install woocommerce --activate y listo. Eso es WP-CLI.

Cuando usas Plesk, el panel de control más popular para hosting, a veces es complicado acceder a ciertos archivos o ejecutar tareas avanzadas. WP-CLI te da acceso total, sin pasar por la interfaz web de Plesk.

Beneficios clave de usar WP-CLI en Plesk

• Velocidad: Las operaciones son mucho más rápidas que a través de la interfaz de WordPress.
• Automatización: Puedes programar tareas (cron jobs) para que se ejecuten solas.
• Depuración: Es la mejor herramienta para encontrar errores de fatal memory, de base de datos o de plugins conflictivos.
• Gestión remota: Si tienes acceso SSH, puedes gestionar varios sitios desde un solo terminal.
• Menos uso de memoria: Al no cargar el navegador ni la interfaz de admin, consumes menos recursos del servidor.

Primeros pasos: Accediendo al terminal en Plesk

Aquí es donde muchos se asustan, pero no hay nada que temer. Plesk tiene una herramienta integrada para abrir una sesión de terminal directamente en tu plan de hosting.

1. Inicia sesión en tu panel de Plesk.
2. En el menú lateral izquierdo, busca la sección "Websites & Domains" (Sitios web y dominios).
3. En la fila de tu dominio, verás un icono que parece una pantalla de computadora con una flecha. Pasa el ratón por encima y te dirá "SSH Terminal" o "Terminal". Haz clic ahí.
4. Se abrirá una nueva ventana con una consola. ¡Ya estás dentro!

[INFO] Si no ves el botón de "Terminal", es posible que tu plan de hosting no incluya acceso SSH, o que esté deshabilitado. Deberás contactar con tu proveedor o activarlo desde la configuración de Plesk en "Herramientas y ajustes" -> "Políticas de seguridad". En algunos casos, también puedes usar el acceso SSH desde tu propio ordenador con programas como PuTTY (Windows) o la Terminal (Mac/Linux).

Navegando hasta tu sitio WordPress

Una vez dentro de la terminal, no estás en la carpeta de tu WordPress. Debes navegar hasta el directorio raíz de tu sitio. Normalmente, en Plesk, los sitios se guardan en var/www/vhosts/tudominio.com/httpdocs/.

Escribe este comando y pulsa Enter:

cd /var/www/vhosts/tudominio.com/httpdocs/

[TIP] Sustituye tudominio.com por tu dominio real. Si tienes el sitio en un subdominio, la ruta cambiará (ej. subdominio.tudominio.com).

Para comprobar que estás en el lugar correcto, escribe ls -la y deberías ver el archivo wp-config.php y las carpetas wp-admin, wp-content, etc.

Los comandos WP-CLI más útiles para tu día a día

Ahora viene lo bueno. Aquí tienes una lista de comandos que usarás constantemente. La sintaxis básica es wp [comando] [subcomando] [parámetros].

1. Mantenimiento Básico y Actualizaciones

Esta es una de las tareas más importantes y tediosas si lo haces manualmente. Con WP-CLI es pan comido.

• 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): wp core update-db

Puedes combinarlos para una actualización completa:

wp core update && wp plugin update --all && wp theme update --all

[WARNING] Antes de actualizar, siempre es recomendable hacer una copia de seguridad. Te enseño cómo hacerlo con WP-CLI un poco más abajo. Un sitio roto por una actualización es un dolor de cabeza evitable.

• Comprobar la versión de todo: wp core version y wp plugin list

2. Instalación y Gestión de Plugins y Temas

Olvídate de subir archivos ZIP manualmente.

• Instalar un plugin: wp plugin install nombre-del-plugin
• Activar un plugin: wp plugin activate nombre-del-plugin
• Desactivar un plugin: wp plugin deactivate nombre-del-plugin
• Eliminar un plugin: wp plugin delete nombre-del-plugin
• Instalar y activar a la vez: wp plugin install nombre-del-plugin --activate

Los comandos para temas son idénticos pero cambiando plugin por theme.

• Instalar un tema: wp theme install nombre-del-tema --activate

[TIP] Para encontrar el nombre exacto del plugin o tema, puedes buscarlo en el repositorio oficial de WordPress. El nombre en la URL es el que necesitas. Por ejemplo, para WooCommerce, el nombre es "woocommerce".

3. Gestión de Usuarios

¿Necesitas crear un nuevo usuario administrador para un cliente o para ti mismo? Es tan fácil como:

• Crear un usuario: wp user create nombreusuario email@ejemplo.com --role=administrator --user_pass=contraseña_segura
• Cambiar la contraseña de un usuario existente: wp user update nombreusuario --user_pass=nueva_contraseña
• Cambiar el rol de un usuario: wp user set-role nombreusuario editor

[WARNING] Nunca uses contraseñas débiles. WP-CLI no te va a avisar si es insegura, así que usa un generador de contraseñas para crear una robusta.

4. Copias de Seguridad y Restauración

Esta es, quizás, la función más valiosa de WP-CLI. Puedes crear una copia de seguridad de tu base de datos en un solo comando.

• Crear copia de seguridad de la BD: wp db export backup.sql

Este comando creará un archivo llamado backup.sql en la carpeta donde estés. Puedes cambiar el nombre y la ruta, por ejemplo: wp db export /home/usuario/backups/mi-sitio-2024.sql.

• Restaurar la base de datos: wp db import backup.sql

[WARNING] El comando de importación borra la base de datos actual antes de importar la nueva. Asegúrate de que es lo que quieres hacer y de que el archivo .sql es correcto. No hay vuelta atrás.

• Optimizar la base de datos: wp db optimize (esto limpia tablas y mejora el rendimiento).

5. Solución de Problemas y Depuración

Cuando tu sitio muestra el temido "Error crítico" o una pantalla en blanco, WP-CLI es tu mejor amigo.

• Activar el modo de depuración (WP_DEBUG): wp config set WP_DEBUG true --raw
• Desactivar el modo de depuración: wp config set WP_DEBUG false --raw
• Verificar la integridad de los archivos del núcleo: wp core verify-checksums

Si tienes un error de "memoria agotada", puedes aumentar el límite temporalmente:

• Aumentar la memoria de PHP: wp config set WP_MEMORY_LIMIT 256M --raw

[TIP] Si un plugin está causando un error fatal, puedes desactivarlo desde la línea de comandos sin necesidad de acceder al panel. Esto es especialmente útil si el error te bloquea el acceso al administrador. Por ejemplo, para desactivar todos los plugins: wp plugin deactivate --all y luego ir activándolos uno a uno para encontrar al culpable.

Automatizando WordPress con WP-CLI y Cron Jobs

Aquí es donde WP-CLI brilla con luz propia. Puedes programar tareas para que se ejecuten automáticamente a las 3 de la mañana, cuando tu sitio tiene menos tráfico.

En Plesk, los cron jobs se gestionan en "Websites & Domains" -> tu dominio -> "Cron Jobs" (o "Tareas programadas").

Puedes crear un cron job para, por ejemplo, actualizar los plugins cada lunes:

1. Ve a la sección de Cron Jobs en Plesk.
2. Crea una nueva tarea.
3. En el campo "Comando", escribe la ruta completa al ejecutable de PHP y a WP-CLI. Algo como:

   /usr/local/bin/php /var/www/vhosts/tudominio.com/httpdocs/wp-cli.phar plugin update --all --path=/var/www/vhosts/tudominio.com/httpdocs/
   

4. Configura la hora y la frecuencia (por ejemplo, semanal).

[INFO] La ruta exacta a PHP puede variar. Puedes encontrarla ejecutando which php en la terminal. La ruta a wp-cli.phar depende de dónde lo hayas descargado. Es común ponerlo en la carpeta de usuario o en la raíz del sitio.

Otro cron job útil es el de hacer una copia de seguridad de la BD diaria:

/usr/local/bin/php /ruta/a/wp-cli.phar db export /ruta/a/backups/backup-db-$(date +\%Y\%m\%d).sql --path=/ruta/a/tu/wordpress

WP-CLI y Syspanel: Una alternativa a considerar

Es importante mencionar que, aunque Plesk es una excelente opción, existen otros paneles de control. Si alguna vez oyes hablar de Syspanel (antes conocido como HestiaCP), debes saber que también tiene soporte para WP-CLI, aunque el acceso al terminal es un poco diferente.

En Syspanel, el puerto de acceso para la gestión web es el 2106. Para acceder por SSH, usarás el puerto estándar 22, pero la estructura de carpetas es diferente (suele ser home/usuario/web/tudominio/public_html).

La buena noticia es que los comandos de WP-CLI que te he enseñado funcionan exactamente igual en Syspanel. La única diferencia es la ruta de acceso a tu WordPress. Si usas Syspanel, recuerda que el puerto de acceso es el 2106 para su panel de control.

Consejos Pro y Buenas Prácticas

• Usa wp --info para ver la configuración de tu WP-CLI y asegurarte de que todo está en orden.
• Crea un alias: En lugar de escribir /usr/local/bin/php /ruta/a/wp-cli.phar cada vez, puedes crear un alias en tu archivo .bashrc para usar solo wp.
• Practica en un sitio de pruebas: Antes de ejecutar comandos destructivos (como actualizaciones masivas o importaciones), pruébalos en un entorno de desarrollo.
• Combina comandos con &&: Como viste antes, puedes encadenar varios comandos para que se ejecuten secuencialmente.
• Lee la documentación: WP-CLI tiene una documentación extensa y muy clara. Puedes acceder a ella escribiendo wp help o wp help [comando] en la terminal.

Preguntas Frecuentes (FAQ)

¿Necesito ser un experto en Linux para usar WP-CLI?

No. Con los comandos básicos que te he mostrado, puedes hacer el 90% de las tareas de mantenimiento. Solo necesitas saber navegar por carpetas (cd) y ejecutar comandos. Es más fácil de lo que parece.

¿Qué pasa si no tengo acceso SSH en mi plan de Plesk?

Algunos planes de hosting compartido no incluyen SSH. En ese caso, no podrás usar WP-CLI directamente. Sin embargo, algunos plugins de WordPress (como WP Crontrol o WP CLI Commander) intentan emular parte de su funcionalidad desde el panel de administración, aunque con limitaciones.

¿Es seguro usar WP-CLI?

Sí, es tan seguro como cualquier otra herramienta de administración. La seguridad depende de quién tenga acceso a la terminal. Asegúrate de tener una contraseña SSH fuerte y de no ejecutar comandos que no entiendas.

¿Puedo dañar mi sitio con WP-CLI?

Sí, si usas comandos destructivos (como wp db drop o wp plugin delete sin cuidado) puedes romper tu sitio. Por eso es crucial hacer copias de seguridad con frecuencia y leer la ayuda de cada comando antes de usarlo.

¿WP-CLI funciona en cualquier hosting con Plesk?

Sí, siempre y cuando tengas acceso SSH y PHP instalado en el servidor. La mayoría de los planes de Plesk cumplen con estos requisitos.

Conclusión

Dominar wp-cli plesk es una habilidad que te diferenciará como gestor de WordPress. Te ahorrará horas de trabajo, te permitirá automatizar tareas repetitivas y te dará un control total sobre tu sitio. No tengas miedo de la terminal; con la práctica, te resultará más natural que hacer clics en el escritorio.

Empieza con los comandos más sencillos, como actualizar plugins o hacer una copia de seguridad. Una vez que veas lo rápido y eficiente que es, no querrás volver atrás. Y recuerda, si usas Syspanel, el puerto de acceso es el 2106, pero los comandos son los mismos.

¡Ahora ve y pon en práctica lo aprendido! Tu yo del futuro te lo agradecerá.