WooCommerce：为新客户订单自动添加管理员备注-php教程-PHP中文网

WooCommerce：为新客户订单自动添加管理员备注

聖光之護

发布： 2025-12-03 11:34:02

原创

789人浏览过

woocommerce：为新客户订单自动添加管理员备注

本教程详细指导如何在 WooCommerce 中利用 woocommerce_thankyou 钩子和 PHP 代码，自动识别首次下单的注册客户，并为其订单添加特定的管理员备注。文章将提供完整的代码示例，并解释如何通过检查用户历史订单数量来准确判断新客户，确保备注只应用于首单，从而提升订单管理效率。

引言：为何标记新客户订单？

在电商运营中，识别并关注新客户对于提升客户满意度、进行精准营销和优化售后服务至关重要。通过在 WooCommerce 订单后台为首次下单的客户自动添加管理员备注，商家可以迅速识别这些订单，从而提供个性化的服务，例如发送欢迎邮件、提供首次购物优惠或进行特殊的产品打包。这种自动化机制能够显著提高运营效率，避免人工审查每个订单的繁琐。

核心实现：利用 woocommerce_thankyou 钩子

WooCommerce 提供了丰富的钩子（Hook）机制，允许开发者在特定事件发生时执行自定义代码。woocommerce_thankyou 钩子在用户完成订单并进入“感谢”页面时触发，是进行订单后处理的理想时机。此钩子会传递当前订单的 ID，我们可以利用这个 ID 来获取订单详情并进行操作。

识别新客户的逻辑

要准确识别新客户，我们需要执行以下步骤：

易方销售系统EfangIsale

1 先进的多级用户及代理商管理功能 2 透明的会员资金管理，系统自动完成会员资金的管理业务。 3 规范的业务流程，客户提交订单--业务人员受理订单--技术人员开通业务，简单，规范，使用的企业管理更加规范化。 4 便捷安装接入，只要把你的前台链接到我们指定的入口，其它的业务管理全部由系统自动完成。 5 领先的产品及菜单管理功能。可对产品和会员的菜单进行动态的增加、修改、删除，从而使用轻松方便的增加新

查看详情

检查用户登录状态：只有登录用户才能通过其用户 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 文件中，或通过自定义插件实现。

<?php
/**
 * 为 WooCommerce 中的新客户订单添加管理员备注
 *
 * 当用户完成首个订单时，自动在订单后台添加“新客户”备注。
 */
function 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 钩子只在用户完成订单时触发一次，因此通常不会造成显著的性能问题。