本教程旨在指导开发者如何在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 参数来设置订单的创建日期范围。要筛选最近三天内的订单，可以将其设置为 ‘youjiankuohaophpcn’ . date( ‘Y-m-d’, strtotime(‘- 3day’ ) )。这表示查询创建日期晚于三天前的订单。
- 执行查询： 将 $args 数组传递给 wc_get_orders 函数。
- 遍历订单及商品： 遍历返回的订单对象，并进一步遍历每个订单中的商品项，以获取商品详情。
示例代码
<?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 参数，我们可以实现复杂的日期范围筛选。
品杰电子商务购物平台系统
0
网上购物商城，它属于BtoC电子商务网站平台，它能够直接绕过中介（如批发商、销售商或经销商）建立与客户的直接关系。该网站可以为用户提供商品的详细信息，用户可以在线购买商品，确定镇定的订单；同时提供关于商品或电子零销商的选择建议等等。网上购物平台使得人们的购买变的更方便、更加容易。 前台功能模块有： 热销商品 订单管理 购物车 结算中心 注册会员 用户登录
0
实现步骤
- 构建查询参数数组： 定义一个包含筛选条件的 $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 对象，然后遍历其中的商品项。
示例代码
<?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>';
}
?>
登录后复制
注意事项与总结
- 日期格式： 在设置日期条件时，请始终使用 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())，以避免显示错误信息或安全漏洞。
通过上述两种方法，您可以灵活地在WooCommerce中根据购买日期筛选和展示用户的已购商品。选择哪种方法取决于您的具体需求和对WooCommerce API的偏好，但通常情况下，wc_get_orders 是更现代和推荐的选择。
以上就是在WooCommerce中实现按购买日期筛选用户订单商品的功能的详细内容，更多请关注php中文网其它相关文章！