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>标签是针对订单编辑页的宽布局设计的,直接放到快速视图的窄弹窗容器里会出现样式错位、内容溢出的问题。
正确修改方案
不需要替换原有钩子,两个场景的展示逻辑拆分成独立的回调最稳定,既保留订单编辑页的原有展示效果,也能在快速视图正常展示优惠券信息:
- 保留订单编辑页的原钩子和回调逻辑,不要做替换
- 单独为快速视图编写适配的回调,通过快速视图模板的全局上下文获取订单对象,不依赖钩子传参
- 调整输出的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
相关产品推荐
相关产品推荐

