本教程旨在帮助 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' => '<' . ( $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 商店中 "失败" 状态的订单更改为 "已取消" 状态。 确保正确配置代码并进行充分的测试，以确保功能正常运行。通过自动取消未支付的订单，您可以更好地管理您的库存和订单流程，提高运营效率。
