Comprobar el estado y la compatibilidad de Product Add-Ons
El panel de estado de POM Product Add-Ons ofrece a los responsables de tienda una vista práctica y respetuosa con la privacidad del módulo antes de una migración, tras un cambio de configuración o al investigar un problema de la tienda. Separa las comprobaciones de estado rutinarias de una inspección más profunda del catálogo, de modo que abrir Site Health no escanea todas las definiciones de Product Add-Ons.
Antes de empezar
- WooCommerce y el POM Tweak Product Add-Ons deben estar activos.
- Necesitas acceso a WordPress Site Health para ver el panel.
- Necesitas permiso para gestionar WooCommerce para ejecutar un diagnóstico profundo o reconstruir datos derivados.
- En multisitio, abre el área de administración del sitio que quieras inspeccionar. Los informes y las acciones de mantenimiento se aplican únicamente a ese sitio.
Abrir el panel
- Ve a Tools → Site Health.
- Selecciona la pestaña POM Product Add-Ons.
- Revisa Current status y Known compatibility.
El estado actual informa sobre el entorno de ejecución de WooCommerce, si la tienda POM está activa o intencionadamente inactiva, la frescura del índice de asignaciones, la preparación de las cargas privadas, el almacenamiento de capacidad compartida y la limpieza de retenciones caducadas, y la hora del último diagnóstico profundo. Las filas de compatibilidad distinguen entre que se detecte una extensión y que se cargue su integración con POM. La detección por sí sola no es una garantía de compatibilidad.
La página de estado estándar de Site Health también incluye comprobaciones independientes de POM Product Add-Ons para el entorno de ejecución, la integridad de los datos y la protección de las cargas. La información de WordPress Site Health incluye el mismo resumen operativo sin rutas.
Comprender los niveles de estado
- Healthy significa que las comprobaciones económicas de entorno de ejecución y de datos derivados no encontraron ningún problema procesable, y que el último informe profundo guardado está en buen estado cuando existe.
- Needs attention significa que la tienda normalmente puede continuar mediante alternativas a los datos de origen, pero un índice, una integración opcional, un origen de migración, una entidad sin uso, una referencia desactivada o un elemento de traducción necesita revisión.
- Critical significa que un entorno de ejecución necesario no está disponible o que el último escaneo explícito encontró referencias rotas, definiciones no válidas, identidades duplicadas, problemas de ID de compatibilidad, problemas de propiedad, un directorio de carga heredado sin protección o un almacenamiento privado no disponible utilizado por campos de archivo.
Un informe profundo guardado permanece visible hasta que se ejecuta otro diagnóstico. Su marca de tiempo se muestra en UTC para que un informe de soporte pueda compararse entre sistemas.
Ejecutar un diagnóstico profundo
- Selecciona Run deep diagnostic en Protected diagnostic actions.
- Espera al aviso de éxito y revisa Latest deep diagnostic summary.
- Investiga cada recuento de errores distinto de cero antes de cambiar asignaciones activas o eliminar entidades.
- Selecciona Copy redacted support report cuando necesites compartir el resultado con el soporte.
El escaneo es de solo lectura. Comprueba las referencias almacenadas y la propiedad, la validez de la configuración, UUID e ID de compatibilidad duplicados, grupos publicados sin una asignación, opciones reutilizables seleccionadas que están desactivadas, el estado del índice de asignaciones, la preparación del almacenamiento de archivos, el estado de identidad de las traducciones y los orígenes de migración de extensiones oficiales. Utiliza lecturas indexadas y por lotes con un límite de registros acotado; un resultado truncado se marca como que necesita atención en lugar de presentarse como completo.
El JSON copiado excluye los valores de clientes, etiquetas, nombres de archivo, rutas del sistema de archivos, URL del sitio, secretos y datos de solicitudes sin procesar. Revisa cualquier informe de diagnóstico según la política de soporte y privacidad de tu tienda antes de compartirlo.
Reconstruir cachés e índices derivados
Utiliza el mantenimiento solo cuando el panel informe de un índice de asignaciones o un registro de ID de compatibilidad obsoletos, o después de que el soporte te pida refrescar los datos derivados.
- Selecciona Preview cache and index rebuild.
- Revisa el nuevo resumen de diagnóstico de solo lectura.
- Si aparece el botón de confirmación y el informe sigue siendo aplicable, selecciona Rebuild caches and derived indexes.
- Confirma que Assignment index cambia a Valid y, a continuación, prueba un producto afectado.
La vista previa es de corta duración y está vinculada al usuario, al sitio y a la huella de diagnóstico actuales. Si los datos de origen cambian antes de la confirmación, POM rechaza la reconstrucción y solicita otra vista previa. El mantenimiento reconstruye únicamente cachés, el índice de asignaciones y el registro de ID de compatibilidad; no edita las definiciones de Product Add-Ons, las asignaciones, el estado de publicación, las traducciones, los carritos ni los pedidos.
Adaptadores de almacenamiento privado
El almacén de archivos privado integrado informa de su preparación sin mostrar su directorio. Un adaptador de almacenamiento de objetos personalizado también debería implementar este filtro de estado para que Site Health pueda distinguir un adaptador listo de uno no disponible:
| Filtro | Argumentos después del valor inicial | Valor de retorno |
|---|---|---|
pom_tweaks_product_addons_file_storage_health |
Contexto que contiene blog_id y uploads_enabled |
true cuando el ciclo de vida completo del almacenamiento privado está listo, false cuando no está disponible, o null para dejar que POM inspeccione su alternativa local |
La devolución de llamada de estado debe ser económica y no debe revelar nombres de buckets, rutas del sistema de archivos, credenciales, URL firmadas ni claves de objetos cargados.
Los desarrolladores pueden reducir el límite máximo del escaneo profundo con pom_tweaks_product_addons_health_max_records. POM limita el resultado a entre 500 y 50 000 registros de metadatos. Utiliza un límite inferior solo cuando un alojamiento necesite un presupuesto de operación interactiva más estricto; un escaneo truncado no puede establecer la integridad de todo el sitio.
Verificar el resultado
Después de resolver un problema:
- Ejecuta de nuevo el diagnóstico profundo.
- Confirma que el recuento esperado es cero o que se comprende el aviso restante.
- Abre un producto simple y otro variable que utilicen la configuración afectada.
- Añade una selección válida al carrito y verifica el precio calculado por el servidor.
- Si los archivos están habilitados, prueba una carga y una descarga autorizadas sin copiar una URL pública permanente.
Solución de problemas
Si POM storefront está inactiva, desactiva la extensión oficial WooCommerce Product Add-Ons antes de usar la tienda POM. El panel nunca cambia por sí mismo el estado de traspaso.
Si un índice sigue obsoleto después del mantenimiento, ejecuta otra vista previa. Una publicación de configuración simultánea puede invalidar de forma intencionada la vista previa anterior. La resolución de productos puede recurrir a los registros de origen mientras el índice no esté disponible, pero la obsolescencia repetida debe investigarse antes de realizar cambios amplios en el catálogo.
Si los recuentos de huérfanos de traducción o de limpieza siguen siendo distintos de cero, sigue el flujo de trabajo de migración de identidad de traducción y limpieza para ese sitio. Site Health informa de la condición pero no elimina las cadenas de traducción.
Si las cargas privadas no están disponibles, confirma que el directorio privado local tiene permisos de escritura o que el adaptador de almacenamiento implementa almacenamiento, descarga autorizada, eliminación y la devolución de llamada de estado. No resuelvas el aviso exponiendo el directorio privado mediante una URL web pública.
Si Shared capacity ledger no está disponible, las opciones reutilizables gestionadas fallan de forma segura en la validación del carrito y en el pago. Confirma que el usuario de base de datos del sitio puede crear y actualizar el almacenamiento de capacidad de Product Add-Ons con ámbito de sitio y, a continuación, vuelve a cargar el tweak habilitado para que pueda ejecutarse su comprobación de esquema. Si Expired-hold cleanup se retrasa, las filas caducadas dejan de contarse inmediatamente en función de su caducidad UTC; el cron solo realiza una limpieza física acotada.
Guías relacionadas: Configurar grupos y opciones reutilizables, Gestionar la disponibilidad de opciones reutilizables y la capacidad compartida y Integrar Product Add-Ons.