WooCommerce自动取消失败订单教程

知识点掌握了，还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战，手把手教大家学习《自动取消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 文件中：

   <?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() 函数将订单状态更新为“已取消”，并添加备注信息。

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学习网公众号了解相关技术文章。