WP-CLI

WP-CLI es una interfaz de línea de comandos para WordPress a la que se puede acceder cuando estás conectado a través de SSH. En esta guía veremos los comandos que se utilizan más habitualmente y sus subcomandos asociados.

Acceder a CLI

WP-CLI viene preinstalado en WordPress.com y extiende la shell para proporcionar herramientas de línea de comandos específicas de WordPress. Puedes empezar a ejecutar comandos de WP-CLI una vez que te hayas conectado a SSH. Echa un vistazo a la guía de SSH para aprender a activar y usar SSH.

Comandos comunes

Existen varios comandos que pueden resultar útiles al trabajar en tu web. A continuación puedes ver una lista de estos comandos y sus parámetros comunes. También hay muchos otros comandos útiles disponibles, y en estas secciones no se incluyen todos. Consulta la guía de comandos de CLI para desarrolladores de WordPress.org para obtener más información.

Gestionar usuarios

Utiliza los siguientes comandos para gestionar los usuarios locales de tu web. Ten en cuenta que cambiar aspectos de los usuarios en CLI no cambiará la configuración de las cuentas de usuario de WordPress.com que puedan estar asociadas con las cuentas locales.

Comando	Descripción
wp user list	Lista todos los usuarios del sitio Si tienes muchos usuarios, es posible que prefieras restringir la lista a roles específicos añadiendo --role={ROLE}
wp user get {USER ID/NAME/EMAIL}	Devuelve un usuario específico
wp user create {NAME} {USER EMAIL} --role={ROLE}	Crea un nuevo usuario con el nombre, correo electrónico del usuario y rol que hayas definido Este comando creará y devolverá automáticamente una contraseña segura para el usuario Este comando no crea un usuario coincidente de WordPress.com. Si estás utilizando el inicio de sesión seguro de WordPress.com (SSO), debes crear el usuario local invitando a un usuario a través de Usuarios > Añadir nuevo. Esto garantiza que se cree tanto una cuenta de WordPress.com como un usuario local.
wp user update {USER ID/NAME/EMAIL} --{KEY}={VALUE}	Actualiza un usuario Las claves incluyen display_name, user_email, role y user_pass
wp user reset-password {USER ID/NAME/EMAIL}	Restablece la contraseña de un usuario con una cadena segura aleatoria Este comando puede aceptar varios usuarios si separas cada ID con un espacio Si no quieres notificar a los usuarios sobre el restablecimiento de la contraseña, puedes añadir --skip-email
wp user add-role {USER ID} {ROLE}	Añade un rol a un usuario Esto se puede utilizar para añadir roles predeterminados y personalizados
wp user remove-role {USER ID} {ROLE}	Elimina un rol de un usuario
wp user delete {USER ID/NAME/EMAIL} --reassign={USER ID/NAME/EMAIL}	Elimina un usuario Si no incluyes la flag --reassign={USER ID/NAME/EMAIL} todos los contenidos creados por el usuario se eliminarán

Nota: No podrás actualizar el user_login de un usuario con el comando wp user update. En su lugar, para actualizar el user_login es necesario utilizar wp search-replace. Sin embargo, no se recomienda este cambio, ya que realiza sustituciones parciales. Por ejemplo: si hay dos usuarios con los nombres de usuario «techie» y «nontechie», reemplazar «techie» por «sense» resultará en «sense» y «nonsense».

Si aún así quieres sustituir un user_login, el comando a utilizar es:

wp --skip-plugins --skip-themes search-replace "old username" "new username" *users --include-columns=user_login,user_nicename --dry-run

Gestionar plugins y temas

Utiliza los siguientes comandos para gestionar tus plugins y temas. Al trabajar con plugins y temas, ten en cuenta que el slug relacionado no siempre coincidirá con el nombre del plugin/tema.

Comando	Descripción
wp plugin list wp theme list	Lista todos los plugins/temas instalados en el sitio y su estado. En estas listas encontrarás los slugs de los plugins y temas instalados que puedes utilizar para ejecutar los siguientes comandos.
wp plugin activate {SLUG} wp theme activate {SLUG}	Activa el plugin/tema especificado Para desactivar un tema, debes activar otro en su lugar
wp plugin deactivate {SLUG}	Desactiva el plugin especificado
wp plugin delete {SLUG} wp theme delete {SLUG}	Elimina el plugin/tema especificado No puedes eliminar un tema activo o temas gestionados con este comando. Para eliminar un tema activo, cambia a un tema diferente primero y luego elimina el tema que quieras. Para eliminar temas gestionados, puedes hacerlo a través de SFTP.
wp plugin install {PLUGIN SLUG or URL TO INSTALLATION_FILE} wp theme install {PLUGIN SLUG or URL TO INSTALLATION_FILE}	Instala un plugin del repositorio de WordPress.org a partir del slug del plugin o a través de una ruta de URL a un archivo .zip de instalación No puedes sobrescribir un plugin/tema existente a menos que ejecutes el comando con la flag --force. Puedes usarla para actualizar plugins y reparar carpetas de plugins corruptas. Para activar automáticamente el plugin después de la instalación, incluye la flag --activate
wp plugin update {SLUG} wp theme update {SLUG}	Actualiza el plugin especificado si está disponible. No puedes utilizar este comando para actualizar plugins/temas gestionados. También puedes utilizar la flag --all si quieres actualizar todos los plugins
wp plugin auto-updates {COMMAND} {PLUGIN SLUG}	Muestra el estado de las actualizaciones de plugins o activa/desactiva las actualizaciones de un plugin específico Los COMMANDS son status, enable, disable No puedes desactivar las actualizaciones de plugins o temas gestionados

Gestionar Jetpack

Utiliza los siguientes comandos para ajustar los módulos de Jetpack, verificar tu conexión de Jetpack o solucionar problemas de Jetpack.

Comando	Descripción
wp jetpack module list	Enumera los módulos de Jetpack y sus estados
wp jetpack module activate {MODULE NAME}	Activa el módulo de Jetpack especificado También puedes utilizar all en lugar de {MODULE NAME}
wp jetpack module deactivate {MODULE NAME}	Desactiva el módulo de Jetpack especificado También puedes utilizar all en lugar de {MODULE NAME}
wp jetpack status	Informa sobre el estado de Jetpack, incluyendo qué cuenta de usuario es la conexión principal (siempre debería ser el propietario del sitio) Se puede añadir un parámetro adicional, full, para informar sobre detalles completos, incluyendo la versión de Jetpack, la versión de WordPress y el estado del módulo
wp jetpack sync start	Forzar una nueva sincronización de Jetpack, entre WordPress.com o la instalación de WordPress Nota: Jetpack se sincroniza automáticamente cada cierto tiempo, por lo que este comando generalmente no es necesario. Si ejecutas este comando, ten en cuenta que consume recursos y puede ralentizar tu sitio hasta que se complete la sincronización
wp jetpack disconnect blog	Desconecta el sitio actualmente conectado Si desconectas Jetpack, deberás volver a conectarlo para que tu sitio funcione correctamente. Un Jetpack desconectado causará que tu sitio no realice copias de seguridad de datos correctamente e interferirá con las funciones de Jetpack, como las publicaciones programadas, las suscripciones, VideoPress, etc.
wp jetpack disconnect user {USER ID/NAME/EMAIL}	Desconecta a un usuario específico del sitio actualmente conectado

Gestionar los ajustes del sitio

Utiliza los siguientes comandos para gestionar diferentes aspectos de tu sitio y usuarios.

Comando	Descripción
wp site empty --yes	Vacía un sitio de contenido (entradas y páginas)
wp site empty --uploads --yes	Vacía el sitio, incluyendo los archivos multimedia

Los comandos wp site no eliminarán temas ni plugins, ni restablecerán un tema ni borrarán la configuración de los plugins. Si necesitas restablecer completamente tu sitio, ponte en contacto con el servicio de soporte de WordPress.com.

Comando	Descripción
wp option get {OPTION}	Devuelve el valor de una opción
wp option update {OPTION} {VALUE}	Actualiza el valor de una opción
wp option add {OPTION} {VALUE}	Añade una nueva opción
wp option delete {OPTION}	Elimina una opción

Cuando trabajas con los comandos wp option, si obtienes el siguiente error en CLI, puede significar que la tabla de opciones se ha corrompido:

One or more database tables are unavailable. The database may need to be repaired.

Puedes restaurar la tabla restaurando una copia SQL anterior del sitio. Ten en cuenta que esto revertirá todos los cambios mutables en la base de datos que ocurrieron después del punto de restauración y puede resultar en la pérdida de datos.

Para restaurar una tabla SQL:

1. En el escritorio del sitio, ve a Jetpack > Registro de actividad.
2. Selecciona el punto de la copia de seguridad al que quieras volver.
3. Desmarca todas las casillas excepto Base de datos del sitio (SQL).
4. Haz clic en Confirmar retroceso.

Comando	Descripción
wp role list	Devuelve una lista de perfiles
wp role reset {ROLE}	Restablece el perfil especificado Puedes listar varios perfiles (sin coma) También puedes reemplazar {ROLE} con --all para restablecer todos a la vez

Gestionar contenido

Puedes utilizar los siguientes comandos para gestionar el contenido de tu sitio, incluyendo entradas/páginas, menús y archivos multimedia.

Comando	Descripción
wp post list	Devuelve una lista de entradas del blog Puedes utilizar una variedad de indicadores con este comando, incluyendo: --format={FORMAT}  --posts_per_page={#} --post_type={TYPE} Los tipos de entrada incluyen posts, pages, attachments y products Se pueden utilizar varios indicadores a la vez ej: wp post list --post_type=posts,pages --format=count
wp post update {POST_ID} --{KEY}={VALUE}	Actualiza la información de una entrada ej: wp post update123 --post_status=draft
wp post delete {POST_ID}	Elimina una entrada
wp post exists {POST_ID}	Comprueba si una entrada existe

Comando	Descripción
wp menu list	Lista los menús del sitio
wp menu item list {TERM_ID}	Lista los elementos de menú de un menú específico
wp menu item update {MENU_ITEM_PARENT_ID}	Actualiza un elemento de menú específico

Comando	Descripción
wp media regenerate	Regenera las miniaturas de los archivos multimedia cuando el módulo Jetpack Photon está desactivado Puedes añadir --only-missing al final para omitir los tamaños de imagen existentes

Solución de problemas del sitio

Puedes utilizar los siguientes comandos al solucionar problemas en tu sitio. Comprobar los errores de PHP puede ayudarte a identificar las fuentes de errores en tu sitio o utilizar los comandos wp wpcomsh para realizar rápidamente comprobaciones de conflictos de plugins o para ajustar si estás utilizando o no versiones gestionadas de plugins.

Comando	Descripción
wp php-errors	Mostrar registros de errores en WP-CLI Este comando solo muestra errores de PHP, no de otros lenguajes como HTML, Javascript o CSS. Para ver estos otros errores, utiliza el inspector del navegador Puedes añadir --limit={#} para reducir la cantidad de errores mostrados y que sea más fácil verlos
wp wpcomsh deactivate-user-plugins	Desactivar plugins de usuario Puedes añadir la opción --interactive al final del comando para forzar la confirmación para cada plugin Este comando no desactivará Akismet, Jetpack ni plugins de comercio electrónico gestionados
wp wpcomsh reactivate-user-plugins	Reactivar plugins de usuario Puedes añadir la opción --interactive al final del comando para forzar la confirmación para cada plugin
wp wpcomsh persistent-data {DATA}	Devolver datos persistentes (que Jetpack utiliza para verificar las capacidades del sitio) Los datos disponibles incluyen: WPCOM_PLAN_EXPIRATION JETPACK_BLOG_TOKEN WPCOM_PURCHASES WPCOM_PUBLIC_COMING_SOON
wp wpcomsh plugin use-managed {SLUG}	Utilizar una versión gestionada (symlinked) de un plugin Este comando eliminará las versiones no gestionadas existentes y las sustituirá por versiones gestionadas. Está disponible para amp, classic-editor, coblocks, crowdsignal-forms, full-site-editing, gutenberg, layout-grid, page-optimize, wp-seo, woocommerce, extensiones de WooCommerce del marketplace de WordPress.com y plugins incluidos en el plan Commerce. Puedes añadir --remove-existing para omitir el paso de confirmación
wp wpcomsh theme use-managed {SLUG}	Utilizar una versión gestionada (symlinked) de un tema Este comando eliminará las versiones no gestionadas existentes y las reemplazará por versiones gestionadas. Está disponible para todos los temas de WordPress.com, Storefront y cualquier tema Twenty (por ejemplo, Twenty Twenty Two) Puedes añadir --remove-existing para omitir el paso de confirmación
wp wpcomsh plugin use-unmanaged {SLUG}	Utilizar una versión no gestionada (no symlinked) de un plugin Este comando eliminará las versiones gestionadas existentes y las sustituirá por versiones no gestionadas del repositorio de plugins de WordPress.org. No funcionará con extensiones de WooCommerce del marketplace de WordPress.com y plugins incluidos en el plan Commerce. Tendrás que instalar estos plugins manualmente para obtener la versión no gestionada. Puedes añadir --remove-existing para omitir el paso de confirmación y --version={X.Y.Z} para definir la versión a instalar
wp wpcomsh theme use-unmanaged {SLUG}	Utilizar una versión no gestionada (no symlinked) de un tema Este comando eliminará las versiones gestionadas existentes y las sustituirá por versiones no gestionadas del repositorio de temas de WordPress.org si están disponibles. Puedes añadir --remove-existing para omitir el paso de confirmación y --version={X.Y.Z} para definir la versión a instalar

El plugin Site Helper de WordPress.com o wpcomsh se ejecuta en sitios con funciones de alojamiento activadas para que funcionen perfectamente en el ecosistema de WordPress.com.

Comando	Descripción
wp cache flush	Limpiar la caché Este comando no está destinado a solucionar problemas y puede ocultar las causas de fondo. Utilízalo con precaución. Al vaciar la caché, es posible que tu sitio se ejecute más lento mientras se reconstruye la caché al cargar la página

Omitir plugins y temas

Puede que quieras omitir plugins y, a veces, temas al ejecutar comandos en CLI. Esto puede ser útil para solucionar conflictos o para anular restricciones impuestas por plugins, como el control sobre los perfiles.

• Se puede añadir --skip-plugins antes de cualquier comando para omitir los plugins
• Se puede añadir --skip-themes antes de cualquier comando para omitir los temas

Puedes utilizar estos comandos juntos. También puedes utilizar estos comandos con slugs para omitir plugins o temas concretos. Esto puede ser útil para descartar los efectos de ciertos plugins o temas cuando no es posible desactivarlos.

Por ejemplo: wp --skip-plugins=woocommerce, code-snippets, elementor-pro plugin list

Restricciones de CLI

Con el fin de proporcionar un entorno seguro y de alto rendimiento, hemos restringido ciertos comandos de CLI. Si un comando está restringido, devolverá forbidden en CLI.

Por lo general, en CLI puedes hacer prácticamente cualquier cosa que podrías hacer con la interfaz gráfica de usuario (GUI) en el escritorio de tu sitio, pero sin ninguna de las advertencias o comprobaciones que aparecen en la GUI. Por ejemplo, el comando wp site empty --yes vaciará el contenido de tu sitio sin necesidad de confirmación. Con estas restricciones, es más difícil destruir un sitio por error.

Solución de problemas de CLI

A veces, es posible que veas HTML devuelto cuando introduces un comando en CLI. Esto puede suceder cuando tienes un plugin de mantenimiento activo o puede ser una señal de que un tema o plugin tiene código incorrecto.

Si no hay un plugin de mantenimiento presente, puedes utilizar los comandos --skip-* para comprobar si la fuente es un plugin o un tema. Una vez identificado, puedes desactivar el plugin o tema y ponerte en contacto con el desarrollador para corregirlo.

Debido a la naturaleza compleja de los comandos de WP-CLI, no podemos proporcionar un soporte extenso para el uso de estas herramientas. Los Happiness Engineers están siempre dispuestos a ayudar con cualquier problema de acceso a WP-CLI, pero no pueden guiarte en el uso de los comandos.

Otros recursos de WP-CLI

• Documentación de WP-CLI de WordPress.org
• Documentación de WP-CLI de WooCommerce
• WP-CLI.org