本文档旨在指导开发者如何在 WooCommerce 后台订单编辑页面获取指定客户的订单信息，特别是当前订单和之前的订单的账单地址。通过提供的代码示例，您可以轻松地在后台订单编辑页面显示客户的过往订单账单地址，方便您进行订单管理和客户服务。
获取 WooCommerce 客户订单信息
在 WooCommerce 开发中，经常需要获取客户的订单信息，例如账单地址、订单状态等。本教程将介绍如何在 WooCommerce 后台订单编辑页面获取当前客户和之前订单的账单地址。
前提条件
- 已安装并激活 WooCommerce 插件。
- 熟悉 WordPress 和 WooCommerce 的基本开发知识。
- 了解 PHP 编程语言。
实现步骤
我们将通过以下步骤实现目标：
- 使用 woocommerce_admin_order_data_after_shipping_address 钩子，在后台订单编辑页面添加自定义内容。
- 获取当前订单的客户 ID。
- 使用 wc_get_orders() 函数获取客户的所有已完成订单。
- 遍历订单，提取账单地址信息并显示。
代码实现
以下是获取所有已完成订单的代码示例：
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_admin_order_data_after_shipping_address 钩子，在后台订单编辑页面的配送地址后显示自定义内容。
- $order->get_user_id()：获取当前订单的客户 ID。
- $args 数组：用于配置 wc_get_orders() 函数的参数。
- customer_id：客户 ID，用于筛选指定客户的订单。
- status：订单状态，这里设置为 wc-completed，表示已完成的订单。可以根据需求修改为其他状态，如 wc-processing（处理中）、wc-on-hold（待处理）等。
- exclude：排除的订单 ID，这里排除当前订单，避免重复显示。
- wc_get_orders( $args )：获取符合条件的订单数组。
- foreach 循环：遍历订单数组，提取每个订单的账单地址信息，并使用
标签显示。
限制订单数量
如果您只想显示最近的几个订单，可以使用 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 '<p><strong>账单地址：</strong>'.$order->get_billing_address_1().'</p>';
endforeach;
endif;
endif;
}获取当前订单和之前的订单
以下代码示例展示了如何获取当前订单和之前的订单信息：
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);
// 从所有值中查找当前订单的键值，并加 1 获取前一个订单的 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;
}
add_action( 'woocommerce_admin_order_data_after_shipping_address', 'edit_woocommerce_order_page', 10, 1 );代码解释：
- $args 数组：
- return：设置为 ids，表示只返回订单 ID。
- posts_per_page：设置为 -1，表示获取所有订单。
- array_flip(array_keys($all_order_ids))：将订单 ID 数组的键和值进行反转，方便查找当前订单的键值。
- array_keys($all_order_ids, $order_id)：查找当前订单 ID 在数组中的键值。
- $all_order_id_values[$all_order_id_keys[$current_order_key[0]]+1]：获取前一个订单的 ID。
- $order_args 数组：用于获取当前订单和前一个订单的信息。
- post__in：指定要获取的订单 ID 数组。
注意事项
- 请根据实际需求修改代码中的订单状态、订单数量等参数。
- 在生产环境中，建议对代码进行错误处理和安全性检查。
- 可以根据需要提取订单的其他信息，如订单总额、下单时间等。
- 确保代码放置在主题的 functions.php 文件或自定义插件中。
总结
通过本教程，您学习了如何在 WooCommerce 后台订单编辑页面获取客户的订单信息，包括当前订单和之前的订单的账单地址。您可以根据自己的需求修改代码，实现更复杂的功能。希望本教程对您有所帮助！
