Solucionar problemas de los productos compuestos

Empieza por el síntoma que se indica a continuación. POM Tweaks conserva la última configuración válida guardada cuando falla la validación de un editor, una importación o el servidor.

Falta el tipo de producto compuesto

Confirma que WooCommerce esté activo y, a continuación, ve a Settings → POM Tweaks → E-Commerce → Products y activa Composite products. En multisitio, comprueba el sitio actual en lugar de suponer que se aplica la configuración de otro sitio.

Desactivar el ajuste elimina su comportamiento en el editor de productos, la tienda, la REST, el carrito, los pedidos y los bloques, sin eliminar los productos guardados ni los datos históricos de los pedidos.

El producto no se guarda

Lee todos los avisos de error de WooCommerce y expande el capítulo o la regla indicados. Las causas más comunes son:

• un capítulo sin una fuente válida;
• el mismo producto incluido y excluido explícitamente;
• una variación predeterminada fuera de la fuente del capítulo;
• cantidades mínimas, máximas o exactas contradictorias;
• una fila de precios, escenarios o compatibilidad incompleta;
• un producto, una variación, una categoría o una imagen que faltan;
• un capítulo reutilizable vinculado que debe restaurarse, desvincularse o volver a vincularse; o
• un escenario o ciclo de compatibilidad imposible.

Corrige la ruta indicada y vuelve a guardar. No des por hecho que un cambio de campo realizado en el navegador se haya almacenado después de una solicitud rechazada.

El total no está disponible

La tienda no confía en un precio calculado en el navegador. Comprueba que todos los capítulos visibles obligatorios estén completos, que las cantidades cumplan los límites del capítulo y los globales, que las variaciones se puedan comprar, que el stock sea suficiente, que se cumplan las reglas de compatibilidad y que los complementos obligatorios de los componentes estén completos.

Usa Update total again después de un error de red temporal. El total anterior se borra intencionadamente y añadir al carrito permanece desactivado hasta que una cotización actual se complete correctamente.

Sigue visible “Loading component options…”

Este mensaje significa que el producto de catálogo seleccionado tiene POM Product Add-Ons y que el configurador está cargando el contrato de campos completo necesario para mostrarlos y validarlos. Los productos que el resumen ligero del catálogo confirma que no tienen complementos omiten esta solicitud y nunca muestran el mensaje. Los contratos completos se comparten entre las selecciones coincidentes de la página, y los productos seleccionados inicialmente se cargan con una concurrencia acotada.

Si la carga agota el tiempo de espera, usa Reload component options. Confirma que la configuración de Product Add-Ons esté publicada y dentro de sus límites admitidos. Un complemento de carga de archivos u otro campo no admitido bloquea ese componente en lugar de aceptar una carga de carrito incompleta. Un fallo temporal de la solicitud no elimina silenciosamente los campos obligatorios.

Faltan opciones

En un capítulo de categoría, confirma si Category membership es Dynamic o Snapshot. Una instantánea solo cambia cuando se guarda el producto compuesto. Revisa también las exclusiones explícitas de productos y categorías, la publicación del producto, la disponibilidad de las variaciones, el stock y las exclusiones de escenarios.

El contrato de componentes integrado acepta productos simples publicados y variaciones comprables de productos variables. La búsqueda de productos y las fuentes de categorías omiten intencionadamente los tipos de producto suscripción, suscripción variable, agrupado, externo y compuesto. Escribe al menos un carácter del nombre del producto o del SKU en el selector del editor de productos. Si una categoría contiene solo uno de esos tipos no admitidos, sustituye la fuente por productos admitidos o usa una integración diseñada específicamente que implemente el ciclo de vida completo de la tienda, la facturación recurrente, el carrito, el pedido y la renovación antes de ampliar la elegibilidad del componente.

La búsqueda y los filtros consultan la fuente configurada; no conceden acceso a una opción que esté fuera de ella. Un producto seleccionado que deja de estar disponible se elimina durante la revalidación.

El constructor o el resumen aparece en el lugar equivocado

Abre Storefront layout y revisa Builder position, Builder hook priority, Summary position y Hook priority. En todos los diseños, incluido Slot builder, el constructor y el resumen son independientes y el tema debe ejecutar el hook de WooCommerce permitido seleccionado; la ubicación de la descripción larga también requiere una descripción de producto no vacía. Cuando un constructor se sitúa fuera del área predeterminada de añadir al carrito, el único control de cantidad del producto principal permanece con Product Add-Ons y el botón de añadir al carrito en la columna de compra normal de WooCommerce. Sus cambios de menos, más y entrada directa actualizan el configurador y la barra fija del producto sin requerir el script de cantidad del tema activo. Si el hook de resumen seleccionado no se ejecuta, POM Tweaks usa una alternativa de resumen en línea dentro del configurador.

El envío o los totales difieren de lo esperado

Revisa el Shipping mode del producto, la configuración de envío de cada capítulo en modo parcial, las clases de impuestos del producto principal y de los componentes, “precios introducidos con impuestos”, las restricciones de cupones y los importes fijos regionales. Usa Precio y envío de productos compuestos para rastrear el orden de cálculo.

Ejecuta el diagnóstico de solo lectura

En una sesión de staging o de soporte, selecciona el sitio exacto:

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

Un análisis completo y en buen estado no informa de errores ni de referencias rotas y no se trunca. Usa --max-products, --batch-size y --details-limit dentro de los límites documentados del comando para un catálogo más grande. El comando informa de los ID de producto y los códigos de incidencia sin imprimir las selecciones de los clientes, los nombres de producto, los cuerpos de las solicitudes ni las credenciales, y no repara los datos.

Usa wp help pomtweaks composite-products diagnose para ver las opciones instaladas y el resumen del código de salida.