当前位置：首页 > 文章列表 > 文章 > php教程 > WooCommerce自动取消失败订单教程

WooCommerce自动取消失败订单教程

2025-07-14 10:21:27 0浏览收藏

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

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

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

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

实现原理

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

步骤详解

创建 mu-plugin 文件
首先，我们需要创建一个 mu-plugin 文件。mu-plugins 目录是 WordPress 用于存放必须加载的插件的目录。如果该目录不存在，请手动创建。
在 wp-content/mu-plugins/ 目录下创建一个名为 auto-cancel-failed-orders.php 的文件。
编写代码
将以下代码添加到 auto-cancel-failed-orders.php 文件中：
```
<?php
add_action( 'woocommerce_cancel_unpaid_orders', 'cancel_failed_orders' );

function cancel_failed_orders() {
    $days_delay = 1; // 设置延迟天数，这里设置为1天
    $one_day    = 24 * 60 * 60;
    $today      = strtotime( date('Y-m-d') );

    $failed_orders = wc_get_orders( array(
        'limit'        => -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() 函数将订单状态更新为“已取消”，并添加备注信息。
保存并激活 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学习网公众号了解相关技术文章。