本文详解如何使用 wc_get_orders() 正确、安全地获取当前登录用户的全部订单编号与商品名称，并封装为可复用的短代码，避免原始代码中变量未定义、提前返回、对象误用等常见错误。
本文详解如何使用 wc_get_orders() 正确、安全地获取当前登录用户的全部订单编号与商品名称，并封装为可复用的短代码，避免原始代码中变量未定义、提前返回、对象误用等常见错误。
在 WooCommerce 主题或插件开发中，常需在自定义页面（如重写的 orders.php）中动态展示当前用户的历史订单信息。但直接实例化 WC_Order 或误用未声明变量（如 $customer_order、$customer_orders）会导致返回 0、空白或致命错误——正如原始代码所示：prcsed_order_1() 中 $customer_order 未定义，new WC_Order($customer_order) 将创建无效订单对象；prcsed_order_2() 则存在变量名混淆、循环内 return 导致仅处理首条记录、且试图调用不存在的 $item->get_name() 方法等问题。
✅ 正确做法是
统一使用 wc_get_orders() 查询接口
（WooCommerce 3.0+ 推荐方式），它支持按用户 ID、状态、日期等条件高效检索订单集合，返回标准 WC_Order 对象数组，安全、可扩展且兼容性好。
以下为两个推荐的短代码实现：
✅ 获取当前用户所有订单编号（逗号分隔）
✅ 获取当前用户所有订单中的商品名称（去重合并）
注意：订单中可能含多个商品，此处示例提取
首个商品名称
；如需全部商品，可嵌套遍历 $order->get_items()。
⚠️ 关键注意事项：
安全性优先
：始终检查 is_user_logged_in()，禁止未登录用户访问订单数据；
性能优化
：设置合理 limit，避免全量查询拖垮服务器；必要时添加缓存（如 wp_cache_set/get）；
状态过滤
：默认排除 trash、cancelled 等无效订单，提升数据准确性；
错误防御
：wc_get_orders() 返回空数组而非 false，无需额外 is_array() 判断；
避免 new WC_Order() 直接传参
：该构造函数接受的是订单 ID（整数/字符串），而非未定义变量或对象。
通过以上重构，短代码可在任意页面（如 [prcsed_order_numb]）稳定输出用户订单摘要，既满足定制化需求，又符合 WooCommerce 最佳实践与数据安全规范。
add_shortcode('prcsed_order_numb', 'wpse_get_customer_order_numbers');
function wpse_get_customer_order_numbers() {
// 确保用户已登录，防止未授权访问
if (!is_user_logged_in()) {
return '请先登录以查看您的订单。
';
}
$user_id = get_current_user_id();
$orders = wc_get_orders([
'customer' => $user_id,
'status' => ['wc-completed', 'wc-processing', 'wc-on-hold'], // 可按需调整状态
'limit' => 50, // 防止大数据量拖慢页面
'orderby' => 'date',
'order' => 'DESC'
]);
$order_numbers = array_map(function($order) {
return $order->get_order_number();
}, $orders);
return !empty($order_numbers)
? implode(', ', $order_numbers)
: '暂无订单';
}add_shortcode('prcsed_order_name', 'wpse_get_customer_order_names');
function wpse_get_customer_order_names() {
if (!is_user_logged_in()) {
return '请先登录以查看您的订单。
';
}
$user_id = get_current_user_id();
$orders = wc_get_orders([
'customer' => $user_id,
'status' => ['wc-completed', 'wc-processing'],
'limit' => 30
]);
$product_names = [];
foreach ($orders as $order) {
foreach ($order->get_items() as $item) {
$product_names[] = $item->get_name();
break; // 每单只取第一个商品名（如需全部，移除此行）
}
}
return !empty($product_names)
? implode(', ', array_unique($product_names))
: '暂无订单商品';
}