获取 WooCommerce 客户订单信息：完整指南_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

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

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

2025-11-16

浏览次数：次

返回列表

获取 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>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/1852">
                            <img src="https://img.php.cn/upload/ai_manual/000/969/633/68b6c77ba67c5501.png" alt="Zyro AI Background Remover">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/1852">Zyro AI Background Remover</a>
                            <p>Zyro推出的AI图片背景移除工具</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="Zyro AI Background Remover">
                                <span>145</span>
                            </div>
                        </div>
                        <a href="/ai/1852" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="Zyro AI Background Remover">
                        </a>
                    </div>
                ';
            endforeach;
        endif;
    endif;
}

代码解释：

add_action( 'woocommerce_admin_order_data_after_shipping_address', 'edit_woocommerce_order_page', 10, 1 );：将自定义函数 edit_woocommerce_order_page 挂载到 WooCommerce 后台订单编辑页面的 woocommerce_admin_order_data_after_shipping_address 钩子上。
$customer_id = $order->get_user_id();：获取当前订单的客户 ID。
if($customer_id != 0):：判断是否为注册用户订单（访客订单的客户 ID 为 0）。
$args = array(...)：定义查询参数，包括客户 ID、订单状态（默认为 wc-completed，即已完成）以及需要排除的订单 ID（当前订单）。
$orders = wc_get_orders( $args );：使用 wc_get_orders() 函数根据参数获取订单对象数组。
if($orders):：判断是否获取到订单。
foreach($orders as $k=>$order):：循环遍历订单数组，输出每个订单的账单地址。
echo '
账单地址：'.$order->get_billing_address_1().'
';：输出账单地址信息。

注意事项：

'status' => array('wc-completed')：可以根据实际需求修改订单状态，例如 'status' => array('wc-processing', 'wc-completed') 获取正在处理和已完成的订单。
此方法会获取客户的所有已完成订单，如果客户订单数量较多，可能会影响页面加载速度。

方法二：限制订单数量

此方法与方法一类似，但限制了获取的订单数量。

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。

注意事项：

'limit' => 2：可以根据实际需求修改限制的订单数量。
此方法获取的是最新的 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();
    // 获取当前订单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);
        // 根据当前订单的键获取前一个订单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;
}

代码解释：

$args = array(...)：定义查询参数，'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));：将订单 ID 数组的键值互换，方便查找当前订单的键。
$current_order_key = array_keys($all_order_ids, $order_id);：获取当前订单在订单 ID 数组中的键。
$all_order_id_values = array_values($all_order_ids);：获取所有订单 ID 的值。
$previous_order_id = $all_order_id_values[$all_order_id_keys[$current_order_key[0]]+1];：根据当前订单的键，获取前一个订单的 ID。
$order_args = array(...)：定义查询参数，'post__in' => array($order_id,$previous_order_id) 表示获取当前订单和前一个订单。
$orders = wc_get_orders( $order_args );：根据参数获取订单对象数组。

注意事项：