WooCommerce WPGens Referral插件:如何将推荐码展示在邮件订单详情上方
调整推荐码在WooCommerce邮件中的展示位置
原代码会把推荐码堆在邮件底部,核心原因是挂载的woocommerce_email_customer_details钩子本身就处于邮件模板的靠后区块,设计定位就是展示完订单核心信息之后才加载的附加内容。只要把回调挂载的钩子换成订单表格前置的位置,就能让推荐码成为客户打开邮件后最先看到的内容,完全不需要改动你原来的推荐码获取、展示逻辑。
具体操作
- 先移除原来挂载在
woocommerce_email_customer_details上的旧回调,避免推荐码在底部和前置位置重复输出。移除操作必须和原add_action的参数完全一致,否则无法生效。 - 将同一个推荐码输出函数,重新挂载到WooCommerce邮件模板专属的「订单表格正上方」钩子
woocommerce_email_before_order_table上,设置合适的执行优先级,保证内容刚好展示在订单详情模块的最顶部。
调整后的完整代码
// 移除旧的底部输出逻辑,避免重复展示 remove_action( 'woocommerce_email_customer_details', 'gens_raf_customer_email', 30, 3 ); function gens_raf_customer_email( $order, $sent_to_admin, $plain_text, $email ) { // 可选配置:管理员收件的邮件里不展示客户的推荐码 if ( $sent_to_admin ) return; $user_id = ( version_compare( WC_VERSION, '2.7', '<' ) ) ? $order->customer_user : $order->get_customer_id(); if( ! empty( $user_id ) && ( get_user_meta($user_id, "gens_referral_id", true) ) != '' ){ $code = get_user_meta($user_id, "gens_referral_id", true); } else { $code = ( version_compare( WC_VERSION, '2.7', '<' ) ) ? $order->billing_email : $order->get_billing_email(); } if( $plain_text ){ _e('Your referral code is: ','gens-raf') . $code; } else { echo '<p style="text-align:center;margin-top:10px;">Your referral code is: ' .get_home_url() .'?raf='. $code . '</p>'; } } // 挂载到订单表格上方的钩子,参数数量和钩子要求完全匹配 add_action('woocommerce_email_before_order_table', 'gens_raf_customer_email', 20, 4 );
补充说明
woocommerce_email_before_order_table钩子从WooCommerce 2.7版本开始就默认接收4个参数,和你原函数需要的参数完全兼容,从旧版本到最新版WooCommerce都能正常运行。- 代码中的管理员邮件判断逻辑是可选的,如果需要在给管理员发送的订单通知里也展示对应客户的推荐码,直接删掉那行判断代码即可。
- 推荐码的排版样式可以根据品牌需求自由调整,使用内联样式不会被WooCommerce邮件的默认模板样式覆盖。
内容的提问来源于stack exchange,提问作者Aleksei
相关产品推荐
相关产品推荐

