在 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 订单邮件中产品购买备注的显示，满足不同的业务需求。该方法避免了全局禁用购买备注的副作用，提高了代码的灵活性和可维护性。 请务必根据您的实际需求修改代码，并进行充分的测试。
