本文档旨在指导开发者如何在 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;
}代码解释：
- 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 客户订单信息的方法，开发者可以根据实际需求选择合适的方法。需要注意的是，在获取大量订单信息时，应考虑性能问题，避免影响页面加载速度。同时，需要对可能出现的异常情况进行处理，例如访客订单、订单不存在等。
