在WooCommerce中实现按购买日期筛选用户订单商品的功能

碧海醫心

发布时间：2025-11-20 12:28:29

546人浏览过

来源于php中文网

原创

在WooCommerce中实现按购买日期筛选用户订单商品的功能

本教程旨在指导开发者如何在woocommerce中，针对特定用户，筛选并展示其在指定日期范围内（例如最近三天）购买的商品。文章将详细介绍两种主要方法：利用`wc_get_orders`函数配合`date_created`参数，以及通过`get_posts`函数结合`date_query`参数来实现这一功能，并提供完整的代码示例及注意事项，帮助您高效地管理和展示用户购买历史。

在WooCommerce开发中，经常需要为用户展示其购买历史。然而，有时我们不仅需要展示所有已购商品，还需要根据购买日期进行筛选，例如只显示用户在最近几天内购买的商品。本文将提供两种有效的方法来实现在WooCommerce中按购买日期筛选用户已购商品的功能。

方法一：使用 wc_get_orders 函数进行日期筛选（推荐）

wc_get_orders 是WooCommerce 3.0及更高版本中推荐的订单查询方法，它提供了强大的参数来筛选订单，包括按创建日期筛选。这种方法更符合WooCommerce的API设计，通常也更高效。

实现步骤

构建查询参数数组： 定义一个包含筛选条件的 $args 数组。
指定日期范围： 使用 date_created 参数来设置订单的创建日期范围。要筛选最近三天内的订单，可以将其设置为 '>' . date( 'Y-m-d', strtotime('- 3day' ) )。这表示查询创建日期晚于三天前的订单。
执行查询： 将 $args 数组传递给 wc_get_orders 函数。
遍历订单及商品： 遍历返回的订单对象，并进一步遍历每个订单中的商品项，以获取商品详情。

示例代码

请登录以查看您的购买历史。';
    return;
}

// 获取当前用户ID
$current_user_id = get_current_user_id();

// 构建查询参数：获取最近3天内创建的订单
$args = array(
    'numberposts'  => -1,  // 获取所有匹配的订单
    'orderby'      => 'date',
    'order'        => 'DESC', // 按日期降序排列
    'customer_id'  => $current_user_id, // 筛选当前用户的订单
    'date_created' => '>' . date( 'Y-m-d', strtotime('- 3day' ) ), // 筛选创建日期在3天前的订单
);

// 执行订单查询
$customer_orders = wc_get_orders( $args );

echo '您最近3天内购买的商品：';

if ( empty( $customer_orders ) ) {
    echo '您在最近3天内没有购买任何商品。';
} else {
    echo '';
    // 遍历每个 WC_Order 对象
    foreach( $customer_orders as $order_obj ){
        // 获取订单ID（如果需要）
        $order_id = $order_obj->get_id();
        $order_date = esc_html( wc_format_datetime( $order_obj->get_date_created() ) );

        echo '订单 #' . $order_id . ' (购买日期: ' . $order_date . ')';
        echo '';

        // 遍历订单中的每个商品项
        foreach ( $order_obj->get_items() as $item_id => $item ) {
            $product = $item->get_product(); // 获取商品对象
            if ( $product ) {
                $product_name = $product->get_name();
                $product_id = $product->get_id();
                echo '商品名称: ' . esc_html( $product_name ) . ' (ID: ' . $product_id . ')';
            }
        }
        echo '';
    }
    echo '';
}

?>

方法二：使用 get_posts 函数结合 date_query

get_posts 是WordPress核心函数，用于查询各种类型的文章（包括WooCommerce的订单，因为订单在WordPress中也是一种自定义文章类型）。通过 date_query 参数，我们可以实现复杂的日期范围筛选。

睿拓智能网站系统-网上商城

睿拓智能网站系统-网上商城1.0免费版软件大小:5M运行环境：asp+access本版本是永州睿拓信息专为电子商务入门级用户开发的网上电子商城系统，拥有产品发布，新闻发布，在线下单等全部功能，并且正式商用用户可在线提供多个模板更换，可实现一般网店交易所有功能，是中小企业和个人开展个人独立电子商务商城最佳的选择，以下为详细功能介绍：1.最新产品-提供最新产品发布管理修改，和最新产品订单查看2.推荐产

下载

实现步骤

构建查询参数数组： 定义一个包含筛选条件的 $args 数组。
指定订单类型和状态： 确保 post_type 设置为 wc_get_order_types( 'view-orders' )，并且 post_status 包含所有相关的订单状态。
添加 date_query： 在 $args 中添加一个 date_query 数组，并在其中使用 after 参数来指定日期。例如，'after' => date( 'Y-m-d', strtotime('-3 days') ) 表示查询创建日期晚于三天前的订单。
执行查询： 将 $args 数组传递给 get_posts 函数。
遍历订单及商品： 遍历返回的订单文章对象，并将其转换为 WC_Order 对象，然后遍历其中的商品项。

示例代码

请登录以查看您的购买历史。';
    return;
}

$current_user_id = get_current_user_id();
$order_status = array_keys( wc_get_order_statuses() ); // 获取所有订单状态

// 构建查询参数：获取最近3天内创建的订单
$args = array(
    'numberposts' => -1, // 获取所有匹配的订单
    'meta_key'    => '_customer_user', // 按客户ID筛选
    'meta_value'  => $current_user_id,
    'post_type'   => wc_get_order_types( 'view-orders' ), // 筛选订单类型的文章
    'post_status' => $order_status, // 筛选所有订单状态
    'date_query'  => array( // 日期查询
        array(
            'after'     => date( 'Y-m-d', strtotime('-3 days') ), // 筛选创建日期在3天前的订单
            'inclusive' => true, // 包含3天前的当天
        ),
    ),
);

// 应用过滤器（如果需要自定义查询）
$customer_orders = get_posts( apply_filters( 'woocommerce_my_account_my_orders_query', $args ) );

echo '您最近3天内购买的商品：';

if ( empty( $customer_orders ) ) {
    echo '您在最近3天内没有购买任何商品。';
} else {
    echo '';
    foreach ( $customer_orders as $customer_order_post ) {
        $order = new WC_Order( $customer_order_post ); // 将文章对象转换为 WC_Order 对象
        $order_id = $order->get_id();
        $order_date = esc_html( wc_format_datetime( $order->get_date_created() ) );

        echo '订单 #' . $order_id . ' (购买日期: ' . $order_date . ')';
        echo '';

        foreach ( $order->get_items() as $item_id => $item ) {
            $product = $item->get_product();
            if ( $product ) {
                $product_name = $product->get_name();
                $product_id = $product->get_id();
                echo '商品名称: ' . esc_html( $product_name ) . ' (ID: ' . $product_id . ')';
            }
        }
        echo '';
    }
    echo '';
}

?>

注意事项与总结

日期格式： 在设置日期条件时，请始终使用 Y-m-d 格式，以确保日期比较的准确性。strtotime() 函数非常灵活，可以解析多种日期字符串，例如 '-1 week' (一周前), '-1 month' (一个月前) 等。
wc_get_orders vs get_posts：
- wc_get_orders 是WooCommerce官方推荐的查询订单方式，它直接返回 WC_Order 对象，更面向对象，且通常对订单数据有更好的优化。
- get_posts 是WordPress通用的查询文章方式，返回的是 WP_Post 对象，需要手动转换为 WC_Order 对象。对于WooCommerce订单，除非有特定原因，否则建议优先使用 wc_get_orders。
时区问题： WordPress和WooCommerce通常会处理时区问题，但如果在服务器配置或代码中存在自定义时区设置，请确保日期比较在正确的时区下进行。date() 函数默认使用服务器时区，而WordPress的日期函数会考虑在后台设置的时区。
性能优化： 如果用户有大量的订单，'numberposts' => -1 可能会导致性能问题，因为它会一次性加载所有匹配的订单。在实际生产环境中，考虑使用分页（paged 参数）来限制每次加载的订单数量。
用户登录状态： 在展示用户购买历史之前，务必检查用户是否已登录 (is_user_logged_in())，以避免显示错误信息或安全漏洞。