如何在 WooCommerce 中通过短代码安全获取当前用户的所有订单信息-php教程-PHP中文网

如何在 WooCommerce 中通过短代码安全获取当前用户的所有订单信息

本文详解如何使用 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 对象数组，安全、可扩展且兼容性好。

以下为两个推荐的短代码实现：

✅ 获取当前用户所有订单编号（逗号分隔）

add_shortcode('prcsed_order_numb', 'wpse_get_customer_order_numbers');
function wpse_get_customer_order_numbers() {
    // 确保用户已登录，防止未授权访问
    if (!is_user_logged_in()) {
        return '<p class="error">请先登录以查看您的订单。</p>';
    }

    $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) 
        : '暂无订单';
}

✅ 获取当前用户所有订单中的商品名称（去重合并）

注意：订单中可能含多个商品，此处示例提取首个商品名称；如需全部商品，可嵌套遍历 $order->get_items()。

add_shortcode('prcsed_order_name', 'wpse_get_customer_order_names');
function wpse_get_customer_order_names() {
    if (!is_user_logged_in()) {
        return '<p class="error">请先登录以查看您的订单。</p>';
    }

    $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)) 
        : '暂无订单商品';
}