Comandos comunes

Este texto fue traducido usando IA. Si deseas ver el texto original en inglés, haz clic aquí.

Hay una serie de comandos que pueden resultarte útiles al trabajar con tu sitio. Estos comandos y sus parámetros más comunes se incluyen a continuación. También hay muchos otros comandos útiles disponibles, y estas secciones no los incluyen todos. Consulta la Guía de comandos CLI para desarrolladores de WordPress.org para obtener más información.

Gestionar usuarios

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

wp user list

Lista todos los usuarios del sitio. Si tienes muchos usuarios, es posible que desees restringir la lista a roles específicos usando el flag --role:

wp user list –role=adminstrator

wp user get {USER ID/NAME/EMAIL}

Devuelve un usuario específico, ya sea por ID de usuario, nombre de usuario o dirección de correo electrónico.

wp user create {NAME} {USER EMAIL} –role={ROLE}

Crea un nuevo usuario con el nombre, correo electrónico y rol definidos.

Este comando no crea un usuario de WordPress.com correspondiente. Si estás utilizando el inicio de sesión seguro de WordPress.com (SSO), deberías crear el usuario local invitando a un usuario a través de Usuarios > Añadir nuevo. Esto garantizará que se creen tanto una cuenta de WordPress.com como un usuario local.

wp user update {USER ID/NAME/EMAIL} –{KEY}={VALUE}

Actualiza un usuario basándose en el ID de usuario, nombre o correo electrónico. Actualiza el conjunto de pares clave/valor especificados. 

Las claves incluyen display_name, user_email, role y user_pass

Nota: No podrás actualizar el user_login de un usuario con el comando wp user update. En su lugar, actualizar el user_login requiere usar wp search-replace. Sin embargo, este cambio no se recomienda ya que realiza reemplazos 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 aun así deseas reemplazar 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

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

Si tienes problemas con un plugin o tema, puedes iniciar tu comando con wp --skip-themes --skip-plugins para ejecutar los comandos a pesar de los conflictos.

Puedes encontrar más información sobre los comandos de omisión a continuación.

wp plugin/theme list

Lista todos los plugins/temas instalados en el sitio y su estado. En estas listas encontrarás los slugs de tus plugins y temas instalados, que puedes usar para ejecutar los comandos que se indican a continuación.

wp plugin/theme activate {SLUG}

Activa el plugin/tema especificado.

Para desactivar un tema, necesitas activar otro en su lugar.

wp plugin deactivate {SLUG}

Desactiva el plugin especificado.

wp plugin/theme delete {SLUG}

Elimina el plugin/tema especificado.

No puedes eliminar un tema activo ni temas gestionados con este comando. Para eliminar un tema activo, cambia primero a un tema diferente y luego elimina el tema que deseas. Para eliminar temas gestionados, puedes hacerlo a través de SFTP.

wp plugin/theme install {SLUG or URL TO INSTALLATION_FILE}

Instala un plugin/tema desde el repositorio de WordPress.org basándose en el slug o mediante una URL que apunte a un archivo de instalación .zip.

No puedes sobrescribir un plugin/tema existente a menos que ejecutes el comando con la opción --force. Puedes usar esto para actualizar plugins y reparar carpetas de plugins corruptas.

Para activar automáticamente un plugin después de la instalación, incluye la opción --activate.

wp plugin/theme update {SLUG}

Actualiza el plugin/tema especificado si hay una actualización disponible. No puedes usar este comando para actualizar plugins/temas gestionados.

También puedes usar la opción --all si deseas actualizar todos los plugins/temas.

wp plugin auto-updates {COMMAND} {PLUGIN SLUG}

Muestra el estado de las actualizaciones de plugins o habilita/deshabilita las actualizaciones para un plugin específico.

Los COMMANDS disponibles son status, enable, disable.

No puedes deshabilitar las actualizaciones para plugins o temas gestionados.

Gestionar Jetpack

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

wp jetpack module list

Lista los módulos de Jetpack y sus estados.

wp jetpack module activate {MODULE NAME}

Activa el módulo de Jetpack especificado.

También puedes usar all en lugar de {MODULE NAME}

wp jetpack module deactivate {MODULE NAME}

Desactiva el módulo de Jetpack especificado.

También puedes usar all en lugar de {MODULE NAME}

wp jetpack status

Informa del estado de Jetpack, incluyendo qué cuenta de usuario es la conexión principal (esta siempre debería ser la del propietario del sitio).

Se puede añadir un parámetro adicional, full, para obtener un informe completo con detalles que incluyen la versión de Jetpack, la versión de WordPress y el estado de los módulos.

Gestionar los ajustes del sitio

Usa los siguientes comandos para gestionar diversos aspectos de tu sitio y usuarios.

wp site empty –yes

Vacía un sitio de contenido (entradas y páginas).

wp site empty –uploads –yes

Vacía el sitio, incluyendo archivos multimedia.

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

wp option get {OPTION}

Devuelve el valor de una opción.

wp option update {OPTION} {VALUE}

Actualizar el valor de una opción.

wp option add {OPTION} {VALUE}

Añadir una nueva opción.

wp option delete {OPTION}

Eliminar una opción.

Al trabajar con comandos wp option, si obtienes el siguiente error en la terminal, 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 rebobinando la tabla SQL del sitio a la última copia válida. 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 pérdida de datos.

Para restaurar una tabla SQL:

1. En el escritorio del sitio, navega a Jetpack > Registro de actividad.
2. Selecciona un punto de copia de seguridad al que retroceder.
3. Desmarca todas las casillas excepto Base de datos del sitio (SQL).
4. Haz clic en Confirmar restauración.

wp role list

Devuelve una lista de roles

wp role reset {ROLE}

Restablece el rol especificado. Puedes listar múltiples roles (sin comas)

wp reset role administrator editor

También puedes reemplazar {ROLE} con --all para restablecer todos a la vez

Gestionar contenido

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

wp post list

Devuelve una lista de entradas del blog.

Puedes usar una variedad de flags con este comando, incluyendo:

--format={FORMAT}

--posts_per_page={#}

--post_type={TYPE}

Los tipos de entrada posibles incluyen posts, pages, attachments y products.

Se pueden usar múltiples flags a la vez.

wp post list --post_type=posts,pages --format=count

wp post update {POST_ID} –{KEY}={VALUE}

Actualiza la información de una entrada.

wp post update123 --post_status=draft

wp post delete {POST_ID}

Eliminar una entrada.

wp post exists {POST_ID}

Comprobar si una entrada existe.

wp menu list

Listar los menús del sitio.

wp menu item list {TERM_ID}

Listar los elementos de un menú específico.

wp menu item update {MENU_ITEM_PARENT_ID}

Actualizar un elemento de menú específico.

wp media regenerate

Regenerar las miniaturas de medios cuando el módulo Jetpack Photon está desactivado.

Puedes usar la opción --only-missing para omitir los tamaños de imagen existentes.

Solución de problemas del sitio

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

wp php-errors

Mostrar los 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 la opción --limit para reducir el número de errores mostrados y mejorar la legibilidad.

wp php-errors –limit10

wp wpcomsh deactivate-user-plugins

Desactivar plugins del usuario.

Puedes usar la opción --interactive para forzar la confirmación de cada plugin.

Este comando no desactivará Akismet, Jetpack ni los plugins de comercio electrónico gestionados.

wp wpcomsh reactivate-user-plugins

Reactivar plugins del usuario.

Puedes usar la opción --interactive para forzar la confirmación de cada plugin.

wp wpcomsh persistent-data {DATA}

Devuelve datos persistentes (que Jetpack utiliza para verificar las capacidades del sitio).

Las opciones de DATA disponibles incluyen:

WPCOM_PLAN_EXPIRATION

JETPACK_BLOG_TOKEN

WPCOM_PURCHASES

WPCOM_PUBLIC_COMING_SOON

wp wpcomsh plugin use-managed {SLUG}

Usa una versión gestionada (con enlace simbólico) de un plugin.

Este comando eliminará las versiones existentes no gestionadas y las reemplazará con 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 WordPress.com Marketplace y plugins incluidos en el plan Commerce.

Puedes usar la flag --remove-existing para omitir el paso de confirmación.

wp wpcomsh theme use-managed {SLUG}

Usa una versión administrada (con enlace simbólico) de un tema.

Este comando eliminará las versiones existentes no administradas y las reemplazará con versiones administradas. Está disponible para todos los temas de WordPress.com, Storefront y cualquier tema Twenty * (ej: Twenty Twenty Two).

Puedes usar la flag --remove-existing para omitir el paso de confirmación.

wp wpcomsh plugin use-unmanaged {SLUG}

Usa una versión no administrada (sin enlace simbólico) de un plugin.

Este comando eliminará las versiones existentes administradas y las reemplazará con versiones no administradas del repositorio de plugins de WordPress.org. No funcionará para las extensiones de WooCommerce del WordPress.com Marketplace ni para los plugins incluidos en el plan Commerce. Necesitarás instalar estos plugins manualmente para obtener la versión no administrada.

Puedes usar la flag --remove-existing para omitir el paso de confirmación y la flag --version={X.Y.Z} para definir la versión a instalar.

wp wpcomsh theme use-unmanaged {SLUG}

Usa una versión no administrada (no enlazada simbólicamente) de un tema.

Este comando eliminará las versiones administradas existentes y las reemplazará con versiones no administradas del repositorio de temas de WordPress.org, si están disponibles.

Puedes usar la opción --remove-existing para omitir el paso de confirmación y la opción --version={X.Y.Z} para definir la versión a instalar.

El plugin must-use WordPress.com Site Helper o wpcomsh se ejecuta en sitios con funciones de alojamiento activadas para que funcionen de manera integrada en el ecosistema de WordPress.com.

wp cache flush

Vaciar la caché.

Este comando no está pensado como una solución para problemas y puede ocultar las causas raíz. Por favor, úsalo con precaución. Vaciar la caché también puede hacer que tu sitio funcione más lento mientras se reconstruye la caché al cargar las páginas.

Omitir plugins y temas

Es posible que desees omitir plugins, y a veces temas, al ejecutar comandos CLI. Esto puede ser útil para solucionar conflictos o para anular restricciones impuestas por plugins, como el control sobre los roles.

• --skip-plugins se puede añadir antes de cualquier comando y omite los plugins
• --skip-themes se puede añadir antes de cualquier comando y omite los temas

Puedes usar estos comandos juntos. También puedes usar estos comandos con slugs para omitir plugins o temas específicos. Esto puede ser útil para descartar los efectos de ciertos plugins o temas cuando la desactivación no es posible.

Por ejemplo:

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