登录
首页 >  文章 >  php教程

WooCommerce自动取消失败订单教程

时间:2025-07-14 10:21:27 492浏览 收藏

知识点掌握了,还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战,手把手教大家学习《自动取消WooCommerce失败订单教程》,在实现功能的过程中也带大家重新温习相关知识点,温故而知新,回头看看说不定又有不一样的感悟!

自动取消 WooCommerce 失败订单:一步步教程

本文提供了一个详细的教程,旨在帮助 WooCommerce 用户自动将状态为“失败”的订单更改为“已取消”。通过使用 woocommerce_cancel_unpaid_orders 钩子和自定义代码,可以实现订单在一定时间后(例如 24 小时)自动取消,从而优化订单管理流程。本文将提供完整的代码示例和详细的步骤说明。

在 WooCommerce 商店中,经常会遇到客户下单后未能成功支付的情况,这些订单的状态通常为“失败”。手动取消这些订单既耗时又容易遗漏。本文将介绍如何通过自定义代码,实现自动将指定时间(例如 24 小时)前的“失败”订单更改为“已取消”状态。

实现原理

该方法的核心是使用 WooCommerce 提供的钩子 woocommerce_cancel_unpaid_orders。这个钩子在 WooCommerce 内部定期运行,用于处理未支付的订单。我们可以利用这个钩子,编写自定义函数,筛选出需要取消的“失败”订单,并将其状态更新为“已取消”。

步骤详解

  1. 创建 mu-plugin 文件

    首先,我们需要创建一个 mu-plugin 文件。mu-plugins 目录是 WordPress 用于存放必须加载的插件的目录。如果该目录不存在,请手动创建。

    在 wp-content/mu-plugins/ 目录下创建一个名为 auto-cancel-failed-orders.php 的文件。

  2. 编写代码

    将以下代码添加到 auto-cancel-failed-orders.php 文件中:

     -1, // 获取所有订单
            'status'       => 'failed', // 筛选状态为“失败”的订单
            'date_created' => '<' . ( $today - ($days_delay * $one_day) ), // 筛选创建日期早于指定时间的订单
        ) );
    
        if ( ! empty( $failed_orders ) ) {
            $cancelled_text = __("No successful payment", "woocommerce");
            foreach ( $failed_orders as $order ) {
                $order->update_status( 'cancelled', $cancelled_text ); // 更新订单状态为“已取消”
            }
        }
    }

    代码解释:

    • add_action( 'woocommerce_cancel_unpaid_orders', 'cancel_failed_orders' );:将 cancel_failed_orders 函数挂载到 woocommerce_cancel_unpaid_orders 钩子上。
    • $days_delay = 1;:设置延迟天数,这里设置为 1 天,表示取消 24 小时前的“失败”订单。
    • $one_day = 24 * 60 * 60;:计算一天的秒数。
    • $today = strtotime( date('Y-m-d') );:获取今天的 Unix 时间戳。
    • wc_get_orders():使用 WooCommerce 的 wc_get_orders() 函数获取符合条件的订单。
      • 'limit' => -1:获取所有订单。
      • 'status' => 'failed':筛选状态为“失败”的订单。
      • 'date_created' => '<' . ( $today - ($days_delay * $one_day) ):筛选创建日期早于指定时间的订单。
    • $order->update_status( 'cancelled', $cancelled_text );:使用 $order->update_status() 函数将订单状态更新为“已取消”,并添加备注信息。
  3. 保存并激活 mu-plugin

    保存 auto-cancel-failed-orders.php 文件。由于 mu-plugins 目录下的插件会自动激活,因此无需手动激活。

注意事项

  • 状态码: 务必使用正确的状态码。'failed' 对应 "失败" 状态, 'cancelled' 对应 "已取消" 状态。
  • 延迟时间: 根据实际需求调整 $days_delay 的值,以控制订单自动取消的延迟时间。
  • 测试: 在生产环境中使用之前,请务必在测试环境中进行充分的测试,以确保代码能够正常工作。
  • 服务器定时任务: woocommerce_cancel_unpaid_orders 钩子的触发依赖于 WooCommerce 内部的定时任务(WP-Cron)。如果自动取消功能没有按预期工作,请检查 WP-Cron 是否正常运行。可以通过安装 WP Crontrol 插件来管理和监控 WP-Cron。

总结

通过以上步骤,我们可以利用 woocommerce_cancel_unpaid_orders 钩子和自定义代码,实现 WooCommerce 商店中“失败”订单的自动取消。这可以大大提高订单管理效率,减少手动操作,并确保订单数据的准确性。 请记住,在生产环境部署之前,务必进行充分的测试。

文中关于的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《WooCommerce自动取消失败订单教程》文章吧,也可关注golang学习网公众号了解相关技术文章。

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>