Compatibilidad con WooCommerce Blocks (Cart y Checkout)

Los productos de suscripción se renderizan correctamente en el nuevo Carrito y Checkout basados en bloques de WooCommerce. Precio recurrente, signup fee, periodo de prueba, fecha de anclaje y tier de descuento aparecen en la UI de bloques sin tocar plantillas del tema.

Prerequisitos

• WooCommerce 8.3+ (el paquete WC Blocks se fusionó en el core; ya no hace falta el plugin standalone WooCommerce Blocks).
• Las páginas de tu tienda usan la versión bloque: Página → Carrito contiene un bloque woocommerce/cart, Página → Finalizar compra contiene un bloque woocommerce/checkout.
• Un tema con soporte para el editor de bloques Gutenberg (cualquier tema basado en bloques moderno; los temas clásicos funcionan si las páginas de carrito/checkout se guardaron con los bloques).

En el Cart Block

• Subtotal del item muestra el precio recurrente ("€19 cada mes") junto a cada item de suscripción.
• Signup fee se renderiza como línea separada ("Cuota de alta única: €25") cuando existe.
• Periodo de prueba aparece como nota pequeña bajo el precio ("Primer mes gratis").
• Tier de descuento, si lo hay, se muestra con el precio original tachado y el descontado ("€19 → €15 los primeros 3 meses").
• Resumen del pedido al final del bloque separa "Total hoy" de "Total recurrente".

En el Checkout Block

• El panel de resumen del pedido refleja el desglose del Cart Block (signup, recurrente, prueba, descuento).
• Los productos de suscripción fuerzan la creación de cuenta en el checkout — el plugin filtra woocommerce_checkout_registration_enabled cuando el carrito contiene una suscripción. El bloque lo respeta y muestra el campo de contraseña.
• El selector de método de pago muestra solo las pasarelas con soporte de tokenización; las que no tokenizan quedan ocultas vía woocommerce_available_payment_gateways.
• El botón Realizar pedido lee "Suscribirse" en lugar de "Realizar pedido" cuando al menos un item del carrito es una suscripción. Personalizable vía filtro (ver Hooks).

Páginas de producto de suscripción

La página de producto individual es totalmente block-aware. El bloque de precio (woocommerce/product-price) llama a WC_Product::get_price_html(), método que el plugin sobreescribe para productos de suscripción. Así que el bloque de precio imprime automáticamente "€19 cada mes / Cancela cuando quieras" sin que tengas que añadir ningún bloque específico de suscripción.

Bordes conocidos

• Mini-carrito en bloque muestra el precio recurrente pero recorta las notas de prueba y signup fee por espacio. El desglose completo aparece en la página de carrito.
• Botones de express checkout (Apple Pay, Google Pay, Stripe Link) funcionan para items de suscripción siempre que la pasarela soporte tokenización recurrente. Ver el doc de Stripe.
• Bloques personalizados de checkout de terceros pueden no renderizar las notas específicas de suscripción. Prueba antes de pasar a producción.

Hooks relevantes

• aswc_cart_block_item_data — filtra los datos por item que pasamos al endpoint REST del Cart Block.
• aswc_checkout_block_place_order_label — filtra la etiqueta del botón "Suscribirse".
• aswc_subscription_price_html — cambia el HTML que devuelve el bloque de precio para productos de suscripción.