Cómo Mostrar u Ocultar el Botón Contraentrega Condicionalmente por Producto, Precio, Categoría o Rol

En muchas tiendas híbridas que venden tanto productos con Pago Contra Entrega (COD) como productos digitales, preventas o artículos de alto valor que solo aceptan pago anticipado, es indispensable controlar exactamente en qué productos, categorías, precios o roles de usuario se muestra el botón de compra rápida.

En esta guía aprenderás los 3 métodos oficiales (desde la casilla nativa por producto hasta el control programático mediante woocommerce_locate_template y prcod_pre_render_payment_button) disponibles en Modal COD Form Free y PRO.

1. Método 1 (Sin Código): Deshabilitar el Botón COD en un Producto Específico

Tanto la versión Free (mediante la clase MODALCODF_Product_Fields) como la versión PRO incluyen un control nativo en cada ficha de producto de WooCommerce:

  1. Edita el producto en Productos → Todos los productos.
  2. En la caja Datos del producto → Pestaña General, marca la casilla Deshabilitar botón Modal COD Form en este producto (metadato _cod_disable_button = yes).
  3. Actualiza el producto.

Cuando _cod_disable_button vale 'yes':

  • El filtro woocommerce_locate_template omite el reemplazo de las plantillas simple.php, variable.php y variation-add-to-cart-button.php, devolviendo a ese producto el botón nativo «Añadir al carrito» de WooCommerce.
  • Incluso si alguien inserta manualmente el shortcode [custom_add_to_cart_button id="123"] o [modalcodf_custom_add_to_cart_button id="123"] para ese producto, el renderizador verifica primero is_cod_disabled($product_id) y cancela su impresión.

2. Método 2 (PHP): Deshabilitar el Botón COD por Categoría, Precio Mínimo/Máximo o Rol de Usuario

Dado que ambos plugins consultan el metadato _cod_disable_button a través de get_post_meta($product_id, '_cod_disable_button', true), puedes interceptar su lectura en tiempo real usando el filtro estándar de WordPress get_post_metadata para aplicar reglas globales sin editar cientos de productos manualmente:

/**
 * Deshabilitar dinámicamente el botón Modal COD Form según Categoría, Precio o Rol de Usuario
 * Compatible tanto con Modal COD Form Free como con Modal COD Form PRO.
 */
add_filter( 'get_post_metadata', function( $value, $object_id, $meta_key, $single ) {
    if ( '_cod_disable_button' !== $meta_key || is_admin() ) {
        return $value;
    }

    $product = wc_get_product( $object_id );
    if ( ! $product ) {
        return $value;
    }

    // Regla A: Deshabilitar COD en categorías específicas (ej. 'mayoristas' o 'preventa')
    if ( has_term( array( 'mayoristas', 'preventa' ), 'product_cat', $object_id ) ) {
        return $single ? 'yes' : array( 'yes' );
    }

    // Regla B: Deshabilitar COD si el precio del producto supera $1.000.000
    $price = (float) $product->get_price();
    if ( $price > 1000000 ) {
        return $single ? 'yes' : array( 'yes' );
    }

    // Regla C: Ocultar COD para usuarios con rol 'wholesale_customer' (B2B)
    if ( is_user_logged_in() && current_user_can( 'wholesale_customer' ) ) {
        return $single ? 'yes' : array( 'yes' );
    }

    return $value;
}, 10, 4 );

3. Método 3 (PRO): Inyectar Avisos o Lógica Previa con prcod_pre_render_payment_button

En Modal COD Form PRO, justo antes de renderizar la plantilla templates/payment-button.php, se ejecuta la acción do_action( 'prcod_pre_render_payment_button', $product ). Este hook es ideal para mostrar insignias de confianza, contadores de despacho en el mismo día o avisos dinámicos encima del botón contraentrega:

/**
 * Mostrar aviso dinámico de despacho en el mismo día encima del botón COD
 */
add_action( 'prcod_pre_render_payment_button', function( $product ) {
    if ( ! $product instanceof WC_Product ) {
        return;
    }

    // Obtener la hora actual según la zona horaria configurada en WordPress
    $current_hour = (int) current_time( 'G' );

    if ( $current_hour < 15 ) {
        echo '<div class="cod-same-day-dispatch-badge">⚡ Pide antes de las 3:00 PM y despachamos HOY mismo con Pago Contra Entrega.</div>';
    }
}, 10, 1 );

4. Cómo Funciona el Reemplazo de Plantillas (woocommerce_locate_template)

Para garantizar compatibilidad con temas modernos y constructores visuales, el plugin intercepta el filtro woocommerce_locate_template (prioridad 10) únicamente sobre 4 plantillas específicas:

  • single-product/add-to-cart/simple.php
  • single-product/add-to-cart/variable.php
  • single-product/add-to-cart/variation-add-to-cart-button.php
  • cart/mini-cart.php

Si deseas mantener el mini-carrito original de tu tema (por ejemplo, el slide-cart de WoodMart, Flatsome o Astra) pero conservar el botón COD en las páginas de producto, puedes excluir cart/mini-cart.php con este filtro:

/**
 * Conservar la plantilla original de mini-cart.php del tema activo
 */
add_filter( 'woocommerce_locate_template', function( $template, $template_name, $template_path ) {
    if ( 'cart/mini-cart.php' === $template_name ) {
        return WC()->plugin_path() . '/templates/' . $template_name;
    }
    return $template;
}, 20, 3 );

5. Enlaces Relacionados

Compartir esta información

Aumenta tus ventas

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