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

碧海醫心
发布: 2025-11-20 12:28:29
原创
512人浏览过

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

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

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

方法一:使用 wc_get_orders 函数进行日期筛选(推荐)

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

实现步骤

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

示例代码

<?php

// 确保用户已登录
if ( ! is_user_logged_in() ) {
    echo '<p>请登录以查看您的购买历史。</p>';
    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 '<h3>您最近3天内购买的商品:</h3>';

if ( empty( $customer_orders ) ) {
    echo '<p>您在最近3天内没有购买任何商品。</p>';
} else {
    echo '<ul>';
    // 遍历每个 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 '<li><strong>订单 #' . $order_id . '</strong> (购买日期: ' . $order_date . ')';
        echo '<ul>';

        // 遍历订单中的每个商品项
        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 '<li>商品名称: ' . esc_html( $product_name ) . ' (ID: ' . $product_id . ')</li>';
            }
        }
        echo '</ul></li>';
    }
    echo '</ul>';
}

?>
登录后复制

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

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

品杰电子商务购物平台系统
品杰电子商务购物平台系统

网上购物商城,它属于BtoC电子商务网站平台,它能够直接绕过中介(如批发商、销售商或经销商)建立与客户的直接关系。该网站可以为用户提供商品的详细信息,用户可以在线购买商品,确定镇定的订单;同时提供关于商品或电子零销商的选择建议等等。网上购物平台使得人们的购买变的更方便、更加容易。 前台功能模块有: 热销商品 订单管理 购物车 结算中心 注册会员   用户登录

品杰电子商务购物平台系统 0
查看详情 品杰电子商务购物平台系统

实现步骤

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

示例代码

<?php

// 确保用户已登录
if ( ! is_user_logged_in() ) {
    echo '<p>请登录以查看您的购买历史。</p>';
    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 '<h3>您最近3天内购买的商品:</h3>';

if ( empty( $customer_orders ) ) {
    echo '<p>您在最近3天内没有购买任何商品。</p>';
} else {
    echo '<ul>';
    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 '<li><strong>订单 #' . $order_id . '</strong> (购买日期: ' . $order_date . ')';
        echo '<ul>';

        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 '<li>商品名称: ' . esc_html( $product_name ) . ' (ID: ' . $product_id . ')</li>';
            }
        }
        echo '</ul></li>';
    }
    echo '</ul>';
}

?>
登录后复制

注意事项与总结

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

通过上述两种方法,您可以灵活地在WooCommerce中根据购买日期筛选和展示用户的已购商品。选择哪种方法取决于您的具体需求和对WooCommerce API的偏好,但通常情况下,wc_get_orders 是更现代和推荐的选择。

以上就是在WooCommerce中实现按购买日期筛选用户订单商品的功能的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号