自动将 WooCommerce 失败订单状态更改为已取消状态

本教程旨在帮助 WooCommerce 用户解决自动将 “失败” 状态的订单更改为 “已取消” 状态的问题。通过使用 woocommerce_cancel_unpaid_orders 钩子，并结合订单状态更新函数，您可以轻松实现订单在一定时间后自动取消的功能，从而更好地管理您的 WooCommerce 商店。

自动取消 WooCommerce 失败订单

在 WooCommerce 商店中，如果客户在一段时间内未能完成支付，将 “失败” 状态的订单自动更改为 “已取消” 状态，可以帮助您更好地管理订单，释放库存。以下是如何实现此功能的详细步骤：

1. 选择正确的 Action Hook

原代码中使用的 woocommerce_cancel_unpaid_submitted action hook 不存在。正确的 hook 应该是 woocommerce_cancel_unpaid_orders。 WooCommerce 提供了一系列的 action hook，允许开发者在特定的事件发生时执行自定义代码。选择正确的 hook 是实现功能的基础。

2. 代码实现

将以下代码添加到您的主题的 functions.php 文件中，或者创建一个自定义的 mu-plugin：

<?php add_action( 'woocommerce_cancel_unpaid_orders', 'cancel_failed_orders' );  function cancel_failed_orders() {     $days_delay = 1; // 设置延迟天数     $one_day    = 24 * 60 * 60;     $today      = strtotime( date('Y-m-d') );      $args = array(         'limit'        => -1,         'status'       => 'failed', // 注意：这里使用 'failed'，而不是 'wc-failed'         'date_created' => '<' . ( $today - ($days_delay * $one_day) ),     );      $failed_orders = wc_get_orders( $args );      if ( ! empty( $failed_orders ) ) {         $cancelled_text = __("No successful payment", "woocommerce");         foreach ( $failed_orders as $order ) {             $order->update_status( 'cancelled', $cancelled_text ); // 注意：这里使用 'cancelled'，而不是 'wc-cancelled'         }     } }

代码解释：

• add_action( ‘woocommerce_cancel_unpaid_orders’, ‘cancel_failed_orders’ )：将 cancel_failed_orders 函数绑定到 woocommerce_cancel_unpaid_orders action hook。这意味着当 WooCommerce 触发此 hook 时，cancel_failed_orders 函数将被执行。
• $days_delay = 1;：设置订单在多少天后被取消。这里设置为 1 天。您可以根据需要调整此值。
• $one_day = 24 * 60 * 60;：计算一天有多少秒，用于计算时间戳。
• $today = strtotime( date(‘Y-m-d’) );：获取今天的日期的时间戳。
• $args 数组：定义了要检索的订单的参数。
  • ‘limit’ => -1：检索所有符合条件的订单。
  • ‘status’ => ‘failed’：只检索状态为 “失败” 的订单。注意：这里使用的是 failed 而不是 wc-failed。
  • ‘date_created’ => ‘
• $failed_orders = wc_get_orders( $args );：使用 wc_get_orders 函数检索符合条件的订单。
• if ( ! empty( $failed_orders ) ) { … }：检查是否找到了 “失败” 的订单。
• $order->update_status( ‘cancelled’, $cancelled_text );：将订单状态更新为 “已取消”。注意：这里使用的是 cancelled 而不是 wc-cancelled。 $cancelled_text 是一个可选的注释，说明订单被取消的原因。

3. 重要注意事项

• 订单状态： wc-failed 和 wc-cancelled 并非直接使用的状态值，正确的值应该是 failed 和 cancelled。
• Action Hook： 确保使用正确的 action hook woocommerce_cancel_unpaid_orders。
• 测试： 在生产环境中部署之前，务必在测试环境中进行充分的测试。
• Cron Job： woocommerce_cancel_unpaid_orders 钩子通常与 WooCommerce 的内置 Cron 系统一起使用。确保您的 WordPress 站点正确配置了 Cron，以便定期执行此任务。

4. 总结

通过使用 woocommerce_cancel_unpaid_orders action hook，您可以轻松地自动将 WooCommerce 商店中 “失败” 状态的订单更改为 “已取消” 状态。 确保正确配置代码并进行充分的测试，以确保功能正常运行。通过自动取消未支付的订单，您可以更好地管理您的库存和订单流程，提高运营效率。