移除 WooCommerce 订单邮件产品备注方法

在 WooCommerce 商店运营中，有时需要根据不同的邮件类型，调整订单邮件的内容。一个常见的需求是，在订单完成邮件中移除产品购买备注，而在订单确认邮件中保留。直接使用 woocommerce_email_order_items_args 钩子可能会全局禁用购买备注，影响所有邮件。本文将介绍一种更精确的方法，通过邮件ID来控制购买备注的显示，只在指定的邮件类型中生效。

基于邮件ID的解决方案

该方案的核心思想是，首先获取当前正在发送的邮件的ID，然后根据ID判断是否为需要隐藏购买备注的邮件类型。为此，我们需要使用两个钩子：woocommerce_email_before_order_table 和 woocommerce_email_order_items_args。

步骤 1: 获取邮件ID

woocommerce_email_before_order_table 钩子在订单表格之前触发，我们可以利用它来获取邮件ID，并将其存储在一个全局变量中。

// 设置邮件ID为全局变量
function action_woocommerce_email_before_order_table( $order, $sent_to_admin, $plain_text, $email ) {           
    $GLOBALS['email_id_str'] = $email->id;
}
add_action( 'woocommerce_email_before_order_table', 'action_woocommerce_email_before_order_table', 10, 4 );

这段代码定义了一个名为 action_woocommerce_email_before_order_table 的函数，它接收四个参数：$order (订单对象), $sent_to_admin (是否发送给管理员), $plain_text (是否为纯文本格式), 和 $email (邮件对象)。我们只需要 $email 对象，从中提取 id 属性，并将其存储在全局变量 $GLOBALS['email_id_str'] 中。

步骤 2: 根据邮件ID过滤购买备注

现在，我们可以使用 woocommerce_email_order_items_args 钩子，根据全局变量中存储的邮件ID，来决定是否显示购买备注。

function filter_woocommerce_email_order_items_args( $args ) {
    // 获取邮件ID全局变量
    $refNameGlobalsVar = $GLOBALS;
    $email_id = isset( $refNameGlobalsVar['email_id_str'] ) ? $refNameGlobalsVar['email_id_str'] : '';

    // 针对特定邮件. 可以添加多个状态，用逗号分隔
    if ( in_array( $email_id, array( 'customer_completed_order', 'customer_invoice' ) ) ) {
        // 隐藏购买备注
        $args['show_purchase_note'] = false;
    }

    return $args;
}
add_filter( 'woocommerce_email_order_items_args', 'filter_woocommerce_email_order_items_args', 10, 1 );

这段代码定义了一个名为 filter_woocommerce_email_order_items_args 的函数，它接收一个参数 $args，该参数是一个数组，包含了控制订单项目显示的参数。我们首先从全局变量中获取邮件ID，然后使用 in_array 函数判断该ID是否在需要隐藏购买备注的邮件ID列表中。如果匹配，则将 $args['show_purchase_note'] 设置为 false，从而隐藏购买备注。

步骤 3: 添加代码到您的 WooCommerce 站点

将上述两个代码片段添加到您的 WordPress 主题的 functions.php 文件中，或者使用代码片段插件。

注意事项:

• 邮件ID: customer_completed_order 是 WooCommerce 订单完成邮件的ID。您可以通过查看 WooCommerce 的源码或使用调试工具来确定其他邮件的ID。
• 多个邮件ID: 您可以在 in_array 函数的第二个参数中添加多个邮件ID，用逗号分隔，例如 array( 'customer_completed_order', 'customer_processing_order' )。
• 代码位置: 建议将代码添加到子主题的 functions.php 文件中，以避免主题更新导致代码丢失。

总结

通过这种基于邮件ID的解决方案，您可以精确控制 WooCommerce 订单邮件中产品购买备注的显示，满足不同的业务需求。该方法避免了全局禁用购买备注的副作用，提高了代码的灵活性和可维护性。 请务必根据您的实际需求修改代码，并进行充分的测试。