挑战：在结账后页面获取产品自定义字段
在 woocommerce 中，当用户完成购买并被重定向到“订单已接收”（order-received）页面时，直接使用 get_the_id() 或依赖全局 $post 对象来获取购物车中产品的自定义字段是不可行的。这是因为在 template_redirect 钩子下，order-received 页面上下文通常指向的是该页面的本身，而非购买的商品。为了正确地获取与已购买商品相关的自定义字段，我们需要通过订单对象来访问其包含的商品信息。
解决方案：通过订单对象检索产品自定义字段
正确的做法是首先获取当前的订单对象，然后遍历订单中的所有商品，针对每个商品获取其对应的产品ID，进而读取该产品的自定义字段。一旦找到包含重定向URL的自定义字段，即可执行重定向操作。
以下是实现此功能的详细代码和解释：
/**
* 根据产品自定义字段在 WooCommerce 结账后进行重定向。
*
* 此函数在 template_redirect 钩子上执行，用于检查是否在订单接收页面，
* 然后获取订单商品的产品ID，并根据产品自定义字段的值进行重定向。
*/
add_action('template_redirect', 'my_redirect_after_purchase');
function my_redirect_after_purchase() {
// 1. 验证当前页面是否为 WooCommerce 订单接收页面，并检查订单密钥是否存在。
// 确保我们只在正确的上下文执行重定向逻辑。
if ( !is_wc_endpoint_url( 'order-received' ) || empty( $_GET['key'] ) ) {
return;
}
// 2. 使用订单密钥获取订单ID。
// 订单密钥是安全获取订单信息的关键。
$order_id = wc_get_order_id_by_order_key( $_GET['key'] );
// 3. 根据订单ID获取订单对象。
// 订单对象包含了所有购买商品的信息。
$order = wc_get_order( $order_id );
// 4. 遍历订单中的所有商品项。
// 对于每个购买的商品，我们需要检查其自定义字段。
foreach( $order->get_items() as $item ) {
// 5. 从当前商品项中获取产品ID。
// $item['product_id'] 包含的是简单产品或可变产品父产品的ID。
// 如果是可变产品变体，可以使用 $item['variation_id']。
$product_id = $item['product_id'];
// 6. 根据产品ID获取名为 '_my_redirect' 的自定义字段值。
// '_my_redirect' 是您在产品编辑页面添加的自定义字段的键名。
$my_redirect = get_post_meta( $product_id, '_my_redirect', true );
// 7. 如果自定义字段值不为空，则执行重定向。
if ( !empty( $my_redirect ) ) {
// 使用 wp_redirect 进行重定向，并确保 URL 是安全的。
wp_redirect( esc_url( $my_redirect ) );
exit; // 重定向后必须调用 exit 终止脚本执行。
}
}
}代码解析与注意事项
-
add_action('template_redirect', 'my_redirect_after_purchase');
- template_redirect 是一个在 WordPress 加载模板文件之前触发的钩子，非常适合执行重定向操作。
-
if ( !is_wc_endpoint_url( 'order-received' ) || empty( $_GET['key'] ) ) { return; }
- is_wc_endpoint_url('order-received') 确保当前页面是 WooCommerce 的“订单已接收”页面。
- empty( $_GET['key'] ) 检查 URL 中是否存在订单密钥。订单密钥是访问订单信息的重要凭证，也是安全验证的一部分。
-
$order_id = wc_get_order_id_by_order_key( $_GET['key'] );
- 通过 URL 中的订单密钥获取对应的订单 ID。
-
$order = wc_get_order( $order_id );
青辰印刷综合业务管理系统(含网站WEB程序)2.0下载易学易用：友好的系统操作界面，无须具备专业知识，即可熟练的使用系统。功能完善：具备新建、修改、明细、审批、导入、导出、删除、批量、打印等功能。模型开发：自定义表单字段选项零代码二次开发，可无限扩展后台功能模块。 维护方便：基于互联网技术B/S体系结构，实施快速，极大的减少系统升级维护工作。售后保证：专业的技术研发团队，可提供可靠的产品迭代、版本升级和技术支持服务。超低成本：一次投入终身使用、用户不
- 使用订单 ID 获取 WooCommerce 订单对象。这个对象包含了订单的所有详细信息，包括购买的商品。
-
foreach( $order->get_items() as $item ) { ... }
- 遍历订单中的每个商品项。$item 是一个包含商品详细信息的数组或对象。
- $item['product_id'] 获取当前商品项对应的产品 ID。如果商品是可变产品的一个变体，$item['variation_id'] 会提供变体 ID，而 $item['product_id'] 仍会是父产品的 ID。根据您的需求，可能需要检查变体 ID。
-
$my_redirect = get_post_meta( $product_id, '_my_redirect', true );
- get_post_meta() 是 WordPress 获取自定义字段的标准函数。
- $product_id：要获取自定义字段的产品 ID。
- '_my_redirect'：您在产品编辑页面为重定向 URL 设置的自定义字段的键名。请确保这个键名与您实际使用的键名一致。
- true：表示只返回单个值。
-
if ( !empty( $my_redirect ) ) { wp_redirect( esc_url( $my_redirect ) ); exit; }
- 如果找到有效的重定向 URL，则使用 wp_redirect() 函数执行重定向。
- esc_url()：这是一个重要的安全函数，用于清理和验证 URL，防止 XSS 攻击。强烈建议在所有重定向 URL 上使用它。
- exit;：在 wp_redirect() 之后调用 exit; 是至关重要的，它会立即终止脚本的执行，防止进一步的代码运行或意外输出，从而确保重定向顺利进行。
扩展思考
- 多产品场景： 如果订单中包含多个产品，且它们都设置了重定向 URL，上述代码会重定向到第一个找到有效 URL 的产品。如果您需要更复杂的逻辑（例如，重定向到优先级最高的产品，或生成一个包含所有产品相关信息的动态页面），则需要修改循环逻辑。
- 自定义字段定义： 您需要在 WooCommerce 产品的编辑页面为每个产品添加一个名为 _my_redirect 的自定义字段，并填入相应的重定向 URL。这可以通过 ACF (Advanced Custom Fields) 等插件或直接在产品编辑页面的“自定义字段”面板中完成。
- 错误处理： 在实际应用中，您可能需要添加额外的错误处理，例如当 wc_get_order() 返回 false 时。
- 用户体验： 考虑重定向的目标页面是否能提供良好的用户体验，例如，是否能清晰地告知用户购买成功并提供下一步操作。
通过上述方法，您可以灵活地根据 WooCommerce 产品的自定义字段，在用户结账后实现动态且有针对性的页面重定向，从而满足各种个性化的业务需求。
