You need to enable JavaScript to run this app. WooCommerce订单快速视图展示已用优惠券及钩子切换后失效排查
优惠活动
大模型
产品
解决方案
定价
更多

WooCommerce订单快速视图展示已用优惠券及钩子切换后失效排查

问题根源

1. 最核心的致命错误:钩子参数不匹配

  • 原钩子woocommerce_admin_order_data_after_billing_address会直接将完整的WC_Order实例作为入参传给回调函数,因此原代码可以正常获取订单数据执行展示。
  • 但目标钩子woocommerce_admin_order_preview_end的触发逻辑完全不同:它是WooCommerce订单快速视图AJAX模板的末尾钩子,触发时不会主动传入任何参数。你直接把原回调绑定到这个钩子上时,回调函数内的$order变量是未定义的空值,执行$order->get_used_coupons()时会直接抛出PHP致命错误,导致AJAX生成快速视图HTML的流程完全中断,前端收到无效响应后无法渲染弹窗,最终表现为点击眼睛图标没有任何反应。

2. 原有HTML结构不适配快速视图容器

  • 原代码输出的<h4>标题、大段宽边距<p>标签是针对订单编辑页的宽布局设计的,直接放到快速视图的窄弹窗容器里会出现样式错位、内容溢出的问题。
正确修改方案

不需要替换原有钩子,两个场景的展示逻辑拆分成独立的回调最稳定,既保留订单编辑页的原有展示效果,也能在快速视图正常展示优惠券信息:

  1. 保留订单编辑页的原钩子和回调逻辑,不要做替换
  2. 单独为快速视图编写适配的回调,通过快速视图模板的全局上下文获取订单对象,不依赖钩子传参
  3. 调整输出的HTML结构适配快速视图的窄排版

参考实现代码:

// 保留原有订单编辑页的优惠券展示逻辑
add_action( 'woocommerce_admin_order_data_after_billing_address', 'custom_checkout_field_display_admin_order_meta', 10, 1 );
function custom_checkout_field_display_admin_order_meta($order){
    if( $order->get_used_coupons() ) {
        $coupons_count = count( $order->get_used_coupons() );
        echo '<h4>' . __('Coupons used', 'woocommerce') . ' (' . $coupons_count . ')</h4>';
        echo '<p><strong>' . __('Coupons used', 'woocommerce') . ':</strong> ' . esc_html( implode(', ', $order->get_used_coupons() ) ) . '</p>';
    }
}

// 新增快速视图的优惠券展示适配逻辑
add_action( 'woocommerce_admin_order_preview_end', 'custom_order_preview_show_used_coupons' );
function custom_order_preview_show_used_coupons(){
    // 从快速视图模板的全局上下文获取当前订单对象
    global $order;
    if( ! $order instanceof WC_Order ) return;

    $used_coupons = $order->get_used_coupons();
    if( empty($used_coupons) ) return;

    // 输出适配快速视图排版的紧凑结构
    echo '<div style="margin-top:12px; padding-top:12px; border-top:1px solid #e5e5e5;">';
        echo '<strong>' . __('Coupons used', 'woocommerce') . ':</strong> ';
        echo '<span>' . esc_html( implode(', ', $used_coupons) ) . '</span>';
    echo '</div>';
}
排查提示

如果替换代码后快速视图仍然异常,可以打开浏览器的开发者工具Network面板,找到点击眼睛图标后发起的order-preview类型AJAX请求,查看响应内容是否有PHP报错信息,定位其他潜在的代码冲突。


内容的提问来源于stack exchange,提问作者Nik7

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 04:36:04