WooCommerce按日期筛选订单商品技巧

学习文章要努力，但是不要急！今天的这篇文章《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 参数来设置订单的创建日期范围。要筛选最近三天内的订单，可以将其设置为 '>' . 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 参数，我们可以实现复杂的日期范围筛选。

实现步骤

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按日期筛选订单商品技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！