本教程旨在帮助您解决 WooCommerce 中自动将“失败”状态的订单更改为“已取消”状态的问题。我们将探讨如何使用 woocommerce_cancel_unpaid_orders 钩子，并提供可直接使用的代码示例，确保您的 WooCommerce 商店能够自动处理未支付订单，提高运营效率。
在 WooCommerce 商店中，自动处理未支付订单至关重要。如果客户在一定时间内未能成功支付订单，将其状态自动更改为“已取消”可以释放库存，避免不必要的资源占用。本教程将指导您如何实现这一功能，重点介绍正确的 WordPress 钩子以及完整的代码示例。
使用 woocommerce_cancel_unpaid_orders 钩子
原始代码尝试使用 woocommerce_cancel_unpaid_submitted 钩子，但该钩子并不存在。正确的钩子是 woocommerce_cancel_unpaid_orders。此钩子专门用于处理未支付订单的自动取消。
代码实现
以下是修改后的代码，它使用 woocommerce_cancel_unpaid_orders 钩子，并将“失败”状态的订单自动更改为“已取消”状态：
<?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') ); $failed_orders = wc_get_orders( array( 'limit' => -1, 'status' => 'failed', // 注意：这里应使用 'failed'，而不是 'wc-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 ); // 注意：这里应使用 'cancelled'，而不是 'wc-cancelled' } } }
代码解释：
- add_action( ‘woocommerce_cancel_unpaid_orders’, ‘cancel_failed_orders’ );: 将 cancel_failed_orders 函数绑定到 woocommerce_cancel_unpaid_orders 钩子上。
- $days_delay = 1;: 设置延迟天数，即订单创建多久后会被取消。这里设置为 1 天。
- $one_day = 24 * 60 * 60;: 计算一天有多少秒。
- $today = strtotime( date(‘Y-m-d’) );: 获取今天的 unix 时间戳。
- wc_get_orders(…): 使用 wc_get_orders 函数获取所有状态为“失败”，且创建日期早于 $days_delay 天前的订单。
- ‘status’ => ‘failed’: 查询状态为“失败”的订单。重要提示：这里直接使用 failed，而不是 wc-failed。wc-failed 是订单状态的内部表示，而 failed 是更常用的状态名称。
- *`’date_created’ => ‘ $one_day) )`**: 查询创建日期早于指定日期的订单。
- if ( ! empty( $failed_orders ) ) { … }: 检查是否找到了需要取消的订单。
- $cancelled_text = __(“No successful payment”, “woocommerce”);: 设置取消订单的原因。
- $order->update_status( ‘cancelled’, $cancelled_text );: 循环遍历所有找到的订单，并将它们的状态更新为“已取消”，并添加取消原因。重要提示： 这里直接使用 cancelled，而不是 wc-cancelled。wc-cancelled 是订单状态的内部表示，而 cancelled 是更常用的状态名称。
部署方法
将上述代码保存为一个 PHP 文件（例如 cancel-failed-orders.php），然后将其上传到 WordPress 插件目录（wp-content/plugins/）或创建一个 mu-plugin 目录（wp-content/mu-plugins/），并将文件放入其中。 mu-plugins 无需激活，会自动加载。
注意事项
- 订单状态： 确保使用正确的订单状态名称 (failed 和 cancelled)。
- 时间戳计算： 检查时间戳计算是否正确，以确保订单在正确的时间被取消。
- 测试： 在生产环境中使用之前，请务必在测试环境中进行充分测试。
- 兼容性： 确保代码与您的 WooCommerce 版本兼容。
总结
通过使用正确的 woocommerce_cancel_unpaid_orders 钩子，并结合 wc_get_orders 函数和订单状态更新，您可以轻松实现 WooCommerce 中自动取消“失败”订单的功能。 记住，在部署到生产环境之前，务必进行充分的测试。通过自动处理未支付订单，您可以提高商店的运营效率，并确保库存的准确性。
