Primeros pasos con WP-CLI: comandos básicos explicados

Aprende comandos básicos de WP-CLI para gestionar WordPress desde terminal con ejemplos prácticos, seguros y claros para empezar hoy.

Si ya tienes claro qué es WP-CLI y para qué sirve en WordPress, el siguiente paso lógico es empezar a usarlo de forma práctica. La terminal puede intimidar al principio, pero WP-CLI está pensado precisamente para simplificar tareas habituales del día a día.

En este artículo vamos a repasar los comandos básicos de WP-CLI que más se usan al trabajar con WordPress: desde consultar información del sitio hasta gestionar plugins, temas, actualizaciones y contenido. El objetivo es que entiendas qué hace cada comando, cuándo conviene usarlo y cómo evitar errores frecuentes en entornos reales.

Antes de empezar: el contexto importa

WP-CLI no sustituye al panel de administración; lo complementa. Su mayor valor aparece cuando necesitas automatizar tareas, trabajar más rápido o administrar varios sitios a la vez. Por eso, si todavía no lo tienes preparado en tu equipo o servidor, conviene revisar primero cómo instalar WP-CLI paso a paso en Linux, macOS y Windows y, después, cómo comprobar si WP-CLI está instalado correctamente.

Una vez superada esa base, el trabajo con la herramienta se vuelve bastante directo. La mayoría de comandos siguen una estructura similar: wp + recurso + acción. Esa lógica hace que aprender los básicos sea mucho más fácil de lo que parece.

Estructura básica de un comando wp-cli

La sintaxis general suele ser muy simple. Por ejemplo:

wp <recurso> <acción> [opciones]

El recurso puede ser core, plugin, theme, user, post, option o site, entre otros. La acción define lo que quieres hacer: instalar, listar, actualizar, borrar, activar, exportar, etc.

Piensa en WP-CLI como una caja de herramientas ordenada. En lugar de navegar por menús, le dices exactamente qué hacer. Eso reduce pasos, mejora la productividad y facilita la automatización con scripts o tareas programadas.

Comandos básicos de información del sitio

wp core version

Uno de los primeros comandos que conviene conocer es el que muestra la versión del núcleo de WordPress instalada:

wp core version

Es útil para auditorías rápidas, soporte técnico o mantenimiento. En cuestión de segundos puedes verificar qué versión está corriendo sin entrar en el escritorio de WordPress.

wp core check-update

Si quieres saber si hay una nueva versión disponible para WordPress, puedes usar:

wp core check-update

Este comando ayuda a detectar actualizaciones pendientes antes de aplicarlas. Es una buena práctica revisar primero la disponibilidad de cambios y, si trabajas en producción, coordinarlo con copias de seguridad y ventanas de mantenimiento.

Gestión básica de plugins

Listar plugins instalados

Para ver todos los plugins del sitio:

wp plugin list

La salida te muestra información clave como estado, versión y si hay actualizaciones. Es especialmente útil en sitios con muchas extensiones o en auditorías técnicas donde necesitas identificar dependencias y posibles conflictos.

Instalar, activar y desactivar plugins

Instalar un plugin desde el repositorio oficial es tan simple como:

wp plugin install nombre-del-plugin

Si además quieres activarlo en el momento:

wp plugin install nombre-del-plugin --activate

Y para desactivarlo:

wp plugin deactivate nombre-del-plugin

Estos comandos son especialmente valiosos en despliegues, migraciones y entornos de staging. Permiten repetir procesos con precisión y reducen la dependencia de clics manuales.

Actualizar plugins

Cuando llega el momento de aplicar mejoras o correcciones de seguridad, puedes actualizar un plugin concreto con:

wp plugin update nombre-del-plugin

O todos los plugins a la vez:

wp plugin update --all

Aquí conviene ser prudente. En sitios de producción, actualizar en bloque puede introducir incompatibilidades si no has probado antes los cambios. WP-CLI acelera la tarea, pero la responsabilidad técnica sigue siendo la misma.

Trabajo esencial con temas

Listar y gestionar temas

La lógica con los temas es casi idéntica a la de los plugins:

wp theme list

Si necesitas instalar un tema:

wp theme install nombre-del-tema

Y para activarlo:

wp theme activate nombre-del-tema

Esto resulta muy útil en entornos multisitio, pruebas de plantillas o automatización de instalaciones. Además, te permite mover proyectos entre servidores sin depender de la interfaz web.

Comandos básicos para contenido

Listar entradas y páginas

WP-CLI también permite consultar contenido. Un ejemplo muy práctico es listar entradas publicadas:

wp post list --post_type=post

Y si te interesan las páginas:

wp post list --post_type=page

Este tipo de consultas es útil cuando necesitas revisar volúmenes de contenido, exportar datos o cruzar información con scripts. Aunque el panel puede ser más visual, la terminal ofrece una visión inmediata y filtrable.

Crear una entrada rápida

Si quieres generar una entrada desde consola, puedes usar:

wp post create --post_type=post --post_status=draft --post_title="Título de prueba"

Este comando es muy práctico para automatizar cargas de contenido o crear borradores de trabajo. En flujos avanzados, también puede combinarse con importación masiva y tareas de integración.

Usuarios y permisos: una utilidad infravalorada

Listar usuarios

Para ver los usuarios del sitio:

wp user list

Es un comando sencillo, pero muy útil en auditorías de acceso y mantenimiento. Si administras varios proyectos, te ayuda a detectar cuentas obsoletas o revisar roles con rapidez.

Crear un usuario administrador

Si necesitas crear una cuenta nueva con perfil administrativo:

wp user create nuevousuario correo@ejemplo.com --role=administrator

También puedes asignar otros roles según el caso. Esta capacidad es muy valiosa durante migraciones o cuando recuperas el acceso a un entorno donde se ha perdido parte de la configuración.

Opciones, caché y ajustes rápidos

Consultar valores del sitio

Algunas configuraciones clave se guardan como opciones. Para leer una concreta:

wp option get siteurl

O para comprobar el nombre del sitio:

wp option get blogname

Este tipo de consultas permite verificar parámetros sin entrar en la base de datos manualmente. También ayuda a depurar incidencias de configuración de forma más directa.

Limpiar caché si el entorno lo permite

En sitios que usan sistemas de caché compatibles con WP-CLI, puede ser útil vaciarla desde terminal. El comando exacto depende del stack instalado y de las extensiones activas, así que aquí conviene seguir la documentación del proyecto correspondiente.

La idea importante no es memorizar cada variante, sino entender que WP-CLI puede integrarse con muchas tareas operativas habituales. Esa flexibilidad es una de las razones por las que se utiliza tanto en mantenimiento profesional.

Buenas prácticas al trabajar con comandos básicos

Para usar WP-CLI con confianza, hay algunas recomendaciones simples que marcan una gran diferencia. La primera es trabajar siempre que puedas en un entorno de pruebas antes de tocar producción. La segunda, revisar la ayuda de cada comando con –help para descubrir opciones adicionales.

wp plugin update --help
wp post create --help

También es buena idea documentar tus comandos frecuentes o crear pequeños scripts reutilizables. En equipos técnicos, esa costumbre reduce errores, estandariza procesos y facilita el traspaso de conocimiento.

Y, por supuesto, antes de ejecutar operaciones sensibles, asegúrate de tener copia de seguridad. WP-CLI es rápido, pero la rapidez no sustituye a una estrategia de seguridad y recuperación bien pensada.

Qué aprender después de estos primeros pasos

Una vez domines estos comandos básicos, el siguiente nivel suele incluir búsqueda y reemplazo en base de datos, exportación e importación de contenido, manejo de medios y automatización avanzada. Ahí es donde WP-CLI deja de ser una herramienta cómoda y pasa a convertirse en una pieza clave del flujo DevOps o de administración técnica.

Si tu día a día incluye WordPress con frecuencia, invertir unas horas en WP-CLI compensa muy rápido. Lo que al principio parece una curva de aprendizaje se convierte pronto en una mejora real de eficiencia, precisión y trazabilidad.

Fuentes y lecturas recomendadas

WP-CLI Handbook oficial

Documentación de comandos de WP-CLI

Documentación oficial de WordPress