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：

 -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' => '<' . ( $today - ($days_delay * $one_day) )：只检索创建日期早于指定日期的订单。
• $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 商店中 "失败" 状态的订单更改为 "已取消" 状态。 确保正确配置代码并进行充分的测试，以确保功能正常运行。通过自动取消未支付的订单，您可以更好地管理您的库存和订单流程，提高运营效率。