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 '
账单地址：'.$order->get_billing_address_1().'
';
            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 '
账单地址：'.$order->get_billing_address_1().'
';
            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 '
账单地址：'.$order->get_billing_address_1().'
';
            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() 函数只获取当前订单和前一个订单。

注意事项：

• 上述代码假设订单ID数组是按照时间顺序排列的，即越新的订单ID越靠前。
• 如果当前订单是客户的第一个订单，那么 $previous_order_id 将会是 null，需要进行判断。

总结

本文介绍了三种不同的方法来获取 WooCommerce 客户订单信息，包括获取所有已完成订单、限制订单数量以及精确获取当前订单和前一个订单的账单地址。你可以根据自己的需求选择合适的方法，并进行相应的修改和扩展。希望本文能够帮助你更好地理解和使用 WooCommerce 的订单管理功能。