Shortcodes Multi-Instancia en Landing Pages, Atributos Comodín de Variaciones y Compatibilidad con Swatches

Cuando diseñas una landing page de alta conversión (con Elementor, Gutenberg, Divi o Bricks) que presenta varios paquetes o productos distintos en la misma página, o cuando trabajas con productos variables que usan atributos comodín («Cualquier talla…») y plugins de swatches visuales, necesitas que cada botón de compra rápida funcione de forma 100% aislada.

En esta guía técnica detallamos cómo funciona el motor multi-instancia de shortcodes y la resolución de variaciones en 2 pasos tanto en Modal COD Form Free (v2.0+) como en Modal COD Form PRO (v5.0+).

1. Aislamiento CSS Multi-Instancia sin Estilos Inline (.prcod-sc-btn-{hash})

Puedes insertar múltiples shortcodes [custom_add_to_cart_button] (o [modalcodf_custom_add_to_cart_button]) en una misma página, cada uno apuntando a un id de producto diferente y con colores, tamaños o animaciones distintas:

[custom_add_to_cart_button id="101" text="Comprar Pack Básico Contra Entrega" bg_color="#1e293b" text_color="#ffffff" border_radius="8" animation="none"]

[custom_add_to_cart_button id="205" text="¡Quiero el Pack VIP con Envío Gratis!" subtitle="Paga en casa al recibir" bg_color="#16a34a" text_color="#ffffff" border_radius="50" box_shadow="0.8" animation="pulse"]

¿Cómo inyecta el plugin los estilos sin usar style="" en el HTML?

  1. Durante el hook wp_enqueue_scripts, la función prcod_collect_post_shortcode_button_css() (y su equivalente modalcodf_collect_post_shortcode_button_css() en Free) escanea $post->post_content buscando todas las apariciones del shortcode.
  2. Para cada combinación única de atributos visuales, genera un hash determinista MD5 y construye una clase única (.prcod-sc-btn-{hash} en PRO o .modalcodf-sc-btn-{hash} en Free) que define localmente las variables CSS (--cod-btn-bg, --cod-btn-color, --cod-btn-fs, --cod-btn-width, --cod-btn-radius, --cod-btn-bw, --cod-btn-bc, --cod-btn-shadow).
  3. Las reglas compiladas se adjuntan en la cabecera mediante wp_add_inline_style('modalcodf-form-style', $css). Si un shortcode se imprime fuera de post_content (por ejemplo, mediante do_shortcode() en una plantilla PHP), utiliza automáticamente el handle de respaldo prcod-shortcode-inline.

2. Aislamiento de Estado JS (cod_continue_order) por Botón

En versiones antiguas de muchos plugins COD, hacer clic en un botón cambiaba todos los botones de la página al estado «Continuar pedido», provocando que al hacer clic en un segundo producto se abriera el modal con el producto anterior.

En Modal COD Form Free v2.0 y PRO v5.0:

  • Todos los botones nacen siempre en PHP con la clase cod_add_to_cart_button prcod-payment-btn.
  • Al hacer clic en un botón, el script busca la cantidad únicamente dentro de su propio contenedor ($button.closest('.cod_container_button_order')) y añade ese producto por AJAX.
  • Al completarse la petición, restablece cualquier otro botón de la página de vuelta a cod_add_to_cart_button y asigna cod_continue_order exclusivamente al botón que el usuario acaba de clicar.
  • Si el usuario cambia la cantidad, cambia una variación/color o elimina el producto dentro del modal, el botón vuelve automáticamente a cod_add_to_cart_button.

3. Recolección de Variaciones en 2 Pasos y Atributos Comodín («Cualquier…»)

Cuando un producto es variable, el shortcode renderiza automáticamente un formulario form.variations_form.cod_shortcode_variable_form con sus selectores de atributos y encola el script nativo wc-add-to-cart-variation.

Al hacer clic en el botón COD, el recolector JavaScript y el servidor trabajan en equipo para soportar tanto selectores nativos como plugins de swatches (Variation Swatches for WooCommerce, WoodMart Swatches, etc.):

  1. Fase 1 en Frontend (Controles Nativos): Lee todos los <select> e <input> nativos cuyo nombre comience por attribute_ dentro del formulario del botón, ignorando botones y radios no marcados.
  2. Fase 2 en Frontend (Fallback para Swatches): Si algún atributo sigue vacío porque un plugin de swatches ocultó o vació el <select>, inspecciona contenedores [data-attribute_name^="attribute_"] buscando elementos activos (.selected[data-value], .active[data-value], .is-selected[data-value], .checked[data-value] o [aria-checked="true"][data-value]).
  3. Fase 3 en Servidor (resolve_variation_attributes): En el backend (PRCOD_Cart_Handler::resolve_variation_attributes), el plugin inspecciona los atributos de la variación. Si la variación tiene atributos fijos, los respeta; si tiene atributos comodín vacíos ('', es decir, «Cualquier talla / Cualquier color»), los rellena con el valor enviado por el cliente tras validarlo y normalizarlo contra los términos de taxonomía válidos del producto padre (o usa el atributo por defecto del producto).

4. Enlaces Relacionados

Compartir esta información

Aumenta tus ventas

Mejora tu conversión en tiendas WordPress y WooCommerce con pago contra-entrega.