WordPress

Solución de problemas de la CLI de WordPress

Arregla una contraseña de aplicación rechazada, una sincronización parcial o una publicación rechazada.

Haz que wordpress vuelva a funcionar a partir del síntoma que ves. La mayoría de los fallos vienen de la contraseña de aplicación, de tu rol en WordPress o de los permisos del perfil, y cada uno tiene una comprobación que nombra la causa.

Buscas tu síntoma en la tabla, haces la comprobación que indica y vuelves a ejecutar el comando. Si sigue fallando, tienes el código de error y el nombre del perfil listos para una petición de ayuda.

En esta página:

  1. Primeras comprobaciones
  2. Síntomas y qué hacer
  3. Pide ayuda

Primeras comprobaciones

En los ejemplos, blog es el perfil, un nombre que elegiste para un sitio.

wordpress doctor                         # the version, the settings, the profiles, without the network
wordpress blog session status --check    # asks your site whose password it is

Síntomas y qué hacer

SíntomaQué hacer
No sabes qué está configuradoEjecuta wordpress doctor. No lee ningún llavero ni usa la red.
No se encuentra wordpressAbre una terminal nueva y comprueba que la carpeta global de npm está en PATH.
Escribiste wpEse es el WP-CLI oficial. Esta herramienta es wordpress.
"name a profile"Pon el perfil primero, como en wordpress blog config show, o define WCWP_PROFILE.
"not signed in"Ejecuta wordpress blog session start --site blog.example.com --login anna, con tu sitio y tu nombre de usuario. Consulta inicia sesión.
La contraseña se rechazaSe anuló, se escribió mal o es de otro usuario. Crea una nueva (cómo) y ejecuta session start de nuevo con el --login correcto.
No hay sección Contraseñas de aplicación en tu perfilEl sitio necesita WordPress 5.7 o posterior con https, y un plugin o el alojamiento puede desactivar la sección. Pregunta al administrador del sitio.
Una dirección de WordPress.comLos sitios de WordPress.com no son compatibles, solo WordPress autoalojado.
posts list está vacíoEjecuta antes wordpress blog sync. Las entradas se leen de la copia que crea.
sync termina parcial, o faltan páginasUn inicio de sesión de Autor o Colaborador no puede listar páginas, y un Colaborador ve solo sus propias entradas. Solo un Administrador lista los usuarios. Inicia sesión como Administrador para una copia completa, o como Editor para todas las entradas y páginas.
Falta en la copia un cambio del sitioEjecuta sync. Si sigue terminando parcial, mira la fila anterior.
content.conflictLa entrada cambió en el sitio desde la última sincronización. Ejecuta sync, mira la entrada de nuevo y vuelve a intentarlo.
content.lossy-bodyLa entrada tiene galerías, columnas, contenido incrustado o iframes que Markdown no puede conservar. Cambia solo su título, extracto, etiquetas o estado, o añade --replace-body para escribir el cuerpo de todos modos y aplanarlos. Consulta cuando una escritura se detiene.
content.schedule-past--at-time debe estar en el futuro.
content.already-publishedUna entrada publicada no se puede programar. Ejecuta antes posts unpublish.
content.emptyLa escritura no nombra ningún campo. Añade --title, --text-file u otro campo.
posts publish falla con permission_error (WordPress respondió HTTP 403)Tu rol en WordPress no puede publicar. Un Colaborador no puede. Pide ayuda a un Editor, o inicia sesión como uno.
posts stats no muestra visitasWordPress no guarda recuentos de visitas, y las estadísticas de Jetpack no son compatibles.
Un campo de plugin, como un título SEO, no tiene opciónLos campos de plugins no están en la descripción de la API. Envíalos en un --body sin procesar con wordpress blog api.
El archivo de ajustes no se leedoctor enumera cada problema del archivo en config.issues. Ejecuta el config unset que da cada uno, o corrige el archivo a mano.
doctor muestra files.problemsOtros usuarios del ordenador pueden leer config.json o entrar en su carpeta. Ejecuta cada chmod que imprime doctor después de "to make it private:". doctor nunca cambia por sí mismo el modo de un archivo.
"the OS keyring did not answer"El ordenador no tiene ningún llavero en marcha. Inicia sesión con --credential-storage file.
Una escritura se rechazaLos permisos del perfil o WCWP_READ_ONLY la detienen. Consulta los permisos.

Pide ayuda

Pregunta en Discord, o abre un issue con el código de error, el nombre del perfil y el comando. Nunca pegues una contraseña, un token ni contenido privado en una petición de ayuda.