获取 WooCommerce 客户订单信息：包括当前订单和历史订单的账单地址

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

获取 WooCommerce 客户订单信息：包括当前订单和历史订单的账单地址

2025-11-23

浏览次数：次

返回列表

获取 woocommerce 客户订单信息：包括当前订单和历史订单的账单地址

本文旨在指导开发者如何在 WooCommerce 后台订单编辑页面，获取指定客户的当前订单和历史订单信息，特别是账单地址。我们将提供多种方法，包括获取所有已完成订单、限制订单数量以及精确获取当前订单和前一个订单的账单地址。通过本文，你将能够灵活地根据需求定制订单信息展示。

获取客户订单信息

在 WooCommerce 中，获取客户的订单信息是一个常见的需求，例如在后台订单编辑页面显示客户的历史订单信息，或者用于数据分析等。以下我们将介绍几种不同的方法，来实现这一目标。所有代码示例都将展示如何在 WooCommerce 后台订单编辑页面的“账单地址”之后添加自定义信息。

添加自定义信息到订单编辑页面

首先，我们需要使用 woocommerce_admin_order_data_after_shipping_address 钩子来在订单编辑页面添加自定义内容。

add_action( 'woocommerce_admin_order_data_after_shipping_address', 'edit_woocommerce_order_page', 10, 1 );

function edit_woocommerce_order_page($order){
    // 在这里添加你的代码
}

获取所有已完成的客户订单

以下代码展示了如何获取指定客户所有已完成的订单，并显示每个订单的账单地址。它会检查当前订单是否属于注册用户（非访客），然后获取该用户的所有已完成订单，并在订单编辑页面显示每个订单的账单地址。

add_action( 'woocommerce_admin_order_data_after_shipping_address', 'edit_woocommerce_order_page', 10, 1 );

function edit_woocommerce_order_page($order){
    $customer_id =  $order->get_user_id();
    // 检查是否为访客
    if($customer_id != 0):
        $args = array(
            'customer_id' => $customer_id,
            'status' => array('wc-completed'), // 可以修改为需要的订单状态
            'exclude' => array( $order->get_id() ), // 排除当前订单
        );
        $orders = wc_get_orders( $args );
        if($orders):
            foreach($orders as $k=>$order):
                echo '<p><strong>账单地址：</strong>'.$order->get_billing_address_1().'</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/1283">
                            <img src="https://img.php.cn/upload/ai_manual/000/000/000/175680129133514.png" alt="PictoGraphic">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/1283">PictoGraphic</a>
                            <p>AI驱动的矢量插图库和插图生成平台</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="PictoGraphic">
                                <span>133</span>
                            </div>
                        </div>
                        <a href="/ai/1283" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="PictoGraphic">
                        </a>
                    </div>
                ';
            endforeach;
        endif;
    endif;
}

代码解释：

$order->get_user_id(): 获取当前订单的客户ID。
$args: wc_get_orders() 函数的参数，用于筛选订单。
- customer_id: 指定客户ID。
- status: 指定订单状态，这里设置为 wc-completed，即已完成的订单。
- exclude: 排除当前订单，避免重复显示。
wc_get_orders($args): 根据参数获取订单对象数组。
$order->get_billing_address_1(): 获取订单的账单地址第一行。

限制获取的订单数量

如果你只需要获取最近的几个订单，可以使用 limit 参数来限制返回的订单数量。

add_action( 'woocommerce_admin_order_data_after_shipping_address', 'edit_woocommerce_order_page', 10, 1 );

function edit_woocommerce_order_page($order){
    $customer_id =  $order->get_user_id();
    // 检查是否为访客
    if($customer_id != 0):
        $args = array(
            'customer_id' => $customer_id,
            'status' => array('wc-completed'), // 可以修改为需要的订单状态
            'limit' => 2, // 限制只获取最近的 2 个订单
        );
        $orders = wc_get_orders( $args );
        if($orders):
            foreach($orders as $k=>$order):
                echo '<p><strong>账单地址：</strong>'.$order->get_billing_address_1().'</p>';
            endforeach;
        endif;
    endif;
}

代码解释：

limit => 2: 限制只获取最近的 2 个订单。

获取当前订单和前一个订单

以下代码展示了如何获取当前订单和前一个订单的账单地址。它首先获取客户的所有订单ID，然后找到当前订单的ID在订单ID数组中的位置，再根据这个位置获取前一个订单的ID。最后，使用这两个订单ID获取订单对象，并显示它们的账单地址。

function edit_woocommerce_order_page($order){
    $customer_id =  $order->get_user_id();
    // 获取当前订单ID
    $order_id = $order->get_id();
    if($customer_id != 0):
        $args = array(
            'customer_id' => $customer_id,
            'status' => array('wc-completed'), // 可以修改为需要的订单状态
            'return' => 'ids', // 获取订单ID
            'posts_per_page' => -1 // 获取所有订单
        );
        $all_order_ids = wc_get_orders( $args );
        // 查找当前订单ID的键
        $all_order_id_keys = array_flip(array_keys($all_order_ids));
        $current_order_key = array_keys($all_order_ids, $order_id);
        // 获取所有订单ID的值
        $all_order_id_values = array_values($all_order_ids);
        // 根据当前订单ID的键，获取前一个订单ID
        $previous_order_id = $all_order_id_values[$all_order_id_keys[$current_order_key[0]]+1];
        $order_args = array(
            'post__in' => array($order_id,$previous_order_id),
        );
        $orders = wc_get_orders( $order_args );
        if($orders):
            foreach($orders as $k=>$order):
                echo $order->get_id(); // 用于测试
                echo '<p><strong>账单地址：</strong>'.$order->get_billing_address_1().'</p>';
            endforeach;
        endif;
    endif;
}
add_action( 'woocommerce_admin_order_data_after_shipping_address', 'edit_woocommerce_order_page', 10, 1 );

代码解释：

'return' => 'ids': 指定 wc_get_orders() 函数返回订单ID，而不是订单对象。
'posts_per_page' => -1: 获取所有订单。
array_flip(array_keys($all_order_ids)): 将订单ID数组的键和值反转，方便查找。
array_keys($all_order_ids, $order_id): 查找当前订单ID在数组中的键。
$previous_order_id = $all_order_id_values[$all_order_id_keys[$current_order_key[0]]+1]: 根据当前订单ID的键，获取前一个订单ID。
'post__in' => array($order_id,$previous_order_id): 指定 wc_get_orders() 函数只获取当前订单和前一个订单。

注意事项：