WooCommerce 多联盟站点动态追加 Affiliate ID 教程-php教程-PHP中文网

WooCommerce 多联盟站点动态追加 Affiliate ID 教程

本文详解如何在 woocommerce 外部产品链接中，根据目标域名自动追加对应联盟 id（如 sitea.com → ?affiliateid-1，siteb.com → ?affiliateid-2），通过 woocommerce_product_add_to_cart_url 钩子实现精准、可扩展的多联盟路由逻辑。

本文详解如何在 woocommerce 外部产品链接中，根据目标域名自动追加对应联盟 id（如 sitea.com → ?affiliateid-1，siteb.com → ?affiliateid-2），通过 woocommerce_product_add_to_cart_url 钩子实现精准、可扩展的多联盟路由逻辑。

在 WooCommerce 中，外部产品（External/Affiliate Product）的「加入购物车」按钮实际跳转至第三方联盟网站。为追踪推广效果，需为不同合作平台动态拼接专属联盟参数（如 ?affiliateID-1）。原方案仅支持单一域名硬编码，而真实业务常需对接多个联盟渠道（例如 Facebook、Microsoft、Amazon 等），此时需基于 URL 域名智能匹配并注入对应参数。

核心思路是：在 woocommerce_product_add_to_cart_url 过滤器中，先判断产品类型是否为 external，再使用字符串匹配（推荐 parse_url() + str_ends_with() 或 str_starts_with()）精准识别目标域名，避免误判子路径或协议差异。以下为生产就绪的优化代码：

add_filter( 'woocommerce_product_add_to_cart_url', 'custom_product_add_to_cart_url', 20, 2 );
function custom_product_add_to_cart_url( $add_to_cart_url, $product ) {
    // 仅处理外部产品
    if ( ! $product->is_type( 'external' ) ) {
        return $add_to_cart_url;
    }

    // 解析 URL 主机名（兼容 http/https/www/non-www）
    $parsed = parse_url( $add_to_cart_url );
    if ( ! $parsed || ! isset( $parsed['host'] ) ) {
        return $add_to_cart_url;
    }
    $host = strtolower( $parsed['host'] );

    // 定义联盟规则：域名 → 参数后缀
    $affiliate_rules = [
        'facebook.com'     => '?affiliateID-1',
        'microsoft.com'    => '?affiliateID-2',
        'amazon.com'       => '?ref=yourstore-20',
        'example-affiliate.net' => '?utm_source=wc&utm_medium=affiliate',
    ];

    // 匹配并追加参数（支持精确主机名匹配）
    foreach ( $affiliate_rules as $domain => $param ) {
        if ( $host === $domain || $host === 'www.' . $domain ) {
            // 若原 URL 已含查询参数，用 & 连接；否则用 ? 开头
            $separator = ( false !== strpos( $add_to_cart_url, '?' ) ) ? '&' : '?';
            return $add_to_cart_url . $separator . ltrim( $param, '?' );
        }
    }

    // 未匹配时保持原始链接（不添加任何参数）
    return $add_to_cart_url;
}

✅ 关键优势说明：