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:
- Edita el producto en Productos → Todos los productos.
- 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). - Actualiza el producto.
Cuando _cod_disable_button vale 'yes':
- El filtro
woocommerce_locate_templateomite el reemplazo de las plantillassimple.php,variable.phpyvariation-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 primerois_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.phpsingle-product/add-to-cart/variable.phpsingle-product/add-to-cart/variation-add-to-cart-button.phpcart/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 );