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

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

DDD

发布： 2025-11-16 12:06:33

原创

474人浏览过

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

登录后复制

代码解释：

微信 WeLM

WeLM不是一个直接的对话机器人，而是一个补全用户输入信息的生成模型。

查看详情

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 '<p><strong>账单地址：</strong>'.$order->get_billing_address_1().'</p>';：输出账单地址信息。

注意事项：

'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 );：根据参数获取订单对象数组。

注意事项：

此方法需要获取客户的所有订单 ID，然后再根据当前订单的 ID 查找前一个订单的 ID。
如果当前订单是客户的第一个订单，则 $previous_order_id 可能为空。需要添加相应的判断逻辑。
此方法假设订单 ID 是连续的。如果订单 ID 不连续，则可能无法正确获取前一个订单。

总结

本文介绍了三种获取 WooCommerce 客户订单信息的方法，开发者可以根据实际需求选择合适的方法。需要注意的是，在获取大量订单信息时，应考虑性能问题，避免影响页面加载速度。同时，需要对可能出现的异常情况进行处理，例如访客订单、订单不存在等。

以上就是获取 WooCommerce 客户订单信息：完整指南的详细内容，更多请关注php中文网其它相关文章！