实现 WooCommerce 结账后基于产品自定义字段的动态重定向（结账.自定义.字段.重定向.动态...）

本教程详细阐述了如何在 WooCommerce 结账完成后，根据购物车内商品的自定义字段值实现用户重定向。文章分析了在 order-received 页面直接获取产品信息的挑战，并提供了一个健壮的解决方案。通过获取订单详情、遍历订单商品并读取每个商品的自定义字段，您可以精确地将用户导向预设的特定页面，从而提升用户体验或实现特定业务逻辑。挑战：在结账后页面获取产品自定义字段

在 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 终止脚本执行。
        }
    }
}

代码解析与注意事项

1. add_action('template_redirect', 'my_redirect_after_purchase');

   • template_redirect 是一个在 WordPress 加载模板文件之前触发的钩子，非常适合执行重定向操作。

2. if ( !is_wc_endpoint_url( 'order-received' ) || empty( $_GET['key'] ) ) { return; }

   • is_wc_endpoint_url('order-received') 确保当前页面是 WooCommerce 的“订单已接收”页面。
   • empty( $_GET['key'] ) 检查 URL 中是否存在订单密钥。订单密钥是访问订单信息的重要凭证，也是安全验证的一部分。

3. $order_id = wc_get_order_id_by_order_key( $_GET['key'] );

   • 通过 URL 中的订单密钥获取对应的订单 ID。

4. $order = wc_get_order( $order_id );

   • 使用订单 ID 获取 WooCommerce 订单对象。这个对象包含了订单的所有详细信息，包括购买的商品。

5. foreach( $order->get_items() as $item ) { ... }

   • 遍历订单中的每个商品项。$item 是一个包含商品详细信息的数组或对象。
   • $item['product_id'] 获取当前商品项对应的产品 ID。如果商品是可变产品的一个变体，$item['variation_id'] 会提供变体 ID，而 $item['product_id'] 仍会是父产品的 ID。根据您的需求，可能需要检查变体 ID。

6. $my_redirect = get_post_meta( $product_id, '_my_redirect', true );

   • get_post_meta() 是 WordPress 获取自定义字段的标准函数。
   • $product_id：要获取自定义字段的产品 ID。
   • '_my_redirect'：您在产品编辑页面为重定向 URL 设置的自定义字段的键名。请确保这个键名与您实际使用的键名一致。
   • true：表示只返回单个值。

7. 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 产品的自定义字段，在用户结账后实现动态且有针对性的页面重定向，从而满足各种个性化的业务需求。

以上就是实现 WooCommerce 结账后基于产品自定义字段的动态重定向的详细内容，更多请关注知识资源分享宝库其它相关文章！