本教程详细指导如何在 WooCommerce 中利用 woocommerce_thankyou 钩子和 PHP 代码，自动识别首次下单的注册客户，并为其订单添加特定的管理员备注。文章将提供完整的代码示例，并解释如何通过检查用户历史订单数量来准确判断新客户，确保备注只应用于首单，从而提升订单管理效率。
引言：为何标记新客户订单？
在电商运营中，识别并关注新客户对于提升客户满意度、进行精准营销和优化售后服务至关重要。通过在 WooCommerce 订单后台为首次下单的客户自动添加管理员备注，商家可以迅速识别这些订单，从而提供个性化的服务，例如发送欢迎邮件、提供首次购物优惠或进行特殊的产品打包。这种自动化机制能够显著提高运营效率，避免人工审查每个订单的繁琐。
核心实现：利用 woocommerce_thankyou 钩子
WooCommerce 提供了丰富的钩子（Hook）机制，允许开发者在特定事件发生时执行自定义代码。woocommerce_thankyou 钩子在用户完成订单并进入“感谢”页面时触发，是进行订单后处理的理想时机。此钩子会传递当前订单的 ID，我们可以利用这个 ID 来获取订单详情并进行操作。
识别新客户的逻辑
要准确识别新客户，我们需要执行以下步骤：
易方销售系统EfangIsale 1 先进的多级用户及代理商管理功能 2 透明的会员资金管理，系统自动完成会员资金的管理业务。 3 规范的业务流程，客户提交订单--业务人员受理订单--技术人员开通业务，简单，规范，使用的企业管理更加规范化。 4 便捷安装接入，只要把你的前台链接到我们指定的入口，其它的业务管理全部由系统自动完成。 5 领先的产品及菜单管理功能。可对产品和会员的菜单进行动态的增加、修改、删除，从而使用轻松方便的增加新
0 查看详情 
检查用户登录状态：只有登录用户才能通过其用户 ID 查询历史订单。对于访客结账，此方法不适用。获取当前用户 ID：如果用户已登录，获取其唯一的 WordPress 用户 ID。查询历史订单：使用 get_posts 函数查询该用户过去的所有订单。为了确保查询的准确性，我们需要指定订单的 meta_key (_customer_user) 和 meta_value (用户 ID)，以及相关的订单类型 (shop_order) 和有效的订单状态（例如“待处理”、“处理中”、“已完成”等）。判断订单数量：如果查询到的历史订单数量为零，则当前订单是该用户的首个订单，该用户即为新客户。添加管理员备注
一旦确认当前订单来自新客户，我们就可以为该订单添加一个内部管理员备注。这通过以下步骤完成：
获取订单对象：使用 wc_get_order() 函数根据订单 ID 获取订单的完整对象。添加备注：调用订单对象的 add_order_note() 方法，传入自定义的备注内容。保存订单：调用订单对象的 save() 方法，确保备注被持久化到数据库中。完整代码示例
将以下代码添加到您的 WordPress 子主题的 functions.php 文件中，或通过自定义插件实现。
<?phpfunction add_note_for_new_customer_order( $order_id ) { // 1. 验证订单 ID if ( ! $order_id ) { return; } // 2. 检查用户是否登录 if ( is_user_logged_in() ) { $customer_id = get_current_user_id(); // 获取当前登录用户的 ID // 定义需要查询的历史订单状态。 // 这些状态通常表示一个已经完成或正在处理的有效订单。 $order_statuses = array( 'wc-on-hold', 'wc-processing', 'wc-completed' ); // 3. 查询该用户的所有历史订单（排除当前订单） // 通过 meta_key '_customer_user' 关联用户 ID $customer_orders = get_posts( array( 'meta_key' => '_customer_user', 'meta_value' => $customer_id, 'post_type' => 'shop_order', 'post_status' => $order_statuses, 'numberposts' => -1, // 获取所有匹配的订单 'exclude' => array( $order_id ), // 排除当前正在处理的订单 ) ); // 4. 判断是否为新客户 // 如果历史订单数量为 0，则该用户是新客户 if ( count( $customer_orders ) < 1 ) { $order = wc_get_order( $order_id ); // 获取订单对象 $note = '*** 新客户首单 ***'; // 定义备注内容 $order->add_order_note( $note ); // 添加管理员备注 $order->save(); // 保存订单以持久化备注 } }}add_action( 'woocommerce_thankyou', 'add_note_for_new_customer_order', 10, 1 );登录后复制代码详解
function add_note_for_new_customer_order( $order_id ): 定义了一个名为 add_note_for_new_customer_order 的 PHP 函数，它接收一个参数 $order_id，即当前订单的 ID。if ( ! $order_id ) { return; }: 这是一个基本的验证，确保我们有一个有效的订单 ID。if ( is_user_logged_in() ): 检查当前用户是否已登录。此功能仅适用于注册用户。$customer_id = get_current_user_id();: 获取当前登录用户的 WordPress 用户 ID。$order_statuses = array( 'wc-on-hold', 'wc-processing', 'wc-completed' );: 定义了一个数组，包含我们认为有效的、应该计入“历史订单”的订单状态。这意味着只有处于这些状态的订单才会被视为用户的有效历史订单。get_posts(...): 这是 WordPress 查询文章（包括自定义文章类型如 shop_order）的标准函数。'meta_key' => '_customer_user', 'meta_value' => $customer_id：通过订单的元数据 _customer_user 字段来匹配用户 ID。'post_type' => 'shop_order'：指定我们要查询的帖子类型是 WooCommerce 订单。'post_status' => $order_statuses：只查询处于我们定义状态的订单。'numberposts' => -1：表示获取所有符合条件的订单，而不是限制数量。'exclude' => array( $order_id )：关键修正。为了准确判断新客户，我们需要排除当前正在处理的订单本身，只计算之前的历史订单。如果一个用户这是第一次下单，并且我们不排除当前订单，那么 count($customer_orders) 将会是 1，从而错误地将其识别为老客户。if ( count( $customer_orders ) < 1 ): 这是判断新客户的核心逻辑。如果查询到的历史订单（排除当前订单）数量小于 1（即为 0），则说明该用户是首次下单。$order = wc_get_order( $order_id );: 获取当前订单的 WC_Order 对象。`$note = '** 新客户首单 ';`**: 定义要添加到订单的备注文本。您可以根据需要自定义此文本。$order->add_order_note( $note );: 将备注添加到订单中。这个备注只会在 WooCommerce 后台可见，不会显示给客户。$order->save();: 保存对订单所做的更改，确保备注被永久存储。add_action( 'woocommerce_thankyou', 'add_note_for_new_customer_order', 10, 1 );: 将我们的函数挂载到 woocommerce_thankyou 钩子上。10 是优先级，1 表示函数接收一个参数（$order_id）。注意事项与最佳实践
代码放置位置：强烈建议将此代码放置在您主题的 functions.php 文件中（最好是子主题，以避免主题更新时代码丢失），或者作为一个自定义插件。直接修改 WooCommerce 核心文件是不可取的。仅适用于已登录用户：此解决方案依赖于 get_current_user_id() 来识别客户。对于选择作为访客结账的用户，此代码将无法识别其为新客户。如果您需要处理访客订单，需要采用不同的逻辑，例如基于客户的邮箱地址或IP地址进行判断，但这会增加复杂性。订单状态选择：在 $order_statuses 数组中，您应仔细选择哪些订单状态才算作“历史订单”。例如，如果一个订单被取消或退款，您可能不希望它计入历史订单，这取决于您的业务逻辑。备注内容自定义：您可以根据需要修改 $note 变量的值，使其更具描述性或包含更多信息。性能考量：对于拥有大量订单和客户的网站，get_posts 查询可能会对性能产生轻微影响。然而，woocommerce_thankyou 钩子只在用户完成订单时触发一次，因此通常不会造成显著的性能问题。总结
通过上述教程，您现在应该能够成功地在 WooCommerce 中为首次下单的注册客户自动添加管理员备注。这个简单的自动化功能可以显著提高您的订单管理效率，并为新客户提供更个性化的服务。请务必在开发环境中充分测试代码，以确保其按预期工作，并与您的现有系统兼容。
以上就是WooCommerce：为新客户订单自动添加管理员备注的详细内容，更多请关注php中文网其它相关文章！
