You need to enable JavaScript to run this app. WooCommerce WPGens Referral插件:如何将推荐码展示在邮件订单详情上方
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.29 10:27:03