获取 WooCommerce 客户订单：完整指南-php教程-PHP中文网

获取 WooCommerce 客户订单：完整指南

花韻仙語

发布： 2025-11-16 12:14:23

原创

663人浏览过

获取 woocommerce 客户订单：完整指南

本文旨在指导开发者如何在 WooCommerce 中获取特定客户的订单信息，包括获取所有已完成订单、限制订单数量以及获取当前订单和上一个订单的详细信息（如账单地址）。通过提供的代码示例，你将能够轻松地在 WooCommerce 后台的订单编辑页面显示所需的客户订单数据。

在 WooCommerce 平台中，有时我们需要获取特定客户的订单信息，例如获取其所有已完成的订单，或者仅获取最近的几个订单，甚至获取当前订单和上一个订单的账单地址等详细信息。本文将详细介绍如何实现这些需求，并提供相应的代码示例。

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

以下代码段展示了如何获取指定客户的所有已完成订单，并在 WooCommerce 后台的订单编辑页面显示每个订单的账单地址：

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;
}

登录后复制

代码解释：

知我AI·PC客户端

离线运行 AI 大模型，构建你的私有个人知识库，对话式提取文件知识，保证个人文件数据安全

查看详情

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 钩子上，以便在 WooCommerce 后台订单编辑页面的送货地址之后显示自定义内容。
$customer_id = $order->get_user_id();：获取当前订单的客户 ID。
if($customer_id != 0):：检查客户 ID 是否为 0，如果不是 0，则表示该订单不是访客订单。
$args = array(...);：定义一个数组 $args，用于传递给 wc_get_orders() 函数，以指定查询订单的参数。
- 'customer_id' => $customer_id：指定要查询的客户 ID。
- 'status' => array('wc-completed')：指定要查询的订单状态为“已完成”。
- 'exclude' => array( $order->get_id() )：排除当前订单，避免重复显示。
$orders = wc_get_orders( $args );：使用 wc_get_orders() 函数根据指定的参数查询订单，并将结果存储在 $orders 变量中。
if($orders):：检查是否找到了订单。
foreach($orders as $k=>$order):：循环遍历找到的订单。
echo '<p><strong>账单地址:</strong>'.$order->get_billing_address_1().'</p>';：在页面上显示每个订单的账单地址。

注意事项：

可以根据需要修改 $args 数组中的 'status' 键值，以查询不同状态的订单，例如 'wc-processing'（处理中）或 'wc-cancelled'（已取消）。
此代码将所有已完成的订单都显示出来，如果订单数量过多，可能会影响页面加载速度。可以考虑使用分页或其他方式来限制显示的订单数量。

限制显示的订单数量

如果只需要显示最近的几个订单，可以使用 limit 参数来限制 wc_get_orders() 函数返回的订单数量。以下代码段展示了如何获取指定客户的最近两个已完成订单：

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;
}

登录后复制

代码解释：

与上一个示例相比，此代码段仅在 $args 数组中添加了一个 'limit' => 2 键值对，用于限制 wc_get_orders() 函数返回的订单数量为 2。

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

以下代码段展示了如何获取指定客户的当前订单和上一个订单的账单地址：

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 );
        // 查找当前订单在所有订单中的键
        $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);
        // 从所有值中查找当前订单的键，并加 1 获取上一个订单的 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 );

登录后复制

代码解释：