Inspecciona el estado de los tweaks con WP-CLI

Usa los comandos WP-CLI de POM Tweaks para descubrir los slugs exactos de los tweaks, listar los tweaks activos en un sitio, comprobar un tweak en scripts de shell o encontrar su uso en una red multisitio. Los comandos informan de los módulos instalados del POM Framework. Los componentes clásicos eliminados no forman parte del catálogo de tiempo de ejecución.

Lector al que va dirigido

Esta referencia está pensada para propietarios de sitios, desarrolladores y administradores que pueden ejecutar WP-CLI en la instalación de WordPress. Los comandos son de solo lectura: no activan, desactivan ni reconfiguran tweaks.

La familia de comandos independiente pomtweaks composite-products incluye operaciones de migración, reversión y limpieza con capacidad de escritura para los datos POM anteriores reconocidos. Sus subcomandos status, diagnose y dry-run siguen siendo de solo lectura, y el tiempo de ejecución retirado nunca se carga. Sigue la guía de actualización de POM Composite Products antes de usar esa familia.

Requisitos previos

  1. Instala y activa POM Tweaks para el sitio o la red de destino.
  2. Ejecuta WP-CLI desde el directorio de WordPress, o proporciona el argumento global --path=<wordpress-path>.
  3. En multisitio, selecciona siempre el sitio previsto con --url=<site-url> cuando uses list o is-active.

Descubre los slugs de los tweaks

Lista todos los slugs de módulos instalados en el sitio seleccionado:

wp pomtweaks list --status=all --field=slug --url=https://example.com

El comando list predeterminado muestra solo los tweaks activos:

wp pomtweaks list --url=https://example.com

Su tabla contiene:

  • slug: el valor exacto que aceptan los demás comandos.
  • status: active o inactive para el sitio seleccionado.
  • type: modern, que identifica el tiempo de ejecución del POM Framework.

El --type opcional acepta all (el predeterminado) o modern; ambos seleccionan el catálogo actual. --type=legacy ya no se acepta porque se ha eliminado el tiempo de ejecución clásico. Los antiguos comandos de migración y limpieza de ajustes clásicos ya no se incluyen. Usa --status=inactive para inspeccionar únicamente los tweaks desactivados. El argumento --format acepta table, csv, json, yaml o count; --fields selecciona varias columnas y --field imprime una sola columna sin tabla.

WP-CLI genera la referencia completa de opciones a partir del propio comando:

wp help pomtweaks list

Comprueba un sitio

Pasa el slug descubierto a is-active:

wp pomtweaks is-active image-optimizer --url=https://example.com

En multisitio, los módulos Updates → Update controls y Themes → Theme controls informan de la política de red vigente incluso cuando --url selecciona un subsitio. Su estado procede del administrador de red; las copias de sitios individuales no lo anulan. En WordPress independiente, su estado pertenece al sitio seleccionado.

Los scripts existentes pueden seguir proporcionando --type=modern:

wp pomtweaks is-active woocommerce-composite-products --type=modern --url=https://example.com

El comando sale con el estado 0 cuando el tweak está activo. Sale con el estado 1 y explica si el tweak está inactivo o es desconocido en caso contrario. Esto lo hace adecuado para condiciones de shell:

if wp pomtweaks is-active image-optimizer --url=https://example.com --quiet; then
    echo "Image optimization is enabled."
fi

Encuentra el uso en una red multisitio

find_usage busca en todos los sitios de la red actual y devuelve solo los sitios donde el slug proporcionado está activo:

wp pomtweaks find_usage --tweak=image-optimizer

El --type=modern opcional selecciona el mismo catálogo de tiempo de ejecución actual que el --type=all predeterminado.

La salida incluye el ID del blog, el nombre del sitio, la URL completa del sitio y el tipo de tweak. También están disponibles la salida legible por máquina y la selección de campos:

wp pomtweaks find_usage --tweak=login-registration --field=site_url
wp pomtweaks find_usage --tweak=wp-admin-appearance --format=json

Este comando de red sale con el estado 1 cuando el slug es desconocido, cuando ningún sitio lo tiene activo o cuando la instalación no es multisitio. Lee los sitios en lotes acotados, por lo que el resultado no se limita a la primera página de una red grande.

Diagnostica POM Composite Products

Usa el diagnóstico de solo lectura con ámbito de sitio después de la activación, la migración, la importación o el mantenimiento del catálogo:

wp pomtweaks composite-products diagnose --url=https://example.com

El resultado informa de si el ajuste moderno coincide con sus cinco capas de tiempo de ejecución, de si la extensión oficial WooCommerce Composite Products está activa, instalada pero inactiva o ausente, de las versiones de esquema de configuración y migración admitidas, de los recuentos de migración, de los recuentos de compuestos POM y clásicos, y de los problemas de configuraciones guardadas. El análisis de productos valida los esquemas actuales, los contratos de editor y reglas, las relaciones reutilizables, las integraciones de componentes y los productos, variaciones, categorías e imágenes referenciados. Informa de los IDs de producto y de códigos de problema legibles por máquina, no de nombres de productos, contenido de clientes, cargas de solicitudes, credenciales u otros datos personales.

El análisis lee los productos en lotes y se detiene en 500 productos modernos de forma predeterminada. Ajusta el análisis acotado cuando el sitio seleccionado sea más grande:

wp pomtweaks composite-products diagnose \
    --batch-size=200 \
    --max-products=2000 \
    --details-limit=50 \
    --format=json \
    --url=https://example.com

--batch-size acepta de 1 a 500, --max-products acepta de 1 a 5000 y --details-limit acepta de 0 a 100. El comando sale con 0 después de un análisis completo sin errores, con 2 cuando el sitio seleccionado no puede inspeccionarse y con 7 cuando encuentra errores bloqueantes o alcanza el límite de productos configurado. Las advertencias se notifican sin cambiar el código de salida de éxito. El comando nunca repara, migra, elimina ni reescribe datos de productos.

Resultado esperado y verificación

  1. Ejecuta wp pomtweaks list --status=all --url=<site-url> y confirma que el slug esperado aparece una vez.
  2. Activa o desactiva ese tweak a través de su interfaz de ajustes normal de POM Tweaks.
  3. Ejecuta wp pomtweaks is-active <slug> --url=<site-url> y confirma que su estado de salida coincide con el estado guardado.
  4. En multisitio, ejecuta find_usage con el mismo slug y confirma que el sitio seleccionado aparece solo mientras el tweak está activo.
  5. Cuando Composite Products esté habilitado, ejecuta pomtweaks composite-products diagnose y confirma que toggle_isolation es pass, que scan_truncated es no y que errors es 0.

Resolución de problemas

  • Si WP-CLI dice que el slug es desconocido, cópialo de wp pomtweaks list --status=all --field=slug en lugar de usar la etiqueta visible de los ajustes.
  • Si un tweak moderno sigue inactivo, confirma que su plugin requerido está disponible y que el ajuste se guardó para el mismo sitio seleccionado por --url.
  • Si find_usage no está disponible en una instalación de un solo sitio, usa is-active en su lugar.
  • Si se informa del sitio equivocado, incluye la URL exacta del sitio multisitio en --url para los comandos con ámbito de sitio.
  • Si Composite Products informa de prepared, failed, unknown, una ejecución abandonada o un bloqueo activo, usa su next_action indicado; no inicies la limpieza ni elimines sus datos de recuperación manualmente.
  • Si el diagnóstico de Composite Products informa de incomplete, aumenta --max-products dentro del límite estricto de 5000 productos o inspecciona el catálogo en ámbitos operativos más pequeños. No interpretes un análisis truncado como un resultado correcto.
  • Si broken_references es distinto de cero, usa los IDs de producto y los códigos de problema de details para editar los productos afectados. El diagnóstico, de forma intencionada, no expone ni repara sus valores almacenados.
Integra la salida de WooCommerce de forma segura
Anterior
Personaliza la elegibilidad de `llms.txt`
Siguiente