获取 WooCommerce 客户订单信息：地址及订单历史

新闻中心 NEWS CENTER

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

获取 WooCommerce 客户订单信息：地址及订单历史

2025-11-17

浏览次数：次

返回列表

获取 woocommerce 客户订单信息：地址及订单历史

本文旨在指导开发者如何在 WooCommerce 后台订单编辑页面，获取指定客户的当前订单及历史订单信息，特别是账单地址。通过提供的代码示例，您可以根据客户ID检索其已完成的订单，并提取所需的账单地址信息，方便进行订单管理和数据分析。文章将详细介绍如何获取所有完成订单、限制订单数量以及获取特定订单（如当前订单的前一个订单）的方法。

在 WooCommerce 平台中，有时需要在订单管理后台获取特定客户的订单信息，例如获取当前订单和之前的订单的账单地址。这在需要进行客户行为分析、订单关联查询或者个性化客户服务时非常有用。本文将介绍如何通过 WooCommerce 提供的函数，在订单编辑页面获取客户的订单信息，并展示如何提取账单地址。

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

以下代码展示了如何在 WooCommerce 订单编辑页面，获取指定客户的所有已完成订单的账单地址。该代码通过 wc_get_orders() 函数，根据客户 ID 和订单状态筛选订单，然后循环遍历这些订单，提取账单地址并输出。

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>';
            endforeach;
        endif;
    endif;
}

代码解释：

add_action( 'woocommerce_admin_order_data_after_shipping_address', 'edit_woocommerce_order_page', 10, 1 )：将自定义函数 edit_woocommerce_order_page 挂载到 woocommerce_admin_order_data_after_shipping_address 动作钩子上，以便在订单编辑页面的配送地址之后显示自定义内容。
$customer_id = $order->get_user_id()：获取当前订单的客户 ID。
if($customer_id != 0):：判断客户 ID 是否为 0，如果为 0，则表示是访客订单，不执行后续操作。
$args = array(...)：定义查询订单的参数，包括客户 ID、订单状态和需要排除的订单 ID（当前订单）。
$orders = wc_get_orders( $args )：使用 wc_get_orders() 函数查询符合条件的订单。
foreach($orders as $k=>$order):：循环遍历查询到的订单，提取每个订单的账单地址并输出。

注意事项：

'status' => array('wc-completed')：可以根据需要修改订单状态，例如 'wc-processing' 表示处理中订单。
'exclude' => array( $order->get_id() )：排除当前订单，避免重复显示。

限制订单数量

如果只需要获取最近的几个订单，可以通过在 $args 数组中添加 'limit' => 2 参数来限制返回的订单数量。

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, // 限制返回的订单数量
        );
        $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;
}

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

以下代码展示了如何获取当前订单和前一个订单的信息。该代码首先获取客户的所有订单 ID，然后找到当前订单的 ID 在订单 ID 数组中的位置，通过该位置计算出前一个订单的 ID，最后使用 wc_get_orders() 函数查询这两个订单的信息。

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 在订单 ID 数组中的位置
        $all_order_id_keys = array_flip(array_keys($all_order_ids));
        $current_order_key = array_keys($all_order_ids, $order_id);

        // 从订单 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(); // For testing
                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：获取所有订单，不分页。
$all_order_id_keys = array_flip(array_keys($all_order_ids))：将订单 ID 数组的键和值互换，方便查找当前订单 ID 的位置。
$current_order_key = array_keys($all_order_ids, $order_id)：获取当前订单 ID 在订单 ID 数组中的位置。
$previous_order_id = $all_order_id_values[$all_order_id_keys[$current_order_key[0]]+1]：计算前一个订单的 ID。
'post__in' => array($order_id,$previous_order_id)：指定 wc_get_orders() 函数只查询当前订单和前一个订单。

注意事项：