本文旨在指导开发者如何在 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 的订单管理功能。
